sb: Bereichsbezogen, Global
Die SB Die Skripteinbindung bietet Methoden, mit denen Sie Vorgänge für ausführen können Service Bridge Konfigurationsdatensätze.
- Grundlagendaten-Synchronisierung
- Remote-Datensatzersteller (RRP)
- Remote-Aufgabendefinition (RTD)
- Auschecken: Erstellt eine Entwurfsversion eines angegebenen Konfigurationsdatensatzes. Jede veröffentlichte Version ist weiterhin für die Verwendung durch Kunden verfügbar.
- Veröffentlichen: Veröffentlicht die Entwurfsversion eines angegebenen Konfigurationsdatensatzes und stellt ihn für die Verwendung durch den Kunden bereit.
- Archivieren: Archiviert eine inaktive Version eines angegebenen Konfigurationsdatensatzes und macht ihn für Kunden nicht verfügbar.
- Stilllegen: Deaktiviert alle Versionen eines angegebenen Konfigurationsdatensatzes und macht sie für Kunden nicht verfügbar.
- Virtuelles Feld aktualisieren: Füllt virtuelle Felder in einer Aufgabentabelle in einer Zielinstanz aus, wenn verwendet wird Service Bridge Remote-Aufgaben.
Für zusätzliche Informationen zu Service Bridge Konfigurationsdatensätze, siehe Create configuration revisions.
Um auf diese API zuzugreifen, die Service Bridge Für Provider-Anwendung (sn_sb_pro) und die Service Bridge Basis-Plugins (sn_sb) müssen auf Ihrer Instanz installiert sein.
Sie rufen die Methoden in dieser API mit auf SB Skripteinbindung. Der Code für diese Methoden befindet sich jedoch im PSBPublicAPIUtil Skripteinbindung.
sb.checkout(glideRecord);
sb.publish(glideRecord);
sb.archive(glideRecord);
sb.retire(glideRecord);global.sb.checkout(glideRecord);
global.sb.publish(glideRecord);
global.sb.archive(glideRecord);
global.sb.retire(glideRecord);sb – Archive(glideRecord)
Validiert, dass der angegebene GlideRecord gültig ist Service Bridge Konfigurationsdatensatz und überprüft, ob sich der Datensatz im Status „inaktiv“ befindet. Wenn diese Validierung erfolgreich ist, wird der angegebene Konfigurationsdatensatz archiviert, sodass alle anderen Versionen desselben Konfigurationsdatensatzes unverändert bleiben.
Weitere Informationen zu Konfigurationsüberarbeitungen und den zugehörigen status finden Sie unter Create configuration revisions.
| Name | Typ | Beschreibung |
|---|---|---|
| glideRecord | GlideRecord | Zu archivierender Konfigurationsdatensatz. Dieser Datensatz kann einer der folgenden sein:
|
| Typ | Beschreibung |
|---|---|
| Boolean | Kennzeichnung, die angibt, ob der Konfigurationsdatensatz archiviert wurde. Mögliche Werte:
|
Das folgende Codebeispiel zeigt, wie diese Methode aus dem globalen Bereich in einem FDS-Konfigurationsdatensatz aufgerufen wird.
var grConfig = new GlideRecord('sn_fds_pro_offering’’'); // Configuration table that contains the desired record
grConfig.get('0ed11101ff6aca10c1befe258c4fd99e'); // Sys_id of the configuration record to publish
var isExecuted = sb.archive(grConfig);sb – zur Kasse (glideRecord)
Validiert, dass der angegebene GlideRecord gültig ist Service Bridge Konfigurationsdatensatz und überprüft, ob sich der Datensatz im Status „veröffentlicht“ befindet. Wenn diese Validierung erfolgreich ist, erstellt eine neue Version des angegebenen Konfigurationsdatensatzes und legt das Statusfeld auf „Entwurf“ fest.
| Name | Typ | Beschreibung |
|---|---|---|
| glideRecord | GlideRecord | Konfigurationsdatensatz, der ausgecheckt werden soll. Dieser Datensatz kann einer der folgenden sein:
|
| Typ | Beschreibung |
|---|---|
| GlideRecord | Wenn erfolgreich, wird der neu erstellte Konfigurationsdatensatz zurückgegeben, wobei das Statusfeld auf „Entwurf“ festgelegt ist. Wenn ein Fehler aufgetreten ist, gibt null zurück. |
Das folgende Codebeispiel zeigt, wie diese Methode aus dem globalen Bereich in einem RTD-Konfigurationsdatensatz aufgerufen wird.
var grConfig = new GlideRecord('sn_sb_pro_remote_task_def'); // Configuration table that contains the desired record
grConfig.get('0ed11101ff6aca10c1befe258c4fd99e'); // Sys_id of the configuration record to checkout
var checkoutGr = sb.checkout(grConfig);sb – veröffentlichen (glideRecord)
Validiert, dass der angegebene GlideRecord gültig ist Service Bridge Konfigurationsdatensatz und überprüft, ob sich der Datensatz im Status „Entwurf“ befindet. Wenn diese Validierung erfolgreich ist, wird die Entwurfsversion des Konfigurationsdatensatzes veröffentlicht.
| Name | Typ | Beschreibung |
|---|---|---|
| glideRecord | GlideRecord | Zu veröffentlichender Konfigurationsdatensatz. Dieser Datensatz kann einer der folgenden sein:
|
| Typ | Beschreibung |
|---|---|
| Boolean | Kennzeichnung, die angibt, ob der Konfigurationsdatensatz veröffentlicht wurde. Mögliche Werte:
|
Das folgende Codebeispiel zeigt, wie diese Methode aus dem globalen Bereich in einem RRP-Konfigurationsdatensatz aufgerufen wird.
var grConfig = new GlideRecord('sn_sb_pro_remote_record_producer’'); // Configuration table that contains the desired record
grConfig.get('0ed11101ff6aca10c1befe258c4fd99e'); // Sys_id of the configuration record to publish
var isExecuted = sb.publish(grConfig);sb – stilllegen(glideRecord)
Validiert, dass der angegebene GlideRecord gültig ist Service Bridge Konfigurationsdatensatz und überprüft, ob sich der Datensatz in einem gültigen Status befindet. Wenn diese Validierung erfolgreich ist, wird die angegebene Version des Konfigurationsdatensatzes zusammen mit allen anderen Überarbeitungen desselben Konfigurationsdatensatzes stillgelegt.
Weitere Informationen zu Konfigurationsüberarbeitungen und den zugehörigen status finden Sie unter Create configuration revisions.
| Name | Typ | Beschreibung |
|---|---|---|
| glideRecord | GlideRecord | Konfigurationsdatensatz, der stillgelegt werden soll. Dieser Datensatz kann einer der folgenden sein:
|
| Typ | Beschreibung |
|---|---|
| Boolean | Kennzeichnung, die angibt, ob der Konfigurationsdatensatz stillgelegt wurde. Mögliche Werte:
|
Das folgende Codebeispiel zeigt, wie diese Methode aus dem globalen Bereich in einem RTD-Konfigurationsdatensatz aufgerufen wird.
var grConfig = new GlideRecord('sn_sb_pro_remote_task_def'); // Configuration table that contains the desired record
grConfig.get('0ed11101ff6aca10c1befe258c4fd99e'); // Sys_id of the configuration record to checkout
var isExecuted = sb.retire(grConfig);sb – updateVirtualField (GlideRecord remoteTaskGr, Zeichenfolge virtualField, Zeichenfolge virtualValue, Zeichenfolge virtualDisplayValue)
Füllt virtuelle Felder in einer Aufgabentabelle in einer Zielinstanz aus, wenn verwendet wird Service Bridge Remote-Aufgaben.
Ein virtuelles Feld ist ein Feld, das in einer Zielaufgabentabelle vorhanden ist, aber nicht in der Quellaufgabentabelle vorhanden ist. Sie verwenden diese Methode, um die Werte für ein virtuelles Feld von der Quellinstanz an die Zielinstanz zu übergeben. Diese Methode speichert die angegebenen Werte für das virtuelle Feld als JSON im Formularabschnitt des angegebenen Remote-Aufgabe . Diese Remote-Aufgabe wird dann mit der Zielinstanz synchronisiert, in der die Werte im zugeordneten Feld in der Zielaufgabentabelle gespeichert werden.
Virtuelle Felder werden in Remote-Aufgabendefinitionen definiert. Remote-Aufgabendefinitionen enthalten eingehende und ausgehende Zuordnungstabellen, die Felder zwischen Aufgabentabellen in Quell- und Zielinstanzen zuordnen. Wenn eine Quelltabelle kein Feld enthält, das in einer Zieltabelle vorhanden ist, wird das Feld in der Remote-Aufgabendefinition als virtuelles Feld konfiguriert. Der Verbraucher kann dann entweder verwenden Service Bridge Transformationen oder diese Methode zum Aktualisieren der Werte dieser virtuellen Felder im zugehörigen Zielaufgabendatensatz.
- Der Anbieter erstellt eine Remote-Aufgabendefinition für die Anbieterfalltabelle und die Verbraucher-Incident-Tabelle.
- Auf der Eingehende Felder Registerkarte in Zugehörige Links Der Remote-Aufgabendefinition ordnet der Anbieter die Felder zwischen der Incident-Tabelle und der Falltabelle zu.Beim Definieren des Felds Betroffene Instanzen wählt der Anbieter aus Virtuell Kontrollkästchen und wählt dann aus Betroffene Instanzen Von Zielfeld Auf der Zielzuordnung Registerkarte.Hinweis:Beim Definieren eines virtuellen Felds wird kein Quellfeld definiert, da es nicht vorhanden ist.
- Der Anbieter veröffentlicht dann die Remote-Aufgabendefinition, die mit der Verbraucherinstanz synchronisiert wird.
- Der Verbraucher erstellt eine Remote-Aufgabe für die Incident-Tabelle. Eine JSON-Nutzlast, die alle Werte für die zugeordneten Felder enthält, einschließlich der Informationen zu virtuellen Feldern, ist in einem Formularabschnitt in der Remote-Aufgabe enthalten.
- Die Verbraucherinstanz ruft auf UpdateVirtualField() Methode, z. B. in einer Business-Regel, die ausgeführt wird, wenn Datensätze in der Incident-Tabelle aktualisiert werden, zum Festlegen der Werte des Felds Betroffene Instanzen in der Remote-Aufgabe.Hinweis:Obwohl Sie Daten in der Zieltabelle jederzeit ausfüllen können, müssen Pflichtfelder, die als virtuelle Felder konfiguriert sind, in der Remote-Aufgabe ausgefüllt werden, bevor die Remote-Aufgabe an die Erstellerinstanz gesendet wird.
- Die Remote-Aufgabe wird mit der Anbieterinstanz synchronisiert und erstellt einen Falldatensatz in der Anbieterinstanz.
Informationen zum Erstellen einer Remote-Aufgabendefinition finden Sie unter Create a remote task definition in Service Exchange for Providers.
Für Informationen zum Erstellen von Service Bridge Transformieren Sie, siehe Transform data with the Service Exchange transform framework.
| Name | Typ | Beschreibung |
|---|---|---|
| RemoteTaskGr | GlideRecord | GlideRecord-Objekt der Remote-Aufgabe, für die die angegebenen virtuellen Feldwerte festgelegt werden sollen. |
| Virtuelles Feld | Zeichenfolge | Feldname Des virtuellen Felds, für das die Zuordnungsinformationen aktualisiert werden sollen. Definiert auf Ausgehende Felder Registerkarte „Zugehörig“ der zugehörigen Remote-Aufgabendefinition. |
| Virtueller Wert | Zeichenfolge | Wert, der für dieses Feld in der Zielinstanz festgelegt werden soll. |
| VirtualDisplayValue | Zeichenfolge | Anzeigewert, der für dieses Feld in der Zielinstanz festgelegt werden soll |
| Typ | Beschreibung |
|---|---|
| Keine |
Das folgende Beispiel zeigt, wie diese Methode aufgerufen wird.
var remoteTaskGr = new GlideRecord("");
/** Remote Task table name,
** Table name vary based on which instance the script is being executed.
**/
remoteTaskGr.get(""); // Remote Task record sys_id
global.sb.updateVirtualField(remoteTaskGr,"<virtual outbound field name>", "<value to set on target field>", "<display value to set on target field>");