ServiceNow

ServiceNow hizmet düzeylerini geliştirir, çalışanları enerjilendirir ve kuruluşunuzun lightspeed'de çalışmasını sağlar. Olaylar, Sorular, Kullanıcılar ve daha fazlası dahil olmak üzere ServiceNow'da depolanan kayıtları oluşturun, okuyun ve güncelleştirin.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet	Class	Bölgeler
Copilot Studio	Premium	Aşağıdakiler dışında tüm Power Automate bölgeleri :      - 21Vianet tarafından işletilen Çin Bulutu
Logic Apps	Standart	Aşağıdakiler dışında tüm Logic Apps bölgeleri :      - ABD Savunma Bakanlığı (DoD)
Power Apps	Premium	Aşağıdakiler dışında tüm Power Apps bölgeleri :      - 21Vianet tarafından işletilen Çin Bulutu
Power Automate	Premium	Aşağıdakiler dışında tüm Power Automate bölgeleri :      - 21Vianet tarafından işletilen Çin Bulutu

İletişim
İsim	Microsoft
URL	https://learn.microsoft.com/connectors/service-now/

Bağlayıcı Meta Verileri
Publisher	Microsoft
Web sitesi	https://www.servicenow.com/
Gizlilik ilkesi	https://www.servicenow.com/privacy-statement.html
Kategoriler	Web sitesi

Uyarı

Bilgi Bankası Makalelerini Al işlemi yalnızca Bilgi API'si (sn_km_api) eklentisi etkinleştirildiğinde kullanılabilir.

Bilinen Sorunlar ve Sınırlamalar

1. Kayıt Oluştur eylemi kullanılırken, tam kayıt açıklaması belirtilmesi mümkün değildir. Service-Now REST API sınırlamaları nedeniyle alan değeri yoksayılır.

2. Kayıtları Al eylemi Power Apps'te "Geçersiz Tablo" veya başka bir hata döndürebilir. Power Apps uygulamaları için önerilen çözüm, Power Automate'teki Kayıt Al eylemini kullanmak ve verileri Power Apps'e geri geçirmektir.

3. Bağlayıcı şu anda yalnızca "service-now.com" ile biten örnek URL'lerini destekler. "servicenowservices.com" gibi alternatif etki alanlarının kullanılması bağlantı hatalarına neden olabilir. Bu gibi durumlarda, özellikle GCC'de yeni ServiceNow etki alanıyla çalışırken Temel Kimlik Doğrulaması'nın kullanılması önerilir.

