Editor de Script¶

Introdução¶

Existem duas versões do editor de script : (1) o editor de script completo que é o padrão para scripts criados como um componente do projeto e (2) o editor de script embutido que está presente nas transformações, que pode ser expandido para o editor de script completo clicando no ícone popout 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 obter mais informações sobre tipos de scripts, consulte Tipos e criação de Script.

Acesse o Editor de Script¶

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

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

A interface completa do editor de script é aberta:

Renomear um Script¶

Quando você cria um novo script, seu nome padrão é New Script. Novos scripts subseqüentes com nomes padrão são anexados com um número incrementado entre parênteses. Os nomes de Script devem ser exclusivos e não devem conter barras (/) ou dois pontos (:) Ser válido.

Para renomear um script no editor de script, edite o campo Nome do Script no canto superior esquerdo:

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

• A aba Workflows do painel do projeto (consulte Menu de ações do componente na Guia Workflows do Painel do Projeto).
• A aba Componentes do painel do projeto (consulte Menu de ações do componente na Guia Componentes do painel do projeto).
• A quadro de design (consulte Renomeando Workflows, operações e etapas da operação em Quadro de Design).

Adicionar Notas¶

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

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

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 remoção . Para fechar a nota, basta clicar em outra parte da interface.

Quando uma ou mais notas estão presentes, a cor do ícone da nota é exibida em laranja:

Notas adicionais podem ser adicionadas usando o mesmo método descrito acima.

Salve e Visualize o Status de Salvamento¶

Depois de fazer alterações em um script, a configuração do script é salva automaticamente. Para salvar manualmente o script, pressione Control+S (Windows ou Linux) ou Command+S (macOS).

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

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

Selecione a Linguagem do Script¶

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

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

Alternar os Modos de Edição e Teste¶

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

Para mais detalhes, consulte Teste de Script.

Feche o Script¶

Para sair do script e retornar à tela anterior, clique no ícone fechar no canto superior direito.

Construa o Script¶

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

Em Jitterbit Script, os scripts devem ser colocados dentro de um <trans> marca de abertura e </trans> tag de fechamento, a menos que usando funções que exigem especificamente que o código seja colocado fora dessas tags, como várias Funções de banco de dados.

Em JavaScript, os scripts devem ser colocados dentro de um <javascript> marca de abertura e </javascript> etiqueta de fechamento.

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

• Destaque 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.

• Destaque de colchete: 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 realçar o conjunto. Esses conjuntos de colchetes são destacados: (), [], {}.

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

• Autovalidação: O Harmony fornece verificação de sintaxe básica e destaque de linhas com erros. Se o script for aprovado na validação de sintaxe básica, uma linha abaixo da área do script exibirá Script válido. Se o script não passar na validação de sintaxe básica, informações de erro específicas serão fornecidas aqui, uma linha por vez. Ou seja, depois de resolver um erro em uma linha, erros de sintaxe adicionais a serem resolvidos podem ser relatados nas linhas subsequentes.

• Arrastar e soltar: Arrastar um item da paleta de componentes para a área de script insere automaticamente o item na sintaxe apropriada para uso no script.

• Preenchimento automático: Conforme você digita, você pode exibir sugestões de preenchimento automático que começam com a string digitada usando Control+Space. Quando apenas uma sugestão está disponível, ela é inserida automaticamente. Quando mais de uma sugestão estiver disponível, você pode navegar pela lista usando as setas do teclado e pressionar Enter ou Tab para inserir a sugestão na área de script.

• Recuo de bloco: Quando uma linha ou linhas completas são selecionadas, pressionando Tab recua as linhas selecionadas uma aba à direita. De forma similar, Shift+Tab move as linhas selecionadas uma parada de tabulação para a esquerda. Se nenhum texto for selecionado, Shift+Tab move a linha para a esquerda para onde o cursor está.

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

Adicionar Componentes da Paleta¶

A paleta de componentes de script fornece acesso a vários componentes que podem ser usados em um script. Cada aba é resumida abaixo, com detalhes adicionais fornecidos em Jitterbit Script ou JavaScript dependendo do idioma.

