Udostępnij przez

ALVAO

Usługa Alvao umożliwia automatyzowanie akcji w usłudze Alvao Service Desk i Zarządzanie zasobami oraz integrowanie ich z innymi aplikacjami.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Pomoc techniczna dotycząca ALVAO
adres URL https://www.alvao.com/en/support-and-services
Email support@alvao.com
Metadane łącznika
Publisher ALVAO
Witryna internetowa https://www.alvao.com
Zasady ochrony prywatności https://www.alvao.com/en/privacystatement
Kategorie Współpraca;operacje IT

Za pomocą tego łącznika możesz użyć usługi Power Automate, Power Apps lub Azure Logic Apps, aby zautomatyzować akcje w usłudze Alvao lub zintegrować aplikację Alvao z innymi aplikacjami. Łącznik umożliwia rozpoczęcie automatyzacji powiązanych nie tylko z przepływem pracy biletów w usłudze Service Desk, ale także cyklem życia zasobów zarejestrowanych w usłudze Asset Management. Następnie akcje łącznika umożliwiają przeniesienie przepływu pracy biletu lub zarządzanie cyklem życia zasobu.

Wymagania wstępne

Musisz być klientem ALVAO (SaaS lub on-prem) z wersją ALVAO co najmniej 11.1 i mieć interfejs API REST dostępny z Internetu.

Jak uzyskać poświadczenia

  1. Utwórz konto aplikacji w programie Alvao WebApp - - AdministrationUsers.
  2. Ustaw co najmniej element Name and Surnamei User name włącz opcję Application account - Other applications.
  3. Ustaw hasło na to konto.
  4. Ustaw odpowiednie uprawnienia dla konta do pracy z biletami lub elementami zawartości.
  5. Użyj wartości User name i Password tego konta, aby utworzyć połączenie z tym łącznikiem.

Uwaga: adres URL będzie również potrzebny do interfejsu API REST usługi Alvao, który można znaleźć w pliku Alvao WebAppSettings - Web servicesAdministration - - .

Wprowadzenie do łącznika

Po utworzeniu połączenia można użyć różnych wyzwalaczy lub akcji.

Na przykład przyznaj uprawnienie do odczytu folderu w programie SharePoint przy użyciu zautomatyzowanego przepływu na podstawie zatwierdzenia biletu w usłudze Alvao Service Desk:

  1. When a ticket transitions to a status Użyj wyzwalacza i określ nazwę procesu oraz stan, w którym ma być wyzwalany przepływ.
  2. Następnie dodaj Get Ticket akcję i jako dane wejściowe wprowadź Ticket ID dostępne z wyzwalacza.
  3. Następnie użyj na przykład wiadomości e-mail nadawcy, którą otrzymasz od akcji, i użyj jej do znalezienia użytkownika w usłudze M365 i przypisania mu odpowiednich uprawnień.

Inne akcje mogą również pomóc w automatyzacji w usłudze Asset Management. Na przykład akcje tworzenia elementu zawartości, zmiany wartości jego właściwości lub przenoszenia ich w rejestrze. Jeśli musisz regularnie importować zasoby z innego systemu, możesz użyć akcji Import objects from CSV.

Znane problemy i ograniczenia

  • Wszystkie wyzwalacze są dostępne tylko w wersji ALVAO 11.2 lub nowszej.
  • Te akcje są dostępne tylko w ALVAO 11.2 lub nowszym:
    • Tworzenie obiektu
    • Pobieranie obiektu
    • Pobieranie obiektów
    • Aktualizowanie właściwości obiektu
    • Przenoszenie obiektów
    • Pobieranie użytkowników
    • Importowanie obiektów z pliku CSV
  • Niektóre akcje wymagają identyfikatora jednostki jako danych wejściowych, które muszą istnieć w usłudze Alvao. Te identyfikatory są zwykle znajdowane w aplikacji internetowej Alvao na końcu adresu URL na ich stronach szczegółów lub edycji.

Typowe błędy i środki zaradcze

  • 403 Zabronione — sprawdź, czy używane konto aplikacji ma wszystkie uprawnienia niezbędne do wykonania akcji. Sprawdź również poświadczenia używane w połączeniu.
  • 404 Nie znaleziono — sprawdź, czy wszystkie parametry wejściowe są poprawne, a adres URL interfejsu API REST jest poprawny w połączeniu. Sprawdź, czy akcja jest dostępna w twojej wersji ALVAO.

Często zadawane pytania

Pola niestandardowe

Łącznik obsługuje również odczytywanie i zapisywanie wartości z/do pól niestandardowych biletu. Nie można opisać pól niestandardowych w ogólnej definicji łącznika, dlatego do ich przetwarzania należy użyć następujących technik.

