JavaScript Jitterbit e Funções Comuns

Os JavaScripts Jitterbit podem acessar — além das funções JavaScript padrão que fazem parte do ECMA-262 v5.1—essas funções específicas do Jitterbit. Como ECMA-262 v5.1 é uma versão mais antiga do JavaScript do que o que está comumente disponível em navegadores e outros mecanismos JavaScript, incluímos tabelas das funções JavaScript comuns e padrão que estão disponíveis em Jitterbit JavaScripts.

Importante

Para melhor desempenho, recomendamos usar JavaScript somente quando um Jitterbit Script equivalente não está disponível.

Nota

Um máximo de 50.000 iterações de loop é permitido para cada script JavaScript. Para aumentar o número permitido de iterações por script, consulte Iterações de loop em JavaScript.

Funções Jitterbit

`Jitterbit.DbExecute`

Declaração

array Jitterbit.DbExecute(string databaseId, string sql)

int Jitterbit.DbExecute(string databaseId, string sql, string outputVariable,...)

Sintaxe

Jitterbit.DbExecute(<databaseId>, <sql>)

Jitterbit.DbExecute(<databaseId>, <sql>, <outputVariable>,...])

Parâmetros Obrigatórios

databaseId: Um caminho de referência de string para uma conexão de banco de dados no projeto atual
sql: O comando SQL a ser executado no banco de dados
outputVariable: (Segunda forma) Um parâmetro de saída que é correspondido aos campos retornados no comando SQL. Argumentos adicionais podem ser especificados conforme necessário.

Descrição

Executa uma instrução SQL em um banco de dados e retorna os resultados. Veja o Jitterbit Script DBExecute função para mais detalhes.

O banco de dados usado nesta chamada de função deve ser definido como uma conexão de banco de dados no projeto atual. Para obter mais informações, consulte as instruções sobre como inserir endpoints em Endpoints em JavaScript.

[Voltar ao topo]

`Jitterbit.DbLookup`

Declaração

string Jitterbit.DbLookup(string databaseId, string sql)

Sintaxe

Jitterbit.DbLookup(<databaseId>, <sql>)

Parâmetros Obrigatórios

databaseId: Um caminho de referência de string para uma conexão de banco de dados no projeto atual
sql: O comando SQL a ser executado no banco de dados

Descrição

Executa uma instrução SQL em um banco de dados e retorna o primeiro campo do primeiro resultado que corresponde ao critério especificado. Veja o Jitterbit Script DBLookup função para mais detalhes.

O banco de dados usado nesta chamada de função deve ser definido como uma conexão de banco de dados no projeto atual. Para obter mais informações, consulte as instruções sobre como inserir endpoints em Endpoints em JavaScript.

[Voltar ao topo]

`Jitterbit.GetVar`

Declaração

string Jitterbit.GetVar(string jitterbitVariableName)

Sintaxe

Jitterbit.GetVar(<jitterbitVariableName>)

Parâmetros Obrigatórios

jitterbitVariableName: O nome de uma variável Jitterbit

Descrição

Retorna o valor de uma variável Jitterbit (uma variável global predefinida que é incorporada ao agente e começa com jitterbit.). As variáveis disponíveis podem ser vistas no Cloud Studio e estão documentadas em Variáveis Jitterbit.

Aviso

Também é possível, mas não recomendado, usar o Jitterbit.GetVar função para recuperar o valor de uma variável global definida pelo usuário.

A Jitterbit.GetVar a função foi projetada para permitir o uso de variáveis que contêm pontos dentro do nome da variável. No entanto, usar pontos em um nome de variável global definido pelo usuário não é recomendado. Como o valor será convertido em uma string quando a variável for definida, essas funções não podem ser usadas com tipos de dados complexos, como matrizes, dicionários ou objetos JSON. Em vez disso, é recomendável que você crie variáveis globais sem pontos e, em vez disso, use sublinhados no lugar de pontos e use o cifrão padrão $ sintaxe conforme descrito em Variáveis globais.

Exemplos

// Retrieves the value of the Jitterbit variable "jitterbit.api.request"
var request = Jitterbit.GetVar("$jitterbit.api.request");

[Voltar ao topo]

`Jitterbit.ReadFile`

Declaração

string Jitterbit.ReadFile(string sourceId[, string fileFilter])

