Actividad de lectura de Almacenamiento Temporal

Introducción

Una actividad de lectura de Almacenamiento Temporal Read, utilizando su conexión de Almacenamiento Temporal, lee datos de un endpoint de Almacenamiento Temporal y está destinada a ser utilizada como fuente para proporcionar datos a una operación o para ser llamada en un script.

Crear una actividad de lectura de Almacenamiento Temporal

Una instancia de una actividad de lectura de Almacenamiento Temporal Read se crea a partir de una conexión de Almacenamiento Temporal utilizando su tipo de actividad Read.

Para crear una instancia de una actividad, arrastre el tipo de actividad al lienzo de diseño o copie el tipo de actividad y péguelo en el lienzo de diseño. Para más detalles, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.

Una actividad de lectura de Almacenamiento Temporal Read existente se puede editar desde estas ubicaciones:

• El lienzo de diseño (consulte Menú de acciones de componentes en Lienzo de diseño).

• La pestaña Componentes del panel del proyecto (consulte Menú de acciones de componentes en Pestaña de componentes del panel del proyecto).

Configurar una actividad de lectura de Almacenamiento Temporal

Siga estos pasos para configurar una actividad de lectura de Almacenamiento Temporal Read:

• Paso 1: Ingrese un nombre, proporcione un esquema de respuesta y especifique configuraciones

• Paso 2: Revise los esquemas de datos

Paso 1: Ingrese un nombre, proporcione un esquema de respuesta y especifique configuraciones

• Nombre: Ingresa un nombre para identificar la actividad de lectura de almacenamiento temporal Read. El nombre debe ser único para cada actividad de lectura de almacenamiento temporal y no debe contener barras inclinadas (/) ni dos puntos (:).

• Proporcionar esquema de respuesta: El esquema de respuesta define la estructura de los datos que utiliza la actividad de lectura de almacenamiento temporal Read. Si se requiere un esquema de respuesta depende de si la actividad se utiliza como fuente de una transformación (ver Uso de esquemas). Para instrucciones sobre cómo completar esta sección de la configuración de la actividad, consulta Esquemas definidos en una actividad.

• Ruta (opcional): Ingresa la(s) ruta(s) de la carpeta dentro del directorio de almacenamiento temporal que contiene los archivos que deseas leer. Si no se ingresa ninguna ruta, los archivos se leen desde la carpeta de almacenamiento temporal predeterminada. Para leer desde un subdirectorio de almacenamiento temporal existente, ingresa la ruta de la carpeta contenida dentro del directorio de almacenamiento temporal. Se pueden especificar múltiples rutas utilizando valores separados por comas.

  Advertencia

  No se pueden usar estos caracteres especiales en las rutas de archivo: ~, %, $, ", <, >, :, ?.

  Sin embargo, algunos caracteres especiales sí están permitidos: !, @, #, ^, &, *, (, ), [, ], ', ;. Además, se puede usar una barra inclinada / o una barra invertida \ como separador de ruta.

  Nota

  El directorio de almacenamiento temporal predeterminado utilizado por Harmony es el directorio temporal del sistema operativo del agente. Típicamente:

  • Windows: C:\Windows\Temp\jitterbit\TemporaryStorage
  • Linux: /tmp/jitterbit/TemporaryStorage

  En agentes privados, el directorio de almacenamiento temporal predeterminado se puede cambiar utilizando el archivo de configuración del agente privado. Para hacerlo, en la sección [OperationEngine], establece TemporaryStorageRootDirectory a una ruta absoluta a un directorio existente.

  En agentes en la nube, el directorio de almacenamiento temporal predeterminado no se puede cambiar. Sin embargo, dado que la ruta es relativa, si se ha escrito un archivo en el almacenamiento temporal con una ruta particular, ese mismo archivo se puede recuperar del almacenamiento temporal utilizando la misma ruta si se creó dentro de la misma cadena de operación. Para una explicación adicional, consulta Notas importantes bajo Almacenamiento temporal.

