Versionshinweise zur API .

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 5 Minuten Lesedauer

    • ServiceNow® Mit APIs können Sie anwenderdefinierte Anwendungen und Experiences erstellen. APIs wurden im Release Yokohama verbessert und aktualisiert.

    API-Highlights für das Release Yokohama .

    • 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 oder übermittelt wird oder wenn sich ein Feldwert ändert.
    • Verwenden Sie eingehende REST APIs für die Interaktion mit verschiedenen ServiceNow -Funktionalitäten in Ihrer Anwendung.

    Weitere Informationen finden Sie unter API implementation and reference.

    Neu im Release Yokohama

    Tabelle : 1. Neue bereichsbezogene Klassen und zusätzliche Methoden für vorhandene bereichsbezogene Klassen in Yokohama
    Klasse REST-Nachrichtenfunktionen
    Console - Scoped, Global
    • Fehler ()
    • Gruppe ()
    • groupCollapsedString ()
    • GruppenEnde ()
    • Info ()
    • Protokoll ()
    • Tabelle ()
    • Zeit ()
    • ZeitEnde ()
    • Zeitprotokoll ()
    • Ablaufverfolgung ()
    • Warnung ()
    Fetch - Scoped, Global abrufen ()
    Fetch Headers - Scoped, Global
    • Header ()
    • anfügen ()
    • Löschen ()
    • Einträge ()
    • forEach ()
    • abrufen ()
    • abrufenSetCookie()
    • hat ()
    • Schlüssel ()
    • Satz ()
    • Werte ()
    Fetch Request - Scoped, Global
    • Anforderung ()
    • arrayPuffer ()
    • Blob ()
    • Byte ()
    • Klon ()
    • Formulardaten ()
    • JSON ()
    • Text ()
    Fetch RequestInit - Scoped, Global AnforderungInit ()
    Fetch Response - Scoped,Global
    • arrayPuffer ()
    • Blob ()
    • Byte ()
    • Formulardaten ()
    • JSON ()
    • Text ()
    GlideUser - Scoped
    • abrufenTimeZoneLabel()
    • abrufenTimeZoneLabelLang ()
    OrderUtil - Scoped
    • abrufenStatusFromOrder()
    • istOrderInDraftState ()
    PDFGenerationAPI - Scoped, Global
    • konvertierenZuPDFAsynchron ()
    • konvertierenZuPDFMitKopfzeileFußzeileAsynchron ()
    ProcessMiningIntegrationAPI - Scoped
    • erstellenProjekt ()
    • Projekt löschen ()
    • abrufenAufgliederungsstatistiken()
    • abrufenErgebnisse()
    • abrufenMiningStatus()
    • abrufenProjekt ()
    • scheduleMining ()
    RESTMessageV2 - Scoped, Global festlegenZulässigeUmleitungURIs()
    SOAPMessageV2 - Scoped, Global
    • festlegenZulässigeUmleitungURIs()
    • festlegenFollowRedirect ()
    UriMatcher - Scoped
    • UriMatcher ()
    • Übereinstimmung ()
    UriMatcherResponse - Scoped
    • abrufenFehlermeldungen ()
    • isError ()
    • isFragmentMatches ()
    • istHostÜbereinstimmungen ()
    • isMatch ()
    • isPathMatches ()
    • isSchemeMatches ()
    v_record - Scoped, Global festlegenLetzteFehlermeldung()
    Tabelle : 2. Neue globale Klassen und zusätzliche Methoden für vorhandene globale Klassen in Yokohama
    Klasse REST-Nachrichtenfunktionen
    Console - Scoped, Global
    • Fehler ()
    • Gruppe ()
    • groupCollapsedString ()
    • GruppenEnde ()
    • Info ()
    • Protokoll ()
    • Tabelle ()
    • Zeit ()
    • ZeitEnde ()
    • Zeitprotokoll ()
    • Ablaufverfolgung ()
    • Warnung ()
    Fetch - Scoped, Global abrufen ()
    Fetch Headers - Scoped, Global
    • Header ()
    • anfügen ()
    • Löschen ()
    • Einträge ()
    • forEach ()
    • abrufen ()
    • abrufenSetCookie()
    • hat ()
    • Schlüssel ()
    • Satz ()
    • Werte ()
    Fetch Request - Scoped, Global
    • Anforderung ()
    • arrayPuffer ()
    • Blob ()
    • Byte ()
    • Klon ()
    • Formulardaten ()
    • JSON ()
    • Text ()
    Fetch RequestInit - Scoped, Global AnforderungInit ()
    Fetch Response - Scoped,Global
    • arrayPuffer ()
    • Blob ()
    • Byte ()
    • Formulardaten ()
    • JSON ()
    • Text ()
    GlideDynamicAttribute - Global
    • getSysId()
    • getName()
    • abrufenTyp()
    • abrufenGruppenName ()
    • getPfad ()
    • istTransient ()
    GlideDynamicAttributeStore - Global abrufenDynamischeAttribute()
    GlideElementDynamicAttributeStore - Global
    • abrufenDynamischeAttributeInSchema ()
    • abrufenDynamicAttributesInStore()
    GlideTransientDynamicAttribute - Global
    • getSysId()
    • getName()
    • abrufenTyp()
    • abrufenGruppenName ()
    • getPfad ()
    • istTransient ()
    GlideUser - Global
    • abrufenTimeZoneLabel()
    • abrufenTimeZoneLabelLang ()
    PDFGenerationAPI - Scoped, Global
    • konvertierenZuPDFAsynchron ()
    • konvertierenZuPDFMitKopfzeileFußzeileAsynchron ()
    • abrufenWährungscode ()
    • abrufenNumerischer Währungscode ()
    RESTMessageV2 - Scoped, Global festlegenZulässigeUmleitungURIs()
    SOAPMessageV2 - Scoped, Global
    • festlegenZulässigeUmleitungURIs()
    • festlegenFollowRedirect ()
    Tabelle : 3. Neue REST APIs und zusätzliche Endpunkte für vorhandene REST APIs in Yokohama
    API Endpunkte
    AWA Offer Work API POST /now/awa/documents/{document_table}/{document_sys_id}/offer
    Continuous Integration and Continuous Delivery (CICD) Update Set API
    • POST /sn_cicd/update_set/retrieve
    • POST /sn_cicd/update_set/commitMultiple
    • POST /sn_cicd/update_set/preview/{remote_update_set_id}
    • POST /sn_cicd/update_set/back_out
    • POST /sn_cicd/update_set/commit/{remote_update_set_id}
    • POST /sn_cicd/update_set/create
    Tabelle : 4. Neue bereichsbezogene Klassen und zusätzliche Methoden für vorhandene bereichsbezogene Klassen im ServiceNow Store
    Anwendung App-Version Klasse REST-Nachrichtenfunktionen
    Lead Management v3.0 LeadAPIHelperOOB - Scoped
    • abrufenJSONFromGR()
    • abrufenLeadsJSON()
    • abrufenTransformedLead ()
    Lead Management v3.0 LeadAPIProcessUtilOOB - Scoped
    • ProzessErstellenLead()
    • ProzessGetAllLeads()
    • ProzessGrtLeadById ()
    • ProzessUpdateLead ()
    Lead Management v3.0 LeadAPIValidationUtilOOB - Scoped
    • validLeadObjectForPatchCall ()
    • validLeadObjectForPostCall ()
    Auftragsmanagement v6.0 OrderGuide - Scoped istOrderInDraftState ()
    Tabelle : 5. Neue Client-Klassen und zusätzliche Methoden für vorhandene Client-Klassen in ServiceNow Store
    Anwendung App-Version Klasse REST-Nachrichtenfunktionen
    Kundenservice-Management v1.2 openFrameAPI - Client festlegenICContext()
    Tabelle : 6. Neue REST APIs und zusätzliche Endpunkte für vorhandene REST APIs im ServiceNow Store
    Anwendung App-Version API Endpunkte
    Accounts Payable Operations v8.0 AP Invoice API
    • POST /sn_spend_intg/ap_invoice/xml
    Erweitertes Produktmodell und Assetklassen v1.0 AI Assets API
    • /sn_ent/asset/ai_dataset/{sys_id} ABRUFEN
    • /sn_ent/asset/ai_model/{sys_id} ABRUFEN
    • /sn_ent/asset/ai_prompt/{sys_id} ABRUFEN
    • /sn_ent/asset/ai_system/{sys_id} ABRUFEN
    • POST /sn_ent/asset/ai_dataset
    • POST sn_ent/asset/ai_model
    • POST /sn_ent/asset/ai_prompt
    • POST /sn_ent/asset/ai_system
    • /sn_ent/asset/ai_dataset/{sys_id}
    • /sn_ent/asset/ai_model/{sys_id}
    • /sn_ent/asset/ai_prompt/{sys_id}
    • /sn_ent/asset/ai_system/{sys_id}
    Kundenverträge und Berechtigungen v6.0 Service Contract API
    • POST /sn_pss_core/servicecontract
    • /sn_pss_core/servicecontract/{id} ABRUFEN
    • POST /sn_pss_core/servicecontract/contractline
    • GET /sn_pss_core/servicecontract/contractline/{id}
    Kundenverträge und Berechtigungen v6.0 Verify Entitlements API GET /sn_ent_verify/verifyentitlements
    Lead Management v3.0 lead API
    • Rufen Sie /sn_lead_mgmt_core/lead ab
    • /sn_lead_mgmt_core/lead/{sys_id} ABRUFEN
    • PATCH /sn_lead_mgmt_core/lead/{sys_id}
    • POST /sn_lead_mgmt_core/lead
    Vertriebs- und Auftragsmanagement v4.0 Sales Agreement API
    • GET /sn_sales_agmt_core/salesagement /{id}
    • POST /sn_sales_agmt_core/salesagement

    Änderungen in diesem Release

    Tabelle : 7. Bereichsbezogene Klassen in geändert Yokohama
    Klasse REST-Nachrichtenfunktionen
    PDFGenerationAPI - Scoped, Global
    • konvertierenZuPDF()
    • konvertierenZuPDFMitKopfzeileFußzeile ()

    Die neuen Eigenschaften „glide.pdf.url.whitelisting.enabled“ und „com.snc.pdf.whitelisted_urls“ wurden hinzugefügt, um sicherzustellen, dass bereitgestellte externe URLs in der PDF-Ausgabe gerendert werden sollen.

    Für die Unterstützung der Barrierefreiheit in PDFs wurde die neue Eigenschaft „accessibilityEnabled“ hinzugefügt.
    Tabelle : 8. Globale Klassen in geändert Yokohama
    Klasse REST-Nachrichtenfunktionen
    PDFGenerationAPI - Scoped, Global
    • konvertierenZuPDF()
    • konvertierenZuPDFMitKopfzeileFußzeile ()

    Die neuen Eigenschaften „glide.pdf.url.whitelisting.enabled“ und „com.snc.pdf.whitelisted_urls“ wurden hinzugefügt, um sicherzustellen, dass bereitgestellte externe URLs in der PDF-Ausgabe gerendert werden sollen.

    Für die Unterstützung der Barrierefreiheit in PDFs wurde die neue Eigenschaft „accessibilityEnabled“ hinzugefügt.
    Tabelle : 9. geänderte REST APIs in Yokohama
    API Endpunkte
    Attachment API POST /now/attachment/file: Ein neuer Parameter, „creation_time“, kann zum Erfassen von Anhangserstellungszeiten verwendet werden, wenn Now Mobile-App offline ist und der Anhang zu einem späteren Zeitpunkt in einen Datensatz hochgeladen wird.
    Tabelle : 10. Bereichsbezogene Klassen in geändert ServiceNow Store
    Anwendung App-Version Klasse REST-Nachrichtenfunktionen
    Lead-to-Cash Core V1.4 LeadtoCashCore - Scoped Die Leistung der Commit-Instanz-API wurde verbessert, um die Nummerngenerierung für das Nummernfeld zu verbessern:
    • Wirkung (): Das Rückgabeobjekt _records_count wird hinzugefügt, um Details zu neu eingefügten Datensätzen für eine bestimmte Tabelle bereitzustellen, z. B. Tabellenname und Anzahl der eingefügten Datensätze.
    • commitInstance(): Der neue zusätzliche Parameter „useNumberGenerator“ wird hinzugefügt, um sys_ids optional zu generieren und auf neue Tabellendatensätze anzuwenden.
    Tabelle : 11. Client-Klassen in geändert ServiceNow Store
    Anwendung App-Version Klasse REST-Nachrichtenfunktionen
    Kundenservice-Management v1.2 openFrameAPI - Client subscribe(): neue Ereignisse hinzugefügt
    • openframe_wrap_up_submitted
    • openframe_ Heart_beat
    Tabelle : 12. Geänderte REST APIs in ServiceNow Store
    Anwendung App-Version API Endpunkte
    Accounts Payable Operations v8.0 AP Invoice API Fügen Sie Eigenschaften hinzu, die Rechnungsadresseninformationen unterstützen.
    • POST /sn_spend_intg/ap_invoice/cxml
    • POST /sn_spend_intg/ap_invoice/json

    Aktivierungsinformationen

    Die folgenden APIs sind standardmäßig verfügbar:
    • Anhang
    • Konsole
    • Abrufen
    • Abrufen.Header
    • Abrufen.Anforderung
    • Abrufen.Antwort
    • Abrufen.AnforderungInit
    • GlideDynamicAttribute
    • GlideDynamicAttributeStore
    • GlideElementDynamicAttributeStore
    • GlideTransientDynamicAttribute
    • GlideUser
    • openFrameAPI
    • PDFGenerationAPI
    • RESTMessageV2
    • ScriptableCurrencyCode
    • ScriptableUriMatcher
    • SOAPMessageV2
    • UriMatcher
    • UriMatcherResponse
    Die folgenden APIs erfordern eine Plugin-Aktivierung:
    • Für die KI-Asset-API muss das Plugin „Asset Classes“ (sn_ent) aktiviert sein.
    • Für die API für Kreditorenrechnungen muss das Plugin „Accounts Payable Invoice Processing“ (com.sn_ap_apm) aktiviert sein.
    • Für die AWA-Angebotsarbeits- API muss das Plugin „Erweiterte Arbeitszuweisung“ (com.glide.awa) aktiviert sein.
    • Für die Lead -API muss das Plugin „Lead Management Data Model“ (sn_lead_mgmt_core) aktiviert sein.
    • Für die openFrame -API muss das Plugin „com.sn_openframe_store“ aktiviert sein.
    • Für die OrderUtil -API (Skripteinbindung) muss das Plugin „Order Management“ (com.sn_ind_tmt_orm) aktiviert sein.
    • Für die ProcessMiningIntegrationAPI muss das Plugin „Process Mining Core“ (com.sn_process_optimization) aktiviert sein.
    • Für die Sales Agreement API müssen die folgenden Plugins aktiviert werden:
      • Vertriebsvereinbarungsdatenmodell (com.sn_sales_agmt_core)
      • Product Catalog Management Core (com.sn_prd_pm)
      • Preisgestaltung (com.sn_csm_pricing)
    • Für die Service Contract API müssen die folgenden Plugins aktiviert werden:
      • Kundenverträge und Berechtigungen (com.sn_pss_core)
      • Installationsbasisverwaltung für Kundenservice (com.snc.install)
      • Product Catalog Management Core (com.sn_prd)
    • Für die v_record- API muss das Plugin „Remote Tables“ (com.glide.script.vtable) aktiviert sein.
    • Für die Verify Entitlements API muss das Plugin „Entitlement Verification“ (com.sn_ent_verify) aktiviert sein.