4. "Geçersiz redirect_uri" şeklinde bir açılır pencere hatasıyla karşılaşırsanız, açılan pencereden tam URL'yi kopyalayın ve redirect_uri parametresini ayıklayın (örneğin, redirect_uri=https%3a%2f%2ftip1-shared.consent.azure-apim.net%2fredirect). URL'nin kodunu çözdükten sonra (%3a ile değiştirdikten sonra ve %2f / ile değiştirdikten sonra, aşağıdaki görüntüde gösterildiği gibi ServiceNow örneğinizin OAuth uygulama kayıt defterindeki Yeniden Yönlendirme URL'si alanını güncelleştirin. Ardından bağlantıyı yeniden eklemeyi deneyin.

Microsoft Entra Id kullanan bir ServiceNow Power Platform bağlantısı ayarlama

İki bağlantı türü vardır:

1. Sertifika kullanarak Microsoft Entra Id OAuth: Bu, Entra Id'ye kayıtlı bir uygulamanın ServiceNow temsilcisi Entra ID uygulaması olarak ayarlanmış kaynakla bir belirteç alarak ServiceNow'a erişmek için kullanabildiği uygulama belirteci tabanlı bir kimlik doğrulama türüdür.

2. Kullanıcı Oturum Açma Bilgilerini Kullanarak Microsoft Entra Id OAuth: Bu, son kullanıcının Entra ID 1P uygulamasında (ServiceNow Connector 1p Uygulaması) oturum açabildiği ve ServiceNow temsilcisi Entra Id uygulaması için kapsam kümesine sahip bir erişim belirteci alabildiği kullanıcı belirteci tabanlı bir kimlik doğrulama türüdür.

Sertifika kullanarak Microsoft Entra ID OAuth bağlantısı oluşturma adımları

1. Adım: ServiceNow ile OIDC Tümleştirmesi için Microsoft Entra Id'ye bir "Uygulama A" kaydedin. Bu, ServiceNow temsilcisi Entra ID uygulamasıdır.

• Yeni uygulama kaydı oluşturmak için Uygulama kayıtları > Yeni kayıt'a gidin

  • Ad: tercihi olan herhangi bir ad

  • Yeniden yönlendirme URI'si: gerekli değil

• aud "İsteğe bağlı talepler" altındaki taleplere , ve email ekleyin upn

2. Adım: ServiceNow'da bir OIDC sağlayıcısıyla aynı kimliği kaydetme

• System OAuth > Application Registry > New > Configure an OIDC provider Kimlik belirteçlerini doğrulamak için adresine gidin

  • Ad: tercihi olan herhangi bir ad
  • İstemci Kimliği: client ID 1. Adımda oluşturulan "Uygulama A"
  • gizli dizi: bu aslında kullanılmaz, herhangi bir değer ayarlanabilir

• OIDC sağlayıcısı kayıt formunda yeni bir OIDC sağlayıcı yapılandırması ekleyin. OIDC yapılandırmalarının kayıtlarını açmak için OAuth OIDC Sağlayıcı Yapılandırması alanında arama simgesini seçin, "Yeni" seçeneğini belirleyin.

  • OIDC Sağlayıcısı: Microsoft Entra Id
  • OIDC Meta Veri URL'si: URL biçiminde https://login.microsoftonline.com/<tenantID>/.well-known/openid-configurationolmalıdır, yerine şunu yazın tenantID : Directory (tenant) ID
  • OIDC Yapılandırması Önbellek Ömrü: 120
  • Uygulama: Genel
  • Kullanıcı Talebi: oid
  • Kullanıcı Alanı: Kullanıcı Kimliği
  • JTI talep doğrulamasını etkinleştirme: Devre dışı

• "Gönder" seçeneğini belirleyin ve OAuth OIDC Varlığı formunu güncelleştirin

3. Adım: Bağlayıcı Kullanımı için Microsoft Entra Id'de bir "Uygulama B" kaydedin. Bu, ServiceNow örneğinde yükseltilmiş izinlere sahip bir kullanıcının rolünü üstlenen Uygulamadır

• Yeni uygulama oluşturmak için adresine Uygulama kayıtları > New registration gidin

  • Ad: tercihi olan herhangi bir ad
  • Sertifikalar ve gizli diziler bölümünde sertifikanın .cer dosyasını karşıya yükleyin SNI sertifikası olması durumunda, trustedCertificateSubjects ilgili authorityId vesubjectName

4. Adım: ServiceNow'da Sistem Kullanıcısı Oluşturma. Bu, ServiceNow örneğindeki bir kullanıcı olarak "Uygulama B"dir

• Yeni kullanıcı oluşturmak için adresine User Administration > Users gidin

  • Kullanıcı Kimliği: Adım 3'te oluşturulan "Uygulama B" hizmet sorumlusunun nesne kimliği
  • Web service access only kontrol et

5. Adım: Bağlayıcı kullanarak bağlanma – Copilot Studio – Bağlayıcı yapılandırması

• Bağlayıcıyı aşağıdaki bilgilerle yapılandırın ve bağlanın:

  • Örnek Adı: ServiceNow'un örnek adı
  • Kiracı Kimliği: Microsoft Entra kiracısının kiracı kimliği
  • İstemci Kimliği: Adım 3'te oluşturulan "Uygulama B" istemci kimliği
  • Kaynak URI'si: 1. Adımda oluşturulan "Uygulama A" istemci kimliği (Uygulama URI'si değil )
  • İstemci Sertifikası Gizli Anahtarı: 3. Adımda oluşturulan sertifikanın .pfx dosyası
  • Sertifika Parolası: .pfx dosyasının parolası

Microsoft Entra Id OAuth Kullanıcı oturum açma bilgilerini oluşturma adımları

Microsoft Entra ID OAuth Kullanıcı Oturum Açma bağlantısını yapılandırmak için lütfen yukarıdaki sertifika kimlik doğrulaması bölümünde açıklandığı gibi 1. ve 2. Adımı tamamlayın.

1. adım aynı kalır. 2. Adımda, ServiceNow'daki belirteçten (Entra dışındaki üçüncü taraf kimlik sağlayıcıları için) kullanıcı talebi upn veya özel talep özelliğine güncelleştirin. Kullanıcı alanı, upn veya kullanıcı kimliğini içeren ServiceNow sistem kullanıcı tablosu alanıyla eşleşmelidir.

