Buscar archivos y carpetas

UiPath.MicrosoftOffice365.Activities.Files.FindFilesAndFolders

Descripción

Utiliza los elementos de búsqueda de Microsoft Graph y las API de archivos compartidos para encontrar los archivos, metadatos y/o contenidos que coinciden con los valores de tus parámetros de búsqueda (Consulta). De forma predeterminada, esta actividad busca en tu OneDrive conectado. Tienes la opción de cambiar tu ubicación de búsqueda a un sitio de SharePoint (DriveName y SiteURL).

Después de realizar la búsqueda, la actividad devuelve los objetos DriveItem coincidentes (Primero y Resultados) que puedes utilizar como variables de entrada en actividades posteriores; casi todas las actividades de Excel y Archivos requieren esto como variable de entrada.

Esta actividad está limitada a 200 resultados. Si trabajas con más archivos, usa la actividad Para cada archivo / carpeta .

Nota: Buscar archivos y carpetas no admite el permiso de la aplicación Sites.Selected .

Compatibilidad de proyectos

Windows: heredado | Windows

Configuración

Propiedades

Común

• NombreParaMostrar: el nombre de la actividad que se muestra. Esta propiedad admite variables String y valores en formato de cadena.

Entrada

• Consulta : define la frase de búsqueda de texto libre para los archivos o carpetas a recuperar. Si se deja en blanco, se devuelve el contenido de la carpeta raíz. Para obtener una lista completa de los parámetros de consulta admitidos, consulta las propiedades del elemento de la unidad en la documentación de la API de Microsoft. Esta propiedad admite variables String y valores en formato de cadena.
• Subcarpeta: (opcional) la ruta de una subcarpeta en la que buscar (p. ej. UnaCarpeta o UnaCarpeta/Otra/OtraMás). Si se deja en blanco. se busca en la carpeta raíz. Esta propiedad admite variables String y valores en formato de cadena.

Opciones

• Cuenta: el ID o nombre principal del usuario que es propietario de OneDrive. Este parámetro debe estar configurado para los tipos de autenticación IDYSecretoDeAplicación e IDYCertificadoDeAplicación.

Otros

• Privado: si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado. Este campo admite valores booleanos.

Salida

• Primero : el primer archivo o carpeta que coincide con la consulta especificada. Este campo solo admite DriveItem variables. Obligatorio si planea utilizar los datos de salida en actividades posteriores. La DriveItem contiene información sobre el archivo, incluyendo su nombre, tamaño, tipo, etc., que puedes utilizar en actividades posteriores.
• Resultados : todos los archivos y carpetas que coinciden con la consulta devuelta como una matriz de ElementosDeUnidad. Los DriveItems contienen información como el nombre de archivo, tipo, tamaño, ID, etc., y se pueden utilizar en actividades posteriores. Cuando uses la variable DriveItem Resultados en otras actividades, especifica el elemento en la matriz que quieres usar (p. Ej., MisArchivos (0)).

Sharepoint

• Nombre de la unidad: el nombre de la unidad dentro de OneDrive o SharePoint en la que se buscan los archivos o carpetas indicados. Si el disco existe dentro de SharePoint, se debe especificar la URL del sitio. Si se deja vacío, la búsqueda se realiza en la unidad predeterminada (por lo general, "Documentos") del sitio de SharePoint especificado en el campo URL del sitio. Esta propiedad admite variables String y valores en formato de cadena.
• URL del sitio: la URL del sitio de SharePoint en el que se buscan los archivos o carpetas indicados. Solo se requiere cuando la búsqueda se realiza en SharePoint. Por ejemplo, si deseas buscar en los documentos de tu sitio de SharePoint, tu URL del sitio podría ser "https://uipath.sharepoint.com/sites/Quickstart".y tu Nombre de unidad sería "Documentos". Esta propiedad admite variables String y valores en formato de cadena.

Cómo funciona

Los siguientes pasos y diagrama de secuencia de mensajes son un ejemplo de cómo funciona la actividad desde el momento de diseño (es decir, las dependencias de la actividad y las propiedades de entrada / salida) hasta el tiempo de ejecución.

1. Completa los pasos de configuración .
2. Agrega la actividad de Ámbito de Microsoft Office 365 a tu proyecto.
3. Añade la actividad Buscar archivos y carpetas dentro de la actividad Ámbito Microsoft Office 365.
4. Introduce valores para las propiedades de entrada.
5. Crea e introduce variables DriveItem y DriveItem[] para las propiedades de salida.

6. Ejecuta la actividad.

   • Los valores de las propiedades de entrada se envían a la API BuscarElementos.
   • La API devuelve los valores DriveItem y DriveItem[] a tu variable de propiedad de salida.