Estender a funcionalidade do WorkdayRH spoke

Estenda o. WorkdayRH spoke além das funcionalidades padrão, como adicionar novos campos de entrada e saída.

Para estender o. WorkdayRH spoke, certifique-se de que o administrador esteja ciente de Workday API de serviços web públicos e pode configurar o. Workday sistema.

Estender a ação Pesquisar trabalhadores

A ação Pesquisar trabalhadores disponível junto com o spoke fornece a maioria das entradas e saídas necessárias. Antes de adicionar mais entradas e saídas a esta ação, explore maneiras de usar a ação de spoke padrão.

Esta ação transforma as cápsulas de dados do campo de entrada no WorkdayRH spoke para o associado Workday Solicitar mensagem XML e renderizar de forma síncrona de volta o. Workday Resposta de mensagem XML como cápsulas de dados do campo de saída em ServiceNow Workflow Studio. Certifique-se de verificar Mensagem de solicitação de amostra e. Mensagem de resposta de amostra .

Modifique ou estenda a ação padrão Pesquisar trabalhadores criando uma cópia dela.

Para adicionar o ID de referência da posição como parte dos critérios de solicitação para esta ação:

Nota:

• Certifique-se de verificar se o campo de entrada regular ou Campo adicional o campo de entrada tem a entrada desejada. Se nenhum deles tiver a entrada desejada, execute estas instruções para criar manualmente o campo de entrada necessário.
• A ação Pesquisar trabalhadores oferece suporte ao elemento de solicitação de ID de referência de posição no Campos Adicionais campo de entrada. Para fins de demonstração, este campo está sendo adicionado manualmente à IU.

1. Avalie e entenda como o ID de referência da posição está estruturado no Mensagem de solicitação do Workday . O XPath para adicionar um ID de referência de posição na mensagem de solicitação é dobrado de acordo com Publicação da comunidade de Serviços da Web públicos do Workday .
   1. Atributo do tipo de referência de posição : Get_workers_request/request_criteria/position_reference/ em tipo
   2. O valor do atributo acima, de acordo com o documento de Serviços da Web públicos, é um "ID de posição" codificado.

      

   3. Valor de referência da posição: Get_workers_request/request_criteria/position_reference
   4. O valor real acima é um novo campo de entrada na ação de spoke.
2. Crie uma variável de entrada no Entrada de ação etapa. Clique em Criar entrada e adicione uma variável de entrada do tipo cadeia de caracteres simples.

   

3. Crie uma variável de entrada na etapa de script Pré-processamento.
   1. Clique em Criar variável .
   2. Adicione o nome da variável de entrada com o nome como position_reference_id .
   3. Arraste o. ID de referência da posição cápsula de dados de Variáveis de entrada e solte-o no valor da variável de entrada.

      

4. Aproveite o padrão de design da var organizationReferenceStr na seção de script.
   1. Crie o nó XML para corresponder a. Obter mensagem de solicitação do trabalhador do Workday neste exemplo.
   2. Encontre o padrão de design apropriado na seção de script de acordo. Neste exemplo, este nó XML precisa ser construído para Referência de posição.

      <bsvc:Position_Reference bsvc:Descriptor="string">
      <bsvc:ID bsvc:type="Position_ID">string</bsvc:ID>
      </bsvc:Position_Reference>
      

   3. Quando o XML acima é comparado com o nó XML semelhante, a Referência da organização é uma boa candidata para aproveitar o script de padrão de design associado. Em Script , o snippet de script associado está em "var organizationReferenceStr.

      <bsvc:Organization_Reference bsvc:Descriptor="string">
      <bsvc:ID bsvc:type="Organization_ID">string</bsvc:ID>
      </bsvc:Organization_Reference>
      

   4. Aproveite o snippet de código organizationReferenceStr da var para criar o nó XML de referência de posição de acordo.

      

   5. No mesmo script, no solicitação de var aproveite o padrão de design e defina uma variável de saída.

      

5. Crie o nó XML de posição na etapa SOAP.
   1. Consulte Obter mensagem de solicitação do trabalhador do Workday e o nó de referência de posição de acordo.

      

   2. Salve e publique.
6. Teste a ação.
   1. Como esta é uma ação de fluxo de dados, ela deve ser testada usando um fluxo. Crie um fluxo de amostra com a ação nele.

      

   2. Fornecer ID da posição e testar o fluxo.

      

   3. Abra a execução e navegue até a etapa SOAP para verificar se o nó do elemento XML atualizado com referência de posição foi criado.

      

Adicione e modifique campos de saída da ação Spoke do Workday

Estenda o spoke do Workday para recuperar o nome local e o sobrenome local.

1. Avalie e entenda como o nome local é estruturado no Mensagem de resposta do Workday .
   • Nome local: O XPath para este elemento é Get_Workers_Response/Response_Data/Trabalhador/Worker_Data/Personal_Data/Nome_Data/Nome_Jurídico_Data/Nome_Detalhe_Dados/Nome_Local_Detalhe_Dados/Nome_Detalhe_Dados/Nome_Local
   • Sobrenome local: O XPath deste elemento é Get_Workers_Response/Response_Data/Trabalhador/Worker_Data/Personal_Data/Nome_Data/Nome_Jurídico_Nome_Dados/Nome_Detalhe_Dados/Nome_Local_Detalhe_Dados/SobreNome_Detalhe_Dados
2. Aproveite o padrão de design de Nome jurídico na etapa Analisador de scripts e crie o snippet para o nome jurídico local.

   var LocalFirstName = xmlDoc.getNodeText(Worker_DataXpath.concat("wd:Personal_Data/wd:Name_Data/wd:Legal_Name_Data/wd:Name_Detail_Data/wd:Local_Name_Detail_Data/wd:First_Name"));
           var LocalLastName = xmlDoc.getNodeText(Worker_DataXpath.concat("wd:Personal_Data/wd:Name_Data/wd:Legal_Name_Data/wd:Name_Detail_Data/wd:Local_Name_Detail_Data/wd:Last_Name"));
   
           var LocalLegalName = {
               LocalFirstName: LocalFirstName,
               LocalLastName: LocalLastName,
           };
   

   

3. Adicione LocalLegalName ao objeto PersonalData.

   

4. Crie variáveis de saída no Saídas etapa.
   1. Clique em Editar saída .
   2. Os campos de saída não precisam seguir a hierarquia exata de mensagens de resposta do Workday. Desde que o XPath da etapa 2 siga o XPath correto do Workday, a ação do Spoke pode renderizar os elementos de acordo. Neste caso, adicionando o. Nome jurídico local em Dados pessoais é suficiente.

      

      Nota:

      Nome da variável de cadeia de caracteres em Nome a seção deve corresponder ao mesmo nome de variável definido na etapa 2 acima.
5. Salve e publique a ação.
   Nota:

   A ação Pesquisar trabalhadores tem um número máximo de elementos de saída que uma ação de fluxo de dados pode ter. Se ocorrer algum erro durante a publicação da ação copiada com novos elementos de saída, exclua alguns elementos de saída que não são necessários e tente publicar novamente.
6. Teste a ação.
   1. Certifique-se de que o assunto do trabalhador de teste tenha o nome local e o sobrenome local no Workday.
   2. Crie um fluxo de amostra, adicione a ação a ele e registre a resposta para verificar os elementos de saída.

      

   3. Forneça o ID do funcionário do trabalhador de teste associado para testar e executar o fluxo.

      

   4. Verifique o log e as execuções para verificar se o nome local e o sobrenome local foram recuperados corretamente.