Yukarıdaki sertifika kimlik doğrulaması bölümünde yer alan 3. ve 4. adımlar gerekli değildir. Bunun yerine, bu durumda "Uygulama B", ServiceNow bağlayıcısı için oluşturulan bir 1p Uygulamasıdır. Aşağıdaki uygulamaya "Uygulama A" içinde izin verilmesi gerekir.

"Uygulama B" Kimliği: c26b24aa-7874-4e06-ad55-7d06b1f79b63

Önemli

Bu senaryoda "Uygulama B", kullanıcı tarafından oluşturulan bir uygulama değil Microsoft'un sahip olduğu önceden var olan bir 1p Uygulaması olan kimliği c26b24aa-7874-4e06-ad55-7d06b1f79b63 kullanmalıdır (Sertifika kullanarak Microsoft Entra ID OAuth bağlantısı oluşturmak için gereklidir).

ServiceNow bağlayıcısı için bağlantı oluşturulurken, kullanıcının kimlik doğrulama türü olarak "Microsoft Entra ID User Login" öğesini seçmesi ve yalnızca ServiceNow Örneği adını ve kaynak kimliğini ("Uygulama A" tanımlayıcısı olacaktır) sağlaması gerekir. Bundan sonra oturum açma düğmesi, kullanıcıyı kendi hesabını kullanarak Entra ID oturum açma bilgileri aracılığıyla alır.

Üçüncü Taraf kimlik sağlayıcısının kullanılması veya Entra Id ile ServiceNow kullanıcıları tablosundaki kullanıcı arasında var olan veri uyuşmazlıkları

• Entra Id belirtecindeki kullanıcı tanımlayıcı özelliği ile ServiceNow tablosundaki kullanıcı tanımlayıcısı değeri arasında bir uyuşmazlık varsa
  • Örneğin, belirteç tam upn değerini (etki alanı – abc@contoso.comile birlikte) ve ServiceNow kullanıcıları tablosu yalnızca kullanıcı tanımlayıcısını (abc) içerir. Bir formül uygulayarak ve ardından 2. Adımda talep eşlemesini yapmak için bu yeni özelliği kullanarak ServiceNow tanımlayıcısında kullanıcı tanımlayıcısı ile eşleşen bir değer içeren belirteci özel bir öznitelik eklemeniz önerilir.
  • Yeni talep özelliği ekleme işlemini açıklayan Microsoft Learn Belgeleri: https://learn.microsoft.com/entra/external-id/customers/how-to-add-attributes-to-token

"Microsoft Entra Id kullanan bir ServiceNow Power Platform bağlantısı kurma" başvuruları:

• Rest API'leri için Dış Kimlik Belirteç Kimlik Doğrulaması (OIDC) - Destek ve Sorun Giderme
• ServiceNow Kataloğu Microsoft Graph bağlayıcısı | Microsoft Learn

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:

Temel Kimlik Doğrulaması	Temel kimlik doğrulamasını kullanarak oturum açma	Tüm bölgeler	Paylaşılamaz
Sertifika kullanarak Microsoft Entra ID OAuth	PFX sertifikası kullanarak Microsoft Entra Id ile OAuth.	Yalnızca POWERPLATFORM	Paylaşılabilir
Microsoft Entra Id Kullanıcı Oturum Açma	Microsoft Entra Id Kimlik Bilgileri ile oturum açma	Tüm bölgeler	Paylaşılamaz
Oauth2 kullanma	Oauth2 ile oturum açma	Tüm bölgeler	Paylaşılamaz
Varsayılan [KULLANIM DIŞI]	Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır.	Tüm bölgeler	Paylaşılamaz

Temel Kimlik Doğrulaması

Kimlik Doğrulama Kimliği: basicAuthentication

Geçerli: Tüm bölgeler

Temel kimlik doğrulamasını kullanarak oturum açma

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim	Türü	Description	Gerekli
Örnek	String	service-now.com örneğinin adı veya geçirilen hesap için özel URL	Doğru
Kullanıcı adı	String	Bu örneğin kullanıcı adı	Doğru
Şifre	securestring	Bu hesabın parolası	Doğru

Sertifika kullanarak OAuth kimliğini Microsoft Entra

Kimlik Doğrulama Kimliği: aadOAuthCert

Uygulanabilir: yalnızca POWERPLATFORM

PFX sertifikası kullanarak Microsoft Entra Id ile OAuth.

Bu, paylaşılabilir bir bağlantıdır. Power app başka bir kullanıcıyla paylaşılıyorsa, bağlantı da paylaşılır. Daha fazla bilgi için bkz . Tuval uygulamaları için bağlayıcılara genel bakış - Power Apps | Microsoft Docs

