Ir para o conteúdo

Editor de script no Jitterbit Integration Studio

Introdução

Em um projeto, o editor de script completo é exibido para scripts criados como um componente do projeto. O editor de script inline está presente nas transformações, que podem ser expandidas para o editor de script completo clicando no ícone de expandir no canto superior direito de um script.

O editor de script completo contém todas as opções abordadas nesta página, enquanto o editor inline oferece uma versão simplificada para edição rápida.

Para mais informações sobre tipos de scripts, veja Tipos de script e criação.

Acessar o editor de script

O editor de script completo é o editor de script padrão para scripts criados como um componente do projeto:

editor de script completo

Para acessar o editor de script completo a partir da versão inline presente nas transformações, clique no ícone de popout no canto superior direito do script:

popout do editor de script inline

As ferramentas e regiões da página são mencionadas ao longo desta página. Elas são identificadas na imagem abaixo:

editor de script inline anotado

Legenda

① Renomear um script
② Adicionar notas
③ Selecionar a linguagem do script
④ Alternar modos de script
⑤ Status de salvamento
⑥ Validação de script
⑦ Paleta de componentes de script
⑧ Script

Renomear um script

Quando você cria um novo script, seu nome padrão é Novo Script. Scripts novos subsequentes com nomes padrão são acrescidos de um número incrementado entre parênteses. Os nomes dos scripts devem ser únicos e não podem conter barras (/) ou dois pontos (:) para serem válidos.

Para renomear um script a partir do editor de scripts, edite o campo no canto superior esquerdo:

rename

Os scripts também podem ser renomeados a partir destes locais:

Adicionar notas

Você pode adicionar notas personalizadas a um script que servem como documentação ou lembretes para você ou colaboradores do projeto. Para adicionar uma nota, clique no ícone de nota ao lado do campo Tipo de Script.

Uma área editável se abre, onde você pode inserir o texto da sua nota. Clique em Postar para adicionar a nota ao script:

note post

Sua nota postada é exibida, junto com seu nome e um carimbo de data/hora. Qualquer pessoa com acesso de edição ao script pode remover notas clicando no ícone de remover . Para fechar a nota, clique em outra parte da interface. Quando uma ou mais notas estão presentes, um ponto laranja é exibido no ícone de nota:

note posted

Selecione o idioma do script

Scripts criados como um componente de projeto abrem no idioma Jitterbit Script por padrão. O idioma pode ser alterado para JavaScript usando o menu Tipo de Script:

tipo de script

Scripts criados dentro de uma transformação, seja em um campo de destino ou em um nó, são limitados ao idioma Jitterbit Script.

Alternar modos de script

Scripts são abertos em modo de edição por padrão. Para abrir o script em modo de teste, use o botão no canto superior direito para selecionar Teste:

editar teste

Para mais detalhes, consulte Teste de script.

Status de salvamento

Após fazer alterações em um script, salve o script usando Control+S (Windows ou Linux) ou Command+S (macOS).

O status de salvamento é exibido na parte superior do script, abaixo do nome do script. Esses status são possíveis:

  • Salvo
  • Você tem alterações não salvas
  • Salvando...
  • Script não salvo devido a conflito com outro usuário

Para saber mais sobre salvamento automático, consulte Permissões do Integration Studio, colaboração e salvamento.

Validação de script

A validação de um script é verificada a cada tecla pressionada.

Quando um script é válido, uma mensagem Script é válido é exibida em verde:

script é válido

Quando um erro é detectado, uma mensagem de erro truncada é exibida em vermelho, com a linha do script contendo o erro destacada:

mensagem de erro truncada

Para ver a mensagem de erro completa, clique no ícone de expandir . A mensagem de erro completa é aberta em um diálogo.

A caixa de diálogo da mensagem de erro pode ser redimensionada clicando e arrastando o canto inferior esquerdo da caixa de diálogo:

redimensionar caixa de diálogo de mensagem de erro

Paleta de componentes de script

A paleta de componentes de script é um dos dois tipos de paletas de componentes. (O outro tipo é a paleta de componentes de design.)

As abas da paleta de componentes de script fornecem acesso a vários componentes que podem ser usados dentro de um script:

paleta de componentes de script

Para colapsar a paleta de componentes de script, clique no ícone de colapso localizado no canto superior direito da paleta. Quando colapsada, você pode expandir a paleta de componentes de script clicando em uma das abas da paleta.

Para pesquisar dentro de uma aba, use a caixa de pesquisa para inserir uma única palavra-chave ou string de palavras-chave. Para limpar a pesquisa, clique no ícone de remoção .

Cada aba da paleta de componentes de script é resumida abaixo, com detalhes adicionais fornecidos em Jitterbit Script ou JavaScript, dependendo da linguagem.

Aba
 Descrição
Objetos de Fonte A aba Objetos de Fonte está presente apenas para scripts criados dentro de uma transformação. Como esse tipo de script é limitado àqueles que usam a linguagem Jitterbit Script, a referência a objetos de fonte em scripts escritos em JavaScript não é aplicável.