Aby odczytać wartość pola niestandardowego biletu, użyj wyrażeń w Get ticket akcji. Na przykład aby odczytać wartość pola TicketCategory, użyj wyrażenia:

outputs('Get_request')?['body/customItems/TicketCategory/value']

Aby zapisać wartość w polu niestandardowym biletu, użyj Update ticket akcji z niestandardową specyfikacją JSON. Na przykład aby zapisać wartość "monitor failure" w polu TicketCategory, użyj tej specyfikacji w Custom Items polu:

{
  "TicketCategory": {
    "@@odata.type": "#Alvao.Rest.Api.Models.SD.CustomItem",
    "name": "TicketCategory",
    "value": "monitor failure"
  }
}

Uwaga: znak "@" jest podwajany z powodu ucieczki.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:
Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Host ciąg Określanie adresu URL hosta interfejsu API REST usługi ALVAO Prawda
Nazwa użytkownika ciąg Nazwa użytkownika konta aplikacji ALVAO Prawda
Hasło securestring Hasło do konta aplikacji ALVAO Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Aktualizowanie właściwości obiektu

Aktualizuje właściwości obiektu.
Bilet aktualizacji

Aktualizuje kolumny biletów. Ustaw tylko właściwości do zmiany. Aby zmienić ustawienie umowy SLA, slaId lub slaName. Aby zmienić element żądający, ustaw tylko identyfikator obiektu żądającego lub wszystkie dane w żądaniu (niezarejestrowany użytkownik).
Importowanie obiektów z pliku CSV

Importuje obiekty w formacie CSV. Podobne funkcje do narzędzia ImportUtil.
Pobieranie obiektu

Zwraca obiekt z jego właściwościami.
Pobieranie obiektów

Zwraca obiekty z jego właściwościami zgodnie z parametrami OData.
Pobieranie użytkowników

Zwraca użytkowników i ich właściwości zgodnie z parametrami OData.
Przenieś obiekt

Przenosi obiekt do określonego miejsca docelowego.
Przenoszenie biletu do innej usługi

Przenosi bilet do innej usługi. Wymagany jest identyfikator usługi lub nazwa usługi.
Przypisywanie biletu do zespołu rozwiązywania lub rozwiązywania problemów

Przypisuje bilet do zespołu rozwiązywania lub rozwiązywania problemów.
Tworzenie biletu

Tworzy nowy bilet.
Tworzenie obiektu

Tworzy nowy obiekt z określonego szablonu w określonym obiekcie.
Tworzenie rekordu w dzienniku biletów

Tworzy rekord w dzienniku biletów.
Uzyskiwanie biletu

Zwraca właściwości biletu.
Zmienianie stanu biletu

Zmienia stan biletu. Można go również użyć do rozwiązywania lub ponownego otwierania biletu. Wymagany jest identyfikator stanu lub nazwa stanu.

Aktualizowanie właściwości obiektu

Identyfikator operacji:
UpdateObjectProperties

Aktualizuje właściwości obiektu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Object
 objectId True integer

Wybierz obiekt lub wprowadź jego identyfikator (tblNode.intNodeId).
Name
 name string

Wybierz właściwość obiektu.
Wartość
 value string

Określ wartość właściwości.

Bilet aktualizacji

Identyfikator operacji:
UpdateTicket

Aktualizuje kolumny biletów. Ustaw tylko właściwości do zmiany. Aby zmienić ustawienie umowy SLA, slaId lub slaName. Aby zmienić element żądający, ustaw tylko identyfikator obiektu żądającego lub wszystkie dane w żądaniu (niezarejestrowany użytkownik).

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator biletu
 ticketId True integer

Określ identyfikator biletu (tHdTicket.iHdTicketId).
Name
 name string

Nazwa biletu.
Priority
 priority string

Priorytet biletu.
Wpływ
 impact string

Wpływ biletu.
Pilność
 urgency string

Pilność biletu.
Identyfikator umowy SLA
 slaId integer

Identyfikator umowy SLA biletu (tSla.iSlaId).
Nazwa umowy SLA
 slaName string

Nazwa umowy SLA biletu.
Numer urządzenia
 deviceNumber string

Numer urządzenia biletu.
Powiązana organizacja
 relatedOrganization string

Nazwa organizacji powiązanej z biletami.
Wewnętrzna data docelowa
 internalTargetDate date-time

Wewnętrzna data docelowa biletu.
Element docelowy wewnętrzny
 internalTarget string

Element docelowy wewnętrzny biletu.
Name
 name string

