AncestorAlias

Mit der Textfunktion AncestorAlias() kann der Wert eines bestimmten Attributnamens aus der Abfrage der relationalen Tabelle zurückgegeben werden. Diese Funktion ist für relationale Tabellen gültig.

Syntax

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

Parameter

TableName - Dieser Parameter ist optional, wenn die Textfunktion in einer Textzelle der relationalen Tabelle verwendet wird. Wenn die Textfunktion in einem Textobjekt verwendet wird, ist der Parameter TableName optional, wenn der Bericht nur eine relationale Tabelle enthält. Andernfalls ist der Parameter TableName erforderlich.

AttributeName - Der Attributname ist ein erforderlicher Parameter. Dieser Attributname muss einem Attributnamen entlang der Spaltenachse der relationalen Tabelle oder im POV der relationalen Tabelle entsprechen.

row-reference - Dieser Parameter ist optional. Wenn der Parameter row-reference nicht angegeben und die Textfunktion AttributeValue in einer Textzelle eines relationalen Rasters enthalten ist, wird die aktuelle Zeile in der relationalen Tabelle verwendet. Wenn die Textfunktion AttributeValue in einem Textobjekt und der Attributname auf der Spaltenachse enthalten ist, ist der Parameter row-reference erforderlich. Die Zeilenreferenz kann eine Verschiebung enthalten. (Beispiel: Der Wert 1(5) für row-reference gibt den Attributwert für das 5. Tupel in Zeile 1 zurück.)

Note:

  • Wenn die Funktion AttributeValue den Parameter TableName nicht enthält und in einem Textobjekt vorkommt und mindestens zwei relationale Tabellen vorhanden sind, tritt ein Validierungsfehler auf.
  • Wenn der Parameter AttributeName nicht auf der Spaltenachse oder im POV oder nur in einer Aggregatfunktion enthalten ist (z.B. Count(), Max() usw.), tritt ein Validierungsfehler auf.

Beispiel

  • AttributeValue("Artifact Actions.User"): Diese Funktion gibt den Attributwert für den angegebenen Attributnamen in der aktuellen Zeile der relationalen Tabelle oder den Attributwert des angegebenen Attributnamens im POV zurück.
  • AttributeValue("Artifact Actions.User", 1(5)): Diese Funktion gibt den Attributwert für den angegebenen Attributnamen in der 5. Zeile der relationalen Tabelle zurück. Diese Syntax ist nicht gültig, wenn der Attributname im POV enthalten ist. In diesem Fall tritt ein Validierungsfehler auf. Wenn das ResultSet der relationalen Tabelle weniger als 5 Zeilen enthält, wird eine leere Zeichenfolge zurückgegeben.
  • AttributeValue("Table 1", "Artifact Actions.User", 1(5)):
  • AttributeValue("Table 1", "Artifact Actions.User", 1(5)): Diese Funktion gibt den Attributwert für den angegebenen Attributnamen in der 5. Zeile der angegebenen relationalen Tabelle zurück. Diese Syntax ist nicht gültig, wenn der Attributname im POV enthalten ist. In diesem Fall tritt ein Validierungsfehler auf. Wenn das ResultSet der relationalen Tabelle weniger als 5 Zeilen enthält, wird eine leere Zeichenfolge zurückgegeben.