Para cada elemento de búsqueda, el código en una actividad de Extraction Rules contiene una serie de reglas que se ejecutan de forma secuencial. Cada regla consta de dos partes y termina con un punto y coma:
La parte izquierda comprueba una condición o encuentra valores que la cumplan. La parte derecha crea nuevas instancias de elementos de búsqueda y les asigna esos valores.
Ejemplo
La siguiente regla simple encuentra un elemento de búsqueda kw_Contract que contiene la palabra clave “Contract”:
Estructura del panel izquierdo
El panel izquierdo consta de hasta tres partes:
Condición de existencia (opcional)
Busca un objeto que tenga los atributos especificados. Recomendamos asignarle un nombre al objeto si existe, de modo que pueda volver a utilizarlo dentro de la misma regla. La condición también puede indicar la ausencia de un objeto.
Ejemplos
Si necesita encontrar solo una instancia del elemento de búsqueda SellerName, especifique al inicio de la regla que aún no se ha encontrado ninguna instancia:
No puede asignar un nombre de variable al usar condiciones negativas, porque una condición negativa implica que no existe ningún objeto.
Esta condición comprueba la existencia de una entidad con nombre de tipo dirección:
Consulta Condición de existencia para obtener detalles sobre la sintaxis utilizada en esta sección.
Plantilla de tokens (obligatoria)
Consiste en una secuencia de tokens. Un token es una palabra de un lenguaje natural o un signo de puntuación. Los tokens normalmente no contienen espacios, salvo en algunos casos poco frecuentes en los que el espacio forma parte de una construcción que se usa como una sola palabra: such as, a lot.
Ejemplo
Por ejemplo, la siguiente plantilla de tokens consta de un token que coincide con la palabra clave “Grantor”, un token con dos puntos y un token repetido con la entidad con nombre Person (marcado como repetido porque el nombre de una persona puede constar de varias palabras, cada una como un token independiente):
La plantilla hará coincidir una cadena como “Grantor: Anne Smith” y asignará el valor “Anne Smith” a la variable p.
Consulta Plantilla de token para obtener detalles sobre la sintaxis utilizada en esta sección.
Comprobación adicional (opcional)
Verifica condiciones adicionales para los objetos que ya se mencionaron en la regla.
Ejemplo
Por ejemplo, supongamos que buscas las partes de un contrato y has agrupado los campos en dos instancias de grupo separadas, una para cada parte. Si has encontrado el nombre de una organización y una dirección, puedes comprobar si estos elementos de búsqueda comparten el mismo elemento padre. Si es así, significa que esa dirección corresponde a esa organización.
Consulte Comprobación adicional para más detalles sobre la sintaxis utilizada en esta sección.
Estructura de la parte derecha
La parte derecha consta de una o varias secciones separadas por comas que crean nuevas instancias de grupos y elementos de búsqueda, y asignan valores a dichos elementos:
Por lo general, la parte izquierda de la regla localiza un token, una secuencia de tokens o un objeto y lo asigna a una variable. Luego, la parte derecha puede usar esa variable para escribir su valor en uno de los elementos de búsqueda. Por ejemplo, el siguiente código escribe el valor de t en el elemento de búsqueda Element1:
Ejemplo
Consulte Parte derecha para obtener información detallada sobre la sintaxis utilizada en esta sección.
El código solo crea instancias de elementos de búsqueda y elementos de búsqueda de grupos que ya existen en la actividad Extraction Rules. No se pueden crear nuevos elementos de búsqueda mediante código. Para crear elementos de búsqueda adicionales en la estructura, use la pestaña Search Elements en el Activity Editor.
Referencing search elements
Para acceder a un elemento de búsqueda en el código, debe usar un nombre que lo identifique de forma inequívoca. Si un elemento tiene un nombre único, puede referirse a él simplemente por su nombre. Si hay varios elementos con el mismo nombre, debe especificar una ruta lo suficientemente precisa como para identificar el elemento.
Considere la siguiente estructura anidada de elementos de búsqueda:
Para hacer referencia al nombre del comprador en el código, puede simplemente usar “FullName”, ya que el elemento con ese nombre es único. “Buyer.FullName” o “Root.Buyer.FullName” también funcionarán.
Para hacer referencia a la dirección del comprador, deberá agregar al menos el nombre del grupo principal, porque hay dos elementos llamados “Address”. En este caso, debe usar “Buyer.Address” o “Root.Buyer.Address”.
Reglas específicas del idioma
Puede especificar el idioma del documento para el que se debe ejecutar la regla. Al hacerlo, la regla se omitirá para otros idiomas. Anteceda la regla con un símbolo de almohadilla (#) y el código de idioma de dos letras (norma ISO 639-1).
Códigos de los idiomas compatibles
| Idioma | Código |
|---|
| English | en |
| German | de |
| French | fr |
| Spanish | es |
| Italian | it |
| Portuguese (Standard) | pt |
| Japanese | ja |
| Russian | ru |
Por ejemplo, si procesa documentos en inglés y en español, quizá quiera usar palabras clave específicas del idioma: