Para cada archivo/carpeta

UiPath.MicrosoftOffice365.Activities.Files.ForEachFileFolder

Descripción

Utiliza la API de búsqueda de Microsoft de Microsoft Graph (para la búsqueda avanzada) o la API de elementos de búsqueda de Microsoft Graph (para la búsqueda simple) para realizar una actividad o una serie de actividades en cada archivo/carpeta que coincida con los criterios del filtro.

Para obtener más detalles sobre la implementación de la API de búsqueda de Microsoft, consulte los siguientes recursos:

• Descripción general de la API de búsqueda de Microsoft
• API de búsqueda de Microsoft para buscar contenido en OneDrive y SharePoint
• Propiedades del sitio con opciones de búsqueda

Nota:

Esta actividad no admite la persistencia.

Compatibilidad de proyectos

Windows: heredado | Windows

Configuración

En el cuerpo de la actividad

• Para cada : introduce el nombre por el que referirse al archivo actual en la iteración. El uso de un nombre que describa el tipo de archivo en la carpeta hace que sea más fácil identificar y seleccionar la opción de archivo actual al configurar actividades añadidas dentro de Para cada archivo/carpeta. Por ejemplo, para una carpeta que contiene informes, puedes introducir Report. El valor predeterminado es DriveItem.

Panel de propiedades

Común

• NombreParaMostrar : el nombre para mostrar de la actividad en el panel Diseñador. Esta propiedad admite variables String y valores en formato de cadena.

Entrada

• Búsqueda avanzada : la consulta del lenguaje de consulta de palabras clave (KQL) para los archivos y carpetas que se van a recuperar.
  Nota:

  La actividad utiliza la restricción de propiedad documentLink con una URL creada desde la ubicación especificada en el Repositorio de archivos y el valor en el parámetro Carpeta . No utilices la restricción de propiedades "documentLink:" o "path:" en el parámetro BúsquedaAvanzada .

• Búsqueda simple : el texto de consulta utilizado para buscar archivos y carpetas en varios campos como el nombre del archivo y el contenido del archivo. Esta propiedad admite variables String y valores en formato de cadena.
• Utilizar búsqueda simple : cuando está activa, se utiliza la búsqueda simple en lugar de la búsqueda avanzada. Si esta opción está activa, se ignora el parámetro Incluir subcarpetas . Este campo admite valores booleanos.
  Nota:

  Si se selecciona Usar búsqueda simple , la propiedad Repositorio de archivos solo admite las opciones OneDrive, SharePoint y URL específica . La actividad ahora se puede utilizar con cuentas personales de Microsoft y con los tipos de autenticación ApplicationIdAndSecret y ApplicationIdAndCertificate (cuando se utiliza dentro de la actividad Ámbito de Microsoft Office 365 ) si la opción Usar búsqueda simple está marcada.

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.

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 ApplicationIdAndSecret y ApplicationIdAndCertificate . Esta propiedad admite variables String y valores en formato de cadena.
• Carpeta : la ruta a una carpeta, dentro del repositorio de archivos especificado, en la que buscar (por ejemplo AlgunaCarpeta o AlgunaCarpeta/OtraCarpeta). Si se deja en blanco, se busca en la carpeta raíz. No se tiene en cuenta cuando el Repositorio de archivos se establece en Todos. Esta propiedad admite variables String y valores en formato de cadena.
• Incluir subcarpetas : especifica si expandir la búsqueda para incluir todas las subcarpetas de la ubicación de la nube seleccionada. Este campo admite valores booleanos.
• Limit To First - The maximum number of files and folders to return. If left blank, it retrieves all files and folders matching the filter criteria. This field supports only integer and Int32 variables. The default value is 200.
• Trim Duplicates - Specifies whether duplicate file/folder items should be removed from the search results. This field only supports Boolean values (True, False). The default value is False.
• Qué devolver : selecciona si devolver solo archivos, solo carpetas o ambos:
  • Archivos y carpetas
  • Archivos
  • Carpetas

Salida

• Index - A zero-based index that specifies which element of the current collection is being iterated. This field supports only integer and Int32 variables.

Repositorio

• Files Repository - The files repository where to search for files and folder. Select one of four options: All, OneDrive, SharePoint, SpecificUrl. The default value is All.

• Biblioteca de documentos de SharePoint : la biblioteca de documentos dentro del sitio de SharePoint especificado. Esta propiedad admite variables String y valores en formato de cadena.

• URL del sitio de SharePoint : la URL de un sitio de SharePoint en el que buscar. Esta propiedad admite variables String y valores en formato de cadena.

• URL específica : la URL de una ubicación específica en la que buscar. Esta propiedad admite variables String y valores en formato de cadena.

  Nota:

  Sometimes Microsoft Search API returns duplicate file or folder items. By selecting the option Trim Duplicates, the activity removes duplicates from the search results.

Ejemplos de filtrado

La siguiente tabla muestra ejemplos de filtros que podrían ser de utilidad cuando consultes archivos o carpetas:

Consulta	ExpresiónDeFiltro
Todos los archivos de Excel en la ubicación especificada	"fileextension:xlsx"
Todos los archivos de formato de documento de texto y portátiles en la ubicación especificada	"fileextension:txt OR fileextension:pdf"
Todos los archivos con el nombre "Agenda Brief.xlsx"	"filename:""Agenda Brief.xlsx"""
Todos los archivos de Excel con la palabra "users" en el nombre del archivo	"fileextension:xlsx AND filename:users"
Todos los archivos de Excel modificados el 14/06/2021 con la palabra "users" en el nombre del archivo	"fileextension:xlsx AND filename:users AND lastmodifiedtime=06/14/2021"
Todos los archivos de Excel modificados antes del 14/06/2021 con la palabra "users" en el nombre del archivo	"fileextension:xlsx AND filename:users AND lastmodifiedtime<06/14/2021"
Todos los archivos y carpetas creados por "John Smith" antes del 12/06/2021	"createdby:""John Smith"" AND created<06/12/2021"
Todos los archivos que se han compartido explícitamente con "Cory Belcher"	"sharedwithusersowsuser:""Cory Belcher"""