Actividad de Lectura de Almacenamiento Temporal¶

Introducción¶

Una actividad de lectura de almacenamiento temporal lee datos de un extremo de almacenamiento temporal y está destinada a usarse como fuente para proporcionar datos a una operación o para ser invocada en un secuencia de comandos. Después de configurar una conexión de Almacenamiento temporal, puede configurar tantas actividades de Almacenamiento temporal como desee para cada conexión de Almacenamiento temporal.

Crear una Actividad de Almacenamiento Temporal¶

Una instancia de una actividad se crea a partir de una conexión utilizando un tipo de actividad.

Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño o cópielo y péguelo en el tela de diseño. Para obtener más información, consulte Creación de una instancia de actividad en Reutilización de componentes.

Una actividad existente se puede editar desde estas ubicaciones:

• El tela de diseño (consulte Menú de acciones del componente en Tela de Diseño).
• La pestaña Componentes del panel del proyecto (consulte Menú de acciones de componentes en Pestaña Componentes del panel de proyecto).

Configurar una Actividad de Lectura de Almacenamiento Temporal¶

Siga estos pasos para configurar una actividad de lectura de almacenamiento temporal:

• Paso 1: Ingrese un nombre, proporcione un esquema de respuesta y especifique la configuración
• Paso 2: revisar los esquemas de datos

Paso 1: Ingrese un Nombre, Proporcione un Esquema de Respuesta y Especifique la Configuración¶

• Nombre: Introduzca un nombre que se utilizará para identificar la actividad de lectura de almacenamiento temporal. El nombre debe ser único para cada actividad de lectura de almacenamiento temporal y no debe contener barras diagonales (/) o dos puntos (:).

• Proporcionar esquema de respuesta: El esquema de respuesta define la estructura de datos que utiliza la actividad de lectura de almacenamiento temporal. La necesidad de un esquema de respuesta depende de si la actividad se utiliza como origen de una transformación (consulte Uso del esquema). Para obtener instrucciones sobre cómo completar esta sección de configuración de actividad, consulte Esquemas definidos en una actividad.

• Ruta (opcional): Ingrese la(s) ruta(s) de la carpeta dentro del directorio de almacenamiento temporal que contiene los archivos que desea 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, ingrese la ruta de la carpeta contenida en el directorio de almacenamiento temporal. Se pueden especificar varias rutas utilizando valores separados por comas.

  Advertencia

  Estos caracteres especiales no se pueden utilizar en rutas de archivos: ~, %, $, ", <, >, :, ?.

  Sin embargo, se permiten algunos caracteres especiales es: !, @, #, ^, &, *, (, ), [, ], ', ;. Además, ya sea una barra diagonal / o una barra invertida \ se puede utilizar 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 usando el archivo de configuración de Agente Privado. Para ello, bajo el [OperationEngine] sección, conjunto TemporaryStorageRootDirectory a una ruta absoluta a un directorio existente.

  En Agentes en Nube, el directorio de almacenamiento temporal predeterminado no se puede cambiar. Sin embargo, dado que la ruta es relativa, si un archivo se escribió en un almacenamiento temporal con una ruta particular, ese mismo archivo se puede recuperar del almacenamiento temporal usando la misma ruta si se creó dentro de la misma cadena de operación. Para obtener explicaciones adicionales, consulte Notas importantes en Almacenamiento temporal.

• Obtener archivos: Ingrese el nombre de los archivos que desea leer dentro de la ruta ingresada arriba. Este campo también puede incluir un asterisco (*) para utilizarlo como comodín (por ejemplo, *.dat o *.*) o un signo de interrogación (?) para que coincida exactamente con un carácter (por ejemplo, file?.txt). El uso de comodines es independiente de la opción Usar expresión regular que se describe a continuación. Si especifica datos en formato ZIP para que se descompriman y lean automáticamente, consulte las opciones de Compresión que se describen a continuación.

