Öffnen Sie die Statusverwaltung

Freigeben Version: Xanadu

Aktualisiert 1. August 2024

4 Minuten Lesedauer

Das offene Statusmodell ist ein programmatisches Framework in der Konfigurationsstatusmodell-API, mit dem Sie Variationen von Produktoptionen programmieren können, die in Produktkonfigurator in Vertriebs- und Auftragsmanagementangezeigt werden. Das API-Framework stellt bestimmte Status und API-Hilfsmethoden bereit, um zu steuern, wie Knoten in der Anwenderoberfläche Produktkonfigurator angezeigt werden.

Als Entwickler können Sie Erweiterungspunkte für die Statusverwaltung öffnen, um auf jedem Konfiguratorknoten basierend auf Ereignissen, die beim Laden oder beim Ändern der Produktauswahl auftreten, den Status „Schreibgeschützt“ oder „Bearbeitbar“ festzulegen. Sie können auch optional ein Skript für Informationsnachrichten erstellen, zusammen mit dem Status des Knotens. Diese Nachrichten werden in der Benutzeroberfläche des Produktkonfigurators kontextbezogen angezeigt. Zum Lesen und Festlegen von Status auf jedem Knoten sind verschiedene Hilfs-API-Methoden verfügbar, sodass kein umfangreiches JSON-Skripting erforderlich ist.

Hinweis:

Überprüfen Sie Ihre Berechtigungen, um festzustellen, ob Sie Zugriff auf diese Funktionen haben.

Anwendungsfälle für die Konfigurationsstatusverwaltung

Die folgende Tabelle zeigt verschiedene Möglichkeiten zur Steuerung der in Produktkonfiguratorangezeigten Produktoptionen.

Tabelle : 1. Anwendungsfälle für Konfigurationsstatusmodelle
Anwendungsfall für Produktkonfigurator	Beispiel
Blenden Sie bestimmte Optionen für einen Kunden aus	Aufgrund staatlicher Sicherheitsvorschriften wird für Kunden in Kalifornien keine Produktattributauswahl angezeigt.
Legen Sie bestimmte Standardoptionen für einen Kunden fest	Bei Upgrades wird für Bestandskunden, die über einen Premium-Plan verfügen, nur der Ultimate-Plan angezeigt.
Auswahl nur bestimmter Optionen basierend auf anderen Attributoptionen zulassen	Für bestimmte Produkte wie Laptops alle Größen 13", 15" und 17", aber nur 15" und 17" Laptops anzeigen, wenn nur die Touchscreen-Funktion erforderlich ist.
Festlegung der Menge für Produkte zulassen	Einige Produkte haben möglicherweise andere Standardmengenwerte. Ermöglichen Sie Service Desk-Mitarbeitern, die Menge zu konfigurieren, solange der Wert innerhalb der Grenzen einer Mindest- und Höchstmenge liegt, die für dieses Produkt zulässig ist.
Nur bestimmte Merkmalsauswahlen zulassen	Bestimmte Produktauswahlen erfordern die Auswahl eines bestimmten Merkmalswerts. Wenn Sie beispielsweise den Ultimate Internet Plan auswählen, können Sie eine Konnektivitätsgeschwindigkeit von 5G auswählen.

Sie können die Anzeige von Optionen in Produktkonfigurator mithilfe des API-Frameworks für Konfigurationsstatusmodelle verwalten.

Knotenstatus

Knoten im Produktkonfigurator zeigen Produktbeziehungsgruppen, untergeordnete Produkte und Merkmalsoptionen an. Knoten können die folgenden Status haben:

Sichtbar: Ja (Knoten sichtbar machen) oder Nein (Knoten sichtbar machen): Konfigurationen, die für den Service Desk-Mitarbeiter im Produktkonfigurator sichtbar sind bzw. nicht sichtbar sind. Optionen sind möglicherweise nicht sichtbar, wenn sie nicht mit anderen vom Service Desk-Mitarbeiter getroffenen Auswahlmöglichkeiten kompatibel sind. Beispielsweise sind für eine bestimmte Autoradgröße nicht kompatible Auto-Reifenoptionen sichtbar.
Bearbeitbar: Ja (Knoten anzeigen und auswählbar machen) oder Nein (Knoten anzeigen, aber auswählbar machen): Konfigurationen, die vom Service Desk-Mitarbeiter im Produktkonfigurator bearbeitet werden können oder nicht. Service Desk-Mitarbeiter können bestimmte Aspekte des Produkts personalisieren und gleichzeitig Einschränkungen beibehalten, die für das Produkt erforderlich sind. Beispielsweise können für ein bestimmtes Automodell nur kompatible Außenfarben bearbeitet werden.
Menge – Sichtbar (Ja/Nein), Bearbeitbar (Ja/Nein): Konfigurationen, die die Menge für ein Produkt festlegen, Regeln in Bezug auf die Menge erzwingen und Informations- und Fehlermeldungen in Bezug auf die Menge am entsprechenden Knoten anzeigen.
Aktiviert: Ja (Knotenauswahlen anzeigen) oder Nein (Knotenauswahlen sichtbar machen): Konfigurationen, die die Konfigurationsoptionen für die Auswahl basierend auf dem Kontext anzeigen.
Wert: Sichtbar (Ja/Nein), Bearbeitbar (Ja/Nein): Konfigurationen, die einen Wert für ein Merkmal festlegen, Regeln im Zusammenhang mit dem Merkmal erzwingen und Informations- oder Fehlermeldungen im Zusammenhang mit dem entsprechenden Knoten anzeigen.