Nazwa osoby żądającego.
E-mail
 email string

Wiadomość e-mail z żądaniem.
Adres e-mail 2
 email2 string

Wiadomość e-mail żądającego 2.
Telefon
 phone string

Telefon żądający.
Telefon 2
 phone2 string

Telefon żądający 2.
Telefon komórkowy
 mobilePhone string

Żądający telefon komórkowy.
Dział
 department string

Dział żądań.
Office
 office string

Biuro żądającego.
Stanowisko pracy
 workPosition string

Pozycja pracy żądającego.
Organization
 organization string

Organizacja żądającego.
Inne kontakty
 otherContacts string

Inne kontakty osoby żądającego.
Elementy niestandardowe
 customItems object

Elementy niestandardowe biletu (tHdTicketCust).

Importowanie obiektów z pliku CSV

Identyfikator operacji:
ImportObjectsFromCsv

Importuje obiekty w formacie CSV. Podobne funkcje do narzędzia ImportUtil.

Parametry

Nazwa Klucz Wymagane Typ Opis
CSV
 contentCsv True string

Zawartość CSV do zaimportowania.
Typ obiektu
 objectTypeId integer

Typ importowanych obiektów.
Format daty/godziny
 dateTimeFormat string

Format daty/godziny w ciągach tekstowych (np. dd/MM/rrrr).
Rozdzielacz
 separator string

Separator kolumn używany w zaimportowanych woluminach CSV.
Pomiń błędy
 skipErrors boolean

Jeśli to ustawienie jest włączone, dane są importowane, nawet jeśli wystąpił błąd w jednym z wpisów.
Właściwości klucza
 keyFields string

Pola klucza używane do identyfikowania i aktualizowania istniejących obiektów (np. numer seryjny, model).
Obiekt nadrzędny
 createUnderObjectId integer

Obiekt nadrzędny do tworzenia nowych obiektów.
Aktualizacja odrzuconych obiektów
 updateDiscardedObjects boolean

W przypadku włączenia odrzucone obiekty są również wyszukiwane i aktualizowane podczas importowania.

Zwraca

Body
AM.ImportCsvResponse

Pobieranie obiektu

Identyfikator operacji:
GetObject

Zwraca obiekt z jego właściwościami.

Parametry

Nazwa Klucz Wymagane Typ Opis
Object
 objectId True integer

Wybierz obiekt lub wprowadź jego identyfikator (tblNode.intNodeId).

Zwraca

Body
AM.ObjectExpanded

Pobieranie obiektów

Identyfikator operacji:
GetObjects

Zwraca obiekty z jego właściwościami zgodnie z parametrami OData.

Parametry

Nazwa Klucz Wymagane Typ Opis
Do góry
 $top integer

Określ liczbę obiektów, które chcesz zwrócić.
Search
 $search string

Określ warunek wyszukiwania pełnotekstowego. $search OData.
Filter
 $filter string

Określ filtr, np. Name eq 'Milk'. $filter OData.
Zamów według
 $orderBy string

Określ kolejność. $orderBy OData.

Zwraca

Body
AM.ObjectsExpandedApiResponse

Pobieranie użytkowników

Identyfikator operacji:
GetUsers

Zwraca użytkowników i ich właściwości zgodnie z parametrami OData.

Parametry

Nazwa Klucz Wymagane Typ Opis
Do góry
 $top integer

Określ liczbę obiektów, które chcesz zwrócić.
Search
 $search string

Określ warunek wyszukiwania pełnotekstowego. $search OData.
Filter
 $filter string

Określ filtr, np. e-mail eq "james.smith@contoso.com". $filter OData.
Zamów według
 $orderBy string

Określ kolejność. $orderBy OData.

Zwraca

Body
Common.UsersApiResponse

Przenieś obiekt

Identyfikator operacji:
MoveObject

Przenosi obiekt do określonego miejsca docelowego.

Parametry

Nazwa Klucz Wymagane Typ Opis
Object
 objectId True integer

Wybierz obiekt lub wprowadź jego identyfikator (tblNode.intNodeId).
Obiekt docelowy
 parentObjectId integer

Wybierz obiekt docelowy lub wprowadź jego identyfikator (tblNode.intNodeId).

Przenoszenie biletu do innej usługi

Identyfikator operacji:
MoveTicketToAnotherService

Przenosi bilet do innej usługi. Wymagany jest identyfikator usługi lub nazwa usługi.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator biletu
 ticketId True integer

Określ identyfikator biletu (tHdTicket.iHdTicketId).
Identyfikator usługi
 serviceId integer

Nowy identyfikator usługi (tHdSection.iHdSectionId).
Nazwa usługi
 serviceName string

Nowa nazwa usługi.
Identyfikator modułu rozwiązywania
 newSolverId integer

Nowy identyfikator modułu rozwiązywania (tPerson.iPersonId).
Identyfikator zespołu modułu rozwiązywania
 newSolverTeamId integer

Nowy identyfikator zespołu rozwiązywania problemów (tRole.iPersonId).
Comment
 commentHtml string

Komentarz w kodzie HTML.
Bajty zawartości
 contentBytes string

Zawartość zakodowana w bazie Base64.
Typ zawartości
 contentType string

Typ zawartości, np. image/png.
Nazwa zawartości
 name string

Nazwa zawartości.

Zwraca

response
string

Przypisywanie biletu do zespołu rozwiązywania lub rozwiązywania problemów

Identyfikator operacji:
AssignTicketToSolverOrSolverTeam

Przypisuje bilet do zespołu rozwiązywania lub rozwiązywania problemów.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator biletu
 ticketId True integer

Określ identyfikator biletu (tHdTicket.iHdTicketId).
Identyfikator modułu rozwiązywania
 solverId integer

Nowy identyfikator modułu rozwiązywania (tPerson.iPersonId).
Identyfikator zespołu modułu rozwiązywania
 solverTeamId integer

Nowy identyfikator zespołu rozwiązywania problemów (tRole.iPersonId).
Message
 messageForSolverHtml string

Komunikat dotyczący narzędzia do rozwiązywania problemów i/lub dla zespołu rozwiązywania w kodzie HTML.
Bajty zawartości
 contentBytes string

Zawartość zakodowana w bazie Base64.
Typ zawartości
 contentType string

Typ zawartości, np. image/png.
Nazwa zawartości
 name string

Nazwa zawartości.

Zwraca

response
string

Tworzenie biletu

Identyfikator operacji:
CreateTicket

Tworzy nowy bilet.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator usługi
 serviceId True integer

Identyfikator usługi biletów (tHdSection.iHdSectionId).
Name
 name True string

Nazwa biletu.
Description
 descriptionHtml string

Opis biletu w kodzie HTML.
Identyfikator umowy SLA
 slaId integer

Identyfikator umowy SLA biletu (tSla.iSlaId).
Priority
 priority string

Priorytet biletu.
Wpływ
 impact string

Wpływ biletu.
Pilność
 urgency string

Pilność biletu.
Numer urządzenia
 deviceNumber string

Numer urządzenia biletu.
Powiązana organizacja
 relatedOrganization string

Nazwa organizacji powiązanej z biletami.
Zażądano identyfikatora osoby
 requestedForPersonId integer

Zażądano identyfikatora osoby (tPerson.iPersonId).
identyfikator
 id integer

Identyfikator osoby żądającego (tPerson.iPersonId).
Name
 name string

Nazwa osoby żądającego.
E-mail
 email string

Wiadomość e-mail żądającego.
Adres e-mail 2
 email2 string

Wiadomość e-mail żądającego 2.
Telefon
 phone string

Telefon żądający.
Telefon 2
 phone2 string

Telefon żądający 2.
Telefon komórkowy
 mobilePhone string

Żądający telefon komórkowy.
Dział
 department string

Dział żądań.
Office
 office string

Biuro żądającego.
Stanowisko pracy
 workPosition string

Pozycja pracy żądającego.
Organization
 organization string

Organizacja żądającego.
Inne kontakty
 otherContacts string

Żądający innych kontaktów.
Objects
 objects array of integer

Łącza do obiektów.
Bajty zawartości
 contentBytes string

Zawartość zakodowana w bazie Base64.
Typ zawartości
 contentType string

Typ zawartości, np. image/png.
Nazwa zawartości
 name string

Nazwa zawartości.
Elementy niestandardowe
 customItems object

Elementy niestandardowe biletu (tHdTicketCust).

Zwraca

Body
SD.Ticket

Tworzenie obiektu

Identyfikator operacji:
CreateObject

Tworzy nowy obiekt z określonego szablonu w określonym obiekcie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Template
 templateObjectId True integer

Wybierz szablon obiektu lub wprowadź jego identyfikator (tblNode.intNodeId).
Obiekt nadrzędny
 parentObjectId integer

Wybierz obiekt nadrzędny lub wprowadź jego identyfikator (tblNode.intNodeId).

Zwraca

Body
AM.Object

Tworzenie rekordu w dzienniku biletów

Identyfikator operacji:
CreateRecordInTicketLog

Tworzy rekord w dzienniku biletów.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator biletu
 ticketId True integer

