Expresiones XPath
El lenguaje XPath sirve para ubicar nodos dentro de un documento jerárquico y en RecordsManager se usa para ubicar valores de campos dentro de la estructura jerárquica de su BD de RecordsManager. Para ver una descripción de la estructura jerárquica de la base de datos consulte Almacenamiento de datos.
Para más información sobre XPath consulte los apartados:
Recomendación XPath 3.1 del W3C
Funciones y operadores XPath 3.1
Breve introducción a XPath de Altova
Curso de Altova sobre XPath 3.1
Expresiones XPath en RecordsManager
Además de los procedimientos XPath estándar, RecordsManager también usa las funcionalidades que puede ver más abajo.
La variable $CurrentUser
La variable $CurrentUser contiene información sobre el usuario actual, como su nombre de usuario y su dirección de correo electrónico. Para acceder a esa información debe usar esta variable tal y como explicamos a continuación.
$CurrentUser/Name devuelve el nombre del usuario como una cadena de texto
$CurrentUser/Email devuelve el correo electrónico del usuario como una cadena de texto
$CurrentUser/Group devuelve los nombres de los grupos de usuario a los que pertenece el usuario*
$CurrentUser/Role devuelve los nombres de los roles que se han asignado al usuario*
* El usuario puede pertenecer a más de un grupo o tener más de un rol, en cuyo caso la expresión XPath que devuelva estos valores lo hará como una secuencia de elementos. Tan solo tiene que ajustar la expresión para que tenga esta variable en cuenta. Por ejemplo, si quiere seleccionar un elemento de una de esas secuencias, puede usar un filtro como predicado. En el ejemplo siguiente el campo EditedBy de la tabla de datos actual es de tipo Usuario, que tiene las propiedades de elemento secundario Group y Role, que a su vez pueden tener varios valores (y no solo uno).
EditedBy/Role[contains(., 'Admin')]
Encontrar los campos de registros secundarios o antecesores
En las expresiones XPath de los formularios de entrada puede usar las expresiones de localización para seleccionar los campos de los registros antecesores y secundarios. El primer paso de la expresión de localización sería el nombre de la tabla de datos, seguido del texto _fields. El segundo paso de la expresión sería el nombre del campo que quiere encontrar. La expresión entonces tendría este aspecto:
<DataTableName>_fields/<FieldName>
| Nota: | Si un campo tiene un espacio en su nombre, utilice el carácter de subrayado para el espacio. Por ejemplo, para un campo denominado Fecha de expiración, utilice Expiry_Date en expresiones XPath. |
En los ejemplos siguientes, la tabla de datos Person tiene un campo Address (primer ejemplo a continuación). También tiene un campo EditedBy, que es de tipo Usuario, por lo que tiene las propiedades de un elemento secundario, Group y Role, que a su vez pueden tener distintos valores (y no uno solo); (las propiedades Email y Name de un campo de tipo Usuario, por otro lado, tienen cada uno un único valor de cadena); consulte los ejemplos que siguen.
Person_fields/Address
Person_fields/EditedBy/Name
Person_fields/EditedBy/Role[.='Admin']