İsim	Türü	Description	Gerekli
Örnek Adı	String	ServiceNow Site URl'sini tanımlamak için kullanılan örnek adı	Doğru
Kiracı Kimliği	String		Doğru
Müşteri Kimliği	String		Doğru
Kaynak URI	String		Doğru
İstemci sertifikası gizli dizisi	istemci sertifikası	Bu uygulama tarafından izin verilen istemci sertifikası gizli dizisi	Doğru

Microsoft Entra Id Kullanıcı Oturum Açma

Kimlik Doğrulama Kimliği: entraIDUserLogin

Geçerli: Tüm bölgeler

Microsoft Entra Id Kimlik Bilgileri ile oturum açma

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim	Türü	Description	Gerekli
Kaynak URI	String		Doğru
Örnek Adı	String	ServiceNow Sitesi URL'sini tanımlamak için kullanılan örnek adı	Doğru

Oauth2 kullanma

Kimlik Doğrulama Kimliği: oauth2ServiceNow

Geçerli: Tüm bölgeler

Oauth2 ile oturum açma

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim	Türü	Description	Gerekli
Örnek Adı	String	ServiceNow Site URl'sini tanımlamak için kullanılan örnek adı	Doğru
İstemci Kimliği	String	Bu uygulamayı hizmet sağlayıcısıyla tanımlamak için kullanılan kimlik	Doğru
İstemci gizliliği	securestring	Hizmet sağlayıcısıyla bu uygulamanın kimliğini doğrulamak için kullanılan paylaşılan gizli dizi	Doğru

Varsayılan [KULLANIM DIŞI]

Geçerli: Tüm bölgeler

Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim	Türü	Description	Gerekli
Örnek	String	service-now.com örneğinin adı veya geçirilen hesap için özel URL	Doğru
Kullanıcı adı	String	Bu örneğin kullanıcı adı	Doğru
Şifre	securestring	Bu hesabın parolası	Doğru

Azaltma Sınırları

Name	Çağrılar	Yenileme Dönemi
Bağlantı başına API çağrıları	600	60 saniye

Eylemler

Bilgi Bankası Makalelerini Edinin	Aranabilen ve filtrelenebilen bilgi bankası (KB) makalelerinin listesini döndürür
Bilgi Edinin Makalesi	Bilgi Bankası Makalelerini Al arama uç noktası tarafından döndürülmeyen şablon/Knowledge-Block bölümü içeriği de dahil olmak üzere tek bir bilgi bankası (KB) makalesinin tam içeriğini döndürür.
Ek içeriğini alma	Ek içeriğini alma
Ek Meta Verilerini Alma	Ekler için meta verileri alma
Ek meta verilerini alma	Ek meta verilerini alma
Eki silme	Eki silme
İkili dosyayı ek olarak karşıya yükleme	İkili dosyayı belirtilen kayda ek olarak yükler
Katalog kategorilerini alma	Belirli bir katalog için kategorilerin listesini alır
Katalog öğelerini alma	Arama metni veya katalog gibi belirtilen parametrelere göre katalog öğelerinin listesini alır.
Katalog öğesini alma	Belirli bir katalog öğesini alma.
Katalogları alma	Katalog listesini alır
Kaydı Güncelleştir	'Incidents' gibi bir ServiceNow nesne türü için kaydı güncelleştirir
Kaydı Sil	ServiceNow nesne türü için 'Incidents' gibi bir kaydı siler
Kayıt Al	'Incidents' gibi bir ServiceNow nesne türü için kayıt alır
Kayıt Oluştur	ServiceNow tablosunda kayıt oluşturun.
Kayıt Türlerini Al	Kullanılabilir kayıt türlerini listeler
Kayıtları Listele	'Incidents' gibi belirli bir ServiceNow nesne türünün kayıtlarını alır
Sipariş öğesi	Belirli bir katalog öğesini sipariş eder veya satın alır.
Çok bölümlü dosya eklerini karşıya yükleme	Çok parçalı bir formdan ek yükleme

Bilgi Bankası Makalelerini Edinin

İşlem Kimliği:

GetKnowledgeArticles

Aranabilen ve filtrelenebilen bilgi bankası (KB) makalelerinin listesini döndürür

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Fields	fields		string	Bilgi tablosundaki alanların virgülle ayrılmış listesi.
Sınır	limit		integer	Döndürülecek en fazla kayıt sayısı.
Query	query	True	string	Aranacak metin.
Filter	filter		string	Sonuç kümesini filtrelemek için kullanılacak kodlanmış sorgu.
KB	kb		string	Bilgi bankası sys_ids virgülle ayrılmış listesi.