Określ identyfikator biletu (tHdTicket.iHdTicketId).
Temat
 subject True string

Temat rekordu.
Zawartość HTML
 contentHtml string

Zawartość rekordu w języku Html.
Zawartość zwykłego tekstu
 contentPlain string

Zawartość rekordu w postaci zwykłego tekstu.
Rodzaj
 kind True string

Rodzaj rekordu.
Od nazwy
 from string

Nazwa nadawcy.
Z poczty e-mail
 emailFrom string

Wiadomość e-mail nadawcy.
Do
 emailTo string

Adresaci wiadomości rozdzielone średnikiem.
Kopiuj
 emailCc string

Adresaci wiadomości rozdzielone średnikiem.
Z identyfikatora osoby
 fromPersonId integer

Identyfikator osoby autora (tPerson.iPersonId).
Do identyfikatora osoby
 toPersonId integer

Identyfikator osoby odbiorcy (tPerson.iPersonId).
Data utworzenia
 created string

Data i godzina utworzenia rekordu. Pozostaw wartość pustą dla bieżącej.
Pokaż do żądania
 showToRequester boolean

Zdecyduj, czy element żądający powinien zobaczyć rekord.
Bajty zawartości
 contentBytes string

Zawartość zakodowana w bazie Base64.
Typ zawartości
 contentType string

Typ zawartości, np. image/png.
Nazwa zawartości
 name string

Nazwa zawartości.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator rekordu
 id integer

Identyfikator rekordu dziennika (tAct.iActId).
Temat
 subject string

Temat rekordu dziennika.
Zawartość HTML
 contentHtml string

Rejestrowanie zawartości rekordu w kodzie HTML.
Zawartość zwykłego tekstu
 contentPlain string

Rejestrowanie zawartości rekordu w postaci zwykłego tekstu.
Data utworzenia
 created string

Data utworzenia rekordu dziennika.
Rodzaj
 kind string

Rodzaj rekordu dziennika.
Od nazwy
 from string

Nazwa autora rekordu dziennika.
Z poczty e-mail
 emailFrom string

Poczta e-mail autora rekordu dziennika.
Do
 emailTo string

Adresy e-mail odbiorników rekordów dziennika.
Kopiuj
 emailCc string

Adresy e-mail odbiorników rekordów dziennika.
Z identyfikatora osoby
 fromPersonId integer

Identyfikator nadawcy rekordu dziennika (tPerson.iPersonId).
Do identyfikatora osoby
 toPersonId integer

Identyfikator odbiorcy rekordu dziennika (tPerson.iPersonId).
Identyfikator komunikatu
 messageId string

Identyfikator komunikatu rekordu dziennika.
Załączniki
 attachments array of object

Załączniki rekordów dziennika.
Nazwa załącznika
 attachments.name string

Nazwa załącznika.
Identyfikator załącznika
 attachments.id integer

Identyfikator załącznika (tDocument.iDocumentId).
Łącze załącznika
 attachments.link string

Połącz z załącznikiem.

Uzyskiwanie biletu

Identyfikator operacji:
GetTicket

Zwraca właściwości biletu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator biletu
 ticketId True integer

Określ identyfikator biletu (tHdTicket.iHdTicketId).

Zwraca

Body
SD.Ticket

Zmienianie stanu biletu

Identyfikator operacji:
ChangeTicketState

Zmienia stan biletu. Można go również użyć do rozwiązywania lub ponownego otwierania biletu. Wymagany jest identyfikator stanu lub nazwa stanu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator biletu
 ticketId True integer

Określ identyfikator biletu (tHdTicket.iHdTicketId).
Identyfikator stanu
 stateId integer

Nowy identyfikator stanu (TicketState.id).
Nazwa stanu
 stateName string

Nowa nazwa stanu.
Comment
 commentHtml string

Komentarz w kodzie HTML.
Komentarz dla osób zatwierdzających
 commentForApprovers string

Komentarz dla osób zatwierdzających w kodzie HTML.
Komentarz dla osób żądających
 commentForRequesters string

Komentarz dla osób żądających w kodzie HTML.
Bajty zawartości
 contentBytes string

Zawartość zakodowana w bazie Base64.
Typ zawartości
 contentType string

Typ zawartości, np. image/png.
Nazwa zawartości
 name string

Nazwa zawartości.

Zwraca

response
string

Wyzwalacze

Gdy bilet przechodzi do stanu

Ta operacja jest wyzwalana, gdy bilet przechodzi do określonego stanu.
Gdy wartość właściwości obiektu zostanie zmieniona

