Saltar al contenido

¡Transforma tus conexiones en dinero para el final del año con nuestro nuevo Programa de Indicación de Clientes! Descubre más

✕

Actividad de lectura de almacenamiento local

Introducción

Una actividad de Lectura de almacenamiento local, que utiliza su conexión de almacenamiento local, lee datos desde un extremo de almacenamiento local y está destinado a ser utilizado como una fuente para proporcionar datos a una operación o para ser llamado en un secuencia de comandos.

Crear una actividad de lectura de almacenamiento local

Se crea una instancia de una actividad de Lectura de almacenamiento local desde una conexión de almacenamiento local utilizando su tipo de actividad Leer.

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

Una actividad de Lectura de almacenamiento local existente se puede editar desde estas ubicaciones:

Configurar una actividad de lectura de almacenamiento local

Siga estos pasos para configurar una actividad de Lectura de almacenamiento local:

Paso 1: Ingrese un nombre, proporcione un esquema de respuesta y especifique la configuración

Actividad de lectura de almacenamiento local 1

Consejo

Campos con un icono de variable soporte utilizando variables globales, variables del proyecto y variables de Jitterbit. Comience escribiendo un corchete abierto [ En el campo o haciendo clic en el icono de variable para ver una lista de las variables existentes.

  • Nombre: Introduzca un nombre para identificar la actividad de Lectura del Almacenamiento Local. El nombre debe ser único para cada actividad de Lectura del Almacenamiento Local 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 del almacenamiento local. 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 la actividad, consulte Esquemas definidos en una actividad.

  • Obtener archivos: Ingrese el nombre del/de los archivo(s) que desea leer dentro del directorio especificado en la Conexión de almacenamiento local. Este campo también puede incluir un asterisco (*) para usar 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 se especifica que los datos en formato ZIP se descompriman y lean automáticamente, consulte las opciones de Compresión que se describen a continuación.

  • Configuración opcional: Haga clic para expandir la configuración opcional adicional:

    Configuración opcional de la actividad 1 de lectura de almacenamiento local

    • 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 ha ingresado información en el campo Obtener archivos anterior que debe interpretarse como sin distinguir entre mayúsculas y minúsculas.

      • Usar expresión regular: Seleccione esta casilla si ha introducido información en el campo Obtener archivos que deba interpretarse como una expresión regular. Esta opción es independiente del uso de comodines descrito en Obtener archivos.

    • Codificación de caracteres: Especifique la codificación de caracteres para definir una codificación específica para el archivo fuente. Si deja este campo en blanco, Harmony intentará detectar la codificación. Si desea sobrescribir la predeterminada, puede elegir cualquiera de los tipos de codificación que aparecen en Codificaciones de caracteres compatibles.

    • Carpeta de éxito/error: Estas opciones se utilizan para archivar una copia de todos los archivos procesados. Se puede usar en lugar de la opción Después del procesamiento para Cambiar nombre de archivo en el origen del archivo y así poder escribir en una ubicación separada en lugar de en una subcarpeta dentro de la misma ubicación.

      • Usar carpeta de éxito: Seleccione esta casilla para escribir un archivo en la carpeta especificada tras el procesamiento correcto en la ruta de destino principal. Si se escribe un archivo en varias rutas, la operación solo se considera correcta si todas las rutas son correctas. Si esta casilla está seleccionada, proporcione también la carpeta de éxito en la ruta absoluta en el equipo del agente privado.

      • Usar carpeta de errores: Seleccione esta casilla para escribir un archivo en la carpeta especificada tras un procesamiento fallido. Si al menos una ruta falla, el archivo se escribe en esta carpeta. Si esta casilla está seleccionada, proporcione también la carpeta de errores en la ruta absoluta en el equipo del agente privado.

        Precaución

        Solo se escribe un archivo si el fallo se debe a errores al procesar la actividad Lectura del almacenamiento local. No se escribe un archivo si, por ejemplo, la conexión al almacenamiento local no se establece correctamente, lo que provoca el fallo de toda la operación.

        Nota

        Al usar palabras clave de nombre de archivo en estos campos, estas no se resuelven. Para obtener una solución alternativa, consulte Limitación y solución alternativa en Palabras clave del nombre de archivo.

      El/Los archivo(s) se nombran como se especifica en el campo Obtener archivos anterior, con un guion bajo final y una marca de tiempo. Si ya existe un archivo con el mismo nombre en esa carpeta, se añade un guion bajo adicional y un contador.

      Por ejemplo, si un archivo se llama data.csv se procesa con éxito, se crea una copia con nombre data.csv_2018-01-01_12-00-00-000 Podría escribirse en la carpeta especificada como carpeta de éxito. Si dicho archivo ya existe de una ejecución anterior, se creará un nuevo archivo. data.csv_2018-01-01_12-00-00-000_1Se añadiría. De forma similar, si se especifica una carpeta de errores, los archivos que fallan se escriben en un archivo de dicha carpeta.

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

      • Eliminar archivo: Seleccione esta casilla si desea eliminar los archivos procesados correctamente. Al seleccionar esta opción, la opción Cambiar nombre de archivo que aparece a continuación se rellena automáticamente con /\delete/\ Para indicar que los archivos procesados se eliminarán y, por lo tanto, no se aplica el cambio de nombre. Al desmarcar Eliminar archivo, también se borra el campo Cambiar nombre de archivo.

      • Cambiar nombre de archivo: Introduzca 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 archivo ú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. Además, al activar o desactivar Eliminar archivo, se borra cualquier dato introducido en el campo Cambiar nombre de archivo.

    • Archivo desencadenador: Un archivo desencadenador es un archivo que debe estar presente antes de que una operación recupere un archivo fuente para su procesamiento. Su presencia indica que un archivo fuente está listo para leerse y no está siendo escrito por una operación anterior.

      • Usar disparador: Seleccione esta casilla si desea que el sistema busque un archivo disparador antes de procesar los archivos fuente. Tenga en cuenta que al usar un archivo disparador:

        • La operación sondea, buscando el archivo desencadenador. El intervalo de sondeo es fijo, de un segundo.

        • El archivo desencadenador se elimina cuando se inicia el procesamiento.

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

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

      • Ruta absoluta del archivo: Introduzca la ruta absoluta del archivo en la máquina del agente privado donde reside el archivo de activación. Seleccione un archivo que cumpla estos criterios:

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

        • No se permite el uso de comodines.

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

        Nota

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

    • Ignorar líneas: Si los datos de origen contienen encabezados o pies de página, introduzca el número de líneas que desea ignorar en los campos Nombre y Último.

      Nota

      Esta configuración no tiene efecto cuando una actividad de lectura de almacenamiento local es referenciada desde un secuencia de comandos utilizando el ReadFile o WriteFile funciones.

    • Compresión: Si los datos de origen están comprimidos, seleccione Los datos de origen están comprimidos. Estas opciones estarán disponibles:

      • Formato: Use 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, introduzca la contraseña.

        Nota

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

  • 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 guardar temporalmente la configuración de 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 pedirá que confirme que desea descartar los cambios.

Paso 2: Revisar los esquemas de datos

Actividad de lectura de almacenamiento local 2

  • 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 de nuevo posteriormente durante el mapeo de la transformación, donde puede asignar campos de destino mediante objetos de origen, secuencias de comandos, variables, valores personalizados y más. También puede definir esquemas directamente en una transformación.

  • Añadir complemento(s): Los complementos son aplicaciones proporcionadas por Jitterbit o por el usuario que amplían las funciones nativas de Harmony. Para aplicar un complemento a la actividad, haga clic para expandir esta sección y seleccione la casilla junto al complemento que desea utilizar. Para obtener instrucciones adicionales sobre el uso de complementos, incluyendo detalles sobre cómo configurar las variables requeridas, consulte complemento añadidos a una actividad.

  • Atrás: Haga clic para guardar temporalmente la configuración de este paso y volver al paso anterior.

  • Finalizado: 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 los 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.

Próximos pasos

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

Completar la operación

Después de configurar una actividad de Lectura de almacenamiento local, complete la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puede configurar los ajustes de una operación, lo que incluye la posibilidad de encadenar operaciones que se encuentren en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Se puede acceder a las acciones del menú de una actividad desde el panel del proyecto y el tela de diseño. Para más detalles, consulte menú de acciones de la actividad en Conceptos básicos del conector.

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

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

Uso de actividades de almacenamiento local en secuencias de comandos

Las actividades de Lectura de almacenamiento local también se pueden referenciar en un secuencia de comandos para usar con funciones de secuencia de comandos que utilizan un sourceId como parámetro, incluyendo estos:

Funciones de Jitterbit Script

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

Funciones de Jitterbit en 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.