Namen eines Knotens berechnen und speichern

Sie können einen Ausdruck definieren, um einen Knotennamen während einer Anforderung zu berechnen und diesen Wert zu speichern, wenn die Anforderung abgeschlossen und geschlossen ist.

Der berechnete Name kann auf den Eigenschaften des Knotens oder auf der Position des Knotens in einer Hierarchie basieren.

Beispielanwendungsfälle

  • Sie können einen Knotennamen anhand einer Sequenznummer berechnen. Beispiel: Sie können ein Präfix wie "CC_" mit einer Sequenz verketten, sodass hinzugefügte Knoten automatisch mit "CC_0034", "CC_0035" usw. benannt werden.
  • Sie können einen Knotennamen anhand von Eigenschaften berechnen. Beispiel: Sie können benutzerdefinierte Eigenschaften mit dem Datentyp "Knoten" verketten. In diesem Fall wird der Knotenname beim Definieren der Eigenschaften automatisch berechnet. Beispiel: Für benutzerdefinierte Eigenschaft 1 = 120, benutzerdefinierte Eigenschaft 2 = 200 und benutzerdefinierte Eigenschaft 3 = 340 wird der Knotenname 120-200-340 automatisch berechnet.

    Tip:

    Sie können auch Ausdrücke für die Eigenschaft mit dem Datentyp "Knoten" einrichten, um deren Werte abzuleiten. Beispiel: Wenn Sie stattdessen den Knotennamen 120-200-340 hinzufügen, wird der Wert für jede Eigenschaft entsprechend als 120, 200 und 340 abgeleitet. Informationen hierzu finden Sie unter Abgeleitete und gespeicherte Eigenschaften.

  • Sie können einen Knotennamen anhand struktureller Hierarchieinformationen wie übergeordnete Elemente, Vorgänger und gleichgeordnete Elemente berechnen. Beispiel: Sie können einen übergeordneten Namen und die Knotenbeschreibung verketten.
  • Sie können auch anhand berechneter Knotennamen den Standardnamen beim Hinzufügen eines neuen Knotens anpassen. Beispiel: Wenn ein Benutzer einen Knoten im Knotentyp "Entity" hinzufügt, können Sie statt des Standardnamens "Neuer Entityknoten" den berechneten Namen "CC_####" zurückgeben und die entsprechenden Werte für #### von den Benutzern manuell eingeben lassen.

