---
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


---

# CSBScratchpadUtil -- Umfang

# CSBScratchpadUtil -- Umfang {#ariaid-title1}

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

Die CSBScratchpadUtil Mit API können Verbraucher „zusätzliche" Informationen teilen, die sich außerhalb anderer befinden Service BridgeService mit ihren Providern.

Diese Informationen werden als Name-Wert-Paare in der Scratchpad-Tabelle \[sn_sb_Scratchpad\] gespeichert. Die freigegebenen Informationen müssen Aufgaben zugeordnet werden, die einen von zwei Typen haben: Anbieteraufgaben oder Remoteaufgaben.

Wenn die zugehörige Aufgabe aktiv ist, werden die aktualisierten Scratchpad-Informationen mit der Verbraucherinstanz synchronisiert. Wenn eine Aufgabe deaktiviert oder gelöscht wird, werden die Informationen im Scratchpad auch nach einer angegebenen Anzahl von Tagen gelöscht; standardmäßig drei. Dieser Standard ist in der Eigenschaft sn_sb.scratchpad.autodelete.days definiert.

Sowohl Anbieter als auch Verbraucher können Informationen zur und aus der Scratchpad-Tabelle hinzufügen, aktualisieren und entfernen. Hersteller aktualisieren diese Informationen mit [PSBScratchpadUtil -- Umfang](https://servicenow-prod.fluidtopics.net/73eW99rVOH~ka3Xw2n71AQ#PSBScratchpadUtilScopedAPI "Die PSBScratchpadUtil Die API bietet Methoden, mit denen Anbieter „zusätzliche“ Informationen freigeben können, die sich außerhalb anderer befinden Service BridgeService mit ihren Verbrauchern.")API.

Um auf diese API zuzugreifen, die Service BridgeDie Anwendung „für Verbraucher" muss installiert sein. Diese API wird in ausgeführt `sn_sb_con `Namespace.

## CSBScratchpadUtil -- GET(GlideRecord-Aufgabe GR, Zeichenfolgenname) {#ariaid-title2}

Gibt den Wert einer angegebenen Scratchpad-Eigenschaft zurück.
{#CSBScrUtil-get_GR_S__table_sm3_fpg_czb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| taskGR | GlideRecord | GlideRecord der aktiven Remote-Aufgabe oder Anbieteraufgabe, die der angegebenen Scratchpad-Eigenschaft zugeordnet ist. Tabellen: Remoteaufgabe \[sn_sb_con_remote_task\] und Anbieteraufgabe \[sn_sb_con_provider_task\]. |
| name | Zeichenfolge | Name der Scratchpad-Eigenschaft, deren Wert abgerufen werden soll. Tabelle: scratchpad \[sn_sb_Scratchpad\] |
[Tabelle : 1. Parameter]

{#CSBScrUtil-get_GR_S__table_sm3_fpg_czb} {#CSBScrUtil-get_GR_S__table_tm3_fpg_czb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge oder Null | Wert der angeforderten Scratchpad-Eigenschaft. Null, wenn die Eigenschaft nicht gefunden wird. |
[Tabelle : 2. Rückgaben]

{#CSBScrUtil-get_GR_S__table_tm3_fpg_czb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var rtGR = new GlideRecord("sn_sb_con_remote_task");
    rtGR.setLimit(1); 
    rtGR.query();  
    rtGR.next() 
    if (rtGR.isValidRecord()) { 
      var util = new sn_sb_con.CSBScratchpadUtil();
      util.update(rtGR, "name1", "value1"); 
      gs.info(util.get(rtGR, "name1"));
    }

Ausgabe:

    "value1"

## CSBScratchpadUtil -- getAll(GlideRecord-AufgabenGR) {#ariaid-title3}

Gibt die Eigenschaftsnamen und -Werte (Name-Wert-Paare) aller Scratchpad-Eigenschaften zurück, die der angegebenen Aufgabe zugeordnet sind.
{#CSBScrUtil-getAll_GR__table_ism_vpg_czb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| taskGR | GlideRecord | GlideRecord der aktiven Remote-Aufgabe oder Anbieteraufgabe, deren zugehörige Scratchpad-Eigenschaften zurückgegeben werden sollen. Tabelle: Tabellen „Remoteaufgabe \[sn_sb_con_remote_task\]" und „Anbieteraufgabe \[sn_sb_con_provider_task\]". |
[Tabelle : 3. Parameter]

{#CSBScrUtil-getAll_GR__table_ism_vpg_czb} {#CSBScrUtil-getAll_GR__table_jsm_vpg_czb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Alle Eigenschaftsnamen und -Werte, die in der angegebenen Aufgabe enthalten sind. Zum Beispiel: `{ Name1: Wert1, name2: Wert2, ... }` |
[Tabelle : 4. Rückgaben]

{#CSBScrUtil-getAll_GR__table_jsm_vpg_czb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var rtGR = new GlideRecord("sn_sb_con_remote_task");
    rtGR.setLimit(1);
    rtGR.query();  
    rtGR.next() 
    if (rtGR.isValidRecord()) {  
      var util = new sn_sb_con.CSBScratchpadUtil();
      util.update(rtGR, "name1", "value1"); 
      gs.info(JSON.stringify(util.getAll(rtGR))); 
    }

Ausgabe:

    { "name1": "value1" }

## CSBScratchpadUtil -- getNames(GlideRecord-AufgabenGR) {#ariaid-title4}

Gibt die Liste der Namen aller Scratchpad-Eigenschaften zurück, die dem angegebenen Aufgabendatensatz zugeordnet sind.
{#CSBScrUtil-getNames_GR__table_r5k_dqg_czb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| taskGR | GlideRecord | GlideRecord der aktiven Remote-Aufgabe oder Anbieteraufgabe, für die die Liste der Namen aller zugehörigen Scratchpad-Eigenschaften zurückgegeben werden soll. Tabelle: Remoteaufgabe \[sn_sb_con_remote_task\] und Anbieteraufgabe \[sn_sb_con_provider_task\] |
[Tabelle : 5. Parameter]

{#CSBScrUtil-getNames_GR__table_r5k_dqg_czb} {#CSBScrUtil-getNames_GR__table_s5k_dqg_czb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolgen-Array | Liste der Namen der Scratchpad-Eigenschaften, die dem angegebenen Aufgabendatensatz zugeordnet sind. |
[Tabelle : 6. Rückgaben]

{#CSBScrUtil-getNames_GR__table_s5k_dqg_czb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var rtGR = new GlideRecord("sn_sb_con_remote_task");
    rtGR.setLimit(1); 
    rtGR.query();  
    rtGR.next() 
    if (rtGR.isValidRecord()) {
      var util = new sn_sb_con.CSBScratchpadUtil();
      util.update(rtGR, "name1", "value1"); 
      gs.info(JSON.stringify(util.getNames(rtGR))); 
    }

Ausgabe:

    [ "name1" ]

## CSBScratchpadUtil -- populateClientScratchpadBR(GlideRecord taskGR) {#ariaid-title5}

Platziert die Scratchpad-Eigenschaften, die der angegebenen Remote-Aufgabe oder Anbieteraufgabe zugeordnet sind, im Client g_Scratchpad.
Sie können diese Methode über eine UI-Anzeige-Business-Regel aufrufen.
{#CSBScrUtil-popClientScratch_GR__table_ikg_qdb_fzb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| taskGR | GlideRecord | GlideRecord der aktiven Remote-Aufgabe oder Anbieteraufgabe, deren zugehörige Scratchpad-Einträge im Client g_Scratchpad platziert werden sollen. Tabellen: Remoteaufgabe \[sn_sb_con_remote_task\] und Anbieteraufgabe \[sn_sb_con_provider_task\] |
[Tabelle : 7. Parameter]

{#CSBScrUtil-popClientScratch_GR__table_ikg_qdb_fzb} {#CSBScrUtil-popClientScratch_GR__table_jkg_qdb_fzb__entry__2}

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

{#CSBScrUtil-popClientScratch_GR__table_jkg_qdb_fzb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    new sn_sb_con.CSBScratchpadUtil().populateClientScratchpadBR(current);

## CSBScratchpadUtil -- remove(GlideRecord-AufgabenGR, Zeichenfolgenname) {#ariaid-title6}

Löscht die angegebene Scratchpad-Eigenschaft aus der Scratchpad-Tabelle \[sn_sb_Scratchpad\].
Hinweis:  
Löschungen werden nicht mit anderen synchronisiert ServiceNowInstanzen. Scratchpad-Eigenschaften werden in einer angegebenen Anzahl von Tagen automatisch gelöscht, nachdem der zugehörige Aufgabendatensatz deaktiviert oder gelöscht wurde.
{#CSBScrUtil-remove_GR_S__table_x3b_nqg_czb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| taskGR | GlideRecord | GlideRecord der aktiven Remote-Aufgabe oder Anbieteraufgabe, die der angegebenen Scratchpad-Eigenschaft zugeordnet ist. Tabellen: Remoteaufgabe \[sn_sb_con_remote_task\] und Anbieteraufgabe \[sn_sb_con_provider_task\]. |
| name | Zeichenfolge | Name der Scratchpad-Eigenschaft, die aus der Scratchpad-Tabelle \[sn_sb_Scratchpad\] entfernt werden soll. |
[Tabelle : 9. Parameter]

{#CSBScrUtil-remove_GR_S__table_x3b_nqg_czb} {#CSBScrUtil-remove_GR_S__table_y3b_nqg_czb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 10. Rückgaben]

{#CSBScrUtil-remove_GR_S__table_y3b_nqg_czb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var rtGR = new GlideRecord("sn_sb_con_remote_task");
    rtGR.setLimit(1); 
    rtGR.query();  
    rtGR.next() 
    if (rtGR.isValidRecord()) {
      var util = new sn_sb_con.CSBScratchpadUtil();
      util.update(rtGR, "name1", "value1"); 
      util.remove(rtGR, "name1");
      gs.info(util.get(rtGR, "name1")); 
    }

Ausgabe:

    undefined

## CSBScratchpadUtil -- Update(GlideRecord-Aufgabe GR, Zeichenfolgenname, Zeichenfolgenwert, boolescher Wert „Client_Side_accessible") {#ariaid-title7}

Fügt eine Eigenschaft ein oder aktualisiert den Wert einer Eigenschaft in die Tabelle „scratchpad" \[sn_sb_Scratchpad\].
Hinweis:  
Die maximale Anzahl von Eigenschaften, die Sie in einem Aufruf aktualisieren können, beträgt 50.
{#CSBScrUtil-update_GR_S_S_B__table_z4p_4kg_czb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| taskGR | GlideRecord | GlideRecord der aktiven Remote-Aufgabe oder Anbieteraufgabe, die der angegebenen Scratchpad-Eigenschaft zugeordnet ist. Tabellen: Remoteaufgabe \[sn_sb_con_remote_task\] und Anbieteraufgabe \[sn_sb_con_provider_task\] |
| name | Zeichenfolge | Name einer neuen oder vorhandenen Scratchpad-Eigenschaft. Dieser Name muss für alle Scratchpad-Eigenschaften eindeutig sein. |
| Wert | Zeichenfolge | Wert der Scratchpad-Eigenschaft. Maximal 4000 Zeichen. |
| Client_Side_accessible | Boolean | Optional. Kennzeichnung, die angibt, ob diese Eigenschaft für die Client-Seite verfügbar ist G_Scratchpad Wann PopulateClientScratchpadBR Wird von einer Anzeige-Business-Regel aufgerufen. Gültige Werte: * Wahr: Eigenschaft ist verfügbar. * Falsch: Eigenschaft ist nicht verfügbar. Standard: Falsch |
[Tabelle : 11. Parameter]

{#CSBScrUtil-update_GR_S_S_B__table_z4p_4kg_czb} {#CSBScrUtil-update_GR_S_S_B__table_app_4kg_czb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 12. Rückgaben]

{#CSBScrUtil-update_GR_S_S_B__table_app_4kg_czb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var rtGR = new GlideRecord("sn_sb_con_remote_task");
    rtGR.setLimit(1); 
    rtGR.query();
    rtGR.next()
    if (rtGR.isValidRecord()) {
      var util = new sn_sb_con.CSBScratchpadUtil();
      util.update(rtGR, "name1", "value2");
      gs.info(util.get(rtGR, "name1")); 
    } 

Ausgabe:

    "value2"


