======  Adaptador PDF====== 
=====Introducción =====
El adaptador PDF le permite interactuar
con un archivo .pdf, para que pueda comprobar
si ha sido generado correctamente y contiene
la información a la que se supone que pertenece. Le será útil para probar todos aquellos procesos en los que se
implique la generación de un archivo .pdf.

=====Parámetros de inicialización=====

  * **FilePath:** Ruta completa del archivo.


=====Funciones predefinidas (PF):=====


  * **checkTextOnDocument(Page Area, Search Text):** Busca un texto dado en un área específica del documento (Página completa, Encabezado, Cuerpo, Pie de página). Esta función busca una coincidencia exacta del texto de búsqueda.

  * **checkTextOnPage**: Retorna true, si encuentra el texto especificado por el parámetro Search Text,  en el área indicada por el parámetro PageArea, en la página representada por el parámetro Page,  el número de veces introducido en Occurrences, false en caso contrario.
 
  * **checkTextOnPageArea(Page, CoordinateX, CoordinateY, Width, Height, Text):** Esta función devuelve verdadero si el parámetro texto existe dentro del área de la pagina definida por los parámetros. El parámetro page indica el número de la página a transformar. CoordinateX y CoordinateY indican las coordenadas de inicio del área. Width y Height indican el tamaño del área deseada, text es el texto que debe comprobar esta función. Y por último la imagen contará con 72 ppp de resolución.

  * **generateFileAsEvidence**: La función genera una copia del fichero PDF en su estado actual para añadirlo como evidencia.

  * **getCustomMetaData**: Devuelve el valor del metadato personalizado especificado en su parámetro de entrada. Los metadatos personalizados son otros distintos a los automáticos que se incluyen manualmente en los documentos. En el nombre del metadato se discrimina entre mayúsculas y minúsculas.

  * **getDataSigned**: Obtiene los datos de la firma del documento en el caso de que esté firmado digitalmente.            Devuelve en salida una variable TastTableData. Los datos se devuelven en una fila y N columnas.

  * **getMetaData**: Devuelve el valor del metadato seleccionado en el desplegable del parámetro de entrada. Son los metadatos automáticos como: title, author, subject, keyWords, creator, producer, pageCount, creationDate, modificationDate, traped.

  * **getNumPages():** Devuelve el número de páginas del documento.

  * **getNumRows**:

  * **getNumWhitePages():** Devuelve el número de páginas blancas del documento.
     
  * **getPageAsImage(Page,File):** Esta PF transforma una pagina PDF a una imagen jpg con una resolución de 72 ppp. Los parámetros de entrada con los que contamos son Page, que indica el número de página a transformar y el parámetro File que indica la ruta y el nombre de archivo donde la imagen será generada. La extensión es .jpg. \\ El propósito de esta imagen es permitir al usuario cargarla en cualquier aplicación que le ayude a identificar las coordenadas donde una parte con texto aparezca.\\ A parte de esto, si Get Evidences está marcado, se generará la imagen en la carpeta del log, como evidencia.

  * **getPageText:** Permite recuperar el texto contenido en una página de un PDF, y la función genera como evidencia un fichero con el texto recuperado.

  * **getTextCountOnDocument(Search Text):** Cuenta el número de veces que el texto de búsqueda está presente en el documento.

  * **getTextCountOnPage(Page, Search Text, Page Area):** Cuenta el número de veces que el texto de búsqueda está presente en un área específica (Página, Encabezado, Cuerpo, Pie de página) de una página dada. La función busca coincidencias exactas del texto de búsqueda dado.

  * **getTextPageByArea(Page, CoordinateX, CoordinateY, Width, Height):** Esta función  extrae y devuelve el texto que esta contenido dentro de un área de la página. El parámetro page indica el número de la página a transformar. CoordinateX y CoordinateY indican las coordenadas de inicio del área. Width y Height indican el tamaño del área deseada y por último la imagen contará con 72 ppp de resolución.

  * **isPageWhite(Page):** Devuelve "true" si la página especificada es blanca, "false" si no.

  * **isSigned**: Devuelve en su variable de salida booleana, **true** o **false**, según el documento está firmado digitalmente o no.

  * **readPdfFile**: Lee un fichero PDF y lo carga para su procesamiento.