CSBScratchpadUtil – Umfang

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer

    • Die CSBScratchpadUtil Mit der API können Verbraucher „zusätzliche“ Informationen teilen, die sich außerhalb anderer befinden Service Bridge Service mit ihren Anbietern.

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

    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. Ersteller aktualisieren diese Informationen mit PSBScratchpadUtil – Umfang API.

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

    CSBScratchpadUtil – GET(GlideRecord-AufgabenGR, Zeichenfolgenname)

    Gibt den Wert einer angegebenen Scratchpad-Eigenschaft zurück.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    taskGR GlideRecord GlideRecord der aktiven Remote-Aufgabe oder Anbieteraufgabe, die der angegebenen Scratchpad-Eigenschaft zugeordnet ist.

    Tabellen: Remote-Aufgabe [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 : 2. Rückgaben
    Typ Beschreibung
    Zeichenfolge oder Null Wert der angeforderten Scratchpad-Eigenschaft. Null, wenn die Eigenschaft nicht gefunden wird.

    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)

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

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    taskGR GlideRecord GlideRecord der aktiven Remote-Aufgabe oder Anbieteraufgabe, deren zugehörige Scratchpad-Eigenschaften zurückgegeben werden sollen.

    Tabelle: Tabellen „Remote-Aufgabe“ [sn_sb_con_Remote_Task] und „Anbieteraufgabe“ [sn_sb_con_Provider_Task].
    Tabelle : 4. Rückgaben
    Typ Beschreibung
    Objekt Alle Eigenschaftsnamen und -Werte, die in der angegebenen Aufgabe enthalten sind.

    Zum Beispiel:

    { Name1: Value1, name2: Value2, … }

    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)

    Gibt die Liste der Namen aller Scratchpad-Eigenschaften zurück, die dem angegebenen Aufgabendatensatz zugeordnet sind.

    Tabelle : 5. Parameter
    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: Remote-Aufgabe [sn_sb_con_Remote_Task] und Anbieteraufgabe [sn_sb_con_Provider_Task]
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    Zeichenfolgen-Array Liste der Namen der Scratchpad-Eigenschaften, die dem angegebenen Aufgabendatensatz zugeordnet sind.

    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)

    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.

    Tabelle : 7. Parameter
    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: Remote-Aufgabe [sn_sb_con_Remote_Task] und Anbieteraufgabe [sn_sb_con_Provider_Task]
    Tabelle : 8. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

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

    CSBScratchpadUtil – remove(GlideRecord taskGR, Zeichenfolgenname)

    Löscht die angegebene Scratchpad-Eigenschaft aus der Tabelle „Scratchpad“ [sn_sb_Scratchpad].

    Hinweis:
    Löschvorgänge werden nicht mit anderen synchronisiert ServiceNow Instanzen. Scratchpad-Eigenschaften werden in einer angegebenen Anzahl von Tagen automatisch gelöscht, nachdem der zugehörige Aufgabendatensatz deaktiviert oder gelöscht wurde.
    Tabelle : 9. Parameter
    Name Typ Beschreibung
    taskGR GlideRecord GlideRecord der aktiven Remote-Aufgabe oder Anbieteraufgabe, die der angegebenen Scratchpad-Eigenschaft zugeordnet ist.

    Tabellen: Remote-Aufgabe [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 : 10. Rückgaben
    Typ Beschreibung
    Keine

    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-AufgabenGR, Zeichenfolgenname, Zeichenfolgenwert, boolescher Wert „Client_side_accessible“)

    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.
    Tabelle : 11. Parameter
    Name Typ Beschreibung
    taskGR GlideRecord GlideRecord der aktiven Remote-Aufgabe oder Anbieteraufgabe, die der angegebenen Scratchpad-Eigenschaft zugeordnet ist.

    Tabellen: Remote-Aufgabe [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 Wenn PopulateClientScratchpadBR Wird von einer Anzeige-Business-Regel aufgerufen.
    Gültige Werte:
    • Wahr: Eigenschaft ist verfügbar.
    • Falsch: Eigenschaft ist nicht verfügbar.

    Standardwert: false
    Tabelle : 12. Ergebnisse
    Typ Beschreibung
    Keine

    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"