Hinweis:

Service Desk-Mitarbeiter können Nachrichten auf Knotenebene festlegen, um eine Begründung für eine Statusänderung bereitzustellen.

Ereignisse

Verwalten Sie Knotenstatus mit dem Configuration State Model API Framework. Aktivieren Sie diese Status mithilfe der folgenden beiden Ereignisse im Ereignis-Framework des Konfigurationsstatusmodells:

Beim Laden: Der Status (Sichtbarkeit, Bearbeitbarkeit) jedes Knotens wird anfänglich auf „Ja“ (wahr) festgelegt. Der Status „offen“ wird beim Laden aufgerufen.
Bei Änderung: Diese Funktion wird immer dann aufgerufen, wenn sich der Wert eines Knotens in der Anwenderoberfläche Produktkonfigurator ändert. Dieser Status wird jedoch nicht aufgerufen, wenn sich die Menge in Produktkonfiguratorändert. Diese Status können auf eine der folgenden Arten programmgesteuert festgelegt werden: beim Laden, während der Auswahl oder kurz bevor die Instanz zurück mit der Transaktion synchronisiert wird

Methoden der Hilfs-API

Sie können die folgenden Hilfs-API-Methoden verwenden, um den Status in jedem Knoten zu lesen und festzulegen.

Status anwenden

Legen Sie die sichtbaren und bearbeitbaren Status für Produktbeziehungsgruppen, Produktmerkmale und Produktmerkmaloptionen mithilfe der Getter- und Setter-Methoden fest, um den Status des Konfigurationsmodells zu lesen und zu ändern.

Getter-Methoden

Rufen Sie Knotenpfade zusammen mit den Status auf einem beliebigen Konfigurationsknoten ab:

getAllNodes(): Gibt JSON mit dem Knotenpfad (Referenz zum Code) und dem jeweiligen relativen Pfad mit allen Status zurück.
getNode(nodePath): Gibt das Javascript-Objekt des Knotens für den angegebenen Knotenpfad zurück, falls vorhanden.
getNodeDetails(nodePath: Gibt alle Status für den angegebenen Knotenpfad zurück, falls vorhanden.

Einstellungsmethoden

Legen Sie die sichtbaren und bearbeitbaren Status für Produktbeziehungsgruppen, Produktmerkmale und Produktmerkmaloptionen fest.
- setVisible: Wahr/Falsch auf allen Ebenen
- setVisible(Wahr/Falsch)
- setEditable: Wahr/Falsch auf allen Ebenen
- setEditable(Wahr)
- Implementierungsbeispiel:
```
var newHandler = configInstance.getNode(nodePath);
newHandler.setVisible(true, “This is a sample message for setVisible”);
newHandler.setEditable(false, “This is a sample message for setEditable”);
```
Legen Sie die Menge für Angebote und Spezifikationen fest. Der nodePath bestimmt das Produkt, und der Wert ist die festzulegende Menge.
- setQuantity(Wert);
- Implementierungsbeispiel:
```
var newHandler = configInstance.getNode(nodePath);
newHandler.setQuantity(value, “This is a sample message for setQuantity”);
```

Legen Sie die Konfigurationsoptionen fest, um zu sehen, was ausgewählt wird.

setChecked (Wert); Wahr/Falsch

Implementierungsbeispiel:

var nodePath = “QUADPLAYHO1/OPTIONALPRODUCTS/CONNECTEDC2/CONNECTEDC1/VIN”
var newHandler = configInstance.getNode(nodePath);
var newHandler.setChecked(true, “This is a sample message for setChecked”)

Legen Sie den Wert für einen Merkmalsknoten fest, bei dem der Eingabetyp eine einzelne Textzeile ist.

setValue( Wert);

Implementierungsbeispiel:

var nodePath =
“QUADPLAYHO1/OPTIONALPRODUCTS/CONNECTEDC2/CONNECTEDC1/VIN”
var newHandler = configInstance.getNode(nodePath);
newHandler.setValue(“9TKN332”, “This is a sample message for
setValue”);

Methoden für Kontextvariablen abrufen

Rufen Sie Kontextvariablen innerhalb der Anwenderoberfläche Produktkonfigurator ab.

getHeaderContextVariables(): Gibt eine Liste aller Header-Kontextvariablen zurück.
getHeaderContextVariableValue(contextVariable): Gibt einen Wert und den Anzeigewert einer bestimmten Kontextvariablen im Header zurück.
getLineContextVariables(): Gibt eine Liste aller Zeilenkontextvariablen zurück.
getLineContextVariableValue(nodePath, contextVariable): Gibt den Wert einer bestimmten Kontextvariablen in der Zeile zurück.