Benutzerdefinierte Validierungen

Videos

Wichtige Aspekte

• Sie benötigen die Berechtigung Eigentümer oder Metadatenmanager mindestens für die Dimension, um eine benutzerdefinierte Validierung erstellen, bearbeiten oder löschen zu können.
• Knotentypvalidierungen werden für alle Knoten im Ansichtspunkt nach Knotentyp ausgeführt.
• Hierarchiesetvalidierungen werden für alle Knoten im Ansichtspunkt ausgeführt, sofern es sich bei dem Ansichtspunkt um eine Hierarchie handelt.
• Validierungen werden für den Status von Knoten ausgeführt, nachdem eine Anforderung ausgeführt wurde (d.h. wie der Knoten aussehen wird, nachdem ein Commit für die Anforderung erfolgt ist). Sie können erst eine Validierung im Hinblick auf den Status eines Knotens ausführen, nachdem eine Anforderung ausgeführt wurde.
• Validierungen werden erzwungen, wenn eine Anforderung weitergeleitet, genehmigt oder festgeschrieben wird oder wenn eine Validierung durchgeführt wird. In der folgenden Tabelle wird beschrieben, welche benutzerdefinierten Validierungen ausgeführt werden, wenn Validierungen in unterschiedlichen Kontexten durchgeführt werden:

  Validierungskontext	Ausgeführte Validierungen
  Eine Anforderung validieren	Benutzerdefinierte Validierungen werden für Anforderungselemente ausgeführt, für die entweder die Triggeraktionen ausgeführt wurden oder bei denen die Triggereigenschaften vorliegen.
  Einen Ansichtspunkt mit einer offenen Anforderung validieren	Benutzerdefinierte Validierungen werden für alle Knoten im Ansichtspunkt ausgeführt, einschließlich der Anforderungselemente
  Ansichtspunkt außerhalb einer Anforderung validieren	Benutzerdefinierte Validierungen werden für Anforderungselemente ausgeführt, die die Triggereigenschaften erfüllen, nicht aber die Triggeraktionen.

• Standardmäßig werden benutzerdefinierte Validierungen für vordefinierte Elemente in Oracle Fusion Cloud EPM-Anwendungen ausgeführt (d.h. für Knoten, deren Eigenschaft Enterprise Predefined Member auf "True" gesetzt ist). Da vordefinierte Elemente jedoch von der externen Anwendung verwaltet werden, gelten einige benutzerdefinierte Validierungen möglicherweise nicht für sie. In diesem Fall können Sie den Ausdruck in der benutzerdefinierten Validierung so ändern, dass vordefinierte Elemente ausgelassen werden.

  Beispiel: Sie können dem Ausdruck eine Anweisung wie if (node.properties.PLN.Enterprise Predefined Member) {return true}, else hinzufügen (gefolgt von der Logik des Validierungsausdrucks).

Beispiel für eine benutzerdefinierte Validierung

In diesem Beispiel fügen wir zum Knotentyp "Konto" in der Anwendung "Corporate Planning" eine Validierung hinzu, die besagt, dass alle Knotennamen mit demselben Zeichen anfangen müssen wie das übergeordnete Element des betreffenden Knotens. Im folgenden Screenshot ist die benutzerdefinierte Validierung dargestellt, die wir erstellt haben.

Die Validierung hat folgende Definition:

• Das Kennzeichen "Aktiviert" ist auf "True" gesetzt.
• Der Ausdruck gibt den Wert "True" zurück, wenn der Knotenname mit demselben Zeichen beginnt wie der Name des übergeordneten Elements des Knotens. Ist dies nicht der Fall, wird der Wert "False" zurückgegeben.
• Die Triggeraktionen für die Validierung sind "Hinzufügen" und "Umbenennen", und die Triggereigenschaft ist "Name".
• Eine Fehlermeldung gibt an, dass die Validierung nicht erfolgreich war, wenn der Kontoknoten nicht mit demselben Zeichen beginnt wie der Name des zugehörigen übergeordneten Knotens.

Um die Validierung zu testen, wollen wir versuchen, eine Anforderung weiterzuleiten, die für den Kontoknotentyp einen Knoten hinzufügt, dessen Name mit einem anderen Zeichen beginnt als der Name seines übergeordneten Elements. In diesem Fall werden wir versuchen, unter dem übergeordneten Knoten OFS_Total Revenue einen Knoten namens Project Revenue hinzuzufügen.

Wenn wir die Anforderung weiterleiten, erhalten wir die Validierungsfehlermeldung, die angibt, dass der Knotenname mit demselben Zeichen beginnen muss wie der Name des zugehörigen übergeordneten Knotens.