ServiceNow
ServiceNow förbättrar servicenivåerna, ger anställda energi och gör det möjligt för företaget att arbeta med lightspeed. Skapa, läsa och uppdatera poster som lagras i ServiceNow, inklusive incidenter, frågor, användare med mera.
Den här anslutningsappen är tillgänglig i följande produkter och regioner:
| Tjänster | Class | Regioner |
|---|---|---|
| Copilot Studio | Premie | Alla Power Automate-regioner utom följande: – China Cloud drivs av 21Vianet |
| Logiska appar | Norm | Alla Logic Apps-regioner utom följande: - US Department of Defense (DoD) |
| Power Apps | Premie | Alla Power Apps-regioner utom följande: – China Cloud drivs av 21Vianet |
| Power Automate | Premie | Alla Power Automate-regioner utom följande: – China Cloud drivs av 21Vianet |
| Kontakt | |
|---|---|
| Namn | Microsoft |
| URL | https://learn.microsoft.com/connectors/service-now/ |
| Metadata för anslutningsprogram | |
|---|---|
| Utgivare | Microsoft |
| Webbplats | https://www.servicenow.com/ |
| Sekretesspolicy | https://www.servicenow.com/privacy-statement.html |
| Kategorier | Webbplats |
Anmärkning
Åtgärden Hämta kunskapsartiklar kan bara användas när plugin-programmet Kunskaps-API (sn_km_api) aktiveras.
Kända problem och begränsningar
När du använder åtgärden Skapa post går det inte att ange den fullständiga postbeskrivningen. Fältvärdet ignoreras på grund av Service-Now REST API-begränsningar.
Åtgärden Hämta poster kan returnera en "ogiltig tabell" eller ett annat fel i Power Apps. För Power Apps-implementeringar är det föreslagna arbetet att använda åtgärden Hämta poster i Power Automate och skicka tillbaka data till Power Apps.
Anslutningsappen stöder för närvarande endast instans-URL:er som slutar med "service-now.com". Om du använder alternativa domäner som "servicenowservices.com" kan det leda till anslutningsfel. I sådana fall, särskilt när du arbetar med en ny ServiceNow-domän i GCC, rekommenderas du att använda grundläggande autentisering.
Om det uppstår ett popup-fel med texten "Ogiltig redirect_uri" kopierar du den fullständiga URL:en från popup-fönstret och extraherar parametern redirect_uri (t.ex. redirect_uri=https%3a%2f%2ftip1-shared.consent.azure-apim.net%2fredirect). När du har avkodat URL:en (ersätter %3a med : och %2f med /) uppdaterar du fältet Omdirigerings-URL i ServiceNow-instansens OAuth-appregister enligt bilden nedan. Försök sedan att lägga till anslutningen igen.
Så här konfigurerar du en ServiceNow Power Platform-anslutning som använder Microsoft Entra-ID
Det finns två anslutningstyper:
Microsoft Entra ID OAuth med certifikat: Det här är en apptokenbaserad autentiseringstyp där ett program som är registrerat i Entra-ID kan användas för att komma åt ServiceNow genom att hämta en token med resursuppsättningen som ServiceNow-representantens Entra-ID-app.
Microsoft Entra ID OAuth med användarinloggning: Det här är en användartokenbaserad autentiseringstyp där slutanvändaren kan logga in på Entra ID 1P-programmet (ServiceNow Connector 1p App) och få en åtkomsttoken med omfånget inställt för ServiceNow-representantens Entra-ID-app.
Steg för att skapa en Microsoft Entra ID OAuth-anslutning med hjälp av certifikat
Steg 1: Registrera ett "Program A" i Microsoft Entra-ID för OIDC-integrering med ServiceNow. Det här är ServiceNow-representantens Entra-ID-program .
Gå till Appregistreringar > Ny registrering för att skapa en ny programregistrering
Namn: valfritt namn
Omdirigerings-URI: krävs inte
Lägg till
aud,emailochupni anspråken under "Valfria anspråk"
Steg 2: Registrera samma ID som en OIDC-provider i ServiceNow
Gå till för
System OAuth > Application Registry > New > Configure an OIDC provideratt verifiera ID-token- Namn: valfritt namn
-
Klient-ID: för
client ID"Program A" som skapades i steg 1 - Klienthemlighet: detta kommer inte att användas, vilket värde som helst kan anges
I registreringsformuläret för OIDC-provider lägger du till en ny OIDC-providerkonfiguration. Välj sökikonen mot fältet OAuth OIDC-providerkonfiguration för att öppna posterna för OIDC-konfigurationer och välj "Ny".
- OIDC-provider: Microsoft Entra-ID
-
URL för OIDC-metadata: URL:en måste vara i formuläret
https://login.microsoftonline.com/<tenantID>/.well-known/openid-configuration, ersättastenantIDmedDirectory (tenant) ID - Livslängd för OIDC-konfigurationscachen: 120
- Program: Globalt
- Användaranspråk: oid
- Användarfält: Användar-ID
- Aktivera JTI-anspråksverifiering: Inaktiverad
Välj "Skicka" och uppdatera OAuth OIDC-entitetsformuläret
Steg 3: Registrera ett "Program B" i Microsoft Entra-ID för anslutningsanvändning. Det här är programmet som spelar rollen för en användare med förhöjd behörighet i ServiceNow-instansen
Gå till för att
App registrations > New registrationskapa en ny app- Namn: valfritt namn
- I Certifikat och hemligheter laddar du upp .cer-filen för certifikatet I händelse av SNI-certifikat lägger du bara till
trustedCertificateSubjectsmanifestet för programmet med relevantauthorityIdochsubjectName
Steg 4: Skapa en systemanvändare i ServiceNow. Det här är "Program B" som användare i ServiceNow-instansen
Navigera till för att
User Administration > Usersskapa en ny användare- Användar-ID: Objekt-ID för tjänstens huvudnamn för "Program B" som skapades i steg 3
- Kontrollera
Web service access only
Steg 5: Anslut med anslutningsappen – Copilot Studio – Anslutningskonfiguration
Konfigurera anslutningsappen med följande information och anslut:
- Instansnamn: Instansnamnet för ServiceNow
- Klientorganisations-ID: Klient-ID för Microsoft Entra-klientorganisationen
- Klient-ID: Klient-ID för "Program B" som skapades i steg 3
- Resurs-URI: Klient-ID för "Program A" som skapades i steg 1 (inte program-URI)
- Klientcertifikathemlighet: PFX-filen för certifikatet som skapades i steg 3
- Certifikatlösenord: Lösenordet för .pfx-filen
Steg för att skapa Microsoft Entra ID OAuth-användarinloggning
Om du vill konfigurera en anslutning för OAuth-användarinloggning för Microsoft Entra-ID slutför du steg 1 och steg 2 enligt beskrivningen i avsnittet om certifikatautentisering ovan.
Steg 1 förblir detsamma. I steg 2 uppdaterar du användaranspråket till upn- eller anpassad anspråksegenskap från token (för andra identitetsprovidrar från tredje part än Entra) i ServiceNow. Användarfältet ska matcha servicenow-systemets användartabellfält som innehåller upn- eller användar-ID:t.
Steg 3 och 4 i avsnittet om certifikatautentisering ovan krävs inte. I stället är "Program B" i det här fallet en 1p-app som skapas för ServiceNow-anslutningsappen. Appen nedan måste beviljas behörigheter i "Program A".
"Program B"-ID: c26b24aa-7874-4e06-ad55-7d06b1f79b63
Viktigt!
I det här scenariot måste "Program B" använda ID c26b24aa-7874-4e06-ad55-7d06b1f79b63 som är en befintlig 1p-app som ägs av Microsoft, inte en användarskapad app (som krävs för att skapa en Microsoft Entra ID OAuth-anslutning med certifikat).
När du skapar anslutningen för ServiceNow-anslutningsappen måste användaren välja "Användarinloggning för Microsoft Entra-ID" som autentiseringstyp och behöver bara ange Namnet på ServiceNow-instansen och resurs-ID:t (som skulle vara identifieraren för "Program A"). Därefter tar inloggningsknappen användaren via Entra-ID-inloggningen med sitt eget konto.
Om du använder en identitetsprovider från tredje part eller om data matchar fel mellan användaren i Entra-ID och tabellen ServiceNow-användare
- Om det finns ett matchningsfel mellan användaridentifieraregenskapen i Entra-ID-token och värdet för användaridentifieraren som finns i tabellen ServiceNow
- Token innehåller till exempel det fullständiga upn -värdet (tillsammans med domän –
abc@contoso.com) och tabellen ServiceNow-användare innehåller endast användaridentifieraren (abc). Vi rekommenderar att du lägger till ett anpassat attribut till token som innehåller ett värde som matchar användaridentifieraren i ServiceNow-identifieraren genom att använda en formel och sedan använda den nya egenskapen för att utföra anspråksmappningen i steg 2. - Microsoft Learn-dokumentation som beskriver processen med att lägga till en ny anspråksegenskap: https://learn.microsoft.com/entra/external-id/customers/how-to-add-attributes-to-token
- Token innehåller till exempel det fullständiga upn -värdet (tillsammans med domän –
"Så här konfigurerar du en ServiceNow Power Platform-anslutning som använder Microsoft Entra-ID" referenser:
- External ID tokenautentisering (OIDC) för rest-API:er – support och felsökning
- ServiceNow Catalog Microsoft Graph-anslutningsprogram | Microsoft Learn
Skapa en anslutning
Anslutningsappen stöder följande autentiseringstyper:
| Grundläggande autentisering | Logga in med grundläggande autentisering | Alla regioner | Går inte att dela |
| Microsoft Entra ID OAuth med certifikat | OAuth med Microsoft Entra-ID med PFX-certifikat. | Endast POWERPLATFORM | Shareable |
| Användarinloggning för Microsoft Entra-ID | Logga in med autentiseringsuppgifter för Microsoft Entra-ID | Alla regioner | Går inte att dela |
| Använda Oauth2 | Logga in med Oauth2 | Alla regioner | Går inte att dela |
| Standard [INAKTUELL] | Det här alternativet är endast för äldre anslutningar utan en explicit autentiseringstyp och tillhandahålls endast för bakåtkompatibilitet. | Alla regioner | Går inte att dela |
Grundläggande autentisering
Autentiserings-ID: basicAuthentication
Tillämpligt: Alla regioner
Logga in med grundläggande autentisering
Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.
| Namn | Typ | Description | Krävs |
|---|---|---|---|
| Exempel | snöre | Namnet på instansen för service-now.com eller anpassad URL för migrerat konto | Sann |
| Användarnamn | snöre | Användarnamn för den här instansen | Sann |
| Lösenord | securestring | Lösenordet för det här kontot | Sann |
Microsoft Entra ID OAuth med certifikat
Autentiserings-ID: aadOAuthCert
Tillämpligt: ENDAST POWERPLATFORM
OAuth med Microsoft Entra-ID med PFX-certifikat.
Det här är en delningsbar anslutning. Om power-appen delas med en annan användare delas även anslutningen. Mer information finns i Översikt över anslutningsappar för arbetsyteappar – Power Apps | Microsoft Docs
| Namn | Typ | Description | Krävs |
|---|---|---|---|
| Instansnamn | snöre | Det instansnamn som används för att identifiera ServiceNow Site URl | Sann |
| Hyresgäst-ID | snöre | Sann | |
| Klient-ID | snöre | Sann | |
| Resurs-URI | snöre | Sann | |
| Klientcertifikathemlighet | klientcertifikat | Klientcertifikathemligheten som tillåts av det här programmet | Sann |
Användarinloggning för Microsoft Entra-ID
Autentiserings-ID: entraIDUserLogin
Tillämpligt: Alla regioner
Logga in med autentiseringsuppgifter för Microsoft Entra-ID
Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.
| Namn | Typ | Description | Krävs |
|---|---|---|---|
| Resurs-URI | snöre | Sann | |
| Instansnamn | snöre | Det instansnamn som används för att identifiera Url:en för ServiceNow-webbplatsen | Sann |
Använda Oauth2
Autentiserings-ID: oauth2ServiceNow
Tillämpligt: Alla regioner
Logga in med Oauth2
Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.
| Namn | Typ | Description | Krävs |
|---|---|---|---|
| Instansnamn | snöre | Det instansnamn som används för att identifiera ServiceNow Site URl | Sann |
| Klient-ID | snöre | Det ID som används för att identifiera det här programmet med tjänstleverantören | Sann |
| Klienthemlighet | securestring | Den delade hemligheten som används för att autentisera det här programmet med tjänstleverantören | Sann |
Standard [INAKTUELL]
Tillämpligt: Alla regioner
Det här alternativet är endast för äldre anslutningar utan en explicit autentiseringstyp och tillhandahålls endast för bakåtkompatibilitet.
Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.
| Namn | Typ | Description | Krävs |
|---|---|---|---|
| Exempel | snöre | Namnet på instansen för service-now.com eller anpassad URL för migrerat konto | Sann |
| Användarnamn | snöre | Användarnamn för den här instansen | Sann |
| Lösenord | securestring | Lösenordet för det här kontot | Sann |
Begränsningar för strypning
| Namn | Samtal | Förnyelseperioden |
|---|---|---|
| API-anrop per anslutning | 600 | 60 sekunder |
Åtgärder
| Hämta innehåll för bifogade filer (förhandsversion) |
Hämta innehåll för bifogade filer |
| Hämta kataloger |
Hämtar en lista över kataloger |
| Hämta katalogkategorier |
Hämtar en lista över kategorier för en specifik katalog |
| Hämta katalogobjekt |
Hämta ett specifikt katalogobjekt. |
| Hämta katalogobjekt |
Hämtar en lista över katalogobjekt baserat på de angivna parametrarna, till exempel en söktext eller en katalog. |
| Hämta kunskapsartiklar |
Returnerar en lista över kunskapsbasartiklar (KB) som kan sökas igenom och filtreras |
| Hämta metadata för bifogade filer (förhandsversion) |
Hämta metadata för bifogade filer |
| Hämta metadata för bifogade filer (förhandsversion) |
Hämta metadata för bifogade filer |
| Hämta post |
Hämtar en post för en ServiceNow-objekttyp som "Incidenter" |
| Hämta posttyper |
Visar en lista över tillgängliga posttyper |
| Ladda upp en bifogad fil med flera delar (förhandsversion) |
Ladda upp en bifogad fil från ett formulär med flera delar |
| Ladda upp en binär fil som en bifogad fil (förhandsversion) |
Laddar upp en binär fil som en bifogad fil till en angiven post |
| Lista poster |
Hämtar poster av en viss ServiceNow-objekttyp som "Incidenter" |
| Orderobjekt |
Beställer eller köper ett specifikt katalogobjekt. |
| Skapa post |
Skapa en post i en ServiceNow-tabell. |
| Ta bort en bifogad fil (förhandsversion) |
Ta bort en bifogad fil |
| Ta bort post |
Tar bort en post för en ServiceNow-objekttyp som "Incidenter" |
| Uppdatera post |
Uppdaterar en post för en ServiceNow-objekttyp som "Incidenter" |
Hämta innehåll för bifogade filer (förhandsversion)
Hämta innehåll för bifogade filer
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Sys-ID
|
sys_id | True | string |
Sys_id av den bifogade filen för att hämta innehåll för |
Hämta kataloger
Hämtar en lista över kataloger
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Limit
|
sysparm_limit | integer |
Antal kataloger som ska hämtas |
|
|
Söktext
|
sysparm_text | string |
Sök text för att filtrera kataloger efter namn eller beskrivning |
Returnerar
- Body
- GetCatalogsResponse
Hämta katalogkategorier
Hämtar en lista över kategorier för en specifik katalog
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Katalog-ID
|
catalogId | True | string |
ID:t för katalogen som kategorier ska hämtas för |
|
Limit
|
sysparm_limit | integer |
Antal katalogkategorier som ska hämtas |
|
|
Offset
|
sysparm_offset | integer |
Förskjutning för frågan |
Returnerar
Hämta katalogobjekt
Hämta ett specifikt katalogobjekt.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Objekt-ID
|
sys_id | True | string |
Sys_id av katalogobjektet som ska hämtas |
Returnerar
Hämta katalogobjekt
Hämtar en lista över katalogobjekt baserat på de angivna parametrarna, till exempel en söktext eller en katalog.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Kategori
|
sysparm_category | string |
Kategori-ID:t som objekt ska filtreras efter. Om det inte anges returneras alla objekt. |
|
|
Limit
|
sysparm_limit | True | integer |
Antal katalogobjekt som ska hämtas |
|
Söktext
|
sysparm_text | string |
Sök text för att filtrera objekt efter |
|
|
Catalog
|
sysparm_catalog | string |
Katalog-ID:t som objekt ska filtreras efter. Om det inte anges returneras objekt från alla kataloger |
Returnerar
Hämta kunskapsartiklar
Returnerar en lista över kunskapsbasartiklar (KB) som kan sökas igenom och filtreras
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Fields
|
fields | string |
Kommaavgränsad lista över fält från kunskapstabellen. |
|
|
Limit
|
limit | integer |
Maximalt antal poster som ska returneras. |
|
|
Query
|
query | True | string |
Text att söka efter. |
|
Filter
|
filter | string |
Kodad fråga som ska användas för att filtrera resultatuppsättningen. |
|
|
Kb
|
kb | string |
Kommaavgränsad lista över kunskapsbas sys_ids. |
Returnerar
- Body
- GetArticlesResponse
Hämta metadata för bifogade filer (förhandsversion)
Hämta metadata för bifogade filer
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Limit
|
sysparm_limit | string |
Gräns som ska tillämpas på sidnumrering. Obs! Ovanligt stora sysparm_limit värden kan påverka systemets prestanda. Standard: 1 000 |
|
|
Offset
|
sysparm_offset | string |
Antal poster som ska undantas från frågan. Använd den här parametern för att hämta fler poster än vad som anges i sysparm_limit. Om sysparm_limit till exempel är inställt på 500, men det finns ytterligare poster som du vill fråga efter, kan du ange ett sysparm_offset värde på 500 för att hämta den andra uppsättningen poster. Standard: 0 |
|
|
Query
|
sysparm_query | string |
Kodad fråga. Frågor för API:et för bifogade filer är relativa till tabellen Attachments [sys_attachment]. Exempel: (sysparm_query=file_name=attachment.doc) |
Hämta metadata för bifogade filer (förhandsversion)
Hämta metadata för bifogade filer
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
ID-nummer
|
sys_id | True | string |
Sys_id av den bifogade filen för att hämta metadata för |
Hämta post
Hämtar en post för en ServiceNow-objekttyp som "Incidenter"
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Posttyp
|
tableType | True | string |
Typ av post att lista |
|
System-ID
|
sysid | True | string |
System-ID för posten. |
|
Visa systemreferenser
|
sysparm_display_value | boolean |
Avgör om systemreferenser ska inkluderas |
|
|
Exkludera referenslänkar
|
sysparm_exclude_reference_link | boolean |
Avgör om referenslänkar ska undantas |
|
|
Fields
|
sysparm_fields | string |
Kommaavgränsad lista över fält som ska returneras. Exempel: namn, e-post, telefon |
Returnerar
Hämta posttyper
Ladda upp en bifogad fil med flera delar (förhandsversion)
Ladda upp en bifogad fil från ett formulär med flera delar
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Innehåll för bifogade filer
|
attachment_content | True | file |
Bifogad fil som ska laddas upp |
|
Tabellnamn
|
table_name | True | string |
Namnet på den tabell som du vill bifoga filen till. |
|
Tabell-ID
|
table_sys_id | True | string |
Sys_id av posten i den angivna tabellen som du vill bifoga filen till |
Returnerar
Ladda upp en binär fil som en bifogad fil (förhandsversion)
Laddar upp en binär fil som en bifogad fil till en angiven post
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Tabellnamn
|
table_name | True | string |
Namnet på den tabell som du vill bifoga filen till |
|
Sys-ID
|
table_sys_id | True | string |
Sys_id av posten i den angivna tabellen som du vill bifoga filen till |
|
Filnamn
|
file_name | True | string |
Namn för att ge den bifogade filen |
|
File
|
file | True | binary |
Binär fil som ska bifogas till den angivna posten |
Returnerar
Lista poster
Hämtar poster av en viss ServiceNow-objekttyp som "Incidenter"
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Posttyp
|
tableType | True | string |
Typ av post att lista |
|
Visa systemreferenser
|
sysparm_display_value | boolean |
Avgör om systemreferenser ska inkluderas |
|
|
Exkludera referenslänkar
|
sysparm_exclude_reference_link | boolean |
Avgör om referenslänkar ska undantas |
|
|
Query
|
sysparm_query | string |
Kodad fråga som används för att filtrera resultatuppsättningen. Exempel: active=true^ORDERBYnumber^ORDERBYDESCcategory |
|
|
Limit
|
sysparm_limit | integer |
Gräns som ska tillämpas på sidnumrering. Standardvärdet är 10000. |
|
|
Offset
|
sysparm_offset | integer |
Antal poster som ska undantas från frågan. |
|
|
Fields
|
sysparm_fields | string |
Kommaavgränsad lista över fält som ska returneras. Exempel: namn, e-post, telefon |
Returnerar
Orderobjekt
Beställer eller köper ett specifikt katalogobjekt.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Objekt-ID
|
sys_id | True | string |
Katalogobjektets sys_id att beställa |
|
Brödtext för orderobjekt
|
body | True | dynamic |
Brödtexten i begäran om orderobjekt. Den innehåller kvantiteten, användaren som begärdes för och eventuella ytterligare variabler som krävs av katalogobjektet |
Returnerar
- Body
- OrderItemResponse
Skapa post
Skapa en post i en ServiceNow-tabell.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Posttyp
|
tableType | True | string |
Typ av post att lista |
|
body
|
body | True | dynamic | |
|
Visa systemreferenser
|
sysparm_display_value | boolean |
Avgör om systemreferenser ska inkluderas |
|
|
Exkludera referenslänkar
|
sysparm_exclude_reference_link | boolean |
Avgör om referenslänkar ska undantas |
|
|
Fields
|
sysparm_fields | string |
Kommaavgränsad lista över fält som ska returneras. Exempel: namn, e-post, telefon |
Returnerar
Ta bort en bifogad fil (förhandsversion)
Ta bort en bifogad fil
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Sys-ID
|
sys_id | True | string |
Sys_id av den bifogade filen som ska tas bort |
Ta bort post
Tar bort en post för en ServiceNow-objekttyp som "Incidenter"
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Posttyp
|
tableType | True | string |
Typ av post att lista |
|
System-ID
|
sysid | True | string |
System-ID för posten. |
Uppdatera post
Uppdaterar en post för en ServiceNow-objekttyp som "Incidenter"
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Posttyp
|
tableType | True | string |
Typ av post att lista |
|
System-ID
|
sysid | True | string |
System-ID för posten. |
|
body
|
body | True | dynamic | |
|
Visa systemreferenser
|
sysparm_display_value | boolean |
Avgör om systemreferenser ska inkluderas |
|
|
Exkludera referenslänkar
|
sysparm_exclude_reference_link | boolean |
Avgör om referenslänkar ska undantas |
|
|
Fields
|
sysparm_fields | string |
Kommaavgränsad lista över fält som ska returneras. Exempel: namn, e-post, telefon |
Returnerar
Definitioner
UploadAttachmentResponse
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
average_image_color
|
result.average_image_color | string |
Om den bifogade filen är en bild, summan av alla färger. |
|
komprimerad
|
result.compressed | string |
Flagga som anger om den bifogade filen har komprimerats. |
|
content_type
|
result.content_type | string |
Innehållstyp för den associerade bifogade filen, till exempel bild eller jpeg eller program/x-shockwave-flash. |
|
created_by_name
|
result.created_by_name | string |
Fullständigt namn på entitet som ursprungligen skapade den bifogade filen. |
|
download_link
|
result.download_link | string |
Ladda ned URL:en för den bifogade filen på ServiceNow-instansen. |
|
filnamn
|
result.file_name | string |
Filnamnet på den bifogade filen. |
|
image_height
|
result.image_height | string |
Om en bildfil är bildens höjd. Enhet: Bildpunkter |
|
image_width
|
result.image_width | string |
Om en bildfil är bredden på bilden. Enhet: Bildpunkter |
|
size_bytes
|
result.size_bytes | string |
Storleken på den bifogade filen. Enhet: Byte |
|
size_compressed
|
result.size_compressed | string |
Storleken på den bifogade filen. Enhet: Byte |
|
sys_created_by
|
result.sys_created_by | string |
Entitet som ursprungligen skapade den bifogade filen. |
|
sys_created_on
|
result.sys_created_on | string |
Datum och tid då den bifogade filen ursprungligen sparades i instansen. |
|
sys_id
|
result.sys_id | string |
Sys_id av den bifogade filen. |
|
sys_mod_count
|
result.sys_mod_count | string |
Antal gånger som den bifogade filen har ändrats (laddats upp till instansen). |
|
sys_tags
|
result.sys_tags | string |
Alla systemtaggar som är associerade med den bifogade filen. |
|
sys_updated_by
|
result.sys_updated_by | string |
Alla systemtaggar som är associerade med den bifogade filen. |
|
sys_updated_on
|
result.sys_updated_on | string |
Datum och tid då den bifogade filen senast uppdaterades. |
|
table_name
|
result.table_name | string |
Namnet på den tabell som den bifogade filen är associerad med. |
|
table_sys_id
|
result.table_sys_id | string |
Sys_id av tabellen som är associerad med den bifogade filen. |
|
updated_by_name
|
result.updated_by_name | string |
Fullständigt namn på entitet som senast uppdaterade den bifogade filen. |
GetTypesResponse
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
resultat
|
result | array of object |
Resultatuppsättning för alla posttyper för den aktuella instansen. |
|
Visningsnamn
|
result.label | string |
Visningsnamn för posttypen. |
|
Värde
|
result.value | string |
Värdet för posttypen. |
GetCatalogsResponse
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
resultat
|
result | array of object | |
|
title
|
result.title | string | |
|
sys_id
|
result.sys_id | string | |
|
has_categories
|
result.has_categories | boolean | |
|
has_items
|
result.has_items | boolean | |
|
beskrivning
|
result.description | string | |
|
desktop_image
|
result.desktop_image | string |
GetCatalogCategoriesResponse
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
resultat
|
result | array of object | |
|
title
|
result.title | string | |
|
beskrivning
|
result.description | string | |
|
full_description
|
result.full_description | string | |
|
icon
|
result.icon | string | |
|
header_icon
|
result.header_icon | string | |
|
homepage_image
|
result.homepage_image | string | |
|
count
|
result.count | integer | |
|
underkategorier
|
result.subcategories | array of object | |
|
sys_id
|
result.subcategories.sys_id | string | |
|
title
|
result.subcategories.title | string | |
|
sys_id
|
result.sys_id | string |
GetCatalogItemsResponse
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
resultat
|
result | array of object | |
|
short_description
|
result.short_description | string | |
|
kb_article
|
result.kb_article | string | |
|
icon
|
result.icon | string | |
|
beskrivning
|
result.description | string | |
|
tillgänglighet
|
result.availability | string | |
|
mandatory_attachment
|
result.mandatory_attachment | boolean | |
|
request_method
|
result.request_method | string | |
|
type
|
result.type | string | |
|
visible_standalone
|
result.visible_standalone | boolean | |
|
local_currency
|
result.local_currency | string | |
|
sys_class_name
|
result.sys_class_name | string | |
|
sys_id
|
result.sys_id | string | |
|
content_type
|
result.content_type | string | |
|
pris
|
result.price | string | |
|
recurring_frequency
|
result.recurring_frequency | string | |
|
price_currency
|
result.price_currency | string | |
|
order
|
result.order | integer | |
|
make_item_non_conversational
|
result.make_item_non_conversational | boolean | |
|
owner
|
result.owner | string | |
|
show_price
|
result.show_price | boolean | |
|
recurring_price
|
result.recurring_price | string | |
|
show_quantity
|
result.show_quantity | boolean | |
|
bild
|
result.picture | string | |
|
URL
|
result.url | string | |
|
recurring_price_currency
|
result.recurring_price_currency | string | |
|
localized_price
|
result.localized_price | string | |
|
catalogs
|
result.catalogs | array of object | |
|
sys_id
|
result.catalogs.sys_id | string | |
|
active
|
result.catalogs.active | boolean | |
|
title
|
result.catalogs.title | string | |
|
name
|
result.name | string | |
|
localized_recurring_price
|
result.localized_recurring_price | string | |
|
show_wishlist
|
result.show_wishlist | boolean | |
|
sys_id
|
result.category.sys_id | string | |
|
title
|
result.category.title | string | |
|
turn_off_nowassist_conversation
|
result.turn_off_nowassist_conversation | boolean | |
|
show_delivery_time
|
result.show_delivery_time | boolean |
GetCatalogItemResponse
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
short_description
|
result.short_description | string |
short_description |
|
kb_article
|
result.kb_article | string |
kb_article |
|
icon
|
result.icon | string |
icon |
|
beskrivning
|
result.description | string |
beskrivning |
|
tillgänglighet
|
result.availability | string |
tillgänglighet |
|
mandatory_attachment
|
result.mandatory_attachment | boolean |
mandatory_attachment |
|
request_method
|
result.request_method | string |
request_method |
|
type
|
result.type | string |
type |
|
visible_standalone
|
result.visible_standalone | boolean |
visible_standalone |
|
sys_class_name
|
result.sys_class_name | string |
sys_class_name |
|
sys_id
|
result.sys_id | string |
sys_id |
|
content_type
|
result.content_type | string |
content_type |
|
order
|
result.order | integer |
order |
|
make_item_non_conversational
|
result.make_item_non_conversational | boolean |
make_item_non_conversational |
|
owner
|
result.owner | string |
owner |
|
show_price
|
result.show_price | boolean |
show_price |
|
show_quantity
|
result.show_quantity | boolean |
show_quantity |
|
bild
|
result.picture | string |
bild |
|
URL
|
result.url | string |
URL |
|
catalogs
|
result.catalogs | array of object |
catalogs |
|
sys_id
|
result.catalogs.sys_id | string |
sys_id |
|
active
|
result.catalogs.active | boolean |
active |
|
title
|
result.catalogs.title | string |
title |
|
name
|
result.name | string |
name |
|
show_wishlist
|
result.show_wishlist | boolean |
show_wishlist |
|
sys_id
|
result.category.sys_id | string |
sys_id |
|
title
|
result.category.title | string |
title |
|
turn_off_nowassist_conversation
|
result.turn_off_nowassist_conversation | boolean |
turn_off_nowassist_conversation |
|
show_delivery_time
|
result.show_delivery_time | boolean |
show_delivery_time |
|
categories
|
result.categories | array of object |
categories |
|
sys_id
|
result.categories.sys_id | string |
sys_id |
|
active
|
result.categories.active | boolean |
active |
|
sys_id
|
result.categories.category.sys_id | string |
sys_id |
|
active
|
result.categories.category.active | boolean |
active |
|
title
|
result.categories.category.title | string |
title |
|
title
|
result.categories.title | string |
title |
|
variables
|
result.variables | array of object |
variables |
|
ui_policy
|
result.ui_policy | array of |
ui_policy |
|
onChange
|
result.client_script.onChange | array of |
onChange |
|
onSubmit
|
result.client_script.onSubmit | array of |
onSubmit |
|
onLoad
|
result.client_script.onLoad | array of |
onLoad |
|
data_lookup
|
result.data_lookup | array of |
data_lookup |
|
variablesSchema
|
result.variablesSchema | object |
OrderItemResponse
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
sys_id
|
result.sys_id | string |
sys_id |
|
nummer
|
result.number | string |
nummer |
|
request_number
|
result.request_number | string |
request_number |
|
förfrågan_id
|
result.request_id | string |
förfrågan_id |
|
table
|
result.table | string |
table |
GetArticlesResponse
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
Räkna
|
meta.count | integer |
Antal tillgängliga KB-artiklar |
|
Sluta
|
meta.end | integer |
Slutindex för resultatuppsättningen |
|
Fields
|
meta.fields | string |
Fält i artikeln |
|
Filter
|
meta.filter | string |
Filter som används för att hämta data |
|
Kb
|
meta.kb | string |
Lista över kunskapsbasartikel sys_ids |
|
Language
|
meta.language | string |
Lista över kommaavgränsade språk i KB-artiklar som begärdes |
|
Query
|
meta.query | string |
Angiven begärandefråga |
|
Start
|
meta.start | string |
Startindex för resultatuppsättning |
|
Läge
|
meta.status.code | string |
Status för anropet |
|
Kb
|
meta.ts_query_id | string |
Lista över kommaavgränsade språk i KB-artiklar som begärdes |
|
Artiklar
|
articles | array of object | |
|
Visningsvärde
|
articles.fields.display_value | string |
Visningsvärde för det begärda fältet |
|
Etikett
|
articles.fields.label | string |
Etikett som representerar det begärda fältet |
|
Namn
|
articles.fields.name | string |
Namnet på det begärda fältet |
|
Typ
|
articles.fields.type | string |
Datatyp för begärt fält |
|
Värde
|
articles.fields.value | string |
Värdet för det begärda fältet |
|
Länk
|
articles.Link | string |
Länk till artikeln |
|
Id-nummer
|
articles.id | string |
Kunskapsartikel sys_id från kunskapstabellen [kb_knowledge] |
|
Nummer
|
articles.number | string |
Kunskapsartikel sys_id från kunskapstabellen [kb_knowledge] |
|
Rangordning
|
articles.rank | float |
Sök efter artikel som är specifik för den här sökningen |
|
Score
|
articles.score | float |
Relevanspoäng, resultat sorterade i fallande ordning efter poäng |
|
Utdrag
|
articles.snippet | string |
Text som visar en liten del av kunskapsartikeln |
|
Titel
|
articles.title | string |
Kort beskrivning eller rubrik för kunskapsartikeln |