Döndürülenler

Body

GetArticlesResponse

Bilgi Edinin Makalesi

İşlem Kimliği:

GetKnowledgeArticle

Bilgi Bankası Makalelerini Al arama uç noktası tarafından döndürülmeyen şablon/Knowledge-Block bölümü içeriği de dahil olmak üzere tek bir bilgi bankası (KB) makalesinin tam içeriğini döndürür.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Makale Sys Kimliği	articleSysId	True	string	Alınacak bilgi bankası makalesinin sys_id veya KB numarası.
Fields	fields		string	Döndürülecek Bilgi tablosundaki alanların virgülle ayrılmış listesi.
Language	language		string	Döndürülecek KB makalesinin dillerin virgülle ayrılmış listesi.

Döndürülenler

Body

GetArticleResponse

Ek içeriğini alma

İşlem Kimliği:

RetrieveAttachmentContent

Ek içeriğini alma

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Sys Kimliği	sys_id	True	string	İçerik alınacak ekin Sys_id

Ek Meta Verilerini Alma

İşlem Kimliği:

GetAttachmentMetdata

Ekler için meta verileri alma

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Sınır	sysparm_limit		string	Sayfalandırmaya uygulanacak sınır. Not: Olağan dışı büyük sysparm_limit değerleri sistem performansını etkileyebilir. Varsayılan: 1000
Ofset baskı	sysparm_offset		string	Sorgunun dışında tutulacak kayıt sayısı. sysparm_limit belirtilenden daha fazla kayıt almak için bu parametreyi kullanın. Örneğin, sysparm_limit 500 olarak ayarlanmışsa ancak sorgulamak istediğiniz başka kayıtlar varsa, ikinci kayıt kümesini almak için 500 sysparm_offset değeri belirtebilirsiniz. Varsayılan: 0
Query	sysparm_query		string	Kodlanmış sorgu. Ek API'sinin sorguları Ekler [sys_attachment] tablosuna göredir. Örneğin: (sysparm_query=file_name=attachment.doc)

Ek meta verilerini alma

İşlem Kimliği:

RetrieveAttachmentMetadata

Ek meta verilerini alma

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kimlik	sys_id	True	string	Meta verileri alınacak ekin Sys_id

Eki silme

İşlem Kimliği:

DeleteAttachment

Eki silme

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Sys Kimliği	sys_id	True	string	Silinecek ekin Sys_id

İkili dosyayı ek olarak karşıya yükleme

İşlem Kimliği:

UploadAttachmentFile

İkili dosyayı belirtilen kayda ek olarak yükler

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Tablo Adı	table_name	True	string	Dosyayı eklemek istediğiniz tablonun adı
Sys Kimliği	table_sys_id	True	string	Dosyayı eklemek istediğiniz belirtilen tablodaki kaydın Sys_id
Dosya Adı	file_name	True	string	Eki vermek için ad
Dosya	file	True	binary	Belirtilen kayda eklenecek ikili dosya

Döndürülenler

Body

UploadAttachmentResponse

Katalog kategorilerini alma

İşlem Kimliği:

GetCatalogCategories

Belirli bir katalog için kategorilerin listesini alır

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Katalog Kimliği	catalogId	True	string	Kategorilerin alındığı kataloğun kimliği
Sınır	sysparm_limit		integer	Alınacak katalog kategorisi sayısı
Ofset baskı	sysparm_offset		integer	Sorgu için uzaklık

Döndürülenler

Body

GetCatalogCategoriesResponse

Katalog öğelerini alma

İşlem Kimliği:

GetCatalogItems

Arama metni veya katalog gibi belirtilen parametrelere göre katalog öğelerinin listesini alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kategori	sysparm_category		string	Öğeleri filtrelemek için kategori kimliği. Belirtilmezse, tüm öğeler döndürülür.
Sınır	sysparm_limit	True	integer	Alınacak katalog öğelerinin sayısı
Metin Ara	sysparm_text		string	Öğeleri filtrelemek için metin arama
Catalog	sysparm_catalog		string	Öğeleri filtrelemek için katalog kimliği. Belirtilmezse, tüm kataloglardan öğeler döndürülür

Döndürülenler

Body

GetCatalogItemsResponse

Katalog öğesini alma