Aba	Descrição
	Objetos de origem: A aba Objetos de origem está presente apenas para scripts criados em uma transformação. Como este tipo de script é limitado àqueles que usam Jitterbit Script linguagem, referenciando objetos de origem em scripts escritos em JavaScript não é aplicável. Em um script de transformação, você pode fazer referência a dados de origem inserindo o caminho de referência de um campo ou pode fazer referência a nós de dados de origem inserindo um caminho de referência de nó. Para adicionar um campo ou caminho de referência de nó a um script de transformação ( Jitterbit Script somente), 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 no local do cursor dentro do script. Insira manualmente o caminho de referência para o objeto de origem. Para obter detalhes adicionais, consulte Objetos de origem em Jitterbit Script.
	Funções: Esta aba fornece uma lista de funções disponíveis para uso em um script para o idioma selecionado no script (Jitterbit Script ou JavaScript). Dentro de um script, você pode usar funções inserindo a sintaxe de função apropriada para a linguagem do script. Para adicionar a sintaxe da função a um script (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 seu cursor dentro do script. Ao inserir a sintaxe da função, o primeiro argumento da função fica realçado 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 preenchimento automático. Selecione uma função para inserir a sintaxe da função. Insira manualmente a sintaxe da função. Para obter mais informações, consulte a documentação de cada função por categoria em Funções.
	Variáveis: Esta aba fornece acesso a variáveis disponíveis para referência global em um projeto, incluindo variáveis globais, variáveis do projeto e variáveis Jitterbit. Dentro de um script, você pode usar variáveis inserindo a sintaxe da variável. Para adicionar a sintaxe variável a um script (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 seu cursor dentro do script. Comece a digitar o nome da variável e então pressione Control+Space para exibir uma lista de sugestões de preenchimento automático. Selecione uma variável para inserir a sintaxe da variável. Insira manualmente a sintaxe da variável. Para obter detalhes adicionais, consulte Variáveis em Jitterbit Script ou Variáveis em JavaScript.
	Plugins: Esta aba fornece uma lista de plugins que podem ser executados dentro de um script. Dentro de um script, você pode usar um plug-in como argumento para o RunPlugin função inserindo o caminho de referência do plug-in. Para adicionar um caminho de referência de plug-in a um script (Jitterbit Script apenas), use um destes métodos: Arraste o plug-in da paleta para o script para inserir os dois RunPlugin função e a referência do plug-in. Clique duas vezes no plug-in na paleta para inserir a referência do plug-in no local do cursor no script. Comece a digitar o nome do plug-in e pressione Control+Space para exibir uma lista de sugestões de preenchimento automático. Selecione um plug-in para inserir a referência do plug-in. Insira manualmente a referência do plug-in. Para obter 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 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 (Jitterbit Script somente), use um destes métodos: Arraste a operação da paleta para o script para inserir ambos os RunOperation função e a referência da operação. Clique duas vezes na operação na paleta para inserir a referência da operação no local 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 preenchimento automático. Selecione uma operação para inserir a referência da operação. Insira manualmente a referência da operação. Para obter detalhes adicionais, consulte Operações em Jitterbit Script.
	Notificações: Esta aba 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 fazer referência a uma notificação como um argumento para o SendEmailMessage inserindo o caminho de referência da notificação. Para adicionar um caminho de referência de notificação a um script (Jitterbit Script somente), use um destes métodos: Arraste a notificação da paleta para o script para inserir ambos os SendEmailMessage e a referência de notificação. Clique duas vezes na notificação na paleta para inserir a referência de notificação no local 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 preenchimento automático. Selecione uma notificação para inserir a referência de notificação. Insira manualmente a referência de notificação. Para obter um exemplo, consulte Notificações em Jitterbit Script.
	Scripts: Esta aba fornece uma lista de todos os outros scripts de componentes de projeto independentes 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 fazer referência a outro script como um argumento para o RunScript inserindo o caminho de referência do script. Para adicionar um caminho de referência de script a um script (Jitterbit Script somente), use um destes métodos: Arraste o script da paleta para o script para inserir ambos os RunScript e a referência do script. Clique duas vezes no script na paleta para inserir a referência do script no local do cursor dentro do script. Comece a digitar o nome do script e pressione Control+Space para exibir uma lista de sugestões de preenchimento automático. Selecione um script para inserir a referência do script. Insira manualmente a referência do script. Para obter um exemplo, consulte Scripts em Jitterbit Script. Nota Enquanto um Jitterbit Script pode chamar um JavaScript, o inverso não é verdadeiro. Um Jitterbit JavaScript não pode chamar outro script de qualquer idioma.
	Endpoints: Esta aba fornece uma lista de endpoints no projeto que estão disponíveis para referência em um script. Dentro de um script, você pode fazer referência a endpoints como um argumento para funções inserindo a conexão ou o caminho de referência da atividade. Para adicionar um caminho de referência de conexão ou atividade a um script (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 insira a referência apropriada no local 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 preenchimento automático. Selecione uma conexão ou atividade para inserir a referência apropriada. Insira manualmente a referência de conexão ou atividade. Dependendo do endpoint, você pode usar a aba Funções para adicionar funções para as quais usar a referência de conexão ou atividade como um argumento. Para obter detalhes adicionais, consulte Endpoints em Jitterbit Script ou Endpoints em JavaScript.

Exibir Erros de Script¶

Quando um erro é detectado, uma mensagem de erro truncada é exibida em vermelho:

Para visualizar toda a mensagem de erro, clique no ícone pop-up . A mensagem de erro completa é aberta em uma caixa de 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: