Ir para o conteúdo

JavaScript Jitterbit e Funções Comuns

Jitterbit JavaScripts 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 o ECMA-262 v5.1 é uma versão mais antiga do JavaScript do que a comumente disponível em navegadores e outros mecanismos JavaScript, incluímos tabelas das funções comuns e padrão do JavaScript que estão disponíveis em JavaScripts Jitterbit.

Nota

  • O número máximo de iterações de loop permitido no Jitterbit Harmony é 50.000.
  • O número máximo de iterações de loop em Jitterbit Script Language é por cada loop individual. Para aumentar o número permitido de iterações por loop em um script Jitterbit Script Language, consulte jitterbit.scripting.while.max_iterations em Script de variáveis Jitterbit.
  • O número máximo de iterações de loop em JavaScript é por script (agregado de todos os loops em um script). Para aumentar o número máximo de iterações de loop em JavaScript, consulte Java Script 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 Necessários

  • databaseId: Uma fonte de banco de dados de string no projeto atual
  • sql: O comando SQL a ser executado no banco de dados
  • outputVariable: (Segunda forma) Um parâmetro de saída que corresponde 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 Script Jitterbit DBExecute função para obter detalhes.

Jitterbit.DbLookup

Declaração

string Jitterbit.DbLookup(string databaseId, string sql)

Sintaxe

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

Parâmetros Necessários

  • databaseId: Uma fonte de banco de dados de string 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 correspondente aos critérios especificados. Veja o Script Jitterbit DBLookup função para obter detalhes.

Jitterbit.GetVar

Declaração

string Jitterbit.GetVar(string jitterbitVariableName)

Sintaxe

Jitterbit.GetVar(<jitterbitVariableName>)

Parâmetros Necessários

  • jitterbitVariableName: O nome de uma variável Jitterbit

Descrição

Retorna o valor de uma variável Jitterbit (as variáveis globais predefinidas que são incorporadas ao Jitterbit e começam com "$jitterbit."). O símbolo do dólar é opcional e pode ser omitido.

As variáveis disponíveis podem ser vistas no Jitterbit Studio e estão documentadas em Jitterbit Variables.

Exemplos

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

Jitterbit.ReadFile

Declaração

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

Sintaxe

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

Parâmetros Necessários

  • sourceId: Origem do tipo de arquivo no projeto atual

Parâmetros Opcionais

  • fileFilter: Filtro de arquivo ou nome de arquivo para substituir a definição de origem

Descrição

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

A origem do tipo de arquivo usada nesta chamada de função deve ser definida como uma origem no projeto atual.

Veja as instruções em inserindo itens de projeto.

O método retorna o conteúdo do arquivo apontado pela fonte. Caso o filtro de origem selecione mais de um arquivo, será utilizado o primeiro. Recomenda-se 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 definição de origem. Um nome de arquivo pode ser usado. Como alternativa, uma variável global pode ser usada para substituir o filtro de arquivo na definição de origem. As variáveis globais são referenciadas como [de_name] na definição de origem.

A partir do Harmony versão 8.20, se o ReadFile função falhar, a operação não falhará. Um script será interrompido, um aviso 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.

Exemplos

// Reads the first file retrieved from a source
var fileContents = Jitterbit.ReadFile("<TAG>Sources/Customer CSV FTP</TAG>");

// Use the filename "test.txt" instead of what is defined in the source
var fileContents = Jitterbit.ReadFile("<TAG>Sources/Customer CSV FTP</TAG>", "test.txt");

Jitterbit.SetVar

Declaração

Jitterbit.SetVar(string jitterbitVariableName, string value)

Sintaxe

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

Parâmetros Necessá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 (as variáveis globais predefinidas que são incorporadas ao Jitterbit e começam com "$jitterbit."). O símbolo do dólar é opcional e pode ser omitido.

As variáveis disponíveis podem ser vistas no Jitterbit Studio e estão documentadas em Jitterbit Variables.

Exemplos

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

Jitterbit.WriteFile

Declaração

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

Sintaxe

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

Parâmetros Necessários

  • targetId: Destino do tipo de arquivo no projeto atual

Parâmetros Opcionais

  • fileContents: Dados a serem gravados no arquivo
  • filename: Nome do arquivo para substituir a definição de destino

Descrição

escreve o fileContents para o destino do tipo de arquivo 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 liberado e fechado pela função.

O destino do tipo de arquivo usado nesta chamada de função deve ser definido como um destino no projeto atual.

As variáveis disponíveis podem ser vistas no Jitterbit Studio e estão documentadas em Jitterbit Variables.

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

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

A partir do Harmony versão 8.20, se o WriteFile função falhar, a operação não falhará. Um script será interrompido, um aviso 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>Targets/FTP Target</TAG>", $contents);

// Use the filename "test.txt" instead of what is defined in the target
Jitterbit.WriteFile("<TAG>Targets/FTP Target</TAG>", $contents, "test.txt");

SetScriptOutput

Declaração

void SetScriptOutput(string data)

Sintaxe

SetScriptOutput(<data>)

Parâmetros Necessá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>Scripts/CalculateSomething</TAG>", value_to_be_calculated);

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

SetScriptResult

Declaração

void SetScriptResult(string data)

Sintaxe

SetScriptResult(<data>)

Parâmetros Necessários

  • data: Dados a serem retornados pelo script

Descrição

Um pseudônimo para o SetScriptOutput função. Ver SetScriptOutput para detalhes.

WriteToOperationLog

Declaração

string WriteToOperationLog(string message)

Sintaxe

WriteToOperationLog(<message>)

Parâmetros Necessá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.");

funções Comuns do JavaScript

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

Propriedade Comum Descrição
Array Consulte as propriedades e funções do JavaScript Array
Date Consulte as propriedades e funções de Data 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 válido
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 Consulte as propriedades e funções do JavaScript Math
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 Consulte as propriedades e funções da string JavaScript