Actividad de búsqueda de SMB
Introducción
Una actividad de Búsqueda SMB, utilizando su conexión SMB, devuelve todos los archivos dentro de una carpeta en un servidor SMB y está destinado a ser utilizado como fuente para proporcionar datos en una operación.
Importante
El conector SMB tiene una limitación por la cual es posible que no se puedan recuperar archivos individuales de más de 2 GB.
Crear una actividad de búsqueda de SMB
Se crea una instancia de una actividad Búsqueda SMB desde una conexión SMB utilizando su tipo de actividad Buscar.
Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño o copie el tipo de actividad y péguelo en el tela de diseño. Para obtener más información, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.
Se puede editar una actividad de Búsqueda de SMB existente desde estas ubicaciones:
- El tela de diseño (vea menú de acciones del componente en Lienzo de diseño).
- La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestañaComponentes del panel Proyecto).
Configurar una actividad de búsqueda de SMB
Siga estos pasos para configurar una actividad de Búsqueda de SMB:
-
Paso 1: Ingrese un nombre y especifique una carpeta
Proporcione un nombre para la actividad y especifique una carpeta. -
Paso 2: Revise los esquemas de datos
Se muestran todos los esquemas de solicitud o respuesta.
Paso 1: Ingrese un nombre y especifique una carpeta
En este paso, proporcione un nombre para la actividad y especifique una carpeta. A continuación se describe cada elemento de la interfaz de usuario de este paso.
La interfaz utilizada en este paso de la configuración de una actividad de Búsqueda de SMB depende de la opción Elegir carpeta seleccionada:
-
Seleccionar carpeta existente: Esta opción completará una lista de carpetas existentes para elegir. Para utilizar esta opción, el dominio (especificado durante la conexión configuración) debe tener acceso a las carpetas.
-
Informar el nombre de la carpeta manualmente: Para esta opción, deberá ingresar manualmente la ruta de la carpeta.
Seleccionar carpeta existente
Si se selecciona Seleccionar carpeta existente para Elegir carpeta, se presenta esta interfaz:
-
Nombre: Ingrese un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Búsqueda de SMB y no debe contener barras diagonales.
/
o dos puntos:
. -
Elegir carpeta: Especifique el método para proporcionar la ruta de la carpeta, uno de los siguientes: Seleccionar carpeta existente o Informar el nombre de la carpeta manualmente:
-
Seleccionar carpeta existente: Seleccione esta opción para elegir entre una lista completa de carpetas. Para usar esta opción, el dominio (especificado durante la conexión configuración) debe tener acceso a las carpetas.
-
Informar el nombre de la carpeta manualmente: Seleccione esta opción para ingresar manualmente la ruta de la carpeta.
-
-
Seleccionar una carpeta: Esta sección muestra las carpetas disponibles en la carpeta SMB especificada en la conexión.
- Carpeta seleccionada: Después de seleccionar una carpeta, aparece aquí.
-
Buscar: Ingrese el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de carpetas. La búsqueda no distingue entre mayúsculas y minúsculas. Si ya se muestran carpetas en la tabla, los resultados de la tabla se filtran en tiempo real con cada pulsación de tecla. Para volver a cargar carpetas desde el extremo al realizar una búsqueda, ingrese los criterios de búsqueda y luego actualice, como se describe a continuación.
-
Actualizar elementos raíz: Haga clic en el icono de actualización o la palabra Actualizar elementos raíz para recargar carpetas desde el extremo de SMB. Esto puede resultar útil si se han agregado carpetas al servidor SMB. Esta acción actualiza todos los metadatos utilizados para crear la tabla de carpetas que se muestra en la configuración.
-
Selección de una carpeta: Dentro de la tabla, haga clic en el nombre de la carpeta para seleccionarla. Solo se puede seleccionar una carpeta.
- Actualizar: Al pasar el cursor sobre el nombre de una carpeta, puede hacer clic en el ícono de actualización o la palabra Actualizar para cargar las subcarpetas de esa carpeta. Una vez que se hayan completado las subcarpetas, se pueden seleccionar para usarlas en la actividad.
Consejo
Si la tabla no se completa con las carpetas disponibles, la conexión SMB puede no funcionar correctamente. Asegúrese de estar conectado volviendo a abrir la conexión y volviendo a probar las credenciales.
-
Devolver contenido de archivo: Seleccione esta opción para devolver el contenido de los archivos.
-
Buscar en subcarpetas: Seleccione esta opción para recuperar archivos en subcarpetas.
-
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 con el 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 solicitará que confirme que desea descartar los cambios.
Informar el nombre de la carpeta manualmente
Si se selecciona Informar el nombre de la carpeta manualmente para Elegir carpeta, se presenta esta interfaz:
Consejo
Campos con un icono variable Admite el uso de variables globales, variables del proyecto y variables Jitterbit. Comience escribiendo un corchete abierto [
en el campo o haciendo clic en el ícono de variable para mostrar una lista de las variables existentes para elegir.
-
Nombre: Ingrese un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Búsqueda de SMB y no debe contener barras diagonales.
/
o dos puntos:
. -
Elegir carpeta: Especifique el método para proporcionar la carpeta, uno de los siguientes: Seleccionar carpeta existente o Informar el nombre de la carpeta manualmente:
-
Seleccionar carpeta existente: Seleccione esta opción para elegir de una lista completa de carpetas.
-
Informar el nombre de la carpeta manualmente: Seleccione esta opción para ingresar manualmente la ruta de la carpeta.
-
-
Dirección de la ruta: Ingrese la ruta de la carpeta que se buscará. La ruta debe ingresarse en este formato:
example-folder-1/example-sub-folder-13
. -
Devolver contenido de archivo: Seleccione esta opción para devolver el contenido de los archivos.
-
Buscar en subcarpetas: Seleccione esta opción para recuperar archivos en subcarpetas.
-
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 con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Terminado 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 solicitará que confirme que desea descartar los cambios.
Paso 2: Revisar los esquemas de datos
Se muestran todos los esquemas de solicitud o respuesta. A continuación se describe cada elemento de la interfaz de usuario de este paso.
-
Esquemas de datos: Estos esquemas de datos son heredados por transformaciones adyacentes y se muestran nuevamente durante el mapeo de transformación.
Los esquemas de datos de solicitud y respuesta constan de estos nodos y campos:
Nodo/Campo del esquema de respuesta Descripción root
Nodo que representa la raíz item
Nodo que representa el archivo error_message
Cadena que contiene el mensaje de error, si corresponde response
Cadena que contiene la respuesta item
Nodo que representa el archivo devuelto path
Cadena que contiene la ruta del archivo name
Cadena que contiene el nombre del archivo type
Cadena que contiene el tipo de archivo content
Cadena que contiene el contenido del archivo index
Cadena que contiene el índice del dialecto utilizado Importante
El conector SMB tiene una limitación por la cual es posible que no se puedan recuperar archivos individuales de más de 2 GB.
-
Actualizar: Haga clic en el icono de actualización o la palabra Actualizar para regenerar esquemas desde el extremo de SMB. Esta acción también regenera un esquema en otras ubicaciones en todo el proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.
-
Atrás: Haga clic para almacenar temporalmente la configuración de este paso y regresar 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 los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.
Próximos pasos
Después de configurar una actividad de Búsqueda de SMB, 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 la operación, que incluyen la capacidad de encadenar operaciones que se encuentran 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 obtener más información, consulte menú de acciones de la actividad en Conceptos básicos del conector.
Las actividades de Búsqueda de SMB se pueden utilizar como fuente con estos patrones de operación:
- Patrón de Transformación
- Patrón de archivo de dos objetivos (solo como primera fuente)
- Patrón de archivo HTTP de dos destinos (solo como primera fuente)
Para utilizar la actividad con funciones de script, escriba los datos en una ubicación temporal y luego use esa ubicación temporal en la función de script.
Cuando esté listo, desplegar y ejecute la operación y validar el comportamiento comprobando los registros de operación.