ALVAO
Alvao, Alvao Hizmet Masası ve Varlık Yönetimi'ndeki eylemleri otomatikleştirmenizi ve diğer uygulamalarla tümleştirmenizi sağlar.
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 : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Logic Apps | Standart | Aşağıdakiler dışında tüm Logic Apps bölgeleri : - Azure Kamu bölgeleri - Azure Çin bölgeleri - ABD Savunma Bakanlığı (DoD) |
| Power Apps | Premium | Aşağıdakiler dışında tüm Power Apps bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Power Automate | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| İletişim | |
|---|---|
| İsim | ALVAO Desteği |
| URL | https://www.alvao.com/en/support-and-services |
| E-posta | support@alvao.com |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | ALVAO |
| Web sitesi | https://www.alvao.com |
| Gizlilik ilkesi | https://www.alvao.com/en/privacystatement |
| Kategoriler | İşbirliği;BT İşlemleri |
Bu bağlayıcıyla, Alvao'daki eylemleri otomatikleştirmek veya Alvao'yu diğer uygulamalarla tümleştirmek için Power Automate, Power Apps veya Azure Logic Apps'i kullanabilirsiniz. Bağlayıcı, yalnızca Service Desk'teki biletlerin iş akışına değil, Varlık Yönetimi'nde kayıtlı varlıkların yaşam döngüsüne bağlı otomasyonları da başlatmanıza olanak tanır. Bağlayıcı eylemleri daha sonra bilet iş akışını taşımanıza veya varlık yaşam döngüsünü yönetmenize olanak tanır.
Önkoşullar
ALVAO sürümü en az 11.1 olan bir ALVAO müşterisi (SaaS veya Şirket İçi) olmanız ve İnternet'ten REST API'niz olması gerekir.
Kimlik bilgilerini alma
- içinde
Alvao WebApp- -AdministrationUsersbir uygulama hesabı oluşturun. - En azından değerini
Name and SurnameUser nameayarlayın ve seçeneğiniApplication account-Other applicationsetkinleştirin. - Bu hesaba bir parola ayarlayın.
- Hesabın biletlerle veya varlıklarla çalışması için uygun izinleri ayarlayın.
- Bu bağlayıcıyla
User namebağlantı oluşturmak için bu hesabın vePasswordöğesini kullanın.
Not: içinde bulabileceğiniz Alvao REST API'nizin URL'sine
Alvao WebAppSettingsWeb services-Administration- - de ihtiyacınız olacaktır.
Bağlayıcınızı kullanmaya başlama
Bağlantıyı oluşturduktan sonra çeşitli tetikleyicileri veya eylemleri kullanabilirsiniz.
Örneğin, Alvao Hizmet Masası'ndaki bir biletin onayına bağlı olarak otomatik bir akış kullanarak SharePoint'teki bir klasörü okuma izni verin:
- Tetikleyiciyi
When a ticket transitions to a statuskullanın ve işlemin adını ve akışın tetiklenme durumunu belirtin. - Ardından eylemi ekleyin
Get Ticketve giriş olarak tetikleyiciden kullanılabilir değeriniTicket IDgirin. - Ardından, örneğin eylemden edindiğiniz istek sahibinin e-postasını kullanın ve bunu M365'te kullanıcıyı bulmak ve ona uygun izinler atamak için kullanın.
Diğer eylemler, Varlık Yönetimi'ndeki otomasyonlarda da size yardımcı olabilir. Örneğin varlık oluşturma, özelliklerinin değerlerini değiştirme veya kayıt defteri içinde taşıma eylemleri. Başka bir sistemdeki varlıkları düzenli olarak içeri aktarmanız gerekiyorsa eylemini Import objects from CSVkullanabilirsiniz.
Bilinen sorunlar ve sınırlamalar
- Tüm tetikleyiciler yalnızca ALVAO 11.2 veya üzeri sürümlerde kullanılabilir.
- Bu eylemler yalnızca ALVAO 11.2 veya üzeri sürümlerde kullanılabilir:
- Nesne oluşturma
- Nesne al
- Nesneleri alma
- Nesne özelliklerini güncelleştirme
- Nesneleri taşıma
- Kullanıcıları alma
- CSV'den nesneleri içeri aktarma
- Bazı eylemler, Alvao içinde bulunması gereken giriş olarak bir varlık kimliği gerektirir. Bu kimlikler genellikle Alvao WebApp'te URL'nin sonunda ayrıntılarında veya düzenleme sayfalarında bulunur.
Yaygın hatalar ve çözümler
- 403 Yasak - Kullanılan uygulama hesabının eylemi gerçekleştirmek için gerekli tüm izinlere sahip olup olmadığını denetleyin. Ayrıca, bağlantıda kullanılan kimlik bilgilerini de denetleyin.
- 404 Bulunamadı - Bağlantıda tüm giriş parametrelerinin doğru ve REST API URL'sinin doğru olup olmadığını denetleyin. Eylemin ALVAO sürümünüzde kullanılabilir olup olmadığını denetleyin.
FAQ
Özel alanlar
Bağlayıcı ayrıca özel alanlardan/anahtarlara değer okumayı ve yazmayı da destekler. Özel alanlar genel bağlayıcı tanımında açıklanamaz, bu nedenle bunları işlemek için aşağıdaki teknikleri kullanmanız gerekir.
Biletin özel alanının değerini okumak için eylemdeki Get ticket ifadeleri kullanın. Örneğin, TicketCategory alanının değerini okumak için şu ifadeyi kullanın:
outputs('Get_request')?['body/customItems/TicketCategory/value']
Biletin özel alanına değer yazmak için eylemi özel JSON belirtimi ile kullanın Update ticket . Örneğin, TicketCategory alanına "izleme hatası" değerini yazmak için şu belirtimi Custom Items alanda kullanın:
{
"TicketCategory": {
"@@odata.type": "#Alvao.Rest.Api.Models.SD.CustomItem",
"name": "TicketCategory",
"value": "monitor failure"
}
}
Not: Kaçış nedeniyle "@" karakteri iki katına alınır.
Bağlantı oluşturma
Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
| Varsayılan | Bağlantı oluşturmak için parametreler. | Tüm bölgeler | Paylaşılamaz |
Temerrüt
Geçerli: Tüm bölgeler
Bağlantı oluşturmak için parametreler.
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 |
|---|---|---|---|
| Host | String | ALVAO REST API'nizin konak URL'sini belirtin | Doğru |
| Kullanıcı adı | String | ALVAO uygulama hesabının kullanıcı adı | Doğru |
| Şifre | securestring | ALVAO uygulama hesabının parolası | Doğru |
Azaltma Sınırları
| Name | Çağrılar | Yenileme Dönemi |
|---|---|---|
| Bağlantı başına API çağrıları | 100 | 60 saniye |
Eylemler
| Anahtar durumunu değiştirme |
Bilet durumunu değiştirir. Bileti çözümlemek veya yeniden açmak için de kullanılabilir. Durum Kimliği veya Durum Adı gereklidir. |
| Bilet al |
Anahtar özelliklerini döndürür. |
| Bilet günlüğünde kayıt oluşturma |
Bilet günlüğünde kayıt oluşturur. |
| Bilet oluşturma |
Yeni bilet oluşturur. |
| Bileti başka bir hizmete taşıma |
Bileti başka bir hizmete taşır. Hizmet Kimliği veya Hizmet Adı gereklidir. |
| CSV'den nesneleri içeri aktarma |
CSV biçiminde sağlanan nesneleri içeri aktarır. ImportUtil yardımcı programıyla benzer işlevler. |
| Güncelleştirme bileti |
Bilet sütunlarını güncelleştirir. Yalnızca değiştirecek özellikleri ayarlayın. SLA'yı değiştirmek için slaId veya slaName ayarlayın. İstek sahibini değiştirmek için yalnızca İstek Sahibi Kimliği'ne veya istek sahibindeki tüm verilere (kayıtlı olmayan kullanıcı) ayarlayın. |
| Kullanıcıları alma |
Kullanıcıları ve özelliklerini OData parametrelerine göre döndürür. |
| Nesne al |
Nesnesini özellikleriyle döndürür. |
| Nesne oluşturma |
Belirtilen nesnenin altında belirtilen şablondan yeni bir nesne oluşturur. |
| Nesne özelliklerini güncelleştirme |
Nesne özelliklerini güncelleştirir. |
| Nesneleri alma |
Özelliklerine sahip nesneleri OData parametrelerine göre döndürür. |
| Nesneyi taşıma |
Bir nesneyi belirtilen hedefe taşır. |
| Çözücü veya çözücü ekibine bilet atama |
Çözücü veya çözücü ekibine bilet atar. |
Anahtar durumunu değiştirme
Bilet durumunu değiştirir. Bileti çözümlemek veya yeniden açmak için de kullanılabilir. Durum Kimliği veya Durum Adı gereklidir.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Bilet Kimliği
|
ticketId | True | integer |
Biletin kimliğini belirtin (tHdTicket.iHdTicketId). |
|
Durum Kimliği
|
stateId | integer |
Yeni durum kimliği (TicketState.id). |
|
|
Durum Adı
|
stateName | string |
Yeni durum adı. |
|
|
Comment
|
commentHtml | string |
HTML'de açıklama. |
|
|
Onaylayanlar için Açıklama
|
commentForApprovers | string |
HTML'de onaylayanlar için açıklama. |
|
|
İstekte bulunanlar için açıklama
|
commentForRequesters | string |
HTML'de istekte bulunanlar için açıklama. |
|
|
İçerik Baytları
|
contentBytes | string |
Base64'te kodlanmış içerik. |
|
|
İçerik Türü
|
contentType | string |
İçerik türü; örn. resim/png. |
|
|
İçerik Adı
|
name | string |
İçerik adı. |
Döndürülenler
- response
- string
Bilet al
Anahtar özelliklerini döndürür.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Bilet Kimliği
|
ticketId | True | integer |
Biletin kimliğini belirtin (tHdTicket.iHdTicketId). |
Döndürülenler
- Body
- SD.Ticket
Bilet günlüğünde kayıt oluşturma
Bilet günlüğünde kayıt oluşturur.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Bilet Kimliği
|
ticketId | True | integer |
Biletin kimliğini belirtin (tHdTicket.iHdTicketId). |
|
Konu
|
subject | True | string |
Kaydın konusu. |
|
Html İçeriği
|
contentHtml | string |
Html'de kaydın içeriği. |
|
|
Düz Metin İçeriği
|
contentPlain | string |
Kaydın düz metin olarak içeriği. |
|
|
Kind
|
kind | True | string |
Bir çeşit kayıt. |
|
Kimden Adı
|
from | string |
Gönderenin adı. |
|
|
E-postadan
|
emailFrom | string |
Gönderenin e-postası. |
|
|
İçin
|
emailTo | string |
İletinin alıcıları noktalı virgülle ayrılır. |
|
|
Kopyala
|
emailCc | string |
İletinin alıcıları noktalı virgülle ayrılır. |
|
|
Kimden Kişi Kimliği
|
fromPersonId | integer |
Yazarın kişi kimliği (tPerson.iPersonId). |
|
|
Kişi Kimliği
|
toPersonId | integer |
Alıcının Kişi Kimliği (tPerson.iPersonId). |
|
|
Oluşturulma Tarihi
|
created | string |
Kaydın oluşturulduğu tarih ve saat. Akım için boş bırakın. |
|
|
İstek Sahibine Göster
|
showToRequester | boolean |
İstekte bulunanın kaydı görüp görmeyeceğine karar verin. |
|
|
İçerik Baytları
|
contentBytes | string |
Base64'te kodlanmış içerik. |
|
|
İçerik Türü
|
contentType | string |
İçerik türü; örn. resim/png. |
|
|
İçerik Adı
|
name | string |
İçerik adı. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Kayıt Kimliği
|
id | integer |
Günlük kaydı kimliği (tAct.iActId). |
|
Konu
|
subject | string |
Günlük kaydı konusu. |
|
Html İçeriği
|
contentHtml | string |
Kayıt içeriğini HTML olarak günlüğe kaydedin. |
|
Düz Metin İçeriği
|
contentPlain | string |
Kayıt içeriğini düz metin olarak günlüğe kaydedin. |
|
Oluşturulma Tarihi
|
created | string |
Günlük kaydı oluşturma tarihi. |
|
Kind
|
kind | string |
Günlük kaydı türü. |
|
Kimden Adı
|
from | string |
Günlük kaydı yazar adı. |
|
E-postadan
|
emailFrom | string |
Günlük kaydı yazarı e-postası. |
|
İçin
|
emailTo | string |
Günlük kaydı alıcıları e-postaları. |
|
Kopyala
|
emailCc | string |
Günlük kaydı alıcıları e-postaları. |
|
Kimden Kişi Kimliği
|
fromPersonId | integer |
Günlük kaydı gönderen kimliği (tPerson.iPersonId). |
|
Kişi Kimliği
|
toPersonId | integer |
Günlük kaydı alıcı kimliği (tPerson.iPersonId). |
|
İleti Kimliği
|
messageId | string |
Günlük kaydı ileti kimliği. |
|
Attachments
|
attachments | array of object |
Günlük kaydı ekleri. |
|
Ek Adı
|
attachments.name | string |
Ek adı. |
|
Ek Kimliği
|
attachments.id | integer |
Ek Kimliği (tDocument.iDocumentId). |
|
Ek Bağlantısı
|
attachments.link | string |
Eke bağlanın. |
Bilet oluşturma
Yeni bilet oluşturur.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Hizmet Kimliği
|
serviceId | True | integer |
Bilet hizmeti kimliği (tHdSection.iHdSectionId). |
|
İsim
|
name | True | string |
Anahtar adı. |
|
Description
|
descriptionHtml | string |
HTML'de bilet açıklaması. |
|
|
SLA Kimliği
|
slaId | integer |
Anahtar SLA Kimliği (tSla.iSlaId). |
|
|
Priority
|
priority | string |
Bilet önceliği. |
|
|
Etki
|
impact | string |
Bilet etkisi. |
|
|
Aciliyet
|
urgency | string |
Bilet aciliyeti. |
|
|
Cihaz Numarası
|
deviceNumber | string |
Bilet cihaz numarası. |
|
|
İlgili Kuruluş
|
relatedOrganization | string |
Biletle ilgili kuruluş adı. |
|
|
Kişi Kimliği için İstendi
|
requestedForPersonId | integer |
Kişi kimliği (tPerson.iPersonId) için istendi. |
|
|
Kimlik
|
id | integer |
İstek sahibi kimliği (tPerson.iPersonId). |
|
|
İsim
|
name | string |
İstek sahibi adı. |
|
|
E-posta
|
string |
İstek sahibi e-postası. |
||
|
E-posta 2
|
email2 | string |
İstek sahibi e-posta 2. |
|
|
Telefon
|
phone | string |
İstek sahibi telefonu. |
|
|
Telefon 2
|
phone2 | string |
İstek sahibi telefon 2. |
|
|
Cep Telefonu
|
mobilePhone | string |
İstek sahibi cep telefonu. |
|
|
Departman
|
department | string |
İstek sahibi bölümü. |
|
|
Büro
|
office | string |
İstek sahibi ofisi. |
|
|
çalışma konumu
|
workPosition | string |
İstek sahibi çalışma konumu. |
|
|
Organizasyon
|
organization | string |
İstek sahibi kuruluşu. |
|
|
Diğer Kişiler
|
otherContacts | string |
İstek sahibi diğer kişiler. |
|
|
Objects
|
objects | array of integer |
Nesnelere bağlantılar. |
|
|
İçerik Baytları
|
contentBytes | string |
Base64'te kodlanmış içerik. |
|
|
İçerik Türü
|
contentType | string |
İçerik türü; örn. resim/png. |
|
|
İçerik Adı
|
name | string |
İçerik adı. |
|
|
Özel Öğeler
|
customItems | object |
Anahtar özel öğeleri (tHdTicketCust). |
Döndürülenler
- Body
- SD.Ticket
Bileti başka bir hizmete taşıma
Bileti başka bir hizmete taşır. Hizmet Kimliği veya Hizmet Adı gereklidir.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Bilet Kimliği
|
ticketId | True | integer |
Biletin kimliğini belirtin (tHdTicket.iHdTicketId). |
|
Hizmet Kimliği
|
serviceId | integer |
Yeni hizmet kimliği (tHdSection.iHdSectionId). |
|
|
Hizmet Adı
|
serviceName | string |
Yeni hizmet adı. |
|
|
Çözücü Kimliği
|
newSolverId | integer |
Yeni çözücü kimliği (tPerson.iPersonId). |
|
|
Çözücü Ekip Kimliği
|
newSolverTeamId | integer |
Yeni çözücü ekip kimliği (tRole.iPersonId). |
|
|
Comment
|
commentHtml | string |
HTML'de açıklama. |
|
|
İçerik Baytları
|
contentBytes | string |
Base64'te kodlanmış içerik. |
|
|
İçerik Türü
|
contentType | string |
İçerik türü; örn. resim/png. |
|
|
İçerik Adı
|
name | string |
İçerik adı. |
Döndürülenler
- response
- string
CSV'den nesneleri içeri aktarma
CSV biçiminde sağlanan nesneleri içeri aktarır. ImportUtil yardımcı programıyla benzer işlevler.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
CSV
|
contentCsv | True | string |
İçeri aktaracak CSV içeriği. |
|
Nesne Türü
|
objectTypeId | integer |
İçeri aktarılan nesnelerin türü. |
|
|
Tarih Saat Biçimi
|
dateTimeFormat | string |
Metin dizelerinde tarih saat biçimi (örn. gg/AA/yyyy). |
|
|
Ayırıcı
|
separator | string |
İçeri aktarılan CSV'de kullanılan sütun ayırıcı. |
|
|
Hataları Atla
|
skipErrors | boolean |
Etkinleştirilirse, girdilerden birinde hata olsa bile veriler içeri aktarılır. |
|
|
Anahtar Özellikleri
|
keyFields | string |
Mevcut nesneleri tanımlamak ve güncelleştirmek için kullanılan anahtar alanlar (örneğin, seri numarası, Model). |
|
|
Üst Nesne
|
createUnderObjectId | integer |
Yeni nesneler oluşturmak için üst nesne. |
|
|
Atılan Nesneleri Güncelleştirme
|
updateDiscardedObjects | boolean |
Etkinleştirilirse, atılan nesneler de içeri aktarmada aranıp güncelleştirilir. |
Döndürülenler
- Body
- AM.ImportCsvResponse
Güncelleştirme bileti
Bilet sütunlarını güncelleştirir. Yalnızca değiştirecek özellikleri ayarlayın. SLA'yı değiştirmek için slaId veya slaName ayarlayın. İstek sahibini değiştirmek için yalnızca İstek Sahibi Kimliği'ne veya istek sahibindeki tüm verilere (kayıtlı olmayan kullanıcı) ayarlayın.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Bilet Kimliği
|
ticketId | True | integer |
Biletin kimliğini belirtin (tHdTicket.iHdTicketId). |
|
İsim
|
name | string |
Anahtar adı. |
|
|
Priority
|
priority | string |
Bilet önceliği. |
|
|
Etki
|
impact | string |
Bilet etkisi. |
|
|
Aciliyet
|
urgency | string |
Bilet aciliyeti. |
|
|
SLA Kimliği
|
slaId | integer |
Anahtar SLA Kimliği (tSla.iSlaId). |
|
|
SLA Adı
|
slaName | string |
Anahtar SLA adı. |
|
|
Cihaz Numarası
|
deviceNumber | string |
Bilet cihaz numarası. |
|
|
İlgili Kuruluş
|
relatedOrganization | string |
Biletle ilgili kuruluş adı. |
|
|
İç Hedef Tarihi
|
internalTargetDate | date-time |
Anahtar iç hedef tarihi. |
|
|
İç Hedef
|
internalTarget | string |
Bilet iç hedefi. |
|
|
İsim
|
name | string |
İstek sahibi adı. |
|
|
E-posta
|
string |
İstek sahibi e-postası. |
||
|
E-posta 2
|
email2 | string |
İstek sahibi e-posta 2. |
|
|
Telefon
|
phone | string |
İstek sahibi telefonu. |
|
|
Telefon 2
|
phone2 | string |
İstek sahibi telefon 2. |
|
|
Cep telefonu
|
mobilePhone | string |
İstek sahibi cep telefonu. |
|
|
Departman
|
department | string |
İstek sahibi bölümü. |
|
|
Büro
|
office | string |
İstek sahibi ofisi. |
|
|
çalışma konumu
|
workPosition | string |
İstek sahibi çalışma konumu. |
|
|
Organizasyon
|
organization | string |
İstek sahibi kuruluşu. |
|
|
Diğer kişiler
|
otherContacts | string |
İstek sahibinin diğer kişileri. |
|
|
Özel Öğeler
|
customItems | object |
Anahtar özel öğeleri (tHdTicketCust). |
Kullanıcıları alma
Kullanıcıları ve özelliklerini OData parametrelerine göre döndürür.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Yukarı
|
$top | integer |
Döndürmek istediğiniz nesne sayısını belirtin. |
|
|
Search
|
$search | string |
Tam metin arama koşulunu belirtin. OData $search. |
|
|
Filter
|
$filter | string |
Filtreyi belirtin, örneğin E-posta eq 'james.smith@contoso.com'. OData $filter. |
|
|
Sipariş Ölçütü
|
$orderBy | string |
Siparişi belirtin. OData $orderBy. |
Döndürülenler
Nesne al
Nesnesini özellikleriyle döndürür.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Nesne
|
objectId | True | integer |
Nesneyi seçin veya kimliğini (tblNode.intNodeId) girin. |
Döndürülenler
- Body
- AM.ObjectExpanded
Nesne oluşturma
Belirtilen nesnenin altında belirtilen şablondan yeni bir nesne oluşturur.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Template
|
templateObjectId | True | integer |
Nesne şablonunu seçin veya kimliğini (tblNode.intNodeId) girin. |
|
Üst Nesne
|
parentObjectId | integer |
Üst nesneyi seçin veya kimliğini (tblNode.intNodeId) girin. |
Döndürülenler
- Body
- AM.Object
Nesne özelliklerini güncelleştirme
Nesne özelliklerini güncelleştirir.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Nesne
|
objectId | True | integer |
Nesneyi seçin veya kimliğini (tblNode.intNodeId) girin. |
|
İsim
|
name | string |
Nesnenin özelliğini seçin. |
|
|
Değer
|
value | string |
özelliğinin değerini belirtin. |
Nesneleri alma
Özelliklerine sahip nesneleri OData parametrelerine göre döndürür.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Yukarı
|
$top | integer |
Döndürmek istediğiniz nesne sayısını belirtin. |
|
|
Search
|
$search | string |
Tam metin arama koşulunu belirtin. OData $search. |
|
|
Filter
|
$filter | string |
Filtreyi belirtin; örneğin Ad eq 'Süt'. OData $filter. |
|
|
Sipariş Ölçütü
|
$orderBy | string |
Siparişi belirtin. OData $orderBy. |
Döndürülenler
Nesneyi taşıma
Bir nesneyi belirtilen hedefe taşır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Nesne
|
objectId | True | integer |
Nesneyi seçin veya kimliğini (tblNode.intNodeId) girin. |
|
Hedef Nesne
|
parentObjectId | integer |
Hedef nesneyi seçin veya kimliğini (tblNode.intNodeId) girin. |
Çözücü veya çözücü ekibine bilet atama
Çözücü veya çözücü ekibine bilet atar.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Bilet Kimliği
|
ticketId | True | integer |
Biletin kimliğini belirtin (tHdTicket.iHdTicketId). |
|
Çözücü Kimliği
|
solverId | integer |
Yeni çözücü kimliği (tPerson.iPersonId). |
|
|
Çözücü Ekip Kimliği
|
solverTeamId | integer |
Yeni çözücü ekip kimliği (tRole.iPersonId). |
|
|
Message
|
messageForSolverHtml | string |
HTML'de çözücü ve/veya çözücü ekibi için ileti. |
|
|
İçerik Baytları
|
contentBytes | string |
Base64'te kodlanmış içerik. |
|
|
İçerik Türü
|
contentType | string |
İçerik türü; örn. resim/png. |
|
|
İçerik Adı
|
name | string |
İçerik adı. |
Döndürülenler
- response
- string
Tetikleyiciler
| Anahtar alanı değeri değiştirildiğinde |
Bu işlem, belirli bir anahtar alanı değeri değiştirildiğinde tetikleniyor. |
| Bilet bir duruma geçtiğinde |
Bir bilet belirli bir duruma geçtiğinde bu işlem tetikleniyor. |
| Bir nesne oluşturulduğunda |
Bu işlem, belirli bir türde bir nesne oluşturulduğunda tetikleniyor. |
| Bir nesne taşındığında |
Bu işlem, belirli bir türdeki bir nesne nesne ağacında farklı bir konuma taşındığında tetikleniyor. |
| Nesne özelliğinin değeri değiştirildiğinde |
Bu işlem, belirli bir nesne özelliğinin değeri değiştirildiğinde tetikleniyor. |
Anahtar alanı değeri değiştirildiğinde
Bu işlem, belirli bir anahtar alanı değeri değiştirildiğinde tetikleniyor.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Veri Alanı
|
fieldId | True | integer |
Bir bilet alanı seçin. |
|
İşlem
|
process | string |
Bu akışı tetiklemesini istediğiniz işlemin adını girin. |
|
|
Hizmet
|
service | string |
Bu akışı tetiklemesini istediğiniz hizmetin adını girin. |
Döndürülenler
Bilet bir duruma geçtiğinde
Bir bilet belirli bir duruma geçtiğinde bu işlem tetikleniyor.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
İşlem
|
process | True | string |
Bu akışı tetiklemesini istediğiniz işlemin adını girin. |
|
Bilet durumu
|
status | True | string |
Bilet durumunun adını girin. Bu duruma geçiş bileti bu akışı tetikler. |
|
Hizmet
|
service | string |
Bu akışı tetiklemesini istediğiniz hizmetin adını girin. |
Döndürülenler
Bir nesne oluşturulduğunda
Bu işlem, belirli bir türde bir nesne oluşturulduğunda tetikleniyor.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Kind
|
kindId | integer |
Bu akışı tetiklemesini istediğiniz nesne türünü seçin. |
|
|
Üst Nesne
|
parentObjectId | integer |
Bu akışı tetiklemesini istediğiniz alt ağacının üst nesnesini seçin. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Nesne kimliği
|
objectId | integer |
Nesne Kimliği (tblNode.intNodeId). |
Bir nesne taşındığında
Bu işlem, belirli bir türdeki bir nesne nesne ağacında farklı bir konuma taşındığında tetikleniyor.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Kind
|
kindId | integer |
Bu akışı tetiklemesini istediğiniz nesne türünü seçin. |
|
|
Taşınan
|
fromObjectId | integer |
Bu akışı tetiklemesini istediğiniz alt ağacının kaynak nesnesini seçin. |
|
|
Taşınan
|
toObjectId | integer |
Bu akışı tetiklemesini istediğiniz alt ağacının hedef nesnesini seçin. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Nesne kimliği
|
objectId | integer |
Nesne Kimliği (tblNode.intNodeId). |
|
Eski Üst Nesne Kimliği
|
oldParentObjectId | integer |
Eski Üst Nesne Kimliği (tblNode.intNodeId). |
Nesne özelliğinin değeri değiştirildiğinde
Bu işlem, belirli bir nesne özelliğinin değeri değiştirildiğinde tetikleniyor.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Mülkiyet
|
propertyKindId | integer |
Bu akışı tetiklemesini istediğiniz nesnenin özelliğini seçin. |
|
|
Yeni Değer
|
newValue | string |
Bu akışı tetiklemesini istediğiniz özelliğin yeni değerini girin. Örneğin PC123, 1.45, 14. 4. 2024. |
|
|
Nesne Türü
|
kindId | integer |
Bu akışı tetiklemesini istediğiniz nesne türünü seçin. |
|
|
Üst Nesne
|
parentObjectId | integer |
Bu akışı tetiklemesini istediğiniz alt ağacının üst nesnesini seçin. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Nesne kimliği
|
objectId | integer |
Nesne Kimliği (tblNode.intNodeId). |
|
Özellik Kimliği
|
propertyId | integer |
Değiştirilen Özellik Kimliği (tblProperty.intPropertyId). |
Tanımlar
SD. Bilet
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Kimlik
|
id | integer |
Anahtar Kimliği (tHdTicket.iHdTicketId). |
|
İsim
|
name | string |
Anahtar adı. |
|
İleti Etiketi
|
messageTag | string |
Bilet iletisi etiketi. |
|
SLA Kimliği
|
slaId | integer |
SLA Kimliği (tSla.iSlaId). |
|
SLA Adı
|
slaName | string |
SLA adı. |
|
Priority
|
priority | string |
Bilet önceliği. |
|
Etki
|
impact | string |
Bilet etkisi. |
|
Aciliyet
|
urgency | string |
Bilet aciliyeti. |
|
Cihaz Numarası
|
deviceNumber | string |
Bilet cihaz numarası. |
|
İlgili Kuruluş
|
relatedOrganization | string |
Biletle ilgili kuruluş adı. |
|
İç Hedef Tarihi
|
internalTargetDate | date-time |
Anahtar iç hedef tarihi. |
|
İç Hedef
|
internalTarget | string |
Bilet iç hedefi. |
|
İstek Sahibi Kimliği
|
requesterId | integer |
İstek sahibi kimliği (tPerson.iPersonId). |
|
İstek Sahibi Adı
|
requesterName | string |
İstek sahibi adı. |
|
Kimlik İstendi
|
requestedForId | integer |
Kimlik (tPerson.iPersonId) için istendi. |
|
Ad için İstendi
|
requestedForName | string |
Ad istendi. |
|
Çözücü Kimliği
|
solverId | integer |
Anahtar çözücü kimliği (tPerson.iPersonId). |
|
Çözücü Adı
|
solverName | string |
Anahtar çözücü adı. |
|
Çözücü Ekip Kimliği
|
solverTeamId | integer |
Anahtar çözücü ekip kimliği (tRole.iRoleId). |
|
Çözücü Ekip Adı
|
solverTeamName | string |
Anahtar çözücü ekip adı. |
|
Hizmet Kimliği
|
serviceId | integer |
Bilet hizmeti kimliği (tHdSection.iHdSectionId). |
|
Hizmet Adı
|
serviceName | string |
Bilet hizmeti adı. |
|
İşlem Adı
|
processName | string |
Hizmet işlemi adı. |
|
Durum Kimliği
|
stateId | integer |
Bilet durum kimliği (TicketState.id). |
|
Durum Adı
|
stateName | string |
Bilet durumu adı. |
|
Oluşturulma Tarihi
|
createdDate | date-time |
Bilet oluşturma tarihi. |
|
Çözümlenme Tarih
|
resolvedDate | date-time |
Bilet çözümleme tarihi. |
|
Kapanış Tarihi
|
closedDate | date-time |
Biletin kapanma tarihi. |
|
İlk Eylem Kimliği
|
initialActId | integer |
İlk eylem kimliği (tAct.iActId). |
|
Kaldırılan Tarih
|
removedDate | date-time |
Biletin kaldırılma tarihi. |
|
Onayda
|
inApproval | boolean |
Biletin onay sürecinde olup olmadığı. |
|
Son Tarih
|
dueDate | date-time |
Biletin son tarihi. |
|
Objects
|
objects | array of object |
Nesnelere bağlantılar. |
|
Kimlik
|
objects.objectId | integer |
Nesne Kimliği (tblNode.intNodeId). |
|
Özel Öğeler
|
customItems | object |
Anahtar özel öğeleri (tHdTicketCust). |
Webhook.UpdatedTicket
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Bilet Kimliği
|
requestId | integer |
Biletin kimliği (tHdTicket.iHdTicketId). |
|
Kişi Kimliği
|
personId | integer |
Değişikliği yapan kişinin kimliği (tPerson.iPersonId). |
. Nesne
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Kimlik
|
id | integer |
Nesne Kimliği (tblNode.intNodeId). |
|
İsim
|
name | string |
Nesne adı. |
|
Yol
|
path | string |
Ağaçtaki nesne yolu. |
|
Adı ve Soyadı
|
fullName | string |
Ağaçta yolu olan nesne adı. |
|
Tür Kimliği
|
kindId | integer |
Nesne türü kimliği (tblKind.intKindId). |
|
Tür Adı
|
kindName | string |
Nesne türü adı. |
|
Gizli
|
hidden | boolean |
Nesnenin gizlenip gizlenmediği. |
|
Üst Nesne Kimliği
|
parentObjectId | integer |
Üst nesne kimliği (tblNode.intNodeId). |
. ObjectExpanded
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Kimlik
|
id | integer |
Nesne Kimliği (tblNode.intNodeId). |
|
İsim
|
name | string |
Nesne adı. |
|
Yol
|
path | string |
Ağaçtaki nesne yolu. |
|
Adı ve Soyadı
|
fullName | string |
Ağaçta yolu olan nesne adı. |
|
Tür Kimliği
|
kindId | integer |
Nesne türü kimliği (tblKind.intKindId). |
|
Tür Adı
|
kindName | string |
Nesne türü adı. |
|
Gizli
|
hidden | boolean |
Nesnenin gizlenip gizlenmediği. |
|
Üst Nesne Kimliği
|
parentObjectId | integer |
Üst nesne kimliği (tblNode.intNodeId). |
|
Özellikler
|
properties | array of object |
Nesnenin özellikleri. |
|
Kimlik
|
properties.id | integer |
Özellik Kimliği (tblProperty.intPropertyId). |
|
İsim
|
properties.name | string |
Özellik adı. |
|
Değer
|
properties.value | string |
Özellik değeri. |
|
Ad Sırası
|
properties.nameOrder | integer |
Özellik adı sırası. |
. ObjectsExpandedApiResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
value
|
value | array of AM.ObjectExpanded |
. ImportCsvResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Toplam Kayıt Sayısı
|
recordsTotalCount | integer |
CSV'deki kayıtların toplam sayısı. |
|
İşlenen Kayıt Sayısı
|
recordsProcessedCount | integer |
İşlenen kayıtların sayısı. |
|
Atlanan Kayıt Sayısı
|
recordsSkippedCount | integer |
Atlanan kayıtların sayısı. |
|
Başarısız Kayıt Sayısı
|
recordsFailedCount | integer |
Başarısız kayıtların sayısı. |
|
Oluşturulan Nesne Sayısı
|
objectsCreatedCount | integer |
Oluşturulan nesnelerin sayısı. |
|
Güncelleştirilmiş Nesne Sayısı
|
objectsUpdatedCount | integer |
Güncelleştirilmiş nesnelerin sayısı. |
|
Log
|
log | string |
Ayrıntılı bilgiler içeren içeri aktarma günlüğü. |
Common.Person
| Name | Yol | Tür | Description |
|---|---|---|---|
|
İsim
|
name | string |
Kullanıcı adı ve soyadı. |
|
E-posta
|
string |
Kullanıcı e-postası. |
|
|
E-posta 2
|
email2 | string |
Kullanıcı e-postası 2. |
|
İş Telefonu
|
phone | string |
Kullanıcı iş telefonu. |
|
İş Telefonu 2
|
phone2 | string |
Kullanıcı iş telefonu 2. |
|
Cep Telefonu
|
mobilePhone | string |
Kullanıcı cep telefonu. |
|
Departman
|
department | string |
Kullanıcı departmanı. |
|
Büro
|
office | string |
Kullanıcı ofisi. |
|
Position
|
workPosition | string |
Kullanıcı çalışma konumu. |
|
Organizasyon
|
organization | string |
Kullanıcı kuruluşu. |
|
Diğer Kişiler
|
otherContacts | string |
Diğer kişileri kullan. |
|
Kullanıcı kimliği
|
id | integer |
Kullanıcı Kimliği (tPerson.iPersonId). |
|
Kullanıcı adı (eski sistemler için)
|
sAMAccountName | string |
Windows'un önceki sürümünü destekleyen kullanıcı kullanıcı adı. |
|
Kullanıcı adı
|
login | string |
Kullanıcı kullanıcı adı. |
|
Oluşturuldu
|
createdDate | date-time |
Kullanıcı oluşturma tarihi. |
|
Sistem
|
isSystem | boolean |
Kullanıcının Alvao Sistemi olup olmadığı. |
|
Gizli
|
isHidden | boolean |
Kullanıcının menülerde gizlenip gizlenmediği. |
|
Paylaşılan
|
isShared | boolean |
Kullanıcının paylaşılan bir hesap olup olmadığı. |
|
Devre Dışı
|
isDisabled | boolean |
Kullanıcının devre dışı bırakılmış bir hesap olup olmadığı. |
|
Konuk
|
isGuest | boolean |
Kullanıcının Konuk kullanıcı olup olmadığı. |
|
Uygulamadır
|
isApp | boolean |
Kullanıcının bir uygulama hesabı olup olmadığı. |
|
Removed
|
removedDate | date-time |
Kullanıcı kaldırma tarihi. |
|
Yönetici Kimliği
|
managerId | integer |
Kullanıcı yöneticisi kimliği (tPerson.iPersonId). |
|
Yedek Kimlik
|
substituteId | integer |
Kullanıcı değiştirme kimliği (tPerson.iPersonId). |
|
Kişisel Numara
|
personalNumber | string |
Kullanıcı kişisel numarası. |
|
Tercih Edilen Dil Kimliği
|
localeId | integer |
Kullanıcı tarafından tercih edilen dil kimliği. |
|
Saat Dilimi
|
timezone | string |
Kullanıcı saat dilimi. |
|
Özel Öğeler
|
customItems | object |
Kullanıcı özel öğeleri (tPersonCust). |
|
AD GUID
|
adGuid | string |
Kullanıcı AD GUID'i. |
|
İlk İsim
|
firstName | string |
Kullanıcı adı. |
|
Soyadı
|
lastName | string |
Kullanıcı soyadı. |
|
SID
|
sid | string |
Kullanıcı SID'i. |
|
AD Yolu
|
adPath | string |
Kullanıcı AD yolu. |
|
Azure Kimliği
|
azureAdObjectId | string |
Kullanıcı Azure Kimliği |
Common.UsersApiResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
value
|
value | array of Common.Person |
String
Bu, 'string' temel veri türüdür.