Variables de Jitterbit en Studio
Introducción
Esta página cubre las variables de Jitterbit que están disponibles para actividades utilizadas como objetivos, organizadas por variables informativas que se leen (Informativo) y variables de configuración que se escriben (Configuración).
Informativo
jitterbit.target.file_count
Tipo de dato
Entero
Descripción
Después de que todos los archivos de entrada han sido transformados, esta variable se establece en el número de archivos de destino que serán transferidos.
jitterbit.target.ftp.return_code
Tipo de dato
Entero
Descripción
El código de estado de respuesta devuelto de un objetivo FTP cuando se utiliza en una operación o función de script WriteFile. Si no se devuelve ningún código de estado, el valor reportado es -1.
jitterbit.target.http.status_code
Tipo de dato
Entero
Descripción
Este es el código de estado de respuesta devuelto de un objetivo HTTP cuando se utiliza en una operación o función de script WriteFile. Si no se devuelve ningún código de estado, el valor reportado es -1.
Configuración
jitterbit.target.append_date_to_success_file
Tipo de dato
Booleano
Valor por defecto
false
Descripción
Si no está configurado o está configurado en true, escribe la fecha actual en formato de 24 horas en el nombre del archivo de éxito. Si se establece en false, no se escribe ninguna fecha.
jitterbit.target.chunk_node_name
Tipo de dato
Cadena
Descripción
Si se habilita el fragmentado (dividir un archivo), un nodo es el registro repetido (o nodo de bucle) en el que es posible dividir el archivo.
Por ejemplo, en un archivo XML, los niveles nombrados (registros repetidos) podrían ser raíz, organización, departamento y empleado. Podrías elegir fragmentar (dividir) el archivo en departamento o en empleado.
También es posible establecer el nodo en Opciones de operación.
jitterbit.target.chunk_size
Tipo de dato
Entero
Descripción
Dos casos posibles donde jitterbit.target.chunk_size = 2000:
- Caso 1: El fragmentado de origen está desactivado, se realiza el fragmentado de destino con un tamaño =
2000. - Caso 2: El fragmentado de origen está activado, se combinará el destino primero y luego se fragmentará el destino combinado a un tamaño =
2000.
jitterbit.target.chunking_uncombined
Tipo de dato
Booleano
Descripción
Si se establece en true, y el fragmentado de origen está activado, los archivos de fragmento de destino no se combinan. Esto permite 1 archivo de destino por registro.
jitterbit.target.db.character_encoding
Tipo de dato
Cadena
Descripción
Especifica la codificación de caracteres para las columnas de texto/caracteres de la base de datos de destino ODBC. Si no se especifica ninguna codificación, se asume Latin-1 (ISO-8859-1). Para las codificaciones soportadas, consulta Codificaciones de caracteres soportadas.
jitterbit.target.db.commit_chunks
Tipo de dato
Booleano
Descripción
Si se establece en true y el fragmentado está habilitado para una operación con una fuente de base de datos, cada fragmento se confirma en la base de datos a medida que se crea. Esta configuración puede hacer que la transformación se ejecute más rápido, ya que los fragmentos pueden confirmarse en paralelo.
jitterbit.target.db.include_null_in_sql_statement
Tipo de dato
Booleano
Valor por defecto
false
Descripción
Si se establece en true, las declaraciones INCLUDE y UPDATE generadas por Jitterbit para los destinos de base de datos contendrán valores nulos explícitos para las columnas que son anulables y tienen un mapeo con un resultado nulo.
jitterbit.target.db.no_data_action
Tipo de dato
Cadena
Descripción
Opción para qué hacer si se crea un objetivo de base de datos vacío. Estos valores son válidos:
OKAdvertenciaError
El valor predeterminado (para cuando esta variable no está configurada) se puede cambiar en jitterbit.conf con la opción en la sección [ErrorHandling] llamada NoTargetDataGenerated. Si no se especifica nada allí tampoco, el valor predeterminado es emitir una advertencia.
jitterbit.target.db.pre_target_sql
Tipo de dato
Cadena
Valor predeterminado
""
Descripción
Ejecuta esta declaración SQL antes de comenzar a poblar la(s) tabla(s) de la base de datos de destino. El valor predeterminado es una cadena vacía.
jitterbit.target.db.schema_name_delimiter
Tipo de dato
Cadena
Valor predeterminado
.
Descripción
El valor predeterminado es un solo punto (.). Carácter utilizado por la base de datos de destino para delimitar el nombre del esquema del nombre de la tabla, por ejemplo, Schema.Tab. Casi todas las bases de datos utilizan un punto como delimitador.
jitterbit.target.db.transaction
Tipo de dato
Booleano
Valor predeterminado
true
Descripción
Establecer en false si no se desea que los cambios en la base de datos se realicen en una transacción. El valor predeterminado es confirmar todos los cambios en la base de datos en una transacción.
jitterbit.target.db.use_new_postgress_sequence
Tipo de dato
Booleano
Descripción
Establecer en true aguas arriba de una actividad de base de datos para soportar secuencias al interactuar con una base de datos PostgreSQL a través de JDBC. Esta variable es compatible cuando se utilizan versiones de agente 11.28 o posteriores.
jitterbit.target.file_share.create_directories
Tipo de dato
Booleano
Valor predeterminado
false
Descripción
Establecer en true si se desea que se verifiquen y creen los directorios del destino de archivo compartido. Si se sabe que el directorio existe, no use esta opción.
jitterbit.target.ftp.encode_url
Tipo de dato
Booleano
Valor predeterminado
false
Descripción
Establecer en true en un script de transformación para usar codificación de URL donde un nombre de archivo o carpeta de destino contenga caracteres especiales como #, % o @. Por ejemplo, sftp://reposit.mysite.com/storage/file#1.xml.
Ver jitterbit.source.ftp.encode_url para la versión de origen de esta variable.
jitterbit.target.ftp.transfer_timeout
Tipo de dato
Entero
Descripción
Establecer el tiempo de espera de transferencia en segundos para las transferencias de destino FTP. El tiempo de espera de transferencia predeterminado para FTP es de una hora (3600 segundos). Establecer en cero para deshabilitar.
jitterbit.target.http.form_data
Tipo de dato
Booleano
Descripción
Si se establece en true, cada archivo de destino se carga utilizando la carga de formulario RFC 1687.
jitterbit.target.http.form_data.ContentType
Tipo de dato
Cadena
Descripción
Si se utiliza la carga de formulario RFC 1687, esto establece el Content-Type del archivo.
jitterbit.target.http.form_data.filename
Tipo de dato
Cadena
Descripción
Si se utiliza la carga de formulario RFC 1687, esto establece el nombre del archivo cargado.
jitterbit.target.http.form_data.name
Tipo de dato
Cadena
Descripción
Si se utiliza la carga de formularios según la RFC 1687, esto establece el nombre del formulario.
jitterbit.target.http.max_redirs
Tipo de dato
Entero
Valor por defecto
0
Descripción
Número máximo de redireccionamientos a seguir al usar un objetivo HTTP. Establezca esta variable en un número negativo para seguir cualquier número de redireccionamientos. El valor por defecto es 0 (cero); no se siguen redireccionamientos.
jitterbit.target.http.remove_trailing_linebreaks
Tipo de dato
Cadena
Descripción
Si se establece en true, se eliminarán los saltos de línea finales antes de que se publique la data del objetivo.
jitterbit.target.http.response.header.<HeaderName>
(mostrado en el editor de scripts como jitterbit.target.http.response.header.*)
Tipo de dato
Cadena
Descripción
Se establece al manejar una publicación de servicio web alojado o un punto final HTTP. Los encabezados de respuesta HTTP no se exponen, solo la carga útil. Cuando se sustituye por el nombre de un encabezado HTTP para <HeaderName>, esta variable contiene el valor correspondiente.
Por ejemplo, la variable Get("jitterbit.target.http.response.header.Proxy-Authenticate") contendría el valor del encabezado de respuesta Proxy-Authenticate.
Nota
Si el nombre del encabezado incluye un guion, debe hacer referencia a la variable utilizando las funciones Set o Get.
jitterbit.target.http.ssl_cert_id
Tipo de dato
Cadena
Descripción
Un identificador para una entrada de configuración en jitterbit.conf para el certificado SSL que se utilizará para los objetivos HTTP. Consulte también Personalizaciones > Certificados de Cliente y Agregar certificados al almacén de claves para agentes privados.
jitterbit.target.http.transfer_timeout
Tipo de dato
Entero
Descripción
Establece el tiempo de espera de transferencia en segundos para las transferencias de destino HTTP. El tiempo de espera de transferencia predeterminado para HTTP es de una hora (3600 segundos). Establecer en cero para desactivar.
jitterbit.target.json.array_to_object
Tipo de dato
Booleano
Descripción
Si se establece en true en la parte anterior de una transformación con un esquema de datos de destino JSON en una operación con chunking habilitado, el archivo de destino estará en formato JSON en lugar de XML.
jitterbit.target.sftp.ssh_key_id y jitterbit.source.sftp.ssh_key_id
Tipo de dato
Cadena
Valor predeterminado
""
Descripción
Para configurar múltiples claves SSH. Por defecto, ambas están vacías, lo que significa que la configuración en la sección [SSH] del archivo de configuración jitterbit.conf se utiliza para todas las fuentes y destinos SFTP sin contraseña definida:
[SSH]
PublicKeyFile='Z:/ssh/rsa2048.pub'
PrivateKeyFile='Z:/ssh/rsa2048'
PrivateKeyPassphrase=secret
Nota
Al editar el archivo de configuración, tenga en cuenta que una línea que está comentada con un # al principio no debe dejarse en blanco, o la siguiente línea se leerá como un comentario incluso si no comienza con #.
Si cualquiera de estas variables se establece en una cadena (como "RSA"), entonces estas opciones de configuración se utilizarán para una fuente o destino (dependiendo de cuál variable esté definida):
PublicKeyFileRSA='Z:/ssh/id_rsa.pub'
PrivateKeyFileRSA='Z:/ssh/id_rsa'
PrivateKeyPassphraseRSA=verysecret
Esto permite seleccionar diferentes conjuntos de claves al usar autenticación de clave SSH pública/privada para diferentes fuentes y destinos SFTP.
jitterbit.target.text.character_encoding
Tipo de dato
Cadena
Descripción
Especifica la codificación de caracteres para los documentos de texto de destino. Si no se especifica ninguna codificación, se asume Latin-1 (ISO-8859-1). Para las codificaciones soportadas, consulta Codificaciones de caracteres soportadas.
jitterbit.target.wave.json
Tipo de dato
Cadena
Descripción
Se utiliza para anular el JSON en un metafile JSON de Salesforce Einstein (Wave). Esta variable no es aplicable en Studio y solo se puede usar con una operación de Salesforce Wave en Design Studio (consulta Anulando metadatos JSON en Salesforce Einstein Analytics).
jitterbit.target.xml.exclude_empty_data
Tipo de dato
Booleano
Valor por defecto
false
Descripción
Si un mapeo a un nodo de destino resulta en un valor vacío, establece esta variable en true para excluir el nodo en el XML de destino. El valor por defecto (false) es incluir el nodo con un valor vacío en el XML de destino. Se recomienda esta variable sobre jitterbit.target.xml.include_empty_xml cuando el nodo de destino tiene un valor booleano.
Para que un valor true de jitterbit.target.xml.exclude_empty_data tenga efecto, jitterbit.target.xml.include_null_xml debe estar establecido en false y jitterbit.target.xml.include_empty_xml también debe ser false (su valor por defecto).
jitterbit.target.xml.include_empty_xml
Tipo de dato
Booleano
Valor por defecto
false
Descripción
Si un mapeo a un nodo de destino resulta en un valor vacío, establece esta variable en true para incluir el nodo en el XML de destino. El valor por defecto (false) es excluir el nodo con un valor vacío del XML de destino. Esta variable no afecta a los nodos de destino que tienen un valor booleano (consulta jitterbit.target.xml.exclude_empty_data en su lugar).
jitterbit.target.xml.include_nil_attribute
Tipo de dato
Booleano
Valor por defecto
false
Descripción
Establecer en true antes de una transformación con salida JSON para incluir valores nulos y cadenas vacías en el XML de destino, coincidiendo con la entrada. Esta variable es compatible al usar versiones de agente 11.37 o posteriores.
Nota
Cuando se establece en true antes de las funciones IfNull o IsNull, las funciones evaluarán una cadena vacía como un valor no nulo al usar versiones de agente 11.43 o posteriores.
jitterbit.target.xml.include_null_xml
Tipo de dato
Booleano
Valor por defecto
true
Descripción
Si un mapeo a un nodo de destino resulta en un valor nulo o un valor vacío, el valor por defecto de esta variable (true) es incluir el nodo en el XML de destino pero hacerlo nulo. Establezca esta variable en false para eliminar el nodo con un valor nulo del XML de destino.
jitterbit.target.xml.nsprefix
Tipo de dato
Cadena
Valor por defecto
"NS"
Descripción
El prefijo de espacio de nombres XML por defecto es "NS". Si su XML requiere un prefijo de espacio de nombres diferente, esta variable se puede usar para sobrescribir el prefijo de espacio de nombres por defecto con el nombre de su prefijo de espacio de nombres existente.
Por ejemplo, con el espacio de nombres XML por defecto, su salida XML de destino puede verse así:
<ns:Body xmlns:ns="http://www.marketo.com/mktows/">
<ns:successGetMultipleLeads>
<result>
Cuando establece esta variable global igual a un prefijo diferente, por ejemplo, $jitterbit.target.xml.nsprefix="tp", entonces la salida en este ejemplo cambiaría a esto:
<tp:Body xmlns:tp="http://www.marketo.com/mktows/">
<tp:successGetMultipleLeads>
<result>
jitterbit.target.xml.num_for_bool
Tipo de dato
Booleano
Valor por defecto
true
Descripción
Si se establece en true, los valores booleanos de destino XML se representarán con "0" o "1" para los valores falso y verdadero respectivamente. Este es el valor por defecto, por lo que para obtener los valores de cadena "true"/"false" en su lugar, es necesario establecer este parámetro en false.
jitterbit.target.xml.prettify
Tipo de dato
Booleano
Valor por defecto
true
Descripción
Si se establece en true, los destinos XML se escriben con saltos de línea e indentación de tabulación. Esto es más fácil de leer, pero el archivo resultante será más grande.