İşlem Kimliği:

GetCatalogItem

Belirli bir katalog öğesini alma.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Öğe Kimliği	sys_id	True	string	Alınacak katalog öğesinin sys_id

Döndürülenler

Body

GetCatalogItemResponse

Katalogları alma

İşlem Kimliği:

GetCatalogs

Katalog listesini alır

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Sınır	sysparm_limit		integer	Alınacak katalog sayısı
Metin Ara	sysparm_text		string	Katalogları ada veya açıklamaya göre filtrelemek için metin arama

Döndürülenler

Body

GetCatalogsResponse

Kaydı Güncelleştir

İşlem Kimliği:

UpdateRecord

'Incidents' gibi bir ServiceNow nesne türü için kaydı güncelleştirir

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kayıt Türü	tableType	True	string	Listeye kaydedilecek kayıt türü
Sistem Kimliği	sysid	True	string	Kaydın sistem kimliği.
body	body	True	dynamic
Sistem Başvurularını Görüntüle	sysparm_display_value		boolean	Sistem başvurularının dahil edilmesi gerekip gerekmediğini belirler
Başvuru Bağlantılarını Dışla	sysparm_exclude_reference_link		boolean	Başvuru bağlantılarının dışlanması gerekip gerekmediğini belirler
Fields	sysparm_fields		string	Döndürülecek alanların virgülle ayrılmış listesi. Örnek: ad,e-posta,telefon

Döndürülenler

Bu işlemin çıkışları dinamiktir.

Kaydı Sil

İşlem Kimliği:

DeleteRecord

ServiceNow nesne türü için 'Incidents' gibi bir kaydı siler

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kayıt Türü	tableType	True	string	Listeye kaydedilecek kayıt türü
Sistem Kimliği	sysid	True	string	Kaydın sistem kimliği.

Kayıt Al

İşlem Kimliği:

GetRecord

'Incidents' gibi bir ServiceNow nesne türü için kayıt alır

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kayıt Türü	tableType	True	string	Listeye kaydedilecek kayıt türü
Sistem Kimliği	sysid	True	string	Kaydın sistem kimliği.
Sistem Başvurularını Görüntüle	sysparm_display_value		boolean	Sistem başvurularının dahil edilmesi gerekip gerekmediğini belirler
Başvuru Bağlantılarını Dışla	sysparm_exclude_reference_link		boolean	Başvuru bağlantılarının dışlanması gerekip gerekmediğini belirler
Fields	sysparm_fields		string	Döndürülecek alanların virgülle ayrılmış listesi. Örnek: ad,e-posta,telefon

Döndürülenler

Bu işlemin çıkışları dinamiktir.

Kayıt Oluştur

İşlem Kimliği:

CreateRecord

ServiceNow tablosunda kayıt oluşturun.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kayıt Türü	tableType	True	string	Listeye kaydedilecek kayıt türü
body	body	True	dynamic
Sistem Başvurularını Görüntüle	sysparm_display_value		boolean	Sistem başvurularının dahil edilmesi gerekip gerekmediğini belirler
Başvuru Bağlantılarını Dışla	sysparm_exclude_reference_link		boolean	Başvuru bağlantılarının dışlanması gerekip gerekmediğini belirler
Fields	sysparm_fields		string	Döndürülecek alanların virgülle ayrılmış listesi. Örnek: ad,e-posta,telefon

Döndürülenler

Bu işlemin çıkışları dinamiktir.

Kayıt Türlerini Al

İşlem Kimliği:

GetRecordTypes

Kullanılabilir kayıt türlerini listeler

Döndürülenler

Body

GetTypesResponse

Kayıtları Listele

İşlem Kimliği:

GetRecords

'Incidents' gibi belirli bir ServiceNow nesne türünün kayıtlarını alır

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kayıt Türü	tableType	True	string	Listeye kaydedilecek kayıt türü
Sistem Başvurularını Görüntüle	sysparm_display_value		boolean	Sistem başvurularının dahil edilmesi gerekip gerekmediğini belirler
Başvuru Bağlantılarını Dışla	sysparm_exclude_reference_link		boolean	Başvuru bağlantılarının dışlanması gerekip gerekmediğini belirler
Query	sysparm_query		string	Sonuç kümesini filtrelemek için kullanılan kodlanmış sorgu. Örnek: active=true^ORDERBYnumber^ORDERBYDESCcategory
Sınır	sysparm_limit		integer	Sayfalandırmaya uygulanacak sınır. Varsayılan değer 10000'dir.
Ofset baskı	sysparm_offset		integer	Sorgunun dışında tutulacak kayıt sayısı.
Fields	sysparm_fields		string	Döndürülecek alanların virgülle ayrılmış listesi. Örnek: ad,e-posta,telefon