Ta operacja jest wyzwalana po zmianie wartości określonej właściwości obiektu.
Po przeniesieniu obiektu

Ta operacja jest wyzwalana, gdy obiekt określonego rodzaju jest przenoszony do innej pozycji w drzewie obiektów.
Po utworzeniu obiektu

Ta operacja jest wyzwalana po utworzeniu obiektu określonego rodzaju.
Po zmianie wartości pola biletu

Ta operacja jest wyzwalana po zmianie określonej wartości pola biletu.

Gdy bilet przechodzi do stanu

Identyfikator operacji:
TicketTransitionsToStatus

Ta operacja jest wyzwalana, gdy bilet przechodzi do określonego stanu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Proces
 process True string

Wprowadź nazwę procesu, dla którego chcesz wyzwolić ten przepływ.
Stan biletu
 status True string

Wprowadź nazwę stanu biletu. Przejście biletu do tego stanu spowoduje wyzwolenie tego przepływu.
Usługa
 service string

Wprowadź nazwę usługi, dla której chcesz wyzwolić ten przepływ.

Zwraca

Body
Webhook.UpdatedTicket

Gdy wartość właściwości obiektu zostanie zmieniona

Identyfikator operacji:
ObjectPropertyChanged

Ta operacja jest wyzwalana po zmianie wartości określonej właściwości obiektu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Majątek
 propertyKindId integer

Wybierz właściwość obiektu, dla którego chcesz wyzwolić ten przepływ.
Nowa wartość
 newValue string

Wprowadź nową wartość właściwości, dla której chcesz wyzwolić ten przepływ. Np. PC123, 1.45, 14. 4. 2024.
Rodzaj obiektu
 kindId integer

Wybierz rodzaj obiektu, dla którego chcesz wyzwolić ten przepływ.
Obiekt nadrzędny
 parentObjectId integer

Wybierz obiekt nadrzędny, dla którego poddrzewo chcesz wyzwolić ten przepływ.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator obiektu
 objectId integer

Identyfikator obiektu (tblNode.intNodeId).
Identyfikator właściwości
 propertyId integer

Zmieniono identyfikator właściwości (tblProperty.intPropertyId).

Po przeniesieniu obiektu

Identyfikator operacji:
ObjectMoved

Ta operacja jest wyzwalana, gdy obiekt określonego rodzaju jest przenoszony do innej pozycji w drzewie obiektów.

Parametry

Nazwa Klucz Wymagane Typ Opis
Rodzaj
 kindId integer

Wybierz rodzaj obiektu, dla którego chcesz wyzwolić ten przepływ.
Przeniesiono z
 fromObjectId integer

Wybierz obiekt źródłowy, dla którego poddrzewo chcesz wyzwolić ten przepływ.
Przeniesiono do
 toObjectId integer

Wybierz obiekt docelowy, dla którego poddrzewo chcesz wyzwolić ten przepływ.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator obiektu
 objectId integer

Identyfikator obiektu (tblNode.intNodeId).
Stary identyfikator obiektu nadrzędnego
 oldParentObjectId integer

Stary identyfikator obiektu nadrzędnego (tblNode.intNodeId).

Po utworzeniu obiektu

Identyfikator operacji:
ObjectCreated

Ta operacja jest wyzwalana po utworzeniu obiektu określonego rodzaju.

Parametry

Nazwa Klucz Wymagane Typ Opis
Rodzaj
 kindId integer

Wybierz rodzaj obiektu, dla którego chcesz wyzwolić ten przepływ.
Obiekt nadrzędny
 parentObjectId integer

Wybierz obiekt nadrzędny, dla którego poddrzewo chcesz wyzwolić ten przepływ.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator obiektu
 objectId integer

Identyfikator obiektu (tblNode.intNodeId).

Po zmianie wartości pola biletu

Identyfikator operacji:
TicketFieldChanged

Ta operacja jest wyzwalana po zmianie określonej wartości pola biletu.

Parametry

Nazwa Klucz Wymagane Typ Opis
(No changes needed)
 fieldId True integer

Wybierz pole biletu.
Proces
 process string

Wprowadź nazwę procesu, dla którego chcesz wyzwolić ten przepływ.
Usługa
 service string

Wprowadź nazwę usługi, dla której chcesz wyzwolić ten przepływ.

Zwraca

Body
Webhook.UpdatedTicket

Definicje

SD. Bilet

Nazwa Ścieżka Typ Opis
identyfikator
 id integer

Identyfikator biletu (tHdTicket.iHdTicketId).
Name
 name string

Nazwa biletu.
Tag komunikatu
 messageTag string