Wichtige Aspekte

  • Sie können einen Knotennamen während der folgenden Vorgänge berechnen:
    • Knoten interaktiv hinzufügen
    • Anforderungsdateien laden
    • Knoten über ein Abonnement synchronisieren
  • Während einer Hinzufügeaktion in einer Anforderung wird der Knotenname bei jeder Änderung des Knotens neu berechnet.

    Note:

    Wenn ein Knotenname anhand einer Liste gleichgeordneter Elemente berechnet wird (z.B. durch Ermitteln des letzten gleichgeordneten Elements und Addieren von 1), beachten Sie, dass sich der Knotenname ändern kann, wenn später andere gleichgeordnete Elemente hinzugefügt werden und der ursprüngliche Knoten aktualisiert wird.
  • Beim Anzeigen eines berechneten Knotennamens in einer Anforderung gilt Folgendes:
    • Wenn der Ausdruck für den Knotennamen einen Wert zurückgibt, wird dieser Wert mit dem Ursprung "Berechnet" angezeigt.
    • Wenn der Ausdruck einen Nullwert zurückgibt, wird für den berechneten Namen das Schlüsselwort <cn ####> (wobei #### ein Hash des aktuellen Zeitstempels ist) mit dem Ursprung "Berechnet" angezeigt. Informationen hierzu finden Sie unter Erläuterungen zu den Schlüsselwörtern für berechnete Namen.
  • Sie können den Knotennamen durch manuelles Eingeben eines Namens überschreiben. Als Ursprung wird "Definiert" angezeigt.
  • Bei in einer Anforderung hinzugefügten Knoten können Sie mit der Aktion Löschen einen manuell eingegebenen Namen löschen und den berechneten Namen wiederherstellen. Mit der Aktion Zurücksetzen können Sie die aktuelle Position als primäre Position festlegen (siehe Erläuterungen zu primären Positionen) und den Knotennamen anhand des Ausdrucks neu berechnen. Informationen hierzu finden Sie unter Berechneten Wert löschen und zurücksetzen.
  • Nachdem eine Anforderung abgeschlossen und geschlossen wurde, wird der berechnete Knotenname gespeichert und als Ursprung "Definiert" angezeigt. Anders als bei abgeleiteten und gespeicherten Eigenschaften behält das System den Ursprung nicht als "Berechnet" und "Gespeichert" bei.
  • Im Kontext einer Anforderung mit berechneten Knotennamen ausgeführte Validierungen verwenden den aktuell berechneten Namen. Beispiel: Wenn der Ausdruck aktuell einen Nullwert zurückgibt, lautet der Knotenname für die Validierung "<cn ####>".
  • Bei der Suche nach Knoten in einer Anforderung wird der aktuelle Name in der Hinzufügeaktion für neue Knoten mit berechneten Namen verwendet. Beispiel: Wenn der Ausdruck aktuell einen Nullwert zurückgibt, können Sie im Knotennamen nach "<cn ####>" suchen.
  • Verwenden Sie beim Laden von Anforderungsdateien das Schlüsselwort <cn> oder <cn ####> in der Spalte "Name" einer Anforderungsladedatei (wobei ein Ausdruck für die Eigenschaft Core.Name konfiguriert ist), oder lassen Sie die Spalte "Name" leer, um den Wert für diesen Knotennamen zu berechnen. Informationen hierzu finden Sie unter Verarbeitung von Anforderungsdateien mit berechneten Namen.

Berechnete und gespeicherte Eigenschaft definieren

  1. Prüfen Sie eine Core.Name-Eigenschaftsdefinition.
  2. Wählen Sie die Anwendung oder den Knotentyp aus, für die bzw. den Sie den Knotennamen berechnen möchten.
  3. Wählen Sie unter "Standardtyp" die Option Berechnen und speichern aus.
  4. Klicken Sie unter "Standardwert" auf die Schaltfläche Ausdruck Ausdruck definieren.
  5. Definieren Sie einen Ausdruck zum Berechnen des Knotennamens, und klicken Sie auf Übernehmen. Informationen hierzu finden Sie unter Ausdrücke zum Definieren von benutzerdefinierten Geschäftslogiken verwenden.

Erläuterungen zu primären Positionen

Wenn Sie einen Knoten hinzufügen und diesen anschließend an mehreren anderen Positionen einfügen, bestimmt das System intern die erste Position in einer Hierarchie, in der der Knoten hinzugefügt wird, als primäre Position und berechnet anhand dieser Position den Knotennamen. Alle weiteren Positionen, an denen der Knoten eingefügt wird, verwenden den berechneten Namen der ersten Position.

Note:

Wenn sich die erste Position, an der der Knoten hinzugefügt wird, in einer Liste befindet, wird die primäre Position beim ersten Einfügen in eine Hierarchie festgelegt.

Beispiel: Mit einem Ausdruck wird der Knotenname durch Verketten des Namens des übergeordneten Knotens mit einer Eigenschaft des Knotens berechnet (in diesem Beispiel lautet der Wert der Eigenschaft "ABC"). Wenn Sie den Knoten unter dem übergeordneten Knoten 111 hinzufügen, wird der Name als "111-ABC" berechnet. Wenn Sie den Knoten anschließend unter dem übergeordneten Knoten 222 einfügen, lautet der Name nach wie vor "111-ABC", weil 111 die primäre Position ist.

