PDF Search Text

Tipo: pdf-search-text · Paquete: PDF Activities v1.2.4 · Salida: List

Busca un texto en el PDF y devuelve la lista de números de página (desde 1) donde aparece. Útil para localizar secciones dentro de documentos largos antes de extraer o manipular esas páginas.

Cómo funciona

Recorre todas las páginas buscando el text en el texto extraído de cada una (el mismo que devuelve PDF Get Text (Page)) y devuelve los números de las páginas donde lo encuentra. Por defecto no distingue mayúsculas. No modifica el archivo.

Es una búsqueda de texto literal, no una expresión regular.
Cada página cuenta una sola vez, aunque el texto aparezca varias veces en ella.
Un texto partido entre dos páginas no se encuentra.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`path`	`string`	—	Ruta del archivo PDF.
`text`	`string`	—	Texto a buscar.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`caseSensitive`	`bool`	`false`	Distinguir mayúsculas/minúsculas. El interruptor del Designer o una expresión que dé `true`/`false`. Desde la versión 1.2.4. Otro valor es un error.

Salida

Devuelve una List de int con los números de página (desde 1), en orden ascendente, p. ej. [2, 5]. Si el texto no aparece —o el PDF es escaneado—, una lista vacía.

Errores comunes

Mensaje	Causa y solución
`No se encontró el archivo.`	La ruta no existe.
`'caseSensitive' debe ser true o false. Se recibió: ….`	La expresión de `caseSensitive` no dio un sí/no. Desde la versión 1.2.4.
`'path' es obligatorio.` / `'text' es obligatorio.`	El parámetro quedó vacío o su expresión dio `null`.
Error de la biblioteca de PDF al abrir el archivo	PDF protegido con contraseña o dañado. Ver PDF protegidos y dañados.

Ejemplo

Encontrar las páginas de un anexo y extraerlas a un PDF aparte:

PDF Search Text   path = ruta   text = "ANEXO A"   → output: paginas
If   condition = count(paginas) > 0
 └─ then:
      PDF Extract Pages   path = ruta   pages = paginas   output = "C:/anexoA.pdf"

La lista se pasa tal cual a PDF Extract Pages o a PDF Rotate (desde la versión 1.2.4; antes había que convertirla en texto con join(paginas, ",")). Para quedarte solo con la primera página, usa pages = paginas[0].

Actividades relacionadas

PDF Contains Text — solo saber si aparece (sí/no).
PDF Extract Pages — extraer las páginas encontradas.