Tag komunikatu biletu.
Identyfikator umowy SLA
 slaId integer

Identyfikator umowy SLA (tSla.iSlaId).
Nazwa umowy SLA
 slaName string

Nazwa umowy SLA.
Priority
 priority string

Priorytet biletu.
Wpływ
 impact string

Wpływ biletu.
Pilność
 urgency string

Pilność biletu.
Numer urządzenia
 deviceNumber string

Numer urządzenia biletu.
Powiązana organizacja
 relatedOrganization string

Nazwa organizacji powiązanej z biletami.
Wewnętrzna data docelowa
 internalTargetDate date-time

Wewnętrzna data docelowa biletu.
Element docelowy wewnętrzny
 internalTarget string

Element docelowy wewnętrzny biletu.
Identyfikator obiektu żądającego
 requesterId integer

Identyfikator osoby żądającego (tPerson.iPersonId).
Nazwa osoby żądającego
 requesterName string

Nazwa osoby żądającego.
Zażądano identyfikatora
 requestedForId integer

Zażądano identyfikatora (tPerson.iPersonId).
Zażądano nazwy
 requestedForName string

Zażądano nazwy.
Identyfikator modułu rozwiązywania
 solverId integer

Identyfikator modułu rozwiązywania biletów (tPerson.iPersonId).
Nazwa modułu rozwiązywania
 solverName string

Nazwa modułu rozwiązywania biletów.
Identyfikator zespołu modułu rozwiązywania
 solverTeamId integer

Identyfikator zespołu rozwiązywania biletów (tRole.iRoleId).
Nazwa zespołu modułu rozwiązywania
 solverTeamName string

Nazwa zespołu rozwiązywania biletów.
Identyfikator usługi
 serviceId integer

Identyfikator usługi biletów (tHdSection.iHdSectionId).
Nazwa usługi
 serviceName string

Nazwa usługi biletów.
Nazwa procesu
 processName string

Nazwa procesu usługi.
Identyfikator stanu
 stateId integer

Identyfikator stanu biletu (TicketState.id).
Nazwa stanu
 stateName string

Nazwa stanu biletu.
Data utworzenia
 createdDate date-time

Data utworzenia biletu.
Data rozwiązania sprawy
 resolvedDate date-time

Data rozwiązania biletu.
Data zamknięcia
 closedDate date-time

Data zamknięcia biletu.
Identyfikator aktu początkowego
 initialActId integer

Początkowy identyfikator aktu (tAct.iActId).
Data usunięcia
 removedDate date-time

Data usunięcia biletu.
W zatwierdzeniach
 inApproval boolean

Czy bilet jest w procesie zatwierdzania.
Data upływu
 dueDate date-time

Data ukończenia biletu.
Objects
 objects array of object

Łącza do obiektów.
identyfikator
 objects.objectId integer

Identyfikator obiektu (tblNode.intNodeId).
Elementy niestandardowe
 customItems object

Elementy niestandardowe biletu (tHdTicketCust).

Element webhook.UpdatedTicket

Nazwa Ścieżka Typ Opis
Identyfikator biletu
 requestId integer

Identyfikator biletu (tHdTicket.iHdTicketId).
Identyfikator osoby
 personId integer

Identyfikator osoby, która dokonała zmiany (tPerson.iPersonId).

AM. Sprzeciwiać się

Nazwa Ścieżka Typ Opis
identyfikator
 id integer

Identyfikator obiektu (tblNode.intNodeId).
Name
 name string

Nazwa obiektu.
Ścieżka
 path string

Ścieżka obiektu w drzewie.
Pełna nazwa
 fullName string

Nazwa obiektu ze ścieżką w drzewie.
Identyfikator rodzaju
 kindId integer

Identyfikator typu obiektu (tblKind.intKindId).
Nazwa rodzaju
 kindName string

Nazwa rodzaju obiektu.
Ukryty
 hidden boolean

Czy obiekt jest ukryty.
Identyfikator obiektu nadrzędnego
 parentObjectId integer

Identyfikator obiektu nadrzędnego (tblNode.intNodeId).

AM. ObjectExpanded

Nazwa Ścieżka Typ Opis
identyfikator
 id integer

Identyfikator obiektu (tblNode.intNodeId).
Name
 name string

Nazwa obiektu.
Ścieżka
 path string

Ścieżka obiektu w drzewie.
Pełna nazwa
 fullName string

Nazwa obiektu ze ścieżką w drzewie.
Identyfikator rodzaju
 kindId integer

Identyfikator typu obiektu (tblKind.intKindId).
Nazwa rodzaju
 kindName string

