AncestorAlias

A função de texto AncestorAlias () é usada para retornar o valor de um determinado attribute-name retornado da consulta de tabela relacional. Esta função é válida para tabelas relacionais.

Sintaxe

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

Parâmetros

TableName - este é um parâmetro opcional se a função de texto for usada em uma célula de texto da tabela relacional. Se a função de texto for usada em um objeto de Texto, o parâmetro table-name será opcional se houver apenas uma única tabela relacional no relatório; caso contrário, o parâmetro table-name será obrigatório.

AttributeName - este attribute-name é um parâmetro obrigatório. Este attribute-name deve corresponder a um attribute-name ao longo do eixo da coluna da tabela relacional, ou ao PDV da tabela relacional.

row-reference - é um parâmetro opcional. Se nenhum parâmetro row-reference for fornecido e a função de texto de attribute-value ocorrer em uma célula de texto de uma grade relacional, a linha 'atual' na tabela relacional será usada. Se a função de texto de attribute-value ocorrer em um objeto de texto e o attribute-name estiver no eixo da coluna, a row-reference será obrigatória. A referência de linha pode incluir um deslocamento (por exemplo: uma row-reference de 1(5) retornará o attribute-value para a 5ª tupla na linha 1).

Note:

  • Se a função attribute-value não tiver um parâmetro table-name e ocorrer em um objeto de texto, e houver duas ou mais tabelas relacionais, ocorrerá um erro de validação.
  • Se o parâmetro attribute-name não estiver no eixo da coluna ou pdv, ou se a única ocorrência estiver dentro de uma função de agregação (por exemplo: Count(), Max() etc.), ocorrerá um erro de validação.

Exemplo

  • AttributeValue("Artifact Actions.User"): retornará o attribute-value para o attribute-name fornecido na linha atual da tabela relacional, ou o attribute-value do attribute-name fornecido no PDV.
  • AttributeValue("Artifact Actions.User", 1(5)): retornará o attribute-value para o attribute-name fornecido na 5ª linha da tabela relacional. Esta sintaxe não é válida se o attribute-name estiver no PDV. Ocorrerá um erro de validação. Se o conjunto de resultados da tabela relacional não tiver 5 linhas, uma string vazia será retornada.
  • AttributeValue("Table 1", "Artifact Actions.User", 1(5)):
  • AttributeValue("Table 1", "Artifact Actions.User", 1(5)): retornará o attribute-value para o attribute-name fornecido na 5ª linha da tabela relacional especificada. Esta sintaxe não é válida se o attribute-name estiver no PDV. Ocorrerá um erro de validação. Se o conjunto de resultados da tabela relacional não tiver 5 linhas, uma string vazia será retornada.