Döndürülenler

Bu işlemin çıkışları dinamiktir.

Sipariş öğesi

İşlem Kimliği:

OrderItem

Belirli bir katalog öğesini sipariş eder veya satın alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Öğe Kimliği	sys_id	True	string	Sipariş için katalog öğesinin sys_id
Sipariş Öğesi Gövdesi	body	True	dynamic	Sipariş öğesi isteğinin gövdesi. Katalog öğesi için gereken miktarı, istenen kullanıcıyı ve ek değişkenleri içerir

Döndürülenler

Body

OrderItemResponse

Çok bölümlü dosya eklerini karşıya yükleme

İşlem Kimliği:

UploadAttachment

Çok parçalı bir formdan ek yükleme

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Ek içeriği	attachment_content	True	file	Karşıya yüklenecek ek
Tablo Adı	table_name	True	string	Dosyayı eklemek istediğiniz tablonun adı.
Tablo Kimliği	table_sys_id	True	string	Dosyayı eklemek istediğiniz belirtilen tablodaki kaydın Sys_id

Döndürülenler

Body

UploadAttachmentResponse

Tanımlar

GetArticleResponse

Name	Yol	Tür	Description
Sayı	result.number	string	Makalenin KB numarası.
Sys Kimliği	result.sys_id	string	Makalenin sys_id.
Kısa Açıklama	result.short_description	string	Makalenin kısa açıklaması (başlık).
Metin	result.text	string	Standart vücut alanı makalelerinin gövdesi. Gövdesi içerik altında döndürülen şablon/Knowledge-Block makaleleri için boş.
Template	result.template	boolean	Makale, gövdesi içerik altında döndürülen bir şablon/Knowledge-Block makale olduğunda doğrudur.
Şablon Tablosu	result.template_table	string	Şablon makalesini (örneğin kb_template_how_to) arkalayan şablon tablosu.
Language	result.language	string	Döndürülen makalenin dili.
Content	result.content	array of object	Şablon/Knowledge-Block makaleleri için birleştirilmiş şablon bölümleri.
Etiket	result.content.label	string	Şablon bölümünün görüntüleme etiketi.
Column	result.content.column	string	Bölümün arkasını kollayan şablon sütunu.
Türü	result.content.type	string	Bölümün içerik türü (örneğin html).
Content	result.content.content	string	Bölüm gövdesi.

UploadAttachmentResponse

Name	Yol	Tür	Description
average_image_color	result.average_image_color	string	Ek bir görüntüyse, tüm renklerin toplamıdır.
Sıkıştırılmış	result.compressed	string	Ek dosyasının sıkıştırılıp sıkıştırılmadığını gösteren bayrak.
content_type	result.content_type	string	resim veya jpeg veya uygulama/x-shockwave-flash gibi ilişkili ek dosyasının içerik türü.
created_by_name	result.created_by_name	string	İlk olarak ek dosyasını oluşturan varlığın tam adı.
download_link	result.download_link	string	ServiceNow örneğindeki ekin URL'sini indirin.
dosya_adı	result.file_name	string	Ekin dosya adı.
image_height	result.image_height	string	Bir görüntü dosyasıysa, görüntünün yüksekliği. Birim: Piksel
image_width	result.image_width	string	Bir görüntü dosyasıysa, görüntünün genişliği. Birim: Piksel
size_bytes	result.size_bytes	string	Ekin boyutu. Birim: Bayt
size_compressed	result.size_compressed	string	Ekin boyutu. Birim: Bayt
sys_created_by	result.sys_created_by	string	İlk olarak ek dosyasını oluşturan varlık.
sys_created_on	result.sys_created_on	string	Ek dosyasının başlangıçta örneğe kaydedildiği tarih ve saat.
sys_id	result.sys_id	string	Ek dosyasının Sys_id.
sys_mod_count	result.sys_mod_count	string	Ek dosyasının değiştirilme sayısı (örneğe yüklenir).
sys_tags	result.sys_tags	string	Ek dosyasıyla ilişkili tüm sistem etiketleri.
sys_updated_by	result.sys_updated_by	string	Ek dosyasıyla ilişkili tüm sistem etiketleri.
sys_updated_on	result.sys_updated_on	string	Ek dosyasının son güncelleştirildiği tarih ve saat.
table_name	result.table_name	string	Ekin ilişkilendirildiği tablonun adı.
table_sys_id	result.table_sys_id	string	Ekle ilişkili tablonun Sys_id.
updated_by_name	result.updated_by_name	string	Ek dosyasını son güncelleştiren varlığın tam adı.

GetTypesResponse

Name	Yol	Tür	Description
sonuç	result	array of object	Geçerli örnek için tüm kayıt türlerinin sonuç kümesi.
Ekran adı	result.label	string	Kayıt türünün görünen adı.
Değer	result.value	string	Kayıt türünün değeri.

GetCatalogsResponse

Name	Yol	Tür	Description
sonuç	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
açıklama	result.description	string
desktop_image	result.desktop_image	string

GetCatalogCategoriesResponse

Name	Yol	Tür	Description
sonuç	result	array of object
title	result.title	string
açıklama	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
Alt kategori	result.subcategories	array of object
sys_id	result.subcategories.sys_id	string
title	result.subcategories.title	string
sys_id	result.sys_id	string

GetCatalogItemsResponse

Name	Yol	Tür	Description
sonuç	result	array of object
short_description	result.short_description	string
kb_article	result.kb_article	string
icon	result.icon	string
açıklama	result.description	string
availability	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
fiyat	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
sahip	result.owner	string
show_price	result.show_price	boolean
recurring_price	result.recurring_price	string
show_quantity	result.show_quantity	boolean
resim	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
etkin / aktif	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

Name	Yol	Tür	Description
short_description	result.short_description	string	short_description
kb_article	result.kb_article	string	kb_article
icon	result.icon	string	icon
açıklama	result.description	string	açıklama
availability	result.availability	string	availability
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
sahip	result.owner	string	sahip
show_price	result.show_price	boolean	show_price
show_quantity	result.show_quantity	boolean	show_quantity
resim	result.picture	string	resim
url	result.url	string	url
catalogs	result.catalogs	array of object	catalogs
sys_id	result.catalogs.sys_id	string	sys_id
etkin / aktif	result.catalogs.active	boolean	etkin / aktif
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
etkin / aktif	result.categories.active	boolean	etkin / aktif
sys_id	result.categories.category.sys_id	string	sys_id
etkin / aktif	result.categories.category.active	boolean	etkin / aktif
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

Name	Yol	Tür	Description
sys_id	result.sys_id	string	sys_id
Numara	result.number	string	Numara
request_number	result.request_number	string	request_number
request_id	result.request_id	string	request_id
table	result.table	string	table

GetArticlesResponse

Name	Yol	Tür	Description
Sayı	meta.count	integer	Kullanılabilir KB makalelerinin sayısı
End	meta.end	integer	Sonuç kümesinin bitiş dizini
Fields	meta.fields	string	Makaledeki alanlar
Filter	meta.filter	string	Verileri almak için kullanılan filtre
KB	meta.kb	string	Bilgi bankası makalesi sys_ids listesi
Language	meta.language	string	İstenen KB makalelerinin virgülle ayrılmış dillerinin listesi
Query	meta.query	string	Belirtilen istek sorgusu
Start	meta.start	string	Sonuç kümesinin dizini başlatılıyor
Statü	meta.status.code	string	Aramanın durumu
KB	meta.ts_query_id	string	İstenen KB makalelerinin virgülle ayrılmış dillerinin listesi
Makaleler	articles	array of object
Değer Görüntüle	articles.fields.display_value	string	İstenen alanın değerini görüntüleme
Etiket	articles.fields.label	string	İstenen alanı temsil eden etiket
İsim	articles.fields.name	string	İstenen alanın adı
Türü	articles.fields.type	string	İstenen alanın veri türü
Değer	articles.fields.value	string	İstenen alanın değeri
Link	articles.Link	string	Makalenin bağlantısı
kimlik	articles.id	string	Bilgi [kb_knowledge] tablosundan sys_id bilgi makalesi
Sayı	articles.number	string	Bilgi [kb_knowledge] tablosundan sys_id bilgi makalesi
Sıralama	articles.rank	float	Bu aramaya özgü makalenin arama sırası
Score	articles.score	float	İlgi puanı, sonuçlar puana göre azalan düzende sıralanmış
Parçacığını	articles.snippet	string	Bilgi bankası makalesinin küçük bir bölümünü gösteren metin
Başlık	articles.title	string	Bilgi bankası makalesinin kısa açıklaması veya başlığı