Estender a funcionalidade do spoke Workday de RH

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura

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

    Para estender o spoke Workday de RH, certifique-se de que o administrador esteja ciente do Workday API Public Web Services e pode configurar o sistema Workday.

    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 spoke Workday de RH na mensagem XML de solicitação Workday associada e renderiza de forma síncrona a mensagem XML de resposta Workday como cápsulas de dados do campo de saída em ServiceNow Workflow Studio. Certifique-se de verificar a mensagem de solicitação de amostra e a mensagem de resposta de amostra.

    Modifique ou estenda a ação padrão Pesquisar trabalhadores criando uma cópia dela.
    Crie uma cópia da ação.
    Para adicionar o ID de referência de 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 o campo de entrada Campo adicional 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 ID de referência de posição no campo de entrada Campos adicionais. Para fins de demonstração, este campo está sendo adicionado manualmente na IU.
    1. Avalie e entenda como o ID de referência do cargo está estruturado na mensagem de solicitação do Workday. O XPath para adicionar um ID de referência de posição na mensagem de solicitação é duplicado de acordo com a publicação da comunidade Workday Public Web Services.
      1. Atributo de tipo de referência de posição: Get_Workers_Request/Request_Criteria/Position_Reference/@type
      2. O valor do atributo acima, de acordo com o documento de Serviços Web públicos, é um "ID de posição" codificado.
        ID da posição.
      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 spoke.
    2. Crie uma variável de entrada na etapa Entrada de ação. Clique em Criar entrada e adicione uma variável de entrada do tipo cadeia de caracteres simples.
      Crie a entrada do ID de referência de posição.
    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 comoposition_reference_id.
      3. Arraste a cápsula de dados do ID de referência de posição de Variáveis de entrada e solte-a no valor da variável de entrada.
        ID de referência da posição
    4. Aproveite o padrão de design da variável organizationReferenceStr na seção de script.
      1. Crie o nó XML para corresponder à mensagem de solicitação de trabalhador Get 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 é um bom candidato para aproveitar o script de padrão de design associado. Na seção 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 var organizationReferenceStr para construir o nó XML de referência de posição adequadamente.
        var snippet de código organizationReferenceStr.
      5. No mesmo script, na seção de solicitação de variável, aproveite o padrão de design e defina uma variável de saída.
        seçãode solicitação de var.
    5. Crie o nó XML de posição na etapa SOAP.
      1. Consulte a mensagem Workday Get Worker Request e o nó de referência do cargo de acordo.
        Nó de referência de posição.
      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.
        Ação de teste em um fluxo.
      2. Forneça o ID da posição e teste o fluxo.
        Forneça o ID da posição.
      3. Abra a execução e navegue até a etapa SOAP para verificar se o nó do elemento XML atualizado com a referência de posição foi criado.
        Verifique a execução.

    Adicionar e modificar campos de saída da ação de spoke do Workday

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

    1. Avalie e entenda como o nome do local está estruturado na 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 de 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,
        };
      Padrão de design de Nome jurídico na etapa Analisador de script.
    3. Adicione o LocalLegalName ao objeto PersonalData.
      LocalLegalName ao objeto PersonalData.
    4. Crie variáveis de saída na etapa Saídas.
      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. Contanto que o XPAth da etapa 2 siga o XPath do Workday correto, a ação do spoke pode renderizar os elementos de acordo. Nesse caso, adicionar o Nome jurídico local em Dados pessoais é suficiente.
        Campos de saída.
        Nota:
        O nome da variável de cadeia de caracteres na seção Nome 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 sujeito do trabalhador de teste tenha o nome e o sobrenome locais no Workday.
      2. Crie um fluxo de amostra, adicione a ação a ele e registre a resposta em log para verificar os elementos de saída.
        Teste a ação.
      3. Forneça o ID do funcionário do sujeito do trabalhador de teste associado para testar e executar o fluxo.
        Execute o fluxo.
      4. Verifique o log e as execuções para verificar se o nome e o sobrenome locais foram recuperados corretamente.
        Verifique as execuções.