Sintaxe

Jitterbit.ReadFile(<sourceId>[, <fileFilter>])

Parâmetros Obrigatórios

sourceId: Um caminho de referência de string para uma atividade associada a um endpoint do tipo arquivo no projeto atual

Parâmetros Opcionais

fileFilter: Filtro de arquivo ou nome de arquivo para substituir a configuração da atividade

Descrição

Lê o conteúdo de um arquivo de uma fonte.

A fonte usada nesta chamada de função deve ser definida como uma atividade associada a um endpoint do tipo arquivo no projeto atual. Isso inclui atividades configuradas de Compartilhamento de Arquivos, FTP, HTTP, Armazenamento Local e Armazenamento Temporário. Para obter mais informações, consulte as instruções sobre como inserir endpoints em Endpoints em JavaScript.

O método retorna o conteúdo do arquivo apontado pela fonte. Se o filtro de fonte selecionar mais de um arquivo, o primeiro será usado. É recomendado especificar uma fonte que identifique exclusivamente um único arquivo.

O parâmetro fileFilter é opcional e pode ser usado para substituir o filtro de arquivo usado na configuração da atividade. Um nome de arquivo pode ser usado. Alternativamente, uma variável global pode ser usada para substituir o filtro de arquivo na configuração da atividade. As variáveis globais são referenciadas como [de_name] na configuração da atividade.

Se o ReadFile função falha, a operação não falha. Um script será abortado, um aviso será adicionado ao log da operação e a operação continuará.

Este método pode ser usado para ler dados de uma fonte HTTP. Nesse caso, todos os Jitterbit $jitterbit.source.http.* variáveis serão preenchidas.

Aviso

Esta função não funciona de forma confiável com arquivos que têm conteúdo binário, pois normalmente ela lê apenas uma parte do arquivo. Se o arquivo tiver conteúdo binário, use a função Jitterbit Script Base64EncodeFile em vez de ler todo o conteúdo do arquivo.

Exemplos

// Reads the first file retrieved from a source
var fileContents = Jitterbit.ReadFile("<TAG>activity:ftp/FTP Endpoint/ftp_read/FTP Files</TAG>");

// Use the filename "test.txt" instead of what is defined in the source
var fileContents = Jitterbit.ReadFile("<TAG>activity:ftp/FTP Endpoint/ftp_read/FTP Files</TAG>", "test.txt");

[Voltar ao topo]

`Jitterbit.SetVar`

Declaração

Jitterbit.SetVar(string jitterbitVariableName, string value)

Sintaxe

Jitterbit.SetVar(<jitterbitVariableName>, <value>)

Parâmetros Obrigatórios

jitterbitVariableName: O nome de uma variável Jitterbit
value: Um valor a ser atribuído à variável

Descrição

Define o valor de uma variável Jitterbit (uma variável global predefinida que é incorporada ao agente e começa com jitterbit.). As variáveis disponíveis podem ser vistas no Cloud Studio e estão documentadas em Variáveis Jitterbit.

Aviso

Também é possível, mas não recomendado, usar o Jitterbit.SetVar função para definir o valor de uma variável global definida pelo usuário.

A Jitterbit.SetVar a função foi projetada para permitir o uso de variáveis que contêm pontos dentro do nome da variável. No entanto, usar pontos em um nome de variável global definido pelo usuário não é recomendado. Como o valor será convertido em uma string quando a variável for definida, essas funções não podem ser usadas com tipos de dados complexos, como matrizes, dicionários ou objetos JSON. Em vez disso, é recomendável que você crie variáveis globais sem pontos e, em vez disso, use sublinhados no lugar de pontos e use o cifrão padrão $ sintaxe conforme descrito em Variáveis globais.

Exemplos

// Sets a Jitterbit variable
Jitterbit.SetVar("$jitterbit.scripting.db.max_rows", 1000);

[Voltar ao topo]

`Jitterbit.WriteFile`

Declaração

void Jitterbit.WriteFile(string targetId, type fileContents[, string filename])

Sintaxe

Jitterbit.WriteFile(<targetId>, <fileContents>[, <filename>])

Parâmetros Obrigatórios

targetId: Um caminho de referência de string para uma atividade associada a um endpoint do tipo arquivo no projeto atual

Parâmetros Opcionais

