Crear una fuente de uso compartido de archivos en Jitterbit Design Studio

Introducción

Una fuente de uso compartido de archivos proporciona acceso a recursos (archivos y carpetas) mediante rutas UNC de uso compartido de archivos de Microsoft Windows.

Prerrequisito

Antes de poder utilizar la función de archivo de activación de una fuente de uso compartido de archivos (consulte Opciones a continuación), debe haber habilitado la Ubicación de archivo local en su agente privado Jitterbit. Consulte Habilitar la ubicación de archivo local para más detalles.

Crear una fuente de uso compartido de archivos

Puede optar por crear una nueva fuente de recurso compartido de archivos por sí sola o dentro de una operación existente. Para obtener más información sobre cómo funcionan las fuentes dentro de las operaciones, consulte Crear una operación.

Crear una nueva fuente de uso compartido de archivos como una fuente independiente

Dentro de su proyecto en Jitterbit Design Studio, puede crear una nueva fuente de uso compartido de archivos mediante cualquiera de las siguientes opciones:

• Vaya a Archivo > Nuevo > Nueva fuente; o

• En el árbol de la izquierda, haga clic derecho en Fuentes y seleccione Nueva fuente; o

• En la barra de herramientas superior, haga clic en el ícono de fuente verde .

En la ventana emergente, seleccione Compartir archivos como tipo:

Su nueva fuente aparece en su propia pestaña Nueva fuente en el panel derecho de la ventana.

Nota

Si crea una fuente independiente mediante cualquiera de estos métodos, tenga en cuenta que no está conectada a una operación. Consulte Usar una fuente de recurso compartido de archivos existente en una operación existente a continuación para utilizar la nueva fuente.

Crear una nueva fuente de uso compartido de archivos en una operación existente

Por lo general, se crea una fuente de forma predeterminada cuando se crea una nueva operación. (La excepción es una operación que consta únicamente de un secuencia de comandos). Con una operación existente, puede especificar el tipo de su fuente mediante:

• Haga doble clic en el icono de la fuente; en la ventana emergente, seleccione Crear nueva fuente; o

• Hacer clic derecho en el ícono de la fuente y seleccionar Crear nueva fuente.

En la pantalla de configuración que aparece, use el menú desplegable Tipo para seleccionar Compartir archivos, como se muestra arriba.

Usar una fuente de uso compartido de archivos existente en una operación existente

Para utilizar una fuente de uso compartido de archivos existente en una operación existente con una fuente, puede configurarla mediante cualquiera de las siguientes opciones:

• Dentro de la operación, haciendo doble clic en el icono de origen y, en la ventana emergente resultante, seleccionando el origen de uso compartido de archivos deseado de la lista; o

• Dentro de la operación, haga clic derecho en el ícono de la fuente, elija Seleccionar fuente existente y, en la ventana emergente resultante, seleccione la fuente de uso compartido de archivos deseada de la lista; o

• Arrastre la fuente de uso compartido de archivos deseada desde el árbol de la izquierda y suéltela sobre el ícono de fuente existente de la operación.

Configurar una fuente de uso compartido de archivos

Después de haber creado una fuente de uso compartido de archivos, se abrirá la pantalla de configuración en la vista principal de Design Studio. Puede volver a la pantalla de configuración en cualquier momento haciendo doble clic en el icono de la fuente en la operación o haciendo doble clic en la fuente en el árbol de la izquierda.

Configuración básica

La pantalla de configuración será similar a la de este ejemplo:

• Nombre: Ingrese un nombre apropiado y único para la fuente.

• Tipo: Use el menú desplegable para seleccionar Recurso compartido de archivos, si aún no está especificado.

