Trabalhando com tarefas de aplicativo

Para obter uma exibição detalhada de como criar uma tarefa do aplicativo, consulte a documentação oficial do Apps . Após desenvolver um aplicativo de ação dentro do Apps, você pode configurar campos para cada propriedade definida na propriedade de ação.

Para criar uma tarefa do aplicativo dentro de um fluxo de trabalho, usando a atividade Create App Task , acesse o Studio Web ou Studio Desktop e siga estas etapas:

Crie uma tarefa do aplicativo dentro de um fluxo de trabalho

Crie um fluxo de trabalho no Studio Web ou Studio Desktop para baixar um documento de fatura de uma conta do Google Drive. Carregue o documento baixado para o bucket de armazenamento associado a seu aplicativo de Ação. Em seguida, adicione uma atividade de ação do usuário/ação do aplicativo para exibir o documento específico para aprovação ou rejeição do usuário. Atribua a tarefa a um usuário, aguarde a conclusão da ação e retome o fluxo de trabalho. Registre uma mensagem detalhando a decisão de validação do usuário para o documento.

Observação:

As tarefas do aplicativo estão disponíveis na versão do Studio 2022.10 ou superior.

1. Crie um novo projeto no Studio.

2. Adicione uma atividade Download File .

   1. Estabeleça uma conexão com o Google Drive dentro da atividade.

   2. No campo Arquivo a baixar , especifique o nome do arquivo que você deseja baixar.

   3. Na seção Saída , crie uma variável para armazenar o arquivo baixado.

      Para este exemplo, nomeie a variável downloadFile.

3. Adicione uma atividade Carregar arquivo de armazenamento para carregar o arquivo para o bucket de armazenamento associado a seu aplicativo de Ação.

   1. Em Orchestrator Folder Path e Storage Bucket Name, escolha o caminho de pasta do Orchestrator e bucket de armazenamento onde você deseja carregar o arquivo.

   2. No campo Arquivo , insira a variável onde você armazenou o arquivo que você baixou.

      Para este exemplo, insira downloadFile.

   3. No campo Onde carregar/Caminho , insira a expressão downloadFile.FullName.toString , para salvar o arquivo no bucket de armazenamento.

      Dica:

      É possível armazenar essa expressão em uma variável.

      

4. Adicione uma atividade Create App Task para criar a ação.

   1. Defina o Título e a Prioridade de acordo.

   2. Para Apps, selecione o aplicativo de ação criado em Apps.

   3. Preencha os campos gerados com as variáveis apropriadas.

   4. Na seção Saída , crie uma variável UserActionData para armazenar os dados relacionados à ação gerada.

      Para este exemplo, nomeie a variável como taskID.

5. Adicione uma atividade Atribuir Tarefas para atribuir a tarefa a um usuário dentro da organização.

   1. No campo ID da tarefa , insira uma expressão que recupere a ID da tarefa da variável de saída criada na etapa 4, subetapa d.

      Neste exemplo, insira a expressão taskID.Id.Value .

   2. No campo Nome de usuário ou e-mail, insira o nome de usuário ou o endereço de e-mail do usuário ao qual você deseja atribuir esta ação.

      

      Observação:

      O menu suspenso de Apps na atividade Create App Tasks mostra apenas aplicativos implantados que possuem ações.

6. Adicione uma atividade Esperar pela tarefa do aplicativo e retomar para aguardar que o usuário conclua a ação e então retome o fluxo de trabalho.

   1. No campo Tarefa do aplicativo criada , insira a variável de saída criada na etapa 4, subetapa d.
   2. No campo Ação realizada , crie uma variável (exemplo: userActionTaken) para armazenar o tipo de ação que o usuário realizou para concluir a tarefa.

7. Adicione uma atividade Log Message para imprimir o tipo de ação que o usuário realizou para concluir a tarefa. Use uma expressão como "The action that user used to complete the Validate Invoice action was " + userActionTaken.ToString

   

Exemplo de fluxo de trabalho

Para seguir as etapas e experimentar o tutorial você mesmo, baixe o projeto de exemplo do Studio Desktop. Para abri-lo no Studio Web, salve o projeto no Cloud e, em seguida, verifique seu Studio Web para o projeto para abri-lo lá.