Die primäre Position eines Knotens kann auf verschiedene Arten geändert werden:

  • Wenn Sie einen Knoten in der Anforderung von seiner primären Position verschieben, wird die neue Position zur primären Position, und der Name wird neu berechnet.

  • Wenn Sie den Knoten während der Anforderung aus der primären Position entfernen, wird die nächste Position, an der er eingefügt wurde, zur primären Position.

  • Wenn ein Knoten an mehreren Positionen vorhanden ist und Sie die primäre Position manuell ändern möchten, verwenden Sie die Aktion Zurücksetzen. Informationen hierzu finden Sie unter Berechneten Wert löschen und zurücksetzen.

Berechneten Wert löschen und zurücksetzen

Mit der Aktion Löschen können Sie einen manuell definierten Namen löschen und den berechneten Namen wiederherstellen. Die Aktion "Löschen" ist nur für Knoten verfügbar, die in dieser Anforderung mit dem Standardtyp "Berechnen und speichern" hinzugefügt wurden und deren Name manuell eingegeben wurde.

Mit der Aktion Zurücksetzen können Sie die primäre Position für den berechneten Namen auf die aktuelle Position setzen (siehe Erläuterungen zu primären Positionen) und den Knotennamen anhand der aktuellen Position neu berechnen. Die Aktion "Zurücksetzen" ist nur für Knoten verfügbar, die in dieser Anforderung mit dem Standardtyp "Berechnen und speichern" hinzugefügt wurden und deren Name nicht manuell eingegeben wurde.

Mit der Aktion "Zurücksetzen" können Sie auch einen Knotennamen neu berechnen, wenn Sie außerhalb des Knotens eine Aktion ausgeführt haben, die sich auf den Knotennamen auswirkt (z.B. wenn Sie eine übergeordnete Eigenschaft geändert haben und den Knotennamen anhand der neuen Eigenschaft neu berechnen möchten).

Validierungen und berechnete Knotennamen

Wenn eine Anforderung validiert wird, wird der aktuelle Name in der Hinzufügeaktion für neue Knoten mit berechneten Namen verwendet, mit einer Ausnahme: Wenn der aktuelle Name eines der Schlüsselwörter (<cn> und <cn ####>) ist, werden die Validierungen von Mindest- und Höchstlänge übersprungen. Dadurch kann ein Weiterleitender eine Anforderung mit einem der Schlüsselwörter im Namen weiterleiten, sodass ein Genehmiger oder Anreicherer die erforderlichen Informationen zum Berechnen des Namens hinzufügen kann.

Die Validierungen von Mindest- und Höchstlänge werden ausgeführt, wenn Anforderungen genehmigt oder festgeschrieben werden.

Berechnete Namen und Abonnements

Wenn Sie ein Abonnement mit einem berechneten Namen einrichten, wird der Name im Quellansichtspunkt berechnet, und der Ergebnisname wird in den Abonnementanforderungen an die Zielansichtspunkte übergeben. Wenn Sie den Knotennamen im Zielansichtspunkt berechnen möchten, müssen Sie im Knotentypconverter für das Abonnement eine Eigenschaftsumwandlung einrichten (siehe Mit Knotentypconvertern arbeiten), um den Namen in einen leeren Wert oder eines der Schlüsselwörter für berechnete Namen umzuwandeln (<cn> für Hinzufügevorgänge oder <cn ####> für Hinzufügevorgänge mit Einfügevorgängen, wobei #### eine Zeichenfolge als eindeutige ID ist). Informationen hierzu finden Sie unter Erläuterungen zu den Schlüsselwörtern für berechnete Namen.

Note:

Wenn Sie einen alternativen Namen verwenden möchten (sofern verfügbar), wandeln Sie den Namen in einen leeren Wert um. Wenn Sie immer den berechneten Namen im Zielansichtspunkt verwenden möchten, wandeln Sie den Namen in eines der Schlüsselwörter um.