SpContextManager – Client

Erstellt Daten aus einem Serviceportal Widget, das für andere Anwendungen und Services in einem verfügbar ist Serviceportal Seite. Übergeben Sie beispielsweise Widget-Daten an Mitarbeiterchat Wenn es in einem geöffnet wird Serviceportal Seite.

Die SpContextManager API ist ein AngularJS-Service, den Sie in verwenden können Serviceportal Widget-Client-Skripts.

An diese API übergebene Schlüssel sind pro Seite eindeutig. Beispiel: Wenn „Agent-Chat“ Schlüssel wurde bereits von einem anderen Widget auf der Seite über initialisiert AddContext() -Methode müssen Sie verwenden UpdateContextForKey() Methode zum Aktualisieren der Daten des Schlüssels. Verfügbare Schlüssel: Agent-Chat: Sendet Widget-Daten an Mitarbeiterchat.

Weitere Informationen zum Übergeben von Daten an Mitarbeiterchat, Siehe Konfigurieren Sie den Mitarbeiterchat im Serviceportal .

SpContextManager – addContext(Zeichenfolgenschlüssel, Objektkontext)

Initialisiert einen Schlüssel und fügt Widget-Daten als Wert hinzu. Fügen Sie beispielsweise Daten zum Schlüssel „Agent-Chat“ hinzu, um sie für verfügbar zu machen Mitarbeiterchat.

Verwenden Sie diese Methode, wenn Daten zum ersten Mal einem bestimmten Schlüssel auf einem hinzugefügt werden Serviceportal Seite. Wenn der Schlüssel bereits von einem anderen Widget auf der Seite verwendet wird, verwenden Sie UpdateContextForKey() Stattdessen Methode.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
key	Zeichenfolge	Name des Schlüssels zum Senden der Daten. Verfügbare Schlüssel Agent-Chat : Sendet Widget-Daten an Mitarbeiterchat Wenn es in einem geöffnet wird Serviceportal Seite.
context	Objekt	Widget-Daten im JSON-Format, die an die im Schlüsselparameter angegebene Anwendung oder den Service gesendet werden sollen. Beispiel: {'Approval_count': 5} .

Tabelle : 2. Rückgaben

Typ	Beschreibung
void

Übergeben Sie approval_count an Mitarbeiterchat. Wenn ein Benutzer eine Mitarbeiterchat-Konversation über die Serviceportal-Homepage initiiert, hängt das System &sysparm_approval_count=5 an die Mitarbeiterchat ifram-URL an.

function ($scope, spContextManager) {
    spContextManager.addContext('agent-chat', {
        'approval_count': 5       
    });
};

SpContextManager – getContext()

Gibt jeden Schlüssel und jedes zugehörige Datenobjekt zurück, die von einem beliebigen Widget auf der Seite definiert wurden.

Die Verwendung dieser Methode kann sich auf die Leistung auswirken. Verwenden Sie diese Methode, um zu verstehen, welche Schlüssel auf der Seite initialisiert werden, und um ihre aktuellen Werte abzurufen. Wenn Sie wissen, auf welchen Schlüssel Sie zugreifen müssen, verwenden Sie GetContextForKey() Stattdessen Methode.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Objekt	Jeder Schlüssel und jedes zugehörige Datenobjekt, das auf der Seite definiert ist.

function ($scope, spContextManager) {
  spContextManager.getContext();
} 

SpContextManager – getContextForKey(Zeichenfolgenschlüssel, boolesche returnPromise)

Gibt die Widget-Daten zurück, die einem Schlüssel zugeordnet sind.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
key	Zeichenfolge	Name des Schlüssels, von dem der Kontext abgerufen werden soll. Verfügbare Schlüssel: Agent-Chat: Sendet Widget-Daten an Mitarbeiterchat.
ReturnPromise	Boolean	Kennzeichnung, die bestimmt, ob die einem Schlüssel zugeordneten Daten als Versprechen oder Objekt zurückgegeben werden sollen. Werte: Wahr: Geben Sie die Daten als Zusage zurück. Verwenden Sie diese Option, wenn ein anderes Widget auf der Seite verwendet AddContext() Methode zum Initialisieren desselben Schlüssels. Die Rückgabe einer Zusage verhindert die Rückgabe eines nicht definierten Objekts, wenn der Schlüssel noch nicht initialisiert wurde. Falsch: Gibt ein Objekt zurück, das die Daten enthält, die dem Schlüssel zugeordnet sind.

Tabelle : 6. Rückgaben

Typ	Beschreibung
Zusage	Wenn returnPromise auf „wahr“ festgelegt ist, gibt eine Zusage zurück, die erfüllt wird, wenn ein anderes Widget auf der Seite den Schlüssel initialisiert.
Objekt	Wenn returnPromise auf „falsch“ festgelegt ist, wird ein Objekt zurückgegeben, das die dem Schlüssel zugeordneten Daten enthält. Beispiel: {Approval_count: 5} .

Übergeben Sie approval_count an Mitarbeiterchat. Wenn ein Benutzer eine Mitarbeiterchat-Konversation über die Serviceportal-Homepage initiiert, hängt das System &sysparm_approval_count=5 an die Mitarbeiterchat ifram-URL an.

function ($scope, spContextManager) {
  spContextManager.getContextForKey('agent-chat', true).then(function(context) {
    context = context || {};
    context.approval_count = 5; 
    spContextManager.updateContextForKey('agent-chat', context);
  });
} 

SpContextManager – updateContextForKey(Zeichenfolgenschlüssel, Objektkontext)

Sendet Daten an einen vorhandenen Schlüssel. Beispiel: Wenn ein anderes Widget auf der Seite den Schlüssel „Agent-Chat“ verwendet, um Daten an den zu übergeben Mitarbeiterchat Konfiguration müssen Sie den Kontext des Schlüssels aktualisieren, anstatt zu verwenden AddContext() Methode.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
key	Zeichenfolge	Name des Schlüssels zum Senden der Daten. Verfügbare Schlüssel Agent-Chat : Sendet Widget-Daten an Mitarbeiterchat Wenn es in einem geöffnet wird Serviceportal Seite.
context	Objekt	Widget-Daten im JSON-Format, die an die im Schlüsselparameter angegebene Anwendung oder den Service gesendet werden sollen. Beispiel: {'Approval_count': 5} .

Tabelle : 8. Rückgaben

Typ	Beschreibung
void

Übergeben Sie approval_count an Mitarbeiterchat. Wenn ein Benutzer eine Mitarbeiterchat-Konversation über die Serviceportal-Homepage initiiert, hängt das System &sysparm_approval_count=5 an die Mitarbeiterchat ifram-URL an.

function ($scope, spContextManager) {
  spContextManager.getContextForKey('agent-chat', true).then(function(context) {
    context = context || {};
    context.approval_count = 5; 
    spContextManager.updateContextForKey('agent-chat', context);
  });
}