Tarefa do Script de transformação de dados

A tarefa do script transformador de dados permite escrever, editar e avaliar modelos personalizados em Jsonnet (em inglês) para realizar o mapeamento de dados na sua integração.

Para informações sobre o mapeamento de dados na integração da Apigee, consulte Visão geral do mapeamento de dados.

Configurar a tarefa do script transformador de dados

Para adicionar uma tarefa do script transformador de dados à sua integração, siga estas etapas:

  1. Na IU da Apigee, selecione sua organização da Apigee.
  2. Clique em Desenvolver > Integrações.
  3. Selecione uma integração existente ou clique em Criar integração.

    Caso você esteja criando uma nova integração, siga estas etapas:

    1. Digite um nome e uma descrição na caixa de diálogo Criar integração.
    2. Selecione uma Região para a integração na lista de regiões compatíveis.
    3. Clique em Criar.

    Isso abre a integração na página do designer de integração.

  4. Na barra de navegação do designer de integração, clique em +Adicionar uma tarefa/gatilho> Tarefas para conferir a lista de tarefas disponíveis.
  5. Clique e posicione o elemento do script transformador de dados no editor de integração.
  6. Clique no elemento do script transformador de dados no designer para visualizar o painel de configuração de tarefas do script transformador de dados.
  7. Clique em Abrir editor do script transformador de dados.
  8. O editor do script transformador de dados é exibido com um exemplo de modelo comentado em Jsonnet padrão.
  9. Escreva seu código Jsonnet e feche o editor quando ele for concluído. Todas as alterações serão salvas automaticamente.

Como usar o editor do script transformador de dados

Use o editor do script transformador de dados para acessar as variáveis de integração, realizar atribuições de variáveis e adicionar ou modificar variáveis na sua integração. O editor do script transformador de dados fornece os seguintes recursos para enriquecer sua experiência de scripting:

  • Destaque de sintaxe/código, recuo e numeração de linhas para facilitar a legibilidade do código e o reconhecimento da estrutura.
  • Um minimapa que exibe uma visão geral de alto nível do código do script e ajuda na navegação rápida.
  • Opção clique para copiar o código na área de transferência.

Para abrir o editor, acesse o painel de configuração da tarefa do script transformador de dados e clique em Abrir editor do script transformador de dados.

Por padrão, o editor do script transformador de dados importa functions, uma biblioteca personalizada predefinida que contém um conjunto de funções em Jsonnet para mapeamento de dados na integração da Apigee. Para detalhes sobre as funções personalizadas disponíveis, consulte Funções do transformador de dados.

A imagem a seguir mostra o layout de amostra do editor de script do Data Transformer:

imagem mostrando o editor de script do transformador de dados imagem mostrando o editor de script do transformador de dados

Acessar variáveis de integração

Para ler uma variável de integração existente no editor do Script transformador de dados, use a função extVar da biblioteca functions predefinida.

Exemplo: leia e atualize as variáveis de integração existentes usando o editor do script transformador de dados.

Script em Jsonnet

local f = import "functions"; // Import predefined Data Transformer function library

local str1 = f.extVar("inputVar1"); // Access integration input variable "Inputstr1" with value "Hello"
local str2 = f.extVar("inputVar2"); // Access integration input variable "Inputstr2" with value "World"
{
  OutputVar: str1 + " " + str2 + "!", // Write to Jsonnet output variable "OutputVar"
  "output-str-var": str1 + " Integration " + str2 + "!", // Write to Jsonnet output variable "output-str-var"
}

Saída

imagem mostrando exemplo de script transformador de dados imagem mostrando exemplo de script transformador de dados

Práticas recomendadas

Para informações sobre os limites de uso que se aplicam à tarefa Script do transformador de dados, consulte Limites de uso.