Dentro de um script de transformação, você pode referenciar dados de origem inserindo o caminho de referência de um campo ou pode referenciar nós de dados de origem inserindo o caminho de referência de um nó.

Para adicionar um caminho de referência de campo ou nó a um script de transformação (apenas Jitterbit Script), use um destes métodos:

  • Arraste o objeto da paleta para o script para inserir o caminho de referência do objeto.
  • Clique duas vezes no objeto na paleta para inserir o caminho de referência do objeto na localização do cursor dentro do script.
  • Digite manualmente o caminho de referência para o objeto de origem.
Para detalhes adicionais, consulte Objetos de fonte em Jitterbit Script.
Funções A aba Funções fornece uma lista de funções disponíveis para uso em um script para a linguagem selecionada no script (seja Jitterbit Script ou JavaScript). Dentro de um script, você pode usar funções inserindo a sintaxe da função apropriada para a linguagem do script.

Para adicionar a sintaxe da função a um script (apenas Jitterbit Script ou JavaScript), use um destes métodos:

  • Arraste a função da paleta para o script para inserir a sintaxe da função.
  • Clique duas vezes na função na paleta para inserir a sintaxe da função na localização do cursor dentro do script. Ao inserir a sintaxe da função, o primeiro argumento da função é destacado e seu cursor é movido para o final do argumento.
  • Comece a digitar o nome da função e pressione Control+Space para exibir uma lista de sugestões de autocompletar. Selecione uma função para inserir a sintaxe da função.
  • Digite manualmente a sintaxe da função.
Para mais informações, consulte a documentação para cada função por categoria em Funções.
Variáveis A aba Variáveis fornece acesso a variáveis que estão disponíveis para referência globalmente em todo o projeto, incluindo variáveis globais, variáveis de projeto e variáveis Jitterbit. Dentro de um script, você pode usar variáveis inserindo a sintaxe da variável.

Para adicionar a sintaxe da variável a um script (apenas Jitterbit Script ou JavaScript), use um destes métodos:

  • Arraste a variável da paleta para o script para inserir a sintaxe da variável.
  • Clique duas vezes na variável na paleta para inserir a sintaxe da variável na localização do cursor dentro do script.
  • Comece a digitar o nome da variável e pressione Control+Space para exibir uma lista de sugestões de autocompletar. Selecione uma variável para inserir a sintaxe da variável.
  • Digite manualmente a sintaxe da variável.
Para detalhes adicionais, consulte Variáveis em Jitterbit Script ou Variáveis em JavaScript.
Plugins A aba Plugins fornece uma lista de plugins que podem ser executados dentro de um script. Dentro de um script, você pode usar um plugin como um argumento para a função RunPlugin inserindo o caminho de referência do plugin.

Para adicionar um caminho de referência de plugin a um script (apenas Jitterbit Script), use um destes métodos:

  • Arraste o plugin da paleta para o script para inserir tanto a função RunPlugin quanto a referência do plugin.
  • Clique duas vezes no plugin na paleta para inserir a referência do plugin na localização do cursor dentro do script.
  • Comece a digitar o nome do plugin e pressione Control+Space para exibir uma lista de sugestões de autocompletar. Selecione um plugin para inserir a referência do plugin.
  • Digite manualmente a referência do plugin.
Para detalhes adicionais, consulte Plugins em Jitterbit Script.
Operações Esta aba fornece uma lista de operações no projeto que estão disponíveis para referência em um script. Dentro de um script, você pode usar uma operação como um argumento para funções inserindo o caminho de referência da operação.

Para adicionar um caminho de referência de operação a um script (apenas Jitterbit Script), use um destes métodos:

  • Arraste a operação da paleta para o script para inserir tanto a função RunOperation quanto a referência da operação.
  • Clique duas vezes na operação na paleta para inserir a referência da operação na localização do cursor dentro do script.
  • Comece a digitar o nome da operação e pressione Control+Space para exibir uma lista de sugestões de autocompletar. Selecione uma operação para inserir a referência da operação.
  • Digite manualmente a referência da operação.
Para detalhes adicionais, consulte Operações em Jitterbit Script.
Notificações A aba Notificações fornece uma lista de notificações no projeto que estão disponíveis para referência em um script. Dentro de um script, você pode referenciar uma notificação como um argumento para a função SendEmailMessage inserindo o caminho de referência da notificação.

Para adicionar um caminho de referência de notificação a um script (apenas Jitterbit Script), use um destes métodos:

  • Arraste a notificação da paleta para o script para inserir tanto a função SendEmailMessage quanto a referência da notificação.
  • Clique duas vezes na notificação na paleta para inserir a referência da notificação na localização do cursor dentro do script.
  • Comece a digitar o nome da notificação e pressione Control+Space para exibir uma lista de sugestões de autocompletar. Selecione uma notificação para inserir a referência da notificação.
  • Digite manualmente a referência da notificação.