fileContents: Dados a serem gravados no arquivo
filename: Nome do arquivo para substituir a configuração da atividade

Descrição

Escreve o fileContents para o alvo especificado por targetId. Se fileContents é do tipo binário, os dados binários são gravados no arquivo. Em todos os outros casos, uma representação de string dos dados é gravada. O arquivo é automaticamente esvaziado e fechado pela função.

O alvo usado nesta chamada de função deve ser definido como uma atividade associada a um endpoint do tipo arquivo no projeto atual. Isso inclui atividades configuradas de Compartilhamento de Arquivos, FTP, HTTP, Armazenamento Local e Armazenamento Temporário. Para obter mais informações, consulte as instruções sobre como inserir endpoints em Endpoints em JavaScript.

O terceiro parâmetro, filename, é opcional e pode ser usado para substituir o nome do arquivo usado na configuração da atividade. Como alternativa, uma variável global pode ser usada para substituir o nome do arquivo na configuração da atividade. As variáveis globais são referenciadas como [de_name] na configuração da atividade.

Este método também pode ser usado para escrever/postar dados em um alvo HTTP. Nesse caso, $jitterbit.target.http.*variáveis serão preenchidas.

Se o WriteFile() função falha, a operação não falha. Um script será abortado, um aviso será adicionado ao log da operação e a operação continuará.

Exemplos

//  Writes the value of $contents to the file defined by a target
Jitterbit.WriteFile("<TAG>activity:ftp/FTP Endpoint/ftp_write/FTP Files</TAG>", $contents);

// Use the filename "test.txt" instead of what is defined in the target
Jitterbit.WriteFile("<TAG>activity:ftp/FTP Endpoint/ftp_write/FTP Files</TAG>", $contents, "test.txt");

[Voltar ao topo]

`SetScriptOutput`

Declaração

void SetScriptOutput(string data)

Sintaxe

SetScriptOutput(<data>)

Parâmetros Obrigatórios

data: Dados a serem retornados pelo script

Descrição

Define o valor retornado por um script.

O valor de retorno de um script pode ser acessado como o valor de retorno do RunScript função.

Exemplos

// In the calling Jitterbit Script script:
$result = RunScript("<TAG>script:CalculateSomething</TAG>", value_to_be_calculated);

// In the Jitterbit JavaScript script "CalculateSomething":
var calculated_value = ...;
...
SetScriptOutput(calculated_value);

[Voltar ao topo]

`SetScriptResult`

Declaração

void SetScriptResult(string data)

Sintaxe

SetScriptResult(<data>)

Parâmetros Obrigatórios

data: Dados a serem retornados pelo script

Descrição

Um alias para o SetScriptOutput função. Veja SetScriptOutput para detalhes.

[Voltar ao topo]

`WriteToOperationLog`

Declaração

string WriteToOperationLog(string message)

Sintaxe

WriteToOperationLog(<message>)

Parâmetros Obrigatórios

message: Uma mensagem de string

Descrição

Grava uma mensagem no log de operação.

Exemplos

// Writes a message to the operation log
WriteToOperationLog("The source field 'Price' has an invalid value.");

[Voltar ao topo]

funções Comuns do JavaScript

Estas funções comuns do JavaScript — parte do ECMA-262 v5.1—são suportados em JavaScripts Jitterbit.

Propriedade comum	Descrição
`Array`	Veja as propriedades e funções do array JavaScript
`Date`	Veja as propriedades e funções de data do JavaScript
`decodeURI`	Decodifica um URI
`decodeURIComponent`	Decodifica um componente URI
`encodeURI`	Codifica um URI
`encodeURIComponent`	Codifica um componente URI
`eval`	Avalia uma string e a executa como se fosse um código JavaScript
`isFinite`	Testa se um valor é um número finito e legal
`isNaN`	Testa se um valor é um número ilegal
`JSON.parse`	Analisa uma string JSON e retorna um objeto JavaScript
`JSON.stringify`	Converte um objeto JavaScript em uma string JSON
`Math`	Veja as propriedades e funções matemáticas do JavaScript
`Number`	Converte o valor de um objeto em um número
`parseFloat`	Analisa uma string e retorna um número de ponto flutuante
`parseInt`	Analisa uma string e retorna um inteiro
`String`	Veja as propriedades e funções de string JavaScript

[Voltar ao topo]