Buscar archivos y carpetas

UiPath.MicrosoftOffice365.Activities.Files.FindFilesAndFolders

Descripción

Importante:

Esta actividad ha quedado obsoleta y se ha eliminado del paquete a partir de la versión 2.7.21. Se recomienda reemplazar esta actividad con Para cada archivo/carpeta (clásico) o Para cada archivo o carpeta (conexión de Integration Service).

Utiliza las API Buscar elementos y Archivos compartidos de Microsoft Graph 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 (Primeros 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, utiliza la actividad Para cada archivo/carpeta .

Find Files and Folders doesn't support the Sites.Selected application permission.

Ámbitos

Esta actividad requiere los siguientes ámbitos:

• Sitios. Leer.todos

O

• Sitios. LeerEscribir.todo

Compatibilidad de proyectos

Windows: heredado | Windows

Configuración

Propiedades

Común

• NombreParaMostrar : el nombre para mostrar de la actividad. 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 compatibles, 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 (por ejemplo AlgunaCarpeta o AlgunaCarpeta/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 de usuario para el usuario propietario de OneDrive. Este parámetro debe establecerse para los tipos de autenticación IDDeAplicaciónySecreto e IDDeAplicaciónYCertificado .

Otros

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

Salida

• First - The first file or folder matching the specified query. This field supports only DriveItem variables. Required if you plan to use the output data in subsequent activities. The DriveItem contains information about the file including its name, size, type, etc., that you can use in subsequent activities.
• Results - All files and folders matching the query returned as an array of DriveItems. DriveItems contain info such as filename, type, size, ID, etc., and can be used in subsequent activities. When using the Results DriveItem variable in other activities, specify the item in the array that you want to use (e.g., myFiles(0)).

Sharepoint

• Nombre de la unidad : el nombre de la unidad dentro de OneDrive o SharePoint en la que se buscaron los archivos o carpetas indicados. Si esta unidad 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 (normalmente "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 buscado para los archivos o carpetas indicados. Solo es necesario al buscar en SharePoint. Por ejemplo, si desea buscar en los documentos de su sitio de SharePoint, la URL de su sitio podría ser "https://uipath.sharepoint.com/sites/Quickstart" y su 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.
2. Añade la actividad Ámbito de Microsoft Office 365 a tu proyecto.
3. Add the Find Files And Folders activity inside the Microsoft Office 365 Scope activity.
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 propiedad de entrada se envían a la API BuscarElementos .
   • La API devuelve los valores DriveItem y DriveItem[] a tu variable de propiedad de salida.