AttributeValue

La función de texto AttributeValue() se utiliza para devolver el valor de un nombre de atributo devuelto por una consulta de la tabla relacional. Esta función es válida para tablas relacionales.

Sintaxis

AttributeValue("TableName", "AttributeName", row-reference,)

Parámetros

TableName : es un parámetro opcional si se utiliza la función de texto en una celda de texto de la tabla relacional. Si se utiliza la función de texto en un objeto de texto, el parámetro de nombre de tabla es opcional si solo hay una única tabla relacional en el informes; de lo contrario, el parámetro de nombre de tabla es necesario.

AttributeName: es el nombre de atributo, y es un parámetro necesario. Este nombre de atributo debe corresponder a un nombre de atributo del eje de columnas de la tabla relacional o del TPV de la tabla relacional.

row-reference : es un parámetro opcional. Si no se proporciona ningún parámetro de referencia de fila y se produce la función de texto de valor de atributo en un texto de celda de una cuadrícula relacional, se utiliza la fila "actual" de la tabla relacional. Si se produce la función de texto de valor de atributo en un objeto de texto y el nombre de atributo está en un eje de columnas, la referencia de fila es necesaria. La referencia de fila puede incluir un desfase (por ejemplo, una referencia de fila de 1(5) devolverá el valor de atributo de la quinta tupla de la fila 1).

Note:

  • Si la función de valor de atributo no tiene un parámetro de nombre de tabla, se produce en un objeto de texto y hay dos o más tablas relacionales, se genera un error de validación.
  • Si el parámetro de nombre de atributo no está en el eje de columnas o en el TPV, o si solo aparece dentro de una función de agregado (por ejemplo: Count(), Max(), etc.), se produce un error de validación.

Ejemplo

  • AttributeValue("Artifact Actions.User"): devolverá el valor de atributo del nombre de atributo suministrado en la fila actual de la tabla relacional, o el valor de atributo del nombre de atributo suministrado en el TPV.
  • AttributeValue("Artifact Actions.User", 1(5)): devolverá el valor de atributo del nombre de atributo suministrado en la quinta fila de la tabla relacional. Esta sintaxis no es válida si el nombre de atributo está en el TPV. Se producirá un error de validación. Si el conjunto de resultados de la tabla relacional no tiene 5 filas, se devolverá una cadena vacía.
  • AttributeValue("Table 1", "Artifact Actions.User", 1(5)):
  • AttributeValue("Table 1", "Artifact Actions.User", 1(5)): devolverá el valor de atributo del nombre de atributo suministrado en la quinta fila de la tabla relacional especificada. Esta sintaxis no es válida si el nombre de atributo está en el TPV. Se producirá un error de validación. Si el conjunto de resultados de la tabla relacional no tiene 5 filas, se devolverá una cadena vacía.