Saltar al contenido

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:

  • OK
  • Advertencia
  • Error

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.