Statusverwaltung öffnen

Das offene Statusmodell ist ein programmatisches Framework in der API „Konfigurationsstatusmodell“, mit dem Sie Variationen in Produktoptionen programmieren können, die in angezeigt werden ProduktkonfiguratorIn Vertriebs- und Auftragsmanagement. Das API-Framework bietet bestimmte status und Hilfs-API-Methoden zur Steuerung der Knoten in ProduktkonfiguratorAnwenderoberfläche wird angezeigt.

Als Entwickler können Sie verwenden Erweiterungspunkte für die Verwaltung des offenen Status Dient zum Festlegen der schreibgeschützten oder bearbeitbaren status für jeden Konfiguratorknoten basierend auf Ereignissen, die beim Laden auftreten oder wenn sich die Produktauswahl ändert. Sie können auch optional Informationsnachrichten skripten und den Status des Knotens ändern. Diese Nachrichten werden kontextbezogen auf der Anwenderoberfläche des Produktkonfigurators angezeigt. Verschiedene Hilfs-API-Methoden sind zum Lesen und Festlegen von status auf jedem Knoten verfügbar, wodurch umfangreiches JSON-Skripting überflüssig wird.

Hinweis:

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

Anwendungsfälle für die Verwaltung des Konfigurationsstatus

Die folgende Tabelle zeigt verschiedene Möglichkeiten, wie Sie die in angezeigten Produktoptionen steuern können Produktkonfigurator.

Tabelle : 1. Anwendungsfallbeispiele für Konfigurationsstatusmodell

Anwendungsfall des Produktkonfigurators	Beispiel
Blenden Sie bestimmte Optionen für einen Kunden aus	Aufgrund der staatlichen Sicherheitsvorschriften wird für Kunden in Kalifornien keine Produktattribut-Auswahl angezeigt​.
Legen Sie bestimmte Standardoptionen für einen Kunden fest	Für Upgrades wird nur der ultimative Plan für vorhandene Kunden angezeigt, die über einen Prämienplan verfügen.
Zulassen, dass nur bestimmte Optionen basierend auf anderen Attributoptionen ausgewählt werden	Zeigen Sie für bestimmte Produkte wie Laptops alle Größen 13", 15" und 17" an, aber zeigen Sie nur 15" und 17"-Laptops an, wenn nur die Touchscreen-Funktion erforderlich ist.
Lassen Sie zu, dass die Menge für Produkte festgelegt wird	Einige Produkte haben möglicherweise andere Standardmengenwerte. Zulassen, dass Service Desk-Mitarbeiter die Menge konfigurieren, solange der Wert innerhalb der Grenzen einer für dieses Produkt zulässigen Mindest- und Höchstmenge liegt.
Zulassen, dass nur bestimmte Merkmalsauswahlen getroffen werden	Bestimmte Produktauswahlen erfordern die Auswahl eines bestimmten Merkmalwerts. Beispiel: Bei Auswahl des ultimativen Internetplans kann die Konnektivitätsgeschwindigkeit 5G ausgewählt werden.

Sie können die Anzeige von Optionen in verwalten ProduktkonfiguratorDurch Verwendung des API-Frameworks „Konfigurationsstatusmodell“.

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 unsichtbar machen)

Konfigurationen, die für den Service Desk-Mitarbeiter im Produktkonfigurator sichtbar oder nicht sichtbar sind. Optionen sind möglicherweise nicht sichtbar, wenn sie mit anderen vom Service Desk-Mitarbeiter getroffenen Auswahlen nicht kompatibel sind. Beispiel: Für eine bestimmte Fahrzeugradgröße sind inkompatible Reifenoptionen nicht sichtbar.

Bearbeitbar: Ja (Knoten anzeigen und auswählbar machen) oder Nein (Knoten anzeigen, aber nicht auswählbar machen)

Konfigurationen, die vom Service Desk-Mitarbeiter im Produktkonfigurator bearbeitet werden können oder nicht bearbeitet werden können. Service Desk-Mitarbeiter können bestimmte Aspekte des Produkts personalisieren und gleichzeitig Einschränkungen beibehalten, die für das Produkt erforderlich sind. Beispiel: Für ein bestimmtes Fahrzeugmodell können nur kompatible Außenfarben bearbeitet werden.

Menge – Sichtbar (Ja/Nein), Bearbeitbar (Ja/Nein)

Konfigurationen, die die Menge für ein Produkt festlegen, Regeln im Zusammenhang mit der Menge erzwingen und Informations- und Fehlermeldungen im Zusammenhang mit der Menge am entsprechenden Knoten anzeigen.

Aktiviert – Ja (Knotenauswahl anzeigen) oder Nein (Knotenauswahl unsichtbar 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 Statusänderung zu begründen.

Ereignisse

Verwalten Sie knotenstatus mithilfe des API-Frameworks „Konfigurationsstatusmodell“. Aktivieren Sie diese status mithilfe der folgenden zwei Ereignisse im Ereignis-Framework des Konfigurationsstatusmodells:

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

Hilfe-API-Methoden

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

status anwenden

Legen Sie die sichtbaren und bearbeitbaren status für Produktbeziehungsgruppen, Produktmerkmale und Produktmerkmalsoptionen 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 Knotenpfad (Verweis auf Code) und dem jeweiligen relativen Pfad mit allen status zurück.
• GetNode(nodePath) : Gibt 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.

Setter-Methoden

• Legen Sie die sichtbaren und bearbeitbaren status für Produktbeziehungsgruppen, Produktmerkmale und Produktmerkmalsoptionen fest.
  • Einstellbar : Wahr/falsch auf allen Ebenen
  • SetVisible (wahr/falsch)
  • Bearbeitbar festlegen : Wahr/falsch auf allen Ebenen
  • Setbearbeitbar (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 anzuzeigen, 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”);

Getter-Kontextvariablen-Methoden

Ruft Kontextvariablen in ab ProduktkonfiguratorAnwenderoberfläche.

• 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 Positionskontextvariablen zurück.
• GetLineContextVariableValue(nodePath, contextVariable) : Gibt den Wert einer bestimmten Kontextvariablen in der Zeile zurück.