• Parámetros de conexión: Especifique los detalles para su conexión de archivo local:

  • Ruta(s): Ingrese la(s) ruta(s) del recurso compartido de archivos de Convención de nomenclatura universal (UNC) desde el que desea leer, excluyendo los nombres de archivo. Al ingresar una ruta, use este formato: \\servername\sharename\path\. Además, tenga en cuenta lo siguiente:

    • Las rutas UNC deben comenzar con dos barras invertidas \\ pero una barra invertida al final \ es opcional (por ejemplo, \\dropserver\incoming\po).
    • Se puede utilizar una dirección IP en lugar del nombre del servidor (por ejemplo, \\198.51.100.1\mydir).
    • Se pueden especificar varias rutas utilizando valores separados por comas (por ejemplo, \\myserver\mydir, \\120.104.20.69\mydir).

    Importante

    Si se utiliza un grupo de agentes en la nube, las rutas UNC solo funcionan con una dirección IP pública en lugar del nombre del servidor.

    Todos los grupos de agentes están limitados por las restricciones impuestas por el recurso compartido de archivos al que se accede:

    • Están limitados por el control de acceso y seguridad establecido para el usuario definido en el origen o el destino para ese recurso compartido de archivos determinado.
    • Si el recurso compartido de archivos solo permite una cierta cantidad de conexiones, el grupo de agentes estará limitado a ese límite.
    • Como la mayoría de los recursos compartidos de archivos no permiten que varios usuarios cambien un archivo determinado al mismo tiempo, si otro usuario o proceso está utilizando un archivo, el grupo de agentes no podrá cambiarlo.

  • Inicio de sesión: Si se requiere un inicio de sesión (en forma de DomainName\UserName) para acceder a una unidad de red compartida, ingrese un nombre de usuario válido en el campo Inicio de sesión.

  • Contraseña: Ingrese una contraseña para usar con el Inicio de sesión para acceder a una unidad de red compartida a la que se hace referencia en el campo Ruta(s).

  • Obtener archivos: Ingrese el nombre del archivo o archivos de origen que desea leer desde el directorio especificado en Ruta. Este campo también puede incluir un asterisco * para usar como comodín (por ejemplo, *.txt o *.*) o un signo de interrogación ? para que coincida exactamente con un carácter (por ejemplo, file?.txt). También se pueden utilizar variables en este campo. Si se especifica un archivo comprimido (ZIP), consulte la sección "Compresión" de los parámetros de conexión adicionales en Opciones a continuación. El archivo comprimido se puede descomprimir y leer automáticamente.

    Importante

    Una fuente de uso compartido de archivos tiene una limitación por la cual es posible que no se puedan recuperar archivos individuales de más de 2 GB.

  • Opciones de filtro: Permite especificar si se deben ignorar las mayúsculas y minúsculas en los nombres de archivo o si la información de Obtener archivos se debe tratar como una expresión regular.

• Conexión de prueba: Al hacer clic en el archivo adjunto probará la fuente de uso compartido de archivos; fallará si la ruta no es una ruta UNC válida que encuentre archivos en el sistema operativo donde se ejecuta el agente Jitterbit.

• Haga clic en el botón Guardar en la barra de herramientas principal o en la barra de herramientas del destino para guardar la configuración.

Opciones

Se pueden especificar parámetros de conexión adicionales haciendo clic en Opciones en la parte inferior de la sección Parámetros de conexión:

• Codificación de caracteres: Se utiliza para especificar una codificación de caracteres para los archivos de origen. Si se deja en blanco, Jitterbit intentará detectar la codificación. Para especificar una codificación diferente a la predeterminada, inserte una de las codificaciones compatibles que se describen en Codificación de caracteres.

• Archivo de activación: Use esta opción para especificar un archivo de activación para iniciar el procesamiento de los archivos de origen. El archivo de activación se elimina cuando comienza el procesamiento.

  • Después de seleccionar la casilla de verificación Usar disparador, especifique una Ruta de archivo absoluta a un archivo cuya presencia activará el procesamiento.
  • Se pueden utilizar variables (aunque no comodines) en este campo.
  • Como el archivo desencadenador se elimina cuando comienza el procesamiento, el archivo desencadenador no puede ser el mismo archivo que el archivo fuente que se está procesando.
  • Una vez que se inicia la operación, se operación un sondeo en busca del archivo desencadenador. El intervalo de tiempo del sondeo se fija en un segundo.
  • El archivo desencadenador se elimina cuando comienza el procesamiento.
  • Si no se encuentra el archivo desencadenador, la operación seguirá intentando encontrarlo hasta que se agote el tiempo de espera de la operación.
  • La configuración de un archivo desencadenador bloquea cualquier operación o secuencia de comandos que utilice la fuente hasta que se cumpla la condición del archivo desencadenador o se agote el tiempo de espera de la operación.

• Después del procesamiento:

  • Si la casilla de verificación Eliminar archivo está marcada, los archivos de origen se eliminarán después de que se hayan procesado.
  • Si se especifica un valor en el campo Cambiar nombre de archivo, se cambiará el nombre del archivo utilizando el patrón proporcionado. Se pueden utilizar variables en este campo.
  • Solo se acepta la opción de eliminar o cambiar el nombre; si la casilla de verificación Eliminar archivo está marcada, se deshabilitará y se ignorará la opción Cambiar nombre de archivo. Si la opción Cambiar nombre de archivo está vacía, se ignorará. Si se deja como predeterminada, no se realizará ningún posprocesamiento de los archivos de origen.

• Ignorar líneas: La cantidad indicada de líneas iniciales y finales que se deben ignorar para cada archivo. Si hay encabezados o pies de página que se deben ignorar, ingrese la cantidad de líneas en los campos Primera y Última según corresponda.

  Nota

  Esta configuración no tiene efecto cuando se hace referencia a una fuente de uso compartido de archivos desde un secuencia de comandos que utiliza ReadFile o WriteFile funciones.

• Compresión: Si la casilla de verificación Los datos de origen están comprimidos está marcada, los archivos de origen se descomprimirán utilizando el formato ZIP. Se puede especificar una contraseña (para archivos cifrados). Los archivos cifrados son compatibles si se proporciona una contraseña. Solo se admite la lectura desde el directorio raíz del archivo.