Para um exemplo, consulte Notificações em Jitterbit Script.
Scripts A aba Scripts fornece uma lista de todos os outros scripts de componentes de projeto autônomos no projeto — escritos em Jitterbit Script ou JavaScript — que estão disponíveis para referência em um script. Dentro de um script, você pode referenciar outro script como um argumento para a função RunScript inserindo o caminho de referência do script.

Para adicionar um caminho de referência de script a um script (apenas Jitterbit Script), use um destes métodos:

  • Arraste o script da paleta para o script para inserir tanto a função RunScript quanto a referência do script.
  • Clique duas vezes no script na paleta para inserir a referência do script na localização do cursor dentro do script.
  • Comece a digitar o nome do script e pressione Control+Space para exibir uma lista de sugestões de autocompletar. Selecione um script para inserir a referência do script.
  • Digite manualmente a referência do script.
Para um exemplo, consulte Scripts em Jitterbit Script.

Nota

Embora um Jitterbit Script possa chamar um JavaScript, o inverso não é verdadeiro. Um JavaScript do Jitterbit não pode chamar outro script de qualquer linguagem.
Endpoints A aba Endpoints fornece uma lista de endpoints no projeto que estão disponíveis para referência em um script. Dentro de um script, você pode referenciar endpoints como um argumento para funções inserindo o caminho de referência da conexão ou atividade.

Para adicionar um caminho de referência de conexão ou atividade a um script (apenas Jitterbit Script ou JavaScript), use um destes métodos:

  • Arraste a conexão ou atividade da paleta para o script para inserir a referência apropriada.
  • Clique duas vezes na conexão ou atividade na paleta para inserir a referência apropriada na localização do cursor dentro do script.
  • Comece a digitar o nome da conexão ou atividade e pressione Control+Space para exibir uma lista de sugestões de autocompletar. Selecione uma conexão ou atividade para inserir a referência apropriada.
  • Digite manualmente a referência da conexão ou atividade.
Dependendo do endpoint, você pode então usar a aba Funções para adicionar funções para as quais usar a referência da conexão ou atividade como um argumento.

Para detalhes adicionais, consulte Endpoints em Jitterbit Script ou Endpoints em JavaScript.

Script

A área de script é a área de texto onde você insere um script usando a linguagem apropriada: Jitterbit Script ou JavaScript.

Em Jitterbit Script, os scripts devem estar encapsulados dentro de uma tag de abertura <trans> e uma tag de fechamento </trans>, a menos que se utilizem funções que chamam especificamente para que o código seja colocado fora dessas tags, como várias funções de Banco de Dados.

Em JavaScript, os scripts devem estar encapsulados dentro de uma tag de abertura <javascript> e uma tag de fechamento </javascript>.

Estas são as principais características da área de script:

  • Realce de sintaxe: Cores diferentes são usadas para distinguir as diferentes partes de uma expressão, como nomes de funções, strings e variáveis.

  • Realce de colchetes: Se você colocar o cursor imediatamente antes ou depois de um colchete que faz parte de um conjunto de colchetes de abertura e fechamento, cada colchete do conjunto é exibido com uma borda ao redor do colchete para destacar o conjunto. Esses conjuntos de colchetes são destacados: (), [], {}.

  • Numeração de linhas: Números de linha são exibidos ao longo da margem esquerda da área de script.

  • Auto-validação: O Harmony fornece verificação básica de sintaxe e realce de linhas com erros. Se o script passar na validação básica de sintaxe, uma linha abaixo da área de script lê Script é válido. Se o script não passar na validação básica de sintaxe, informações específicas sobre o erro são fornecidas aqui uma linha de cada vez. Ou seja, após resolver um erro em uma linha, erros de sintaxe adicionais a serem resolvidos podem ser relatados para linhas subsequentes.

  • Arrastar e soltar: Arraste componentes da paleta e solte-os na área de script ou em um campo de destino para inseri-los automaticamente com a sintaxe correta.

  • Auto-completar: À medida que você digita, pode exibir sugestões de auto-completar que começam com a string inserida usando Control+Space. Quando apenas uma sugestão está disponível, ela é inserida automaticamente. Quando mais de uma sugestão está disponível, você pode navegar pela lista usando as teclas de seta do teclado e pressionar Enter ou Tab para inserir a sugestão na área de script.

  • Indentação de bloco: Quando uma linha ou linhas completas são selecionadas, pressionar Tab indenta as linhas selecionadas um espaço de tabulação para a direita. Da mesma forma, Shift+Tab move as linhas selecionadas um espaço de tabulação para a esquerda. Se nenhum texto estiver selecionado, Shift+Tab move a linha para a esquerda até onde o cursor está.

Além disso, os recursos padrão do navegador para desfazer, controlar o tamanho da fonte e pesquisar dentro do script podem ser utilizados.