Estender a funcionalidade do spoke Workday RH

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 4 min. de leitura

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

    Para estender o spoke Workday RH, certifique-se de que o administrador esteja ciente do Workday API de Serviços Web Públicos e podem 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 RH para a mensagem XML de solicitação Workday associada e renderiza de forma síncrona a mensagem XML de resposta Workday como cápsulas de dados de campo de saída em ServiceNow Flow Designer. Certifique-se de verificar a mensagem de solicitação de amostra e a mensagem de respostade 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 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 o campo de entrada Campo Adicional tem a entrada desejada. Se nenhum deles tiver a entrada desejada, siga estas instruções para criar manualmente o campo de entrada necessário.
    • A ação Pesquisar trabalhadores oferece suporte ao elemento de solicitação do ID de referência do cargo 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 do Workday Public Web Services.
      1. Atributo detipo 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 do Public Web Services, é 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 do spoke.
    2. Crie uma variável de entrada na etapa de entrada da ação. Clique em Criar entrada e adicione uma variável de entrada do tipo cadeia de caracteres simples.
      Crie a entrada ID de referência da posição.
    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 posição_referência_id.
      3. Arraste a cápsula de dados do ID de referência da 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 var organizationReferenceStr na seção de script.
      1. Crie o nó XML para corresponder à mensagem de solicitação de trabalho 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 é 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 organizationReferenceStr da var para construir o nó XML de referência de posição de acordo.
        var snippet de código organizationReferenceStr.
      5. No mesmo script, na seção de solicitação de var, aproveite o padrão de design e defina uma variável de saída.
        seção desolicitação var.
    5. Crie o nó XML de posição na etapa SOAP.
      1. Consulte a mensagem de solicitação do trabalhador do Workday 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.
        Testar ação 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 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 está estruturado na mensagem de resposta do Workday.
      • Nome local: o XPath para este 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 para este 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 do 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 assunto 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 assunto 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 execuções.