PREVIEW

Trabalhando com tarefas de aplicativo

Este tutorial orienta você pelo processo de criação de uma tarefa do aplicativo, que envolve as seguintes fases:

• Criar uma definição de ação e carregá-la no Action Center.
• Desenvolvendo um aplicativo de ação dentro do Apps, e configurando os campos para cada propriedade definida na definição da ação.
• Publicar o aplicativo e criar um fluxo de trabalho no Studio Web ou no Studio Desktop usando a atividade Create App Task .

1. Crie e carregue a definição da ação

Para vincular campos de ação a um aplicativo, você deve criar um esquema JSON, você precisa criar um esquema JSON, chamado de definição de ação. Essa definição descreve os campos de ação obrigatórios e especifica as ações permitidas que estão disponíveis ao concluir a ação.

1. Prepare a definição da ação:
   1. Comece adicionando uma chave de abertura para indicar o início do objeto JSON.
   2. Dentro do objeto JSON, defina as propriedades Name e Description como strings, junto com seus valores.

      "Name": "Validate Document",
          "Description": "Validate and approve invoice",

   3. Adicione uma propriedade Allowed Actions como uma matriz de strings para especificar as ações permitidas que você pode realizar no final da ação. Os valores devem ser equivalentes a Complete ou Recusar.

      "AllowedActions": [
              "Yes",
              "No"
          ],

   4. Adicione uma propriedade Schema e atribua a ela um objeto que siga o padrão do Esquema JSON: http://json-schema.org/draft-07/schema#.

      "Schema": {
              "$schema": "http://json-schema.org/draft-07/schema#",
              "type": "object",

   5. Dentro do objeto properties , defina cada propriedade que você deseja incluir no esquema. Para cada propriedade, especifique seu type e description.
      Cada propriedade no Schema é equivalente aos campos de entrada que você adicionará na ação do aplicativo.

      "properties": {
                  "Description": {
                      "type": "string",
                      "direction": "in",
                      "description": "Validation message"
                  },
                  "invoice_document": {
                      "type": "string",
                      "direction": "in",
                      "description": "Document file."
                  },
                  "Comments": {
                      "type": "string",
                      "direction": "inout",
                      "description": "Approval or rejection comments"
                  }
              }

      Observação: se a propriedade direction não estiver definida, então o valor padrão para ela é inout (In/Out).
   6. Se determinadas propriedades forem necessárias, inclua uma matriz required , na qual você lista as propriedades que deseja marcar como obrigatórias na ação.
   7. Feche o objeto JSON adicionando uma chave de fechamento.
2. Carregue a definição da ação para o Action Center:
   1. Abra o Action Center, navegue até Configurações de administrador e selecione Tenant.
   2. Na guia Definições de ação , selecione Adicionar definição de ação.
   3. Selecione Baixar exemplo de definição de ação para baixar um exemplo de esquema JSON para ajudar você a preparar a definição de ação.
   4. Selecione Importar do arquivo e selecione o arquivo JSON que você preparou anteriormente.
   5. Insira um nome e descrição apropriados para a definição da Ação e, em seguida, selecione Criar.

2. Crie o aplicativo de Ação

Os aplicativos criados usando uma integração para ações são projetados para serem utilizados dentro de fluxos de trabalho de longa duração e os usuários finais podem acessar esses aplicativos apenas por meio da interação com as ações geradas.

1. Abra o Apps dentro da organização onde você carregou as definições de ação.
2. Crie um aplicativo do zero ou escolha um modelo pré-fabricado que se adeque às suas necessidades.
3. Ao lado de Adicionar controle, selecione Adicionar qualquer e, então, selecione Ação.
   Esta etapa permite que você especifique a definição de ação para este aplicativo. Para este exemplo, estamos usando a definição da ação Validate Document .
4. Selecione o tenant no qual você carregou anteriormente a definição da ação e selecione Avançar.
5. No lado esquerdo da caixa de diálogo Adicionar ação , selecione a definição de ação que você criou e clique em Adicionar.
   
   

   

   
   

   Acesse Referenciar uma definição de ação em seu aplicativo para saber mais sobre o uso de definições de ação com seus aplicativos de Ação.

6. Agora, você pode começar a adicionar controles ao aplicativo.
   Certifique-se de que os nomes dos controles do aplicativo se alinhem precisamente aos nomes usados no esquema JSON da definição da ação. Por exemplo, se você incluir um controle do Visualizador de documentos para exibir a propriedade invoice_document da definição da ação, nomeie o controle invoice_document.
   Os parâmetros de entrada ou saída de uma ação podem ser associados a qualquer controle de aplicativo, usando a seguinte sintaxe: Actions.<referenced_action_name>.<action_parameter_name>
   1. Crie uma página em branco e adicione um Layout a ela.
   2. Dentro do Layout, adicione um Contêiner, onde você pode adicionar a caixa de texto e os controles de imagem para exibir o nome do cliente e o logotipo da empresa que está validando o documento.
   3. Dentro do Layout, adicione um Contêiner, onde você coloca o controle do Visualizador de documentos .
   4. Crie uma variável chamada var_invoice_file e a adicione como origem do controle do Visualizador de documentos .
   5. Adicione outro contêiner dentro do Layout, no qual você possa adicionar uma Área de texto à esquerda. Como o tipo de texto Padrão na seguinte expressão: Actions.Validate_Document.Comments.
   6. Adicione dois controles Botão responsáveis por concluir a ação e configure uma regra para enviar a ação, correspondendo ao Allowed Actions especificado na definição da ação:
      1. Acesse Eventos e selecione Criar regra.
      2. No menu de lista suspensa selecione Enviar ação.
      3. Em Resultado da ação, selecione a ação permitida que você deseja que o botão acione quando clicado: Yes ou No.

      Acesse Regra: enviar ação para saber mais sobre essa regra específica.

7. Estabeleça um link para um compartimento de armazenamento do qual você carregará o documento antes de encaminhá-lo como parte da ação.
8. Publique o aplicativo, tornando-o acessível para uso dentro dos fluxos de trabalho do Studio.

   Acesse Publicação de um aplicativo de ação para saber mais sobre o processo de publicar um aplicativo de ação.

Observação: opcionalmente, se você quiser substituir a ação que você está usando para seu aplicativo, acesse Substituição de uma ação.

3. Crie uma tarefa do aplicativo dentro de um fluxo de trabalho

Crie um fluxo de trabalho no Studio Web ou no Studio Desktop para baixar um documento de fatura de uma conta do Google Drive. Faça o upload do documento baixado para o bucket de armazenamento associado ao seu aplicativo de Ação. Depois, adicione uma atividade de Ação do usuário/Ação doaplicativo 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. Registra uma mensagem detalhando a decisão de validação do usuário para o documento.

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 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 ao seu aplicativo de Ação.
   1. Em Caminho da pasta do Orchestrator e Nome do bucket de armazenamento, escolha o caminho da pasta do Orchestrator e o bucket de armazenamento em que 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: Você pode armazenar essa expressão em uma variável.
   
   

   

   
   
4. Adicione uma atividade Create App Task para criar a ação.
   1. Defina Título e Prioridade de acordo.
   2. Para Apps, selecione o aplicativo de Ação criado anteriormente no tutorial.
   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.
      Neste exemplo, nomeie a variável como taskID.
5. Adicione uma atividade Assign Tasks 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 seguinte expressão: taskID.Id.Value.
   2. No campo Nome ou e-mail do usuário, insira o nome de usuário ou o endereço de e-mail do usuário a quem você deseja atribuir a ação.
   
   

   

   
   
6. Adicione uma atividade Wait For App Task And Resume para aguardar que o usuário conclua a ação e depois retome o fluxo de trabalho.
   1. No campo Tarefa de 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 Mensagem de Log 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, baixe o projeto de amostra do Studio Desktop aqui. Para abri-lo no Studio Web, salve o projeto no Cloud e, em seguida, verifique seu Studio Web para o projeto abri-lo lá.