Para cada archivo/carpeta

UiPath.MicrosoftOffice365.Activities.Files.ForEachFileFolder

Descripción

Utiliza la API de búsqueda de Microsoft Graph de Microsoft (para búsqueda avanzada) o la API de elementos de búsqueda de Microsoft Graph (para búsqueda simple) para realizar una actividad o una serie de actividades en cada archivo / carpeta que coincida con los criterios de 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 es compatible con la persistencia.

Compatibilidad de proyectos

Windows: heredado | Windows

Configuración

En el cuerpo de la actividad

• Para cada: escribe el nombre por el que referirse al archivo actual de la iteración. Si usas un nombre que describa el tipo de archivo de la carpeta será 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 escribir Report. El valor predeterminado es DriveItem.

Panel de propiedades

Común

• NombreParaMostrar; el nombre de la actividad que se muestra 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 usa la restricción de propiedad DocumentLink con una URL creada a partir de la ubicación especificada en el repositorio de archivos y el valor en el parámetro Carpeta . No utilice la restricción de propiedades "DocumentLink:" o "path:" en el parámetro AdvancedSearch .

• Búsqueda simple: el texto de consulta usado para buscar archivos y carpetas en diversos campos como nombre de archivo y contenido de archivo. Esta propiedad admite variables String y valores en formato de cadena.

• Usar búsqueda simple : cuando está activo, se usa 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, SharePointy URL específica .

  La actividad ahora se puede usar con cuentas de Microsoft personales y con los tipos de autentificación IDYSecretoDeAplicación e IDYCertificadoDeAplicación (cuando se usan dentro de la actividad Ámbito de Microsoft Office 365) si se marca la opción Usar búsqueda simple.

Otros

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

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. Esta propiedad admite variables String y valores en formato de cadena.
• Carpeta: la ruta a una carpeta dentro del repositorio de archivos especificado en el que buscar (por ejemplo,UnaCarpeta 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 está configurado como 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.
• Limitar a primero : el número máximo de archivos y carpetas que se devolverán. Si se deja en blanco, recupera todos los archivos y carpetas que coinciden con los criterios de filtro. Este campo solo admite variables enteras y Int32 . El valor predeterminado es 200.
• Borrar duplicados: especifica si los elementos de archivo/carpeta duplicados deben eliminarse de los resultados de búsqueda. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso.

• Qué devolver : selecciona si deseas devolver solo archivos, solo carpetas o ambos:

  • Archivos y carpetas
  • Archivos
  • Carpetas

Salida

• Índice : un índice de base cero que especifica qué elemento de la colección actual se está iterando. Este campo solo admite variables enteras y Int32 .

Repositorio

• Repositorio de archivos: el repositorio de archivos donde buscar archivos y carpetas. Selecciona una de las cuatro opciones: Todo, OneDrive, SharePoint, URLEspecificada. El valor predeterminado es Todo.
• Biblioteca de documentos de SharePoint : la biblioteca de documentos dentro del sitio SharePoint especificado. Esta propiedad admite variables String y valores en formato de cadena.
• URL del sitio deSharePoint : 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: a veces, la API de búsqueda de Microsoft devuelve elementos de archivos o carpetas duplicados. Al seleccionar la opción Recortar duplicados, la actividad elimina los duplicados de los resultados de búsqueda.

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 Breve.xlsx"	"filename:""Agenda Brief.xlsx"""
Todos los archivos de Excel que contengan la palabra "usuarios" en el nombre del archivo	"fileextension:xlsx AND filename:users"
Todos los archivos de Excel modificados el 14/06/2021 con la palabra "usuarios" en el nombre del archivo	"fileextension:xlsx AND filename:users AND lastmodifiedtime=06/14/2021"
Todos los archivos de Excel modificados antes del 06/14/2021 con la palabra "usuarios" 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"""