8. Usando comodines para recuperar datos de GBDS¶

Al recuperar datos de GBDS a través de List Transactions y List People, es posible utilizar operadores de comodines para filtrar los resultados.

Al realizar una List Transactions utilizando el parámetro qualityStatus, los campos key, biographic y label pueden ser filtrados con operadores de comodines.

Los operadores de comodines disponibles se describen a continuación:

8.1. List Transactions¶

8.1.1. Sufijos¶

El campo clave o biográfico puede contener un id:valor o id|valor, por ejemplo, Name:John Doe, donde se pueden agregar cuatro sufijos.
- [anywhere]: Este es el sufijo predeterminado, si no se escribe ninguno, se selecciona este. En este caso, la aplicación buscará el id o valor proporcionado en cualquier parte de la cadena.
  
  Ejemplo: Si la clave es name[anywhere]:rob, buscará nombres como “Robbin” y apellidos como “Robarts”.
- [atstart]: Si se utiliza este sufijo, la aplicación buscará el id o valor proporcionado al principio de la cadena.
  
  Ejemplo: Si una clave es passportNumber:123[atstart], buscará los números de pasaporte que comiencen con 123 y devolverá todos.
- [atend]: Si se utiliza este sufijo, la aplicación buscará el id o valor proporcionado al final de la cadena.
  
  Ejemplo: Si una clave es passportNumber:123[atend], buscará los números de pasaporte que terminen con 123. name[atend]:son buscará nombres y apellidos que terminen con “son”.
- [exact]: Si se utiliza este sufijo, la aplicación buscará coincidencias exactas con la cadena de búsqueda dada.
  
  Ejemplo: Si una clave es passportNumber:123[exact], buscará los números de pasaporte que sean exactamente iguales a 123.

Warning

Esos operadores de comodines son SUFIXOS, por lo que deben insertarse después del ID o después del valor.

Note

Además, el ID y el valor pueden tener sufijos diferentes para cada uno, por lo que es posible tener operaciones como name[exact]:rob[atstart], donde buscará el campo llamado exactamente “Name” para valores que comiencen con “rob”.

8.1.2. Prefijos¶

El campo biográfico también puede tener un PREFIJO. Este prefijo solo se puede usar en el PRIMER campo biográfico, antes del id. Otros prefijos serán ignorados. Este prefijo definirá qué operación lógica ejecutará la aplicación entre TODOS los campos clave y biográficos. Los valores aceptados son [and] y [or], siendo el primero el valor predeterminado.

Ejemplo: Si el campo biográfico es [or]id:valor, se realizará una operación OR en todos los campos clave y biográficos, como: (Key1 OR Biographic1 OR Biographic2).

Este prefijo se puede combinar con un sufijo, por lo que se aceptan valores como [or]id:valor[exact].

8.2. List People¶

Al realizar una List People, el parámetro operator puede ser and o or. El operador seleccionado se aplicará en las comparaciones de key, biographic y label. Después, se realizará una comparación and con el valor de fecha deseado para filtrar los datos.

Ejemplo: Si el operador es or, la comparación para filtrar los datos será: ((Key1 OR Biographic1 OR Biographic2 OR Label1) AND Date).

8.2.1. Restricciones matchMode¶

Dentro del objeto de restricción, es posible seleccionar uno de los cinco modos de coincidencia cuando la restricción es biográfica o una clave. Los posibles valores y sus operaciones se enumeran a continuación.

Danger

Todo lo que no sea una letra, un número o un guión bajo es un separador. Un separador entre números o letras provocará la tokenización de la palabra/número completa en todos los modos, excepto en EXACTO y NO_IGUAL.

Important

En el valor del filtro de restricción, solo el espacio en blanco `` `` es un delimitador y tokenizará las palabras/números. Este comportamiento no ocurre en el modo de coincidencia EXACTO y NO_IGUAL.

Warning

El parámetro de búsqueda es sensible a los caracteres especiales en las letras, como â, é, ñ y otros.

EXACTO - La operación exacta busca todo el valor proporcionado. Usar exacto no tokenizará la expresión restringida. Este modo distingue entre mayúsculas y minúsculas.
- Ejemplo: La llamada debe devolver el valor “Jose Arruda”. Usando EXACTO con “Jose” o “Arruda” funcionará para devolver el valor deseado.
  
  Note
  
  Las búsquedas como “Jo” o “rrud” no devolverán a Jose Arruda.
- Ejemplo 2: La llamada debe devolver un valor numérico de un documento, como “123456”. Usando EXACTO, el valor DEBE ser “123456”.
  
  Note
  
  Las búsquedas con el valor “123” o “456” no devolverán el valor correcto.
  
  Important
  
  Si el valor se almacena con un separador, el separador debe estar en el valor de restricción.
INICIO - La operación inicio filtrará los valores tokenizando cada conjunto de palabras o números divididos por un separador.
- Ejemplo: Si el usuario restringe el INICIO para el valor “Jo”, algunos posibles resultados podrían ser:
```
Jose Arruda John Doe Marie Johnson
```
- Ejemplo 2: Si el usuario restringe el INICIO para el valor “Jose Arruda”, algunos posibles resultados podrían ser:
```
Jose Arruda Jose Silva Pedro Thomas Arruda
```
- Ejemplo 3: Si el usuario restringe el INICIO para el valor “123”, algunos posibles resultados podrían ser:
```
1234567 123.456 456-123 a-b 123
```
- Ejemplo 4: Si el usuario restringe el INICIO para el valor “123.456”, algunos posibles resultados podrían ser:
```
123.456 123.456.789-90
```
EN_CUALQUIER_PARTE - La operación en_cualquier_parte buscará el valor en cualquier parte de la palabra o número.
- Ejemplo: Si la restricción del usuario es EN_CUALQUIER_PARTE para el valor “Jo”, algunos posibles resultados podrían ser:
```
Jose Arruda Major Pejorative Banjo
```
- Ejemplo 2: Buscando “12” podría devolver:
```
123456 641256 114-4312 a-b 123
```
- Ejemplo 3: Si la restricción del usuario es EN_CUALQUIER_PARTE para el valor “Jo Ru”, algunos posibles resultados podrían ser:
```
Jose Arruda Ruth Silva Havier Russel
```
FIN - La operación fin buscará el valor al FINAL del token. Al igual que INICIO, esta operación tokenizará las palabras/números para cada separador.
- Ejemplo: Si la restricción del usuario es FIN para el valor “son”, algunos posibles resultados podrían ser:
```
Eric Johnson Hudson Santos
```
- Ejemplo 2: Si el usuario restringe el FIN para el valor “Jose Arruda”, algunos posibles resultados podrían ser:
```
Jose Arruda Jose Silva Pedro Thomas Arruda Arruda Bastos
```
- Ejemplo 3: Si el usuario restringe el FIN para el valor “123”, algunos posibles resultados podrían ser:
```
4567123 123.456 456-123 a-b 123
```
- Ejemplo 4: Si el usuario restringe el FIN para el valor “123.456”, algunos posibles resultados podrían ser:
```
123.456 789.123.456
```
NOT_EQUALS - El modo de coincidencia No igual funciona de manera inversa a la operación EXACTA. Filtrará y DESCARTARÁ las coincidencias exactas con el valor proporcionado y mostrará TODOS LOS DEMÁS valores. Este modo distingue entre mayúsculas y minúsculas.
- Ejemplo: Usando NOT_EQUALS con el valor “Jose” podría devolver:
```
John Doe Marie Johnson Josemar Rodrigues
```
- Ejemplo 2: Using NOT_EQUALS with the value “123” could return:
```
4567123
123456
```