Nazwa rodzaju obiektu.
Ukryty
 hidden boolean

Czy obiekt jest ukryty.
Identyfikator obiektu nadrzędnego
 parentObjectId integer

Identyfikator obiektu nadrzędnego (tblNode.intNodeId).
Właściwości
 properties array of object

Właściwości obiektu.
identyfikator
 properties.id integer

Identyfikator właściwości (tblProperty.intPropertyId).
Name
 properties.name string

Nazwa właściwości.
Wartość
 properties.value string

Wartość właściwości.
Kolejność nazw
 properties.nameOrder integer

Kolejność nazw właściwości.

AM. ObjectsExpandedApiResponse

Nazwa Ścieżka Typ Opis
value
 value array of AM.ObjectExpanded

AM. ImportCsvResponse

Nazwa Ścieżka Typ Opis
Łączna liczba rekordów
 recordsTotalCount integer

Łączna liczba rekordów w pliku CSV.
Liczba przetworzonych rekordów
 recordsProcessedCount integer

Liczba przetworzonych rekordów.
Liczba pominiętych rekordów
 recordsSkippedCount integer

Liczba pominiętych rekordów.
Liczba nieudanych rekordów
 recordsFailedCount integer

Liczba rekordów, które zakończyły się niepowodzeniem.
Liczba utworzonych obiektów
 objectsCreatedCount integer

Liczba utworzonych obiektów.
Liczba zaktualizowanych obiektów
 objectsUpdatedCount integer

Liczba zaktualizowanych obiektów.
Log
 log string

Importuj dziennik zawierający szczegółowe informacje.

Common.Person

Nazwa Ścieżka Typ Opis
Name
 name string

Imię i nazwisko użytkownika.
E-mail
 email string

Adres e-mail użytkownika.
Adres e-mail 2
 email2 string

Adres e-mail użytkownika 2.
Telefon służbowy
 phone string

Telefon służbowy użytkownika.
Telefon służbowy 2
 phone2 string

Telefon służbowy użytkownika 2.
Telefon komórkowy
 mobilePhone string

Telefon komórkowy użytkownika.
Dział
 department string

Dział użytkowników.
Office
 office string

Biuro użytkownika.
Position
 workPosition string

Stanowisko pracy użytkownika.
Organization
 organization string

Organizacja użytkowników.
Inne kontakty
 otherContacts string

Użytkownik innych kontaktów.
Identyfikator użytkownika
 id integer

Identyfikator użytkownika (tPerson.iPersonId).
Nazwa użytkownika (dla starszych systemów)
 sAMAccountName string

Nazwa użytkownika obsługującą poprzednią wersję systemu Windows.
Nazwa użytkownika
 login string

Nazwa użytkownika.
Created
 createdDate date-time

Data utworzenia użytkownika.
Jest systemem
 isSystem boolean

Czy użytkownik jest systemem Alvao.
Jest ukryty
 isHidden boolean

Czy użytkownik jest ukryty w menu.
Jest współużytkowany
 isShared boolean

Czy użytkownik jest kontem udostępnionym.
Jest wyłączona
 isDisabled boolean

Czy użytkownik jest wyłączonym kontem.
Jest gościem
 isGuest boolean

Czy użytkownik jest użytkownikiem-gościem.
Czy aplikacja
 isApp boolean

Czy użytkownik jest kontem aplikacji.
Removed
 removedDate date-time

Data usunięcia użytkownika.
Identyfikator menedżera
 managerId integer

Identyfikator menedżera użytkowników (tPerson.iPersonId).
Identyfikator podstawy
 substituteId integer

Identyfikator zastępczy użytkownika (tPerson.iPersonId).
Numer osobisty
 personalNumber string

Numer osobisty użytkownika.
Preferowany identyfikator języka
 localeId integer

Identyfikator preferowanego języka użytkownika.
Strefa czasowa
 timezone string

Strefa czasowa użytkownika.
Elementy niestandardowe
 customItems object

Elementy niestandardowe użytkownika (tPersonCust).
AD GUID
 adGuid string

Identyfikator GUID usługi AD użytkownika.
Imię
 firstName string

Imię użytkownika.
Nazwisko
 lastName string

Nazwisko użytkownika.
SID
 sid string

Identyfikator SID użytkownika.
Ścieżka usługi AD
 adPath string

Ścieżka usługi AD użytkownika.
Identyfikator platformy Azure
 azureAdObjectId string

Identyfikator platformy Azure użytkownika

Common.UsersApiResponse

Nazwa Ścieżka Typ Opis
value
 value array of Common.Person

ciąg

Jest to podstawowy typ danych "string".