Extração da hierarquia de trabalho do Workday

O tutorial a seguir demonstra como usar de forma eficaz as principais funcionalidades dos fluxos de trabalho de API:

• Esquemas de entrada e saída
• Atividades do conector
• Atividades HTTP do conector
• Expressões JavaScript
• Formatação e transformação de respostas
• Publicação de fluxos de trabalho no Orchestrator

O Workday contém dados extensos e confidenciais de funcionários. Usando um fluxo de trabalho de API, você pode extrair e transformar informações específicas. Neste tutorial, o fluxo de trabalho recupera uma hierarquia de funcionários com base em solicitações de nomes e sobrenomes.

É necessária uma conexão válida com o Workday.

1. Crie um fluxo de trabalho da API.
2. Abra o Data Manager e adicione as propriedades firstname e Lastname como entrada. Você pode fazer referência a essas propriedades mais tarde por meio do objeto $workflow.input .
3. Adicione um Conector e configure-o para usar a seguinte atividade Workday (Rest) : Pesquisar Trabalhadores por Nome ou ID.
   1. Para o campo String ou ID de pesquisa , abra o Editor de expressão e escreva o seguinte:

      $workflow.input.firstName + " " + $workflow.input.lastName
      

4. Depure seu fluxo de trabalho e observe a resposta de sucesso. No entanto, zero trabalhadores foram encontrados.

5. Adicione uma atividade If e use o seguinte fragmento como a Condição:

   $context.outputs.Workers_1.content.length <= 0
   

6. Para a ramificação Then da atividade If , adicione uma atividade Response e configure-a da seguinte forma:

   • Tipo— Falha
   • Detalhes—

     { "notFound": "No workers found for given input" }
     

7. Depure seu fluxo de trabalho novamente. Como você não forneceu a entrada necessária, o fluxo de trabalho prossegue automaticamente para esta resposta e define o status do fluxo de trabalho como Falha.

8. Defina uma configuração de Debug com a seguinte carga:

   {
     "firstName": "Betty",
     "lastName": "Liu"
   }
   

9. Depure seu fluxo de trabalho até começar a ver resultados na propriedade de conteúdo do esquema de saída .

   

10. Para a ramificação Else da atividade If , adicione uma atividade Loop > For Each e configure-a da seguinte forma:

    • Em—

      $context.outputs.Workers_1.content
      

    • Nome do item— CurrentItem
    • Acumular resultados— Em

11. No corpo da atividade For Each, adicione três atividades Workday REST HTTP Request para o conector do Workday (REST):

    • Solicitação Workday REST 1: encontrar relatórios diretos
    • Solicitação 2 Workday REST : encontrar detalhes da organização
    • Workday REST HTTP Request 2: Find Peers. Isso significa que, para cada trabalhador no loop, a atividade retorna os detalhes mencionados: relatórios diretos, detalhes da organização e pares.

12. Configure a atividade Workday REST HTTP Request 1: Find Dire Reports da seguinte maneira:

    • Método—GET
    • URL da solicitação—

      "/common/v1/uipath_dpt1/workers/" + $currentItem.id + "/directReports"
      

    Onde uipath_dpt1/workers faz parte da definição de sandbox.

13. Configure a atividade Workday REST HTTP Request 2: Find Organization Detalhes da seguinte forma:

    • Método—GET
    • URL da solicitação—

      "/common/v1/uipath_dpt1/supervisoryOrganizations/" + $currentItem.primaryJob.supervisoryOrganization.id
      

    Onde uipath_dpt1/supervisoryOrganizations faz parte da definição de sandbox.

14. Configure a atividade Workday REST HTTP Request 3: Find Peers da seguinte maneira:

    • Método—GET
    • URL da solicitação—

      "/common/v1/uipath_dpt1/supervisoryOrganizations/" + $currentItem.primaryJob.supervisoryOrganization.id + "/workers"
      

    Onde uipath_dpt1/supervisoryOrganizations faz parte da definição de sandbox.

15. Depure seu fluxo de trabalho novamente. Observe que o fluxo de trabalho executa um número especificado de vezes em loops (com base no número de resultados da primeira atividade) sobre essas três solicitações HTTP.

16. No corpo da atividade For Each, adicione uma atividade Script após as três atividades anteriores Workday REST HTTP Request.

17. Para configurar a atividade Script , use o gerador Autopilot no editor Expressão e forneça o seguinte prompt:

    "Das 3 atividades anteriores, crie 3 objetos. O Objeto 1 é "manager" e deve retornar o descritor como nome e person.email como e-mail. O objeto 2 é pares da 3ª solicitação http e deve fazer loop sobre todos os resultados e retornar o descritor como "name" e primárioworkemail como "email". Por último, adicione um objeto "reports" que executa um loop sobre todos os primeiros resultados http e o nome do relatório (descriptor) e Primaryworkemail como e-mail."

    O código JavaScript gerado deve ter a seguinte aparência:

    return {
    
      // Details on the worker
    
      manager: {
    
          name: $currentItem.descriptor,
    
          email: $currentItem.person.email
    
      },
    
      // Details for their peers
    
      peers: $context.outputs.Workday_REST_HTTP_Request_1.content.data.map(peer => ({
    
          name: peer.descriptor,
    
          email: peer.primaryWorkEmail
    
      })).filter(peers => peers.name !== $currentItem.descriptor), // Filter out the employee itself,
    
      // Details for their direct reports
    
      reports: $context.outputs.Workday_REST_HTTP_Request_3.content.data.map(report => ({
    
          name: report.descriptor,
    
          email: report.primaryWorkEmail
    
      }))
    
    }
    

18. Fora do loop For Each , adicione uma atividade Response e configure-a da seguinte forma:

    • Tipo— Sucesso
    • Detalhes

      $context.outputs.For_Each_1.results
      ```This step instructs the workflow to return the complete list of results generated by the **For Each** loop.
      

19. Depure seu fluxo de trabalho de ponta a ponta. Você deve ter uma execução bem-sucedida e o esquema de resposta deve atender às suas necessidades.

20. Gere o esquema de saída da execução bem-sucedida de seu fluxo de trabalho:

    1. Navegue até a seção Saída do painel Saída de execução .
    2. Selecione Copiar para área de transferência.
    3. Navegue até a seção Saída do painel Data Manager .
    4. Selecione Gerar a partir da carga.
    5. Cole a saída copiada de Output > Run output.

Seu fluxo de trabalho da API agora inclui esquemas de entrada e saída, permitindo que ela seja invocada em toda a plataforma.

21. Publique seu fluxo de trabalho da API no Orchestrator.