• Configuraciones opcionales: Haga 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 anterior:

    • Ignorar mayúsculas y minúsculas: Seleccione esta casilla de verificación si ingresó datos en el campo Obtener archivos de arriba que deben interpretarse como que no distinguen entre mayúsculas y minúsculas.

    • Usar expresión regular: Seleccione esta casilla de verificación si ingresó datos en el campo Obtener archivos de arriba que deben interpretarse como una expresión regular.

  • Codificación de caracteres: Especifique la codificación de caracteres para definir una codificación de caracteres específica para el archivo fuente. Si deja el campo en blanco, Harmony intenta detectar la codificación. Si desea sobrescribir el valor predeterminado, puede elegir cualquiera de los tipos de codificación enumerados en Codificaciones de caracteres admitidas.

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

    • Eliminar archivo: Seleccione esta casilla de verificación si desea eliminar los archivos que se han procesado correctamente. Cuando se selecciona esta opción, la opción Cambiar nombre de archivo a continuación se completa automáticamente con /\delete/\ para indicar que los archivos procesados se eliminarán y, como tal, no se aplica el cambio de nombre de un archivo. Al borrar Eliminar archivo también se borra el campo Cambiar nombre de archivo.

    • Cambiar nombre de archivo: Ingrese un nombre si desea cambiar el nombre de los archivos después del procesamiento. Cualquiera de las palabras clave de nombre de archivo están disponibles para generar nombres de archivos únicos para los datos de origen después del procesamiento. Tenga en cuenta que el campo Cambiar nombre de archivo no está disponible si se selecciona Eliminar archivo arriba. Además, al alternar Eliminar archivo arriba se borra cualquier entrada ingresada en el campo Cambiar nombre de archivo.

      Consejo

      Si desea archivar el origen del archivo en una ubicación separada en un Agente Privado, consulte también la opción Carpeta de éxito/Carpeta de error en la página [Temporal. Actividad de escritura de almacenamiento]](/es/cloud-studio/cloud-studio-reference/connectors/temporary-storage/temporary-storage-write-activity) configuración.

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

    • Usar activador: Seleccione esta casilla de verificación si desea que el sistema busque un archivo activador antes de procesar los archivos fuente. Tenga en cuenta que cuando utilice un archivo desencadenante:

      • La operación sondea y busca el archivo desencadenante. El intervalo de tiempo de sondeo se fija en un segundo.

      • El archivo desencadenante se elimina cuando comienza el procesamiento.

      • Si no se encuentra el archivo desencadenante, la operación sigue intentando encontrar el archivo desencadenante hasta que se agote el tiempo de espera de la operación.

      • La configuración de un archivo desencadenante bloquea cualquier operación o secuencia de comandos que utilice la fuente hasta que se cumpla la condición del archivo desencadenante o se agote el tiempo de espera de la operación.

    • Ruta absoluta del archivo: Ingrese la ruta absoluta del archivo en la máquina del Agente Privado donde reside el archivo desencadenante. Seleccione un archivo que cumpla con estos criterios:

      • El archivo puede ser de cualquier tipo y puede contener cualquier cosa como contenido; sólo la presencia del archivo define el comportamiento del archivo desencadenante.

      • No se permite el uso de comodines.

      • El archivo desencadenante no puede ser el mismo archivo que el archivo fuente que se está procesando.

      Nota

      Cuando se utilizan palabras clave de nombre de archivo en este campo, las palabras clave no se resuelven. Para obtener una solución alternativa, consulte 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, ingrese el número de líneas a ignorar en los campos Primero y Último.

  • Compresión: Si los datos de origen están en un formato comprimido, seleccione Los datos de origen están comprimidos. Estas opciones estarán 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á cifrado, ingrese la contraseña.

      Nota

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

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

• Siguiente: Haga clic para almacenar temporalmente la configuración para este paso y continuar con el siguiente. 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 pide 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 muestran nuevamente más adelante durante la asignación de transformación proceso, donde puede asignar campos de destino utilizando objetos de origen, secuencias de comandos, variables, valores personalizados y más. También puede definir esquemas directamente en una transformación.

• Agregar complemento(s): Los complementos son aplicaciones de Jitterbit o proporcionadas por el usuario que amplían las capacidades nativas de Harmony. Para aplicar un complemento a la actividad, haga clic para expandir esta sección y seleccione la casilla de verificación junto al complemento que se utilizará. Para obtener instrucciones adicionales sobre el uso de complementos, incluidos detalles sobre cómo configurar las variables requeridas utilizadas por el complemento, consulte Complementos agregados a una actividad.

• Volver: Haga clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.

• Terminado: Haga 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, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Próximos Pasos¶

Después de configurar una actividad de lectura de almacenamiento temporal, puede usarla dentro de una operación o secuencia de comandos como se describe a continuación.

Completa la Operación¶

Después de configurar una actividad de lectura de almacenamiento temporal, complete la configuración de la operación agregando y configurando otras actividades, transformaciones o secuencias de comandos como pasos de la operación. También puede configurar los ajustes de operación de una operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujo de trabajo o en diferentes flujos de trabajo.

Una vez que se ha creado una actividad de Almacenamiento temporal, se puede acceder a las acciones del menú para esa actividad desde el panel del proyecto en las pestañas Flujos de Trabajo o Componentes, y desde el tela de diseño. Consulte Menú de acciones de actividad para detalles.

Las actividades de lectura de almacenamiento temporal se pueden utilizar como fuente con estos patrones de operación:

• Patrón de archivo
• Patrón de Transformación
• Patrón de archivo de dos objetivos (solo como primera fuente)
• Patrón de archivo HTTP de dos objetivos (solo como primera fuente)
• Patrón de dos transformaciones (solo como primera fuente)
• 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 Validez de la operación página.

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

Uso de Actividades de Almacenamiento Temporal en Secuencias de Comandos¶

También se puede hacer referencia a las actividades de lectura de almacenamiento temporal en un secuencia de comandos para usar con funciones de secuencia de comandos que utilizan un sourceId como parámetro, incluidos estos:

Funciones de Jitterbit Script

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

Funciones Jitterbit de JavaScript

• Jitterbit.ReadFile

Para obtener más detalles sobre cómo hacer referencia a actividades en secuencias de comandos, consulte Extremos en Jitterbit Script o Extremos en JavaScript.