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


---

# PSBScratchpadUtil -- Umfang

# PSBScratchpadUtil -- Umfang {#ariaid-title1}

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

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.

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. Verbraucher aktualisieren diese Informationen mit CSBScratchpadUtil API.

Um auf diese API zuzugreifen, die Service BridgeFür Provider muss die Anwendung (sn_sb_pro) installiert sein. Diese API wird in ausgeführt `sn_sb_pro `Namespace.

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

Gibt den Wert einer angegebenen Scratchpad-Eigenschaft zurück.
{#PSBScrUtil-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_pro_remote_task\] und Anbieteraufgabe \[sn_sb_pro_provider_task\] |
| name | Zeichenfolge | Name der Scratchpad-Eigenschaft, deren Wert abgerufen werden soll. Tabelle: scratchpad \[sn_sb_Scratchpad\] |
[Tabelle : 1. Parameter]

{#PSBScrUtil-get_GR_S__table_sm3_fpg_czb} {#PSBScrUtil-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]

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

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

Ausgabe:

    "value1"

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

Gibt die Eigenschaftsnamen und -Werte (Name-Wert-Paare) aller Scratchpad-Eigenschaften zurück, die der angegebenen Aufgabe zugeordnet sind.
{#PSBScrUtil-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. Tabellen: Remoteaufgabe \[sn_sb_pro_remote_task\] und Anbieteraufgabe \[sn_sb_pro_provider_task\] |
[Tabelle : 3. Parameter]

{#PSBScrUtil-getAll_GR__table_ism_vpg_czb} {#PSBScrUtil-getAll_GR__table_jsm_vpg_czb__entry__2}

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

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

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

Ausgabe:

    { "name1": "value1" }

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

Gibt die Liste der Namen aller Scratchpad-Eigenschaften zurück, die dem angegebenen Aufgabendatensatz zugeordnet sind.
{#PSBScrUtil-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. Tabellen: Remoteaufgabe \[sn_sb_pro_remote_task\] und Anbieteraufgabe \[sn_sb_pro_provider_task\] |
[Tabelle : 5. Parameter]

{#PSBScrUtil-getNames_GR__table_r5k_dqg_czb} {#PSBScrUtil-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]

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

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

Ausgabe:

    [ "name1" ]

## PSBScratchpadUtil -- 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.
{#PSBScrUtil-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_pro_remote_task\] und Anbieteraufgabe \[sn_sb_pro_provider_task\] |
[Tabelle : 7. Parameter]

{#PSBScrUtil-popClientScratch_GR__table_ikg_qdb_fzb} {#PSBScrUtil-popClientScratch_GR__table_jkg_qdb_fzb__entry__2}

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

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

    new sn_sb_pro.PSBScratchpadUtil().populateClientScratchpadBR(current);

## PSBScratchpadUtil -- remove(GlideRecord-Aufgabe GR, 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.
{#PSBScrUtil-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_pro_remote_task\] und Anbieteraufgabe \[sn_sb_pro_provider_task\] |
| name | Zeichenfolge | Name der Scratchpad-Eigenschaft, die aus der Scratchpad-Tabelle \[sn_sb_Scratchpad\] entfernt werden soll. |
[Tabelle : 9. Parameter]

{#PSBScrUtil-remove_GR_S__table_x3b_nqg_czb} {#PSBScrUtil-remove_GR_S__table_y3b_nqg_czb__entry__2}

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

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

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

Ausgabe:

    undefined

## PSBScratchpadUtil -- 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.
{#PSBScrUtil-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. Tabelle: Remoteaufgabe \[sn_sb_pro_remote_task\] und Anbieteraufgabe \[sn_sb_pro_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]

{#PSBScrUtil-update_GR_S_S_B__table_z4p_4kg_czb} {#PSBScrUtil-update_GR_S_S_B__table_app_4kg_czb__entry__2}

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

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

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

Ausgabe:

    "value2"


