---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# SpContextManager -- Client

# SpContextManager -- Client {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

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

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

An diese API übergebene Schlüssel sind pro Seite eindeutig. Beispiel: Wenn `„Agent-Chat" `Der 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.

Um weitere Informationen zur Übergabe von Daten an zu erhalten Mitarbeiterchat, Siehe [Konfigurieren Sie den Mitarbeiterchat im Serviceportal](https://www.servicenow.com/docs/access?context=configure-va-in-sp&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US).

## SpContextManager -- addContext(Zeichenfolgenschlüssel, Objektkontext) {#ariaid-title2}

Initialisiert einen Schlüssel und fügt Widget-Daten als Wert hinzu. Fügen Sie beispielsweise dem Schlüssel „Agent-Chat" Daten 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 ServiceportalSeite. Wenn der Schlüssel bereits von einem anderen Widget auf der Seite verwendet wird, verwenden Sie UpdateContextForKey() Stattdessen Methode.
{#SPCM-addContext_S_O__table_dsz_dcz_qhb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| key | Zeichenfolge | Name des Schlüssels zum Senden der Daten. Verfügbare Schlüssel enthalten Agent-Chat : Sendet Widget-Daten an MitarbeiterchatWenn es in geöffnet wird ServiceportalSeite. |
| 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 : 1. Parameter]

{#SPCM-addContext_S_O__table_dsz_dcz_qhb} {#SPCM-addContext_S_O__table_esz_dcz_qhb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 2. Rückgaben]

{#SPCM-addContext_S_O__table_esz_dcz_qhb}  
Bestanden `Approval_count `Bis Mitarbeiterchat. Wenn ein Anwender initiiert MitarbeiterchatKonversation von ServiceportalHomepage, wird das System angehängt `&Sysparm_Approval_count=5 `An Mitarbeiterchat `IFrame `URL.

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

## SpContextManager -- getContext() {#ariaid-title3}

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.
{#SPCM-getContext__table_qgk_tdz_qhb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 3. Parameter]

{#SPCM-getContext__table_qgk_tdz_qhb} {#SPCM-getContext__table_rgk_tdz_qhb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Jeder Schlüssel und das zugehörige Datenobjekt sind auf der Seite definiert. |
[Tabelle : 4. Rückgaben]

{#SPCM-getContext__table_rgk_tdz_qhb}  

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

## SpContextManager -- getContextForKey(Zeichenfolgenschlüssel, boolescher returnPromise) {#ariaid-title4}

Gibt die Widget-Daten zurück, die einem Schlüssel zugeordnet sind.
{#SPCM-getContextForKey_S_B__table_w2r_jcz_qhb__entry__3}

| 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 Daten, die einem Schlüssel zugeordnet sind, als Zusage 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. {#SPCM-getContextForKey_S_B__ul_ccf_jvc_shb} |
[Tabelle : 5. Parameter]

{#SPCM-getContextForKey_S_B__table_w2r_jcz_qhb} {#SPCM-getContextForKey_S_B__table_x2r_jcz_qhb__entry__2}

| Typ | Beschreibung |
|-|-|
| Versprechen | Wenn returnPromise auf „wahr" festgelegt ist, wird eine Zusage zurückgegeben, 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} `. |
[Tabelle : 6. Rückgaben]

{#SPCM-getContextForKey_S_B__table_x2r_jcz_qhb}  
Bestanden `Approval_count `Bis Mitarbeiterchat. Wenn ein Anwender initiiert MitarbeiterchatKonversation von ServiceportalHomepage, wird das System angehängt `&Sysparm_Approval_count=5 `An Mitarbeiterchat `IFrame `URL.

    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) {#ariaid-title5}

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

| Name | Typ | Beschreibung |
|-|-|-|
| key | Zeichenfolge | Name des Schlüssels zum Senden der Daten. Verfügbare Schlüssel enthalten Agent-Chat : Sendet Widget-Daten an MitarbeiterchatWenn es in geöffnet wird ServiceportalSeite. |
| 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 : 7. Parameter]

{#SPCM-updateContextForKey_S_O__table_mhr_lcz_qhb} {#SPCM-updateContextForKey_S_O__table_nhr_lcz_qhb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 8. Rückgaben]

{#SPCM-updateContextForKey_S_O__table_nhr_lcz_qhb}  
Bestanden `Approval_count `Bis Mitarbeiterchat. Wenn ein Anwender initiiert MitarbeiterchatKonversation von ServiceportalHomepage, wird das System angehängt `&Sysparm_Approval_count=5 `An Mitarbeiterchat `IFrame `URL.

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


