PSBScratchpadUtil – Umfang

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

    • Die PSBScratchpadUtil Die API stellt Methoden bereit, mit denen Anbieter „zusätzliche“ Informationen freigeben können, die sich außerhalb anderer befinden Service Bridge Service mit ihren Verbrauchern.

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

    Um auf diese API zuzugreifen, die Service Bridge Die Anwendung „für Anbieter“ (sn_sb_pro) muss installiert sein. Diese API wird in ausgeführt sn_sb_pro Namespace.

    PSBScratchpadUtil – 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_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 : 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_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 taskGR)

    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.

    Tabellen: Remote-Aufgabe [sn_sb_pro_Remote_Task] und Anbieteraufgabe [sn_sb_pro_Provider_Task]
    Tabelle : 4. Rückgaben
    Typ Beschreibung
    Objekt Alle Eigenschaftsnamen und -Werte, die in der angegebenen Aufgabe enthalten sind. Im Formular:

    { Name1: Value1, name2: Value2, … }

    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)

    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.

    Tabellen: Remote-Aufgabe [sn_sb_pro_Remote_Task] und Anbieteraufgabe [sn_sb_pro_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_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)

    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_pro_Remote_Task] und Anbieteraufgabe [sn_sb_pro_Provider_Task]
    Tabelle : 8. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

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

    PSBScratchpadUtil – 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_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 : 10. Rückgaben
    Typ Beschreibung
    Keine

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

    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.

    Tabelle: Remote-Aufgabe [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 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_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"