Estender a funcionalidade do Workday RH spoke

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

Para estender o. Workday RH spoke, certifique-se de que o administrador esteja ciente de Workday API de serviços Web públicos e podem 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 Workday RH spoke com o associado Workday Solicitar mensagem XML e renderizar de forma síncrona 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. Exemplo de mensagem de resposta .

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 é duplo de acordo com Publicação da comunidade Serviços Web públicos do Workday .
   1. Atributo Tipo de referência de posição : Get_workers_request/request_criteria/position_reference/ no tipo
   2. O valor do atributo acima, de acordo com o documento 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 do 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 de 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 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. Este 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 é um bom candidato 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 ReferenceStr organizationvar para construir o nó XML de referência de posição de acordo.

      

   5. No mesmo script, em 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 da 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 do spoke do Workday

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

1. Avalie e entenda como o nome local é estruturado no Mensagem de resposta do Workday .
   • Nome local: O XPath deste elemento é Get_Workers_Response/Response_Data/Worker/Worker_Data/Personal_Data/Name_Data/Legal_Name_Data/Name_Detail_Data/Local_Name_Detail_Data/First_Name
   • Sobrenome local: O XPath deste elemento é Get_Workers_Response/Response_Data/Worker/Worker_Data/Personal_Data/Name_Data/Legal_Name_Data/Name_Detail_Data/Local_Name_Detail_Data/Last_Name
2. Aproveite o padrão de design Nome jurídico na etapa Analisador de script 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 Workday XPath correto, a ação do spoke poderá 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 em 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 sujeito 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.