Saltar al contenido

Actividad de lectura de File Share

Introducción

Una actividad de Lectura de File Share, utilizando su conexión de File Share, lee archivos en una red compartida 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 File Share

Una instancia de una actividad de Lectura de File Share se crea a partir de una conexión de File Share utilizando su tipo de actividad Lectura.

Para crear una instancia de una actividad, arrastra el tipo de actividad al lienzo de diseño o copia el tipo de actividad y pégalo en el lienzo de diseño. Para más detalles, consulta Crear una instancia de actividad o herramienta en Reutilización de componentes.

Una actividad de Lectura de File Share existente se puede editar desde estas ubicaciones:

Configurar una actividad de lectura de File Share

Sigue estos pasos para configurar una actividad de Lectura de File Share:

Paso 1: Ingresa un nombre, proporciona un esquema de respuesta y especifica configuraciones

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comienza escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú con las variables existentes de las que elegir.

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

  • Proporcionar esquema de respuesta: El esquema de respuesta define la estructura de los datos que utiliza la actividad de Lectura de File Share. 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.

  • Obtener archivos: Ingresa el nombre del(los) archivo(s) que deseas leer dentro del directorio especificado en la conexión de File Share. 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.

    Importante

    El conector de File Share tiene una limitación donde los archivos individuales mayores de 2 GB pueden no ser recuperables.

  • 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 una entrada en el campo Obtener archivos arriba que debe interpretarse como insensible a mayúsculas.

      • Usar expresión regular: Selecciona esta casilla si has ingresado una entrada en el campo Obtener archivos arriba que debe interpretarse como una expresión regular. Esta opción es independiente del uso de comodines descrito en Obtener archivos arriba.

    • 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 la predeterminada, puede elegir entre cualquiera de los tipos de codificación enumerados en Codificaciones de caracteres soportadas.

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

      • Eliminar archivo: Seleccione esta casilla si desea 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. Desmarcar Eliminar archivo también borra el campo Renombrar archivo.

      • Renombrar archivo: Ingrese un nombre si desea 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. Tenga en cuenta que el campo Renombrar archivo no está disponible si se selecciona Eliminar archivo arriba. Además, alternar Eliminar archivo arriba borra cualquier entrada ingresada en el campo Renombrar archivo.

    • 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 archivo de activación: Seleccione esta casilla si desea que el sistema busque un archivo de activación antes de procesar archivos fuente. Tenga en cuenta que, al usar un archivo de activación:

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

        • El archivo de activación se elimina al comenzar el procesamiento.

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

        • Establecer un archivo de activación bloquea cualquier operación o script que utilice la fuente hasta que se cumpla la condición del archivo de activación o la operación se agote.

      • Ruta de archivo absoluta: Ingrese la ruta de archivo absoluta en la máquina del agente privado donde reside el archivo de activación. Seleccione 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 de activación.

        • No se permite el uso de comodines.

        • El archivo de activación no puede ser el mismo archivo que un archivo fuente 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, 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.

      Nota

      Esta configuración no tiene efecto cuando una actividad de Lectura de Compartición de Archivos es referenciada desde un script utilizando las funciones ReadFile o WriteFile.

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

        Nota

        Harmony solo admite la lectura desde el directorio raíz de un archivo comprimido 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: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.

  • 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.

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 el proceso de mapeo de transformación, donde puedes mapear a campos de destino utilizando objetos de origen, scripts, variables, valores personalizados y más. También puedes 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, haz clic para expandir esta sección y selecciona 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, consulta Plugins añadidos a una actividad.

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

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

Próximos pasos

Después de configurar una actividad de Lectura de Compartición de Archivos, 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 File Share, completa la configuración de la operación añadiendo y configurando otras actividades o herramientas como pasos de la operación. También se pueden configurar los ajustes de operación de una operación, que incluyen la capacidad de encadenar operaciones que están en el mismo flujo de trabajo o en flujos de trabajo diferentes.

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 File Share se pueden utilizar como fuente con estos patrones de operación:

Otros patrones no son válidos utilizando actividades de Lectura de File Share. Consulta los patrones de validación en la página de Validez de operación.

Cuando estés listo, despliega y ejecuta la operación y valida el comportamiento revisando los registros de operación.

Utiliza actividades de File Share en scripts

Las actividades de Lectura de File Share 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, consulta Endpoints en Jitterbit Script o Endpoints en JavaScript.