Criar uma ação de coleta de dados para um objeto dinâmico

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 3 min. de leitura
  • Crie uma ação para coletar valores de saída. Em seguida, passe os valores para uma ação primária como um objeto dinâmico.

    Antes de Iniciar

    Função necessária: action_designer ou administrador
    Nota:
    As saídas dinâmicas não estão disponíveis no sistema de base. Para usar saídas dinâmicas em Workflow Studio, você deve Solicitar um Integration Hub plug-in.

    Por Que e Quando Desempenhar Esta Tarefa

    Essas etapas permitem criar uma ação de coleta de dados genérica para uma saída dinâmica. Para ver exemplos de trabalho de ações de coleta de dados para saídas dinâmicas, consulte Introdução às saídas dinâmicas.

    Procedimento

    1. Navegar até Todos > Automação de Processo > Workflow Studio.
    2. Na página inicial, selecione Ações.
    3. Selecionar Novo > Nova ação.
    4. No campo Nome, insira um nome para sua ação, escolha o Escopo da aplicação apropriado e selecione Enviar.
    5. Em Descrição da ação, selecione o ícone adicionar uma nova etapa (ícone Adicionar uma nova etapa) em Entradas e selecione a etapa REST.
      Configure sua etapa REST para obter dados da URL base e do caminho do recurso apropriados com todos os parâmetros de consulta aplicáveis para o método HTTP GET. Para obter mais informações sobre como usar a etapa REST em Integration Hub, consulte Etapa REST e REST no IntegrationHub.
    6. Em Descrição da ação, selecione o ícone Adicionar uma nova etapa (ícone Adicionar uma nova etapa) na etapa REST e selecione a etapa Script.
      Esta etapa de script deve transformar a resposta do corpo de resposta da etapa REST em um formato que define o esquema de uma saída de objeto dinâmico para uma ação primária. Sua etapa de script deve:
      • Ter uma única variável de saída JSON. A etapa de script pode ter outras variáveis de saída, mas somente uma deve ser do tipo JSON.
      • Formate a variável de saída JSON para que ela contenha uma propriedade chamada data. Para uma saída de objeto complexo, sua propriedade de dados deve ter um formato semelhante ao exemplo a seguir:
        {
               data: {
                   type: "object",              
                   //Required
        
                   children: [                  
                   //Required - This is a collection of field definitions
        
                       {
                           name: "Name 1",      
                           //Required - Unique name
        
                           label: "Label 1",    
                           //Required - Display name
        
                           type: "string"       
                           //Required - Supported field type (See the Note below)
        
                       },
        
                       {
                           name: "Name 2",
                           label: "Label 2",
                           type: "string"
                       }
                   ]
               }
           }
        
        Para uma saída de matriz de objetos complexos, sua propriedade de dados deve ter um formato semelhante ao exemplo a seguir:
        {
               data: {
                   type: "object",                          
                   //Required
        
                   attributes: { child_type: "object" }     
                   //Required - Indicates that the array's children are of type object
        
                   children: [                              
                   //Required - This is a collection of field definitions
        
                       {
                           name: "Name 1",                  
                           //Required - Unique name
        
                           label: "Label 1",                
                           //Required - Display name
        
                           type: "string"                   
                           //Required - Supported field type (See the Note below)
                       },
        
                       {
                           name: "Name 2",
                           label: "Label 2",
                           type: "string"
                       }
                   ]
               }
           }
        Nota:
        Os tipos de dados de ação compatíveis com a propriedade de tipo incluem:
        • Cadeia de caracteres
        • inteiro
        • data/hora
        • opção
        • booliano
        • objeto
        • matriz.cadeia de caracteres
        • matriz.inteiro
        • matriz.data/hora
        • matriz.opção
        • matriz.booliano
        • matriz.objeto
    7. Em Descrição da ação, selecione Saídas.
      1. Crie uma saída do tipo Saída dinâmica.
        Nota:
        Se as Saídas dinâmicas não forem exibidas como uma opção de tipo de dados, você não terá uma assinatura Integration Hub.
      2. Nas Opções dinâmicas, selecione uma ação de coleta de dados para a opção Ação.
        Para obter exemplos de ações de coleta de dados de saída dinâmica, consulte Introdução às saídas dinâmicas.
      3. Opcional: Se necessário, defina a opção de entrada Depende de outro e selecione a entrada.
      Crie uma saída do tipo Objeto dinâmico.
    8. Selecione Salvar e teste a ação.
      Nos detalhes de execução, sua ação de coleta de dados será executada com sucesso se o valor de tempo de execução da saída contiver a propriedade de dados no formato apropriado.
    9. Selecione Publicar para disponibilizar a ação para outros fluxos ou ações no mesmo escopo da aplicação.

      Use sua ação de coleta de dados para preencher valores de esquema para um objeto dinâmico.

      Agora você pode usar sua ação de coleta de dados para preencher os valores de esquema de um objeto dinâmico em uma ação primária.