ServiceNow® Mit APIs können Sie anwenderdefinierte Anwendungen und Experiences erstellen. APIs wurden in erweitert und aktualisiert Zurich Release.
API-Hervorhebungen für Zurich Release
- Verwenden Sie serverseitige JavaScript-APIs in Skripts, um die Anwendungsfunktionalität zu ändern.
- Führen Sie Client-APIs aus, wenn ein clientbasiertes Ereignis auftritt, z. B. wenn ein Formular geladen wird, ein Formular übermittelt wird oder sich ein Feldwert ändert.
- Verwenden Sie eingehende REST APIs, um mit verschiedenen zu interagieren ServiceNow Funktionalitäten in Ihrer Anwendung.
- Client Next Experience-APIs enthalten Client-APIs, die mit der Next Experience-UI kompatibel sind.
Weitere Informationen finden Sie unter API implementation and reference.
Neu im Zurich-Release
Tabelle : 1. Neue bereichsbezogene Klassen und zusätzliche Methoden zu vorhandenen bereichsbezogenen Klassen in Zurich
| Klasse |
REST-Nachrichtenfunktionen |
| GlideCurrencyCode - Scoped, Global |
- GetCurrency-Code()
- GetNumericCurrency Code()
|
| GlideCurrencySymbol - Scoped, Global |
- GetCurrency-Symbol()
- GetSortedActiveCurrency Symbols()
|
| GlideRecord - Scoped |
AddUserQuery() |
| GlideSysAttachment - Scoped |
- AddAttribute()
- AddMultipleAttributes()
- DeleteAllAttributes()
- DeleteAttribute()
- FetchAllAttributes()
- FetchAttribute()
- UpdateAllAttributes()
- UpdateAttribute()
|
| GlideSystem - Scoped |
Unterstützung für zusätzliche Nachrichtentypen hinzugefügt, die oben in Formularen angezeigt werden sollen:
- AddHighMessage()
- AddLowMessage()
- AddSuccessMessage()
- AddModerateMessage()
|
Tabelle : 2. Neue globale Klassen und zusätzliche Methoden zu vorhandenen globalen Klassen in Zurich
| Klasse |
REST-Nachrichtenfunktionen |
| GlideRecord - Global |
AddUserQuery() |
| GlideSysAttachment - Global |
- AddAttribute()
- AddMultipleAttributes()
- DeleteAllAttributes()
- DeleteAttribute()
- FetchAllAttributes()
- FetchAttribute()
- UpdateAllAttributes()
- UpdateAttribute()
|
| GlideSystem - Global |
Unterstützung für zusätzliche Nachrichtentypen hinzugefügt, die oben in Formularen angezeigt werden sollen:
- AddHighMessage()
- AddLowMessage()
- AddModerateMessage()
- AddSuccessMessage()
|
| Message - Global |
Ruft lokalisierte Nachrichten aus der Tabelle „Nachricht“ [sys_ui_message] ab. Unterstützt Internationalisierung (i18n), indem Nachrichten dynamisch basierend auf der Sitzungssprache des Anwenders oder einem angegebenen Sprachparameter abgerufen werden.
- getMessage()
- GetMessageLang()
|
Tabelle : 3. Neue Clientklassen und zusätzliche Methoden zu vorhandenen Clientklassen in Zurich
| Klasse |
REST-Nachrichtenfunktionen |
| GlideForm (g_form) - Client |
- AddChoice()
- AddHighMessage()
- AddLowMessage()
- AddModerateMessage()
- AddSuccessMessage()
- ClearChoices()
- DisableChoice()
- EnableChoice()
- GetAnnotationByName()
- GetAnnotations()
- GetChoice()
- GetOptions()
- AusblendenAnnotation()
- AusblendenRelatedLinks()
- AusblendenTemplateBar()
- RemoveChoice()
- SetChoiceLabel()
- SetRelatedLinksDisplay()
- ShowAnnotation()
- ShowRelatedLinks()
- ShowTemplateBar()
- ToggleAnnotations()
|
| GlideModal (Next Experience) - Client |
- Vernichtung ()
- Get()
- GetId()
- GetPreference()
- GetPreferences()
- RenderWithContent (Objekt)
- RenderWithContent(Zeichenfolge)
- SetDialog()
- SetPreference()
- SetTitle()
- Typ ()
|
| GlideNavigation (Next Experience) - Client |
Aktualisierungsnavigator() |
| StopWatch (Next Experience) - Client |
- Stoppuhr ()
- GetTime()
- Neustart ()
- toString()
|
| GlideForm (Next Experience) - Client |
- AddChoice()
- AddHighMessage()
- AddLowMessage()
- AddModerateMessage()
- AddSuccessMessage()
- ClearChoices()
- DisableChoice()
- EnableChoice()
- GetAnnotationByName()
- GetAnnotations()
- GetChoice()
- GetOptions()
- AusblendenAnnotation()
- RemoveChoice()
- SetChoiceLabel()
- ShowAnnotation()
- ToggleAnnotations()
|
| GlideUser (Next Experience) - Client |
GetRoles() |
Tabelle : 4. Neue REST-APIs und zusätzliche Endpunkte zu vorhandenen REST-APIs in Zurich
| API |
Endpunkte |
| Conversation Member API |
- Now/Konversation/member/{user_ID}/Drop EINFÜGEN
- Now/Konversation/member/{user_ID}/Update EINFÜGEN
|
| Omnichannel Callback API |
- VERÖFFENTLICHEN SIE /api/sn_omni_callback/callback/attempt
- VERÖFFENTLICHEN SIE /api/sn_omni_Callback/Callback/create
- PATCH /api/sn_omni_Callback/Callback/Update
|
Tabelle : 5. Neue REST-APIs und zusätzliche Endpunkte zu vorhandenen REST-APIs in ServiceNow Store
| Anwendung |
App-Version |
API |
Endpunkte |
| Erweiterte Netzwerk-Inventarisierung |
10,0 |
DCIM Metric Data Feed API |
VERÖFFENTLICHEN SIE /api/sn_ni_adv/dcim/Feed/{vendorname} |
| Angebotsmanagement |
6.0.1 |
Quote Management API |
- LÖSCHEN SIE /sn_tmf_api/Quote_Management_api/Quote/{ID}
- RUFEN SIE /sn_tmf_api/Quote_Management_api/Quote AB
- RUFEN SIE /sn_tmf_api/Quote_Management_api/Quote/{ID} AB
- PATCH /sn_tmf_api/Quote_Management_api/Quote/{ID}
- VERÖFFENTLICHEN SIE /sn_tmf_api/Quote_Management_api/Quote
|
| Offene APIs für Telekommunikation |
4.1.1 |
Work Order Management API |
- BRECHEN SIE /sn_tmf_api/work_order_Management_api/cancelWorkOrder AB
- RUFEN SIE /sn_tmf_api/work_order_Management_api/workorderManagement AB
- RUFEN SIE /sn_tmf_api/work_order_Management_api/workorder/{ID} AB
- PATCH /sn_tmf_api/work_order_Management_api/Workorder/{ID}
- VERÖFFENTLICHEN SIE /sn_tmf_api/work_order_Management_api/workorder
|
Änderungen in diesem Release
Tabelle : 6. Bereichsbezogene Klassen in geändert Zurich
| Klasse |
REST-Nachrichtenfunktionen |
| GlideSysAttachment - Scoped |
Unterstützung für das Kopieren von Attributen aus Quellanhangsdatensätzen und das Löschen von Attributen mit Anhängen.
- Kopieren ()
- Kopieren(targetFieldName)
- CopyAttachmentsByFieldNames()
- DeleteAllAttachment()
- DeleteAttachment()
|
| IdentificationEngine - Scoped |
Aktivieren Sie referenceItemsEigenschaften der eingehenden Nutzlast, die ausgefüllt werden sollen, bevor ein CI anhand der für eine Klasse definierten IRE-Regeln identifiziert wird.
- CreateOrUpdateCI()
- CreateOrUpdateCIErweitert()
- IdentifyCIErweitert()
|
| ProducerV2 - Scoped |
Send(): Rückgabewert und Fehlerbehandlung wurden hinzugefügt. |
| RESTMessageV2 - Scoped, Global |
SetHttpMethod(): Unterstützung für HEAD-Methodenaufrufe über hinzugefügt methodParameter. |
Tabelle : 7. Globale Klassen in geändert Zurich
| Klasse |
REST-Nachrichtenfunktionen |
| GlideSysAttachment - Global |
Unterstützung für das Kopieren von Attributen aus Quellanhangsdatensätzen und das Löschen von Attributen mit Anhängen.
- Kopieren ()
- Kopieren(targetFieldName)
- CopyAttachmentsByFieldNames()
- DeleteAllAttachment()
- DeleteAttachment()
|
| IdentificationEngineScriptableApi - Global |
Aktivieren Sie referenceItemsEigenschaften der eingehenden Nutzlast, die ausgefüllt werden sollen, bevor ein CI anhand der für eine Klasse definierten IRE-Regeln identifiziert wird.
- CreateOrUpdateCI()
- CreateOrUpdateCIErweitert()
- IdentifyCIErweitert()
|
| RESTMessageV2 - Scoped, Global |
SetHttpMethod(): Unterstützung für HEAD-Methodenaufrufe über hinzugefügt methodParameter. |
Tabelle : 8. REST-APIs in geändert ServiceNow Store
| Anwendung |
App-Version |
API |
Endpunkte |
| Verarbeitung Von Kreditorenrechnungen |
V9.5.17 |
AP Invoice API |
Die folgenden Endpunkte unterstützen jetzt Anhänge:
- sn_spend_intg/ap_Invoice/JSON BUCHEN
- sn_spend_intg/ap_Invoice/xml BUCHEN
|
| Offene APIs für Telekommunikation |
V4.1.1 |
Service Order Open API |
Die folgenden Endpunkte unterstützen jetzt komplexe Servicekomponenten-Werttypen über die serviceOrderItem.service.serviceCharacteristic.valueTypeParameter:
- RUFEN SIE /sn_tmf_api/order/serviceOrder AB
- RUFEN SIE /sn_tmf_api/order/serviceOrder/{ID} AB
- PATCH /sn_tmf_api/order/serviceOrder/{ID}
- VERÖFFENTLICHEN SIE /sn_tmf_api/order/serviceOrder
|
| Offene APIs für Telekommunikation |
V4.1.1 |
Product Catalog Open API |
Die folgenden ProductSpecification-Endpunkte werden aktualisiert, um komplexe Produktspezifikationsmerkmalwerttypen über zu unterstützen productSpecCharacteristic.valueType Parameter:
- VERÖFFENTLICHEN SIE /sn_tmf_api/catalogManagement/ProductSpecification
- PATCH /sn_tmf_api/catalogManagement/ProductSpecification/{ID}
- RUFEN SIE /sn_tmf_api/catalogManagement/ProductSpecification/{ID} AB
- RUFEN SIE /sn_tmf_api/catalogManagement/ProductSpecification AB
|
| Offene APIs für Telekommunikation |
V4.1.1 |
Product Inventory Open API |
Die folgenden Endpunkte unterstützen jetzt komplexe Produktmerkmalwerttypen über die productCharacteristic.valueTypeParameter:
- RUFEN SIE /sn_prd_invt/Product AB
- RUFEN SIE /sn_prd_invt/Product/{ID} AB
- RUFEN SIE /sn_prd_invt/productInventory AB
- RUFEN SIE /sn_prd_invt/productInventory/{inventoryId} AB
- VERÖFFENTLICHEN SIE /sn_prd_invt/Product
- VERÖFFENTLICHEN SIE /sn_prd_invt/productInventory
|
| Offene APIs für Telekommunikation |
V4.1.1 |
Product Order Open API |
Die folgenden Endpunkte unterstützen jetzt komplexe Produktmerkmalwerttypen über die productOrderItem.product.productCharacteristic.valueTypeParameter:
- RUFEN SIE /sn_ind_tmt_orm/order/productOrder AB
- RUFEN SIE /sn_ind_tmt_orm/order/productOrder/{ID} AB
- RUFEN SIE /sn_ind_tmt_orm/productorder AB
- RUFEN SIE /sn_ind_tmt_orm/productorder/{ID} AB
- PATCH /sn_ind_tmt_orm/order/productOrder/{ID}
- PATCH /sn_ind_tmt_orm/productOrder/{ID}
- VERÖFFENTLICHEN SIE /sn_ind_tmt_orm/order/productOrder
- VERÖFFENTLICHEN SIE /sn_ind_tmt_orm/productOrder
|
| Virtual Agent-API |
V4.0.0 |
Virtual Agent Bot Integration API |
Neue Optionen für actionAnforderungstext-Parameter mit entsprechenden Beispielen. VERÖFFENTLICHEN SIE /sn_va_as_Service/bot/Integration |
Verwerfungen
- Die GlideEncrypter Die API unterstützt den Triple Data Encryption Standard (3DES) aufgrund von aktualisiert nicht mehr NIST 800-131A Rev. 2 Richtlinien.
- Für vorhandene Instanzen, die ein Upgrade auf durchführen Zurich Release, die GlideEncrypter API ist zur Verwendung verfügbar, wurde jedoch aktualisiert, um automatisch zu verwenden Key Management Framework Algorithmus. Siehe GlideEncrypter - Global (deprecated) Weitere Informationen dazu, wie Sie diese API weiterhin aufrufen.
- Für alle neuen Instanzen, die ab erstellt werden Zurich Release, die GlideEncrypter API wird nicht mehr unterstützt. Verwenden Sie direkt Key Management Framework Stattdessen für alle Kryptografievorgänge.
- Dynamische Gruppen wurden aus dem dynamischen Schema in der Core Platform entfernt. Für dynamische Attribute, die mit einer zugeordneten dynamischen Attributgruppe vor definiert sind Zurich Release, zwei Methoden, die ursprünglich für dynamische Attributgruppen entwickelt wurden, funktionieren weiterhin für die Abwärtskompatibilität.
Diese Methoden geben Null für migrierte Attribute und neu erstellte Attribute zurück.
Kunden werden dringend aufgefordert, zum aktuellen zu migrieren Dynamisches Attribut Definitionen, um zukünftige Verbesserungen an Funktionen und Funktionen zu nutzen. Migrationsdetails finden Sie unter Migrationsleitfaden für dynamisches Schema Zürich [KB2146133] artikel in der Now Support Knowledge Base.
Aktivierungsinformationen
Die folgenden APIs sind standardmäßig verfügbar:
- Identifikation und Abgleich
- IdentifikationEngine
- IdentificationEngineScriptableApi
- GlideCurrency-Code
- GlideCurrency-Symbol
- GlideForm (Next Experience)
- GlideModal (Next Experience)
- GlideNavigation (Next Experience)
- GlideRecord
- GlideSysAnhang
- GlideUser (Next Experience)
- Stoppuhr (Next Experience)
Die folgenden APIs erfordern die Plugin-Aktivierung:
- ProduktV2 Erfordert das Plugin „ServiceNow Stream Connect Installer“ (com.glide.hub.stream_connect.installer).
- Produktauftrag Offen Die API erfordert das Plugin „Auftragsmanagement für Telekommunikation“ (sn_ind_tmt_orm).
- Serviceauftrag Offen Die API erfordert das Plugin „Auftragsmanagement für Telekommunikation“ (sn_ind_tmt_orm).