Jitterbit de JavaScript y Funciones Comunes¶
Se puede acceder a Jitterbit JavaScripts, además de las funciones estándar de JavaScript que forman parte de ECMA-262 v5.1: estas funciones específicas de Jitterbit. Como ECMA-262 v5.1 es una versión de JavaScript anterior a la que está comúnmente 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.
Importante
Para mejorar el rendimiento, recomendamos usar JavaScript solo cuando se ejecuta un Jitterbit Script equivalente no está disponible.
Nota
Se permite un máximo de 50.000 iteraciones de bucle para cada secuencia de comandos JavaScript. Para aumentar el número permitido de iteraciones por secuencia de comandos, consulte Iteraciones de bucle en JavaScript.
Funciones de Jitterbit¶
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 ruta de referencia de cadena a una conexión de base de datos en el proyecto actualsql
: El comando SQL que se ejecutará en la base de datos.outputVariable
: (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 Jitterbit Script DBExecute
función para más detalles.
La base de datos utilizada en esta llamada de función debe definirse como una conexión de base de datos en el proyecto actual. Para obtener más información, consulte las instrucciones sobre cómo insertar extremos en Extremos en JavaScript.
Jitterbit.DbLookup
¶
Declaración¶
string Jitterbit.DbLookup(string databaseId, string sql)
Sintaxis¶
Jitterbit.DbLookup(<databaseId>, <sql>)
Parámetros Requeridos¶
databaseId
: Una ruta de referencia de cadena a una conexión de base de datos en el proyecto actualsql
: El comando SQL que se ejecutará en la base de datos.
Descripción¶
Ejecuta una declaración SQL en una base de datos y devuelve el primer campo del primer resultado que coincide con los criterios especificados. Ver el Jitterbit Script DBLookup
función para más detalles.
La base de datos utilizada en esta llamada de función debe definirse como una conexión de base de datos en el proyecto actual. Para obtener más información, consulte las instrucciones sobre cómo insertar extremos en Extremos en JavaScript.
Jitterbit.GetVar
¶
Declaración¶
string Jitterbit.GetVar(string jitterbitVariableName)
Sintaxis¶
Jitterbit.GetVar(<jitterbitVariableName>)
Parámetros Requeridos¶
jitterbitVariableName
: El nombre de una variable Jitterbit o variable global
Descripción¶
Devuelve el valor de una variable Jitterbit (las variables globales predefinidas que están integradas en Harmony y comienzan con "$jitterbit.
") u otra variable global. El símbolo del dólar es opcional y se puede omitir. Las variables disponibles se pueden ver en Cloud Studio y están documentadas en Variables Jitterbit. Las variables globales definidas dentro del proyecto actual también se pueden recuperar mediante el mismo mecanismo.
Ejemplos¶
// Retrieves the value of the Jitterbit variable "jitterbit.api.request"
var request = Jitterbit.GetVar("$jitterbit.api.request");
// Retrieves the value of the global variable "email"
var email = Jitterbit.GetVar("email");
// Another method for retrieving a global variable
var email = Jitterbit.GetVar("$email");
Jitterbit.ReadFile
¶
Declaración¶
string Jitterbit.ReadFile(string sourceId[, string fileFilter])
Sintaxis¶
Jitterbit.ReadFile(<sourceId>[, <fileFilter>])
Parámetros Requeridos¶
sourceId
: Una ruta de referencia de cadena a una actividad asociada con un extremo de tipo de archivo en el proyecto actual
Parámetros Opcionales¶
fileFilter
: Filtro de archivo o nombre de archivo para anular la configuración de la actividad
Descripción¶
Lee el contenido de un archivo de una fuente.
La fuente utilizada en esta llamada de función debe definirse como una actividad asociada con un extremo de tipo de archivo en el proyecto actual. Estas incluyen actividades configuradas de uso compartido de archivos, FTP, HTTP, almacenamiento local y almacenamiento temporal. Para obtener más información, consulte las instrucciones sobre cómo insertar extremos en Extremos en JavaScript.
El método devuelve el contenido del archivo al que apunta 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 único archivo.
El parámetro fileFilter
es opcional y se puede utilizar para anular el filtro de archivos utilizado en la configuración de la actividad. Se puede utilizar un nombre de archivo. Alternativamente, se puede usar una variable global para anular el filtro de archivos en la configuración de la actividad. Se hace referencia a las variables globales como [de_name]
en la configuración de la actividad.
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 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.
Advertencia
Esta función no funciona de manera confiable con archivos que tienen contenido binario, ya que generalmente leerá solo una parte del archivo. Si el archivo tiene contenido binario, use la función Jitterbit Script Base64EncodeFile
en lugar de leer todo el contenido del archivo.
Ejemplos¶
// 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");
Jitterbit.SetVar
¶
Declaración¶
Jitterbit.SetVar(string jitterbitVariableName, string value)
Sintaxis¶
Jitterbit.SetVar(<jitterbitVariableName>, <value>)
Parámetros Requeridos¶
jitterbitVariableName
: El nombre de una variable Jitterbit o variable globalvalue
: Un valor que se 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.
") u otra variable global. El símbolo del dólar es opcional y se puede omitir. Las variables disponibles se pueden ver en Cloud Studio y están documentadas en Variables Jitterbit. Las variables globales definidas dentro del proyecto actual también se pueden recuperar mediante el mismo mecanismo.
Ejemplos¶
// Sets a Jitterbit variable and a global variable
Jitterbit.SetVar("$jitterbit.scripting.db.max_rows", 1000);
Jitterbit.SetVar("$email", "first.lastname@example.com");
Jitterbit.WriteFile
¶
Declaración¶
void Jitterbit.WriteFile(string targetId, type fileContents[, string filename])
Sintaxis¶
Jitterbit.WriteFile(<targetId>, <fileContents>[, <filename>])
Parámetros Requeridos¶
targetId
: Una ruta de referencia de cadena a una actividad asociada con un extremo de tipo de archivo en el proyecto actual
Parámetros Opcionales¶
fileContents
: Datos que se escribirán en el archivofilename
: Nombre de archivo para anular la configuración de la actividad
Descripción¶
Escribe el fileContents
al objetivo 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 objetivo utilizado en esta llamada de función debe definirse como una actividad asociada con un extremo de tipo de archivo en el proyecto actual. Estas incluyen actividades configuradas de uso compartido de archivos, FTP, HTTP, almacenamiento local y almacenamiento temporal. Para obtener más información, consulte las instrucciones sobre cómo insertar extremos en Extremos en JavaScript.
El tercer parámetro, filename
, es opcional y se puede utilizar para anular el nombre de archivo utilizado en la configuración de la actividad. Alternativamente, se puede usar una variable global para anular el nombre del archivo en la configuración de la actividad. Se hace referencia a las variables globales como [de_name]
en la configuración de la actividad.
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.
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 operación y la operación continuará.
Ejemplos¶
// 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");
SetScriptOutput
¶
Declaración¶
void SetScriptOutput(string data)
Sintaxis¶
SetScriptOutput(<data>)
Parámetros Requeridos¶
data
: Datos que devolverá 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>script: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 que devolverá 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 operación.
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 Jitterbit JavaScripts.
Propiedad común | Descripción |
---|---|
Array | Consulte las propiedades y funciones de la matriz JavaScript |
Date | Consulte las propiedades y funciones de fecha de JavaScript |
decodeURI | Decodifica un 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 | Prueba si un valor es un número finito y legal |
isNaN | Prueba 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 número entero |
String | Consulte las Propiedades y funciones de la cadena JavaScript |