Jitterbit de JavaScript y Funciones Comunes¶
Jitterbit JavaScripts puede acceder, además de las funciones estándar de JavaScript que forman parte de ECMA-262 v5.1—estas funciones específicas de Jitterbit. Dado que ECMA-262 v5.1 es una versión anterior de JavaScript que la que suele estar disponible en los navegadores y otros motores de JavaScript, hemos incluido tablas de las funciones de JavaScript comunes y estándar que están disponibles en Jitterbit JavaScripts.
Nota
- El número máximo de iteraciones de bucle permitidas en Jitterbit Harmony es 50 000.
- El número máximo de iteraciones de bucle en Jitterbit Secuencia de Comandos Language es por cada bucle individual. Para aumentar el número permitido de iteraciones por bucle en una secuencia de comandos de Jitterbit Secuencia de Comandos Language, consulte jitterbit.scripting.while.max_iterations en Scripting de variables Jitterbit.
- El número máximo de iteraciones de bucle en JavaScript es por secuencia de comandos (agregado de todos los bucles dentro de una secuencia de comandos). Para aumentar el número máximo de iteraciones de bucle en JavaScript, consulte Java Secuencia de Comandos Loop en JavaScript.
Funciones de Fluctuación de Fase¶
Jitterbit.DbExecute
¶
Declaración¶
array Jitterbit.DbExecute(string databaseId, string sql)
int Jitterbit.DbExecute(string databaseId, string sql, string outputVariable,...)
Sintaxis¶
Jitterbit.DbExecute(<databaseId>, <sql>)
Jitterbit.DbExecute(<databaseId>, <sql>, <outputVariable>,...])
Parámetros Requeridos¶
databaseId
: Una fuente de base de datos de cadena en el proyecto actualsql
: El comando SQL que se ejecutará contra la base de datosoutputVariable
: (Segunda forma) Un parámetro de salida que coincide con los campos devueltos en el comando SQL. Se pueden especificar argumentos adicionales según sea necesario.
Descripción¶
Ejecuta una declaración SQL en una base de datos y devuelve los resultados. Ver el Secuencia de Comandos de Jitterbit DBExecute
función para más detalles.
Jitterbit.DbLookup
¶
Declaración¶
string Jitterbit.DbLookup(string databaseId, string sql)
Sintaxis¶
Jitterbit.DbLookup(<databaseId>, <sql>)
Parámetros Requeridos¶
databaseId
: Una fuente de base de datos de cadena en el proyecto actualsql
: El comando SQL que se ejecutará contra la base de datos
Descripción¶
Ejecuta una instrucción SQL en una base de datos y devuelve el primer campo del primer resultado que coincide con los criterios especificados. Ver el Secuencia de Comandos de Jitterbit DBLookup
función para más detalles.
Jitterbit.GetVar
¶
Declaración¶
string Jitterbit.GetVar(string jitterbitVariableName)
Sintaxis¶
Jitterbit.GetVar(<jitterbitVariableName>)
Parámetros Requeridos¶
jitterbitVariableName:
El nombre de una variable Jitterbit
Descripción¶
Devuelve el valor de una variable Jitterbit (las variables globales predefinidas que están integradas en Jitterbit y comienzan con "$jitterbit.
"). El símbolo del dólar es opcional y se puede omitir.
Las variables disponibles se pueden ver en Jitterbit Studio y están documentadas en Variables de Jitterbit.
Ejemplos¶
// Retrieves the value of the Jitterbit variable "jitterbit.api.request"
var request = Jitterbit.GetVar("$jitterbit.api.request");
Jitterbit.ReadFile
¶
Declaración¶
string Jitterbit.ReadFile(string sourceId[, string fileFilter])
Sintaxis¶
Jitterbit.ReadFile(<sourceId>[, <fileFilter>])
Parámetros Requeridos¶
sourceId:
Fuente de tipo de archivo en el proyecto actual
Parámetros Opcionales¶
fileFilter:
Filtro de archivo o nombre de archivo para anular la definición de origen
Descripción¶
Lee el contenido de un archivo de una fuente.
La fuente de tipo de archivo utilizada en esta llamada de función debe definirse como una fuente en el proyecto actual.
Consulte las instrucciones sobre insertar elementos del proyecto.
El método devuelve el contenido del archivo señalado por la fuente. Si el filtro de origen selecciona más de un archivo, se utilizará el primero. Se recomienda especificar una fuente que identifique de forma única un solo archivo.
El parámetro fileFilter
es opcional y se puede utilizar para anular el filtro de archivo utilizado en la definición de origen. Se puede utilizar un nombre de archivo. Como alternativa, se puede usar una variable global para anular el filtro de archivo en la definición de origen. Las variables globales se referencian como [de_name]
en la definición de origen.
A partir de Harmony versión 8.20, Si el ReadFile
la función falla, la operación no falla. Se cancelará un secuencia de comandos, se agregará una advertencia al registro de la operación y la operación continuará.
Este método se puede utilizar para leer datos de una fuente HTTP. En ese caso, todo Jitterbit $jitterbit.source.http.*
se completarán las variables.
Ejemplos¶
// 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
¶
Declaración¶
Jitterbit.SetVar(string jitterbitVariableName, string value)
Sintaxis¶
Jitterbit.SetVar(<jitterbitVariableName>, <value>)
Parámetros Requeridos¶
jitterbitVariableName:
El nombre de una variable Jitterbitvalue:
Un valor a asignar a la variable
Descripción¶
Establece el valor de una variable Jitterbit (las variables globales predefinidas que están integradas en Jitterbit y comienzan con "$jitterbit.
"). El símbolo del dólar es opcional y se puede omitir.
Las variables disponibles se pueden ver en Jitterbit Studio y están documentadas en Variables de Jitterbit.
Ejemplos¶
// Sets a Jitterbit variable
Jitterbit.SetVar("$jitterbit.scripting.db.max_rows", 1000);
Jitterbit.WriteFile
¶
Declaración¶
void Jitterbit.WriteFile(string targetId, type fileContents[, string filename])
Sintaxis¶
Jitterbit.WriteFile(<targetId>, <fileContents>[, <filename>])
Parámetros Requeridos¶
targetId:
Destino de tipo de archivo en el proyecto actual
Parámetros Opcionales¶
fileContents:
Datos a escribir en el archivofilename:
Nombre de archivo para anular la definición de destino
Descripción¶
Escribe el fileContents
al tipo de archivo de destino especificado por targetId
. Si fileContents
es de tipo binario, los datos binarios se escriben en el archivo. En todos los demás casos, se escribe una representación de cadena de los datos. La función vacía y cierra automáticamente el archivo.
El destino de tipo de archivo utilizado en esta llamada de función debe definirse como un destino en el proyecto actual.
Las variables disponibles se pueden ver en Jitterbit Studio y están documentadas en Variables de Jitterbit.
El tercer parámetro, filename
, es opcional y se puede utilizar para anular el nombre de archivo utilizado en el destino. Como alternativa, se puede utilizar una variable global para anular el nombre de archivo en la definición de destino. Las variables globales se referencian como [de_name]
en la definición de destino.
Este método también se puede utilizar para escribir/publicar datos en un destino HTTP. En ese caso, $jitterbit.target.http.*
se completarán las variables.
A partir de Harmony versión 8.20, Si el WriteFile
la función falla, la operación no falla. Se cancelará un secuencia de comandos, se agregará una advertencia al registro de la operación y la operación continuará.
Ejemplos¶
// 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
¶
Declaración¶
void SetScriptOutput(string data)
Sintaxis¶
SetScriptOutput(<data>)
Parámetros Requeridos¶
data:
Datos a ser devueltos por el secuencia de comandos
Descripción¶
Establece el valor devuelto por un secuencia de comandos.
Se puede acceder al valor de retorno de un secuencia de comandos como el valor de retorno del RunScript
función.
Ejemplos¶
// 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
¶
Declaración¶
void SetScriptResult(string data)
Sintaxis¶
SetScriptResult(<data>)
Parámetros Requeridos¶
data:
Datos a ser devueltos por el secuencia de comandos
Descripción¶
Un alias para el SetScriptOutput
función. Ver SetScriptOutput
para detalles.
WriteToOperationLog
¶
Declaración¶
string WriteToOperationLog(string message)
Sintaxis¶
WriteToOperationLog(<message>)
Parámetros Requeridos¶
message:
Un mensaje de cadena
Descripción¶
Escribe un mensaje en el registro de operaciones.
Ejemplos¶
// Writes a message to the Operation Log
WriteToOperationLog("The source field 'Price' has an invalid value.");
funciones Comunes de JavaScript¶
Estas funciones comunes de JavaScript, parte de ECMA-262 v5.1, son compatibles con los JavaScript de Jitterbit.
Propiedad Común | Descripción |
---|---|
Array | Consulte las Propiedades y funciones de matriz de JavaScript |
Date | Consulte las Propiedades y funciones de fecha de JavaScript |
decodeURI() | Decodifica una URI |
decodeURIComponent() | Decodifica un componente URI |
encodeURI() | Codifica un URI |
encodeURIComponent() | Codifica un componente URI |
eval() | Evalúa una cadena y la ejecuta como si fuera código JavaScript |
isFinite() | Comprueba si un valor es un número finito y legal |
isNaN() | Comprueba si un valor es un número ilegal |
JSON.parse() | Analiza una cadena JSON y devuelve un objeto JavaScript |
JSON.stringify() | Convierte un objeto JavaScript en una cadena JSON |
Math | Consulte las Propiedades y funciones de JavaScript Math |
Number() | Convierte el valor de un objeto en un número |
parseFloat() | Analiza una cadena y devuelve un número de coma flotante |
parseInt() | Analiza una cadena y devuelve un entero |
String | Consulte las Propiedades y funciones de JavaScript String |