• Obtener archivos: Ingresa el nombre del(los) archivo(s) que deseas leer desde la ruta ingresada arriba. Este campo también puede incluir un asterisco (*) para usar como comodín (por ejemplo, *.dat o *.*) o un signo de interrogación (?) para coincidir exactamente con un carácter (por ejemplo, file?.txt). El uso de comodines es independiente de la opción Usar expresión regular descrita a continuación. Si se especifican datos en formato ZIP para ser descomprimidos y leídos automáticamente, consulta las opciones de Compresión descritas a continuación.

• Configuraciones opcionales: Haz clic para expandir configuraciones opcionales adicionales:

  

  • Opciones de filtro de archivos: Estas opciones afectan cómo se interpreta la entrada ingresada en el campo Obtener archivos arriba:

    • Ignorar mayúsculas: Selecciona esta casilla si has ingresado un valor en el campo Obtener archivos arriba que debe interpretarse como insensible a mayúsculas.

    • Usar expresión regular: Selecciona esta casilla si has ingresado un valor en el campo Obtener archivos arriba que debe interpretarse como una expresión regular.

  • Codificación de caracteres: Especifica la codificación de caracteres para definir una codificación de caracteres específica para el archivo fuente. Si dejas el campo en blanco, Harmony intenta detectar la codificación. Si deseas sobrescribir la predeterminada, puedes elegir entre cualquiera de los tipos de codificación listados en Codificaciones de caracteres soportadas.

  • Después del procesamiento: Si deseas realizar acciones adicionales después de procesar los datos, estas opciones están disponibles:

    • Eliminar archivo: Selecciona esta casilla si deseas que los archivos que han sido procesados con éxito sean eliminados. Cuando esta opción está seleccionada, la opción Renombrar archivo a continuación se completa automáticamente con /\delete/\ para indicar que los archivos procesados serán eliminados y, por lo tanto, renombrar un archivo no aplica. Limpiar Eliminar archivo también limpia el campo Renombrar archivo.

    • Renombrar archivo: Ingresa un nombre si deseas renombrar archivos después del procesamiento. Cualquiera de las palabras clave de nombre de archivo está disponible para generar nombres de archivo únicos para los datos fuente después del procesamiento. Ten en cuenta que el campo Renombrar archivo no está disponible si se selecciona Eliminar archivo arriba. Además, alternar Eliminar archivo arriba limpia cualquier entrada ingresada en el campo Renombrar archivo.

      Consejo

      Si deseas archivar el archivo fuente en una ubicación separada en un agente privado, también consulta la opción Carpeta de éxito/Carpeta de error en la configuración de la Actividad de escritura en almacenamiento temporal.

  • Archivo de activación: Disponible solo para su uso con agentes privados donde los archivos locales están habilitados, un archivo de activación es un archivo que debe estar presente antes de que un archivo fuente sea recuperado por una operación para su procesamiento. La presencia de un archivo de activación indica que un archivo fuente está listo para ser leído y no está aún en proceso de ser escrito por una operación anterior.

    • Usar disparador: Selecciona esta casilla si deseas que el sistema busque un archivo disparador antes de procesar los archivos de origen. Ten en cuenta que, al usar un archivo disparador:

      • La operación sondea, buscando el archivo disparador. El intervalo de sondeo está fijado en un segundo.

      • El archivo disparador se elimina al comenzar el procesamiento.

      • Si no se encuentra el archivo disparador, la operación sigue intentando encontrar el archivo disparador hasta que la operación se agote.

      • Configurar un archivo disparador bloquea cualquier operación o script que use la fuente hasta que se satisfaga la condición del archivo disparador o la operación se agote.

    • Ruta de archivo absoluta: Ingresa la ruta de archivo absoluta en la máquina del agente privado donde reside el archivo disparador. Selecciona un archivo que cumpla con estos criterios:

      • El archivo puede ser de cualquier tipo y puede contener cualquier cosa como su contenido; solo la presencia del archivo define el comportamiento del archivo disparador.

      • No se permite el uso de comodines.

      • El archivo disparador no puede ser el mismo archivo que un archivo de origen que se esté procesando.

      Nota

      Al usar palabras clave de nombre de archivo en este campo, las palabras clave no se resuelven. Para una solución alternativa, consulta Limitación y solución alternativa en Palabras clave de nombre de archivo.

  • Ignorar líneas: Si hay encabezados y/o pies de página en los datos de origen, ingresa el número de líneas a ignorar en los campos Primero y Último.

    Nota

    Esta configuración no tiene efecto cuando una actividad de Lectura de Almacenamiento Temporal es referenciada desde un script usando las funciones ReadFile o WriteFile.

  • Compresión: Si los datos de origen están en un formato comprimido, selecciona Los datos de origen están Comprimidos. Estas opciones se vuelven disponibles:

    • Formato: Utilice el menú desplegable para seleccionar el formato de los datos comprimidos. Actualmente, solo se admite el formato ZIP.

    • Contraseña: Si el archivo está encriptado, ingrese la contraseña.

      Nota

      Harmony solo admite la lectura desde el directorio raíz de un archivo encriptado.

• Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

• Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

• Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pedirá que confirme que desea descartar los cambios.

Paso 2: Revisar los esquemas de datos

• Esquema de datos: Si se proporciona durante la configuración de la actividad, se muestra el esquema de datos de respuesta. Si la operación utiliza una transformación, los esquemas de datos se mostrarán nuevamente más adelante durante el proceso de mapeo de transformación, donde puede mapear a campos de destino utilizando objetos de origen, scripts, variables, valores personalizados y más. También puede definir esquemas directamente en una transformación.

• Agregar plugin(s): Los plugins son aplicaciones proporcionadas por Jitterbit o por el usuario que amplían las capacidades nativas de Harmony. Para aplicar un plugin a la actividad, haga clic para expandir esta sección y seleccione la casilla junto al plugin que se utilizará. Para obtener instrucciones adicionales sobre el uso de plugins, incluidos los detalles sobre la configuración de cualquier variable requerida utilizada por el plugin, consulte Plugins añadidos a una actividad.

• Atrás: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

• Terminado: Haz clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

• Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Siguientes pasos

Después de configurar una actividad de Lectura de Almacenamiento Temporal, puedes usarla dentro de una operación o script como se describe a continuación.

Completar la operación

Después de configurar una actividad de Lectura de Almacenamiento Temporal, completa la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puedes configurar la configuración de operación de una operación, que incluye la capacidad de encadenar operaciones que están en los mismos o diferentes flujos de trabajo.

Las acciones del menú para una actividad son accesibles desde el panel del proyecto y el lienzo de diseño. Para más detalles, consulta el menú de acciones de actividad en Conceptos básicos de conectores.

Las actividades de Lectura de Almacenamiento Temporal se pueden usar como fuente con estos patrones de operación:

• Patrón de archivo
• Patrón de transformación
• Patrón de archivo de dos destinos (como la primera fuente únicamente)
• Patrón de archivo HTTP de dos destinos (como la primera fuente únicamente)
• Patrón de dos transformaciones (como la primera fuente únicamente)
• Patrón de destino masivo de Salesforce

Otros patrones no son válidos utilizando actividades de Lectura de Almacenamiento Temporal. Consulte los patrones de validación en la página de validez de operaciones.

Cuando esté listo, implemente y ejecute la operación y valide el comportamiento revisando los registros de operación.

Uso de actividades de Almacenamiento Temporal en scripts

Las actividades de Lectura de Almacenamiento Temporal también se pueden referenciar en un script para su uso con funciones de script que utilizan un sourceId como parámetro, incluyendo estas:

Funciones de Script de Jitterbit

• ArchiveFile
• Base64EncodeFile
• DeleteFile
• DeleteFiles
• DirList
• FileList
• ReadFile

Funciones de Jitterbit en JavaScript

• Jitterbit.ReadFile

Para más detalles sobre cómo referenciar actividades en scripts, consulte Puntos finales en Jitterbit Script o Puntos finales en JavaScript.