Udostępnij przez

Cireson Service Manager Portal

Tworzenie i aktualizowanie elementów roboczych za pomocą portalu Cireson dla programu System Center Service Manager

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 Cireson
adres URL https://cireson.com
Email support@cireson.com
Metadane łącznika
Publisher Cireson
Witryna internetowa https://cireson.com/
Zasady ochrony prywatności https://cireson.com/privacy-statement/
Kategorie AI; Witryna internetowa

Rozszerz inwestycję w portal usługi Cireson Service Manager w ekosystem usługi M365 z możliwością kontrolowania elementów roboczych z usługi Power Automate.

Wymagania wstępne

Musisz mieć aktywną licencję portalu Cireson Service Manager, a portal musi być dostępny z Internetu.

Jak uzyskać poświadczenia

Utwórz token platformy (API) w portalu programu Service Manager zgodnie z opisem na stronie https://kb.cireson.com/article/user-guide-authentication-tokens-and-knowledge-base-reporting/2507.

Wprowadzenie do łącznika

Obsługiwane są kilka typowych operacji, takich jak:

  • Po dodaniu nowego komentarza
    • To zdarzenie występuje w dowolnym momencie dodawania komentarza do dowolnego elementu roboczego. To zdarzenie można filtrować do komentarzy analityków lub komentarzy użytkowników końcowych
  • Po utworzeniu nowego elementu roboczego
    • To zdarzenie występuje w dowolnym momencie utworzenia elementu roboczego. To zdarzenie można filtrować do zdarzenia, żądania obsługi, żądania zmiany, problemu lub rekordu wydania
  • Tworzenie/aktualizowanie elementu roboczego
    • Tej akcji można użyć do zmiany typowych właściwości elementu roboczego, takiego jak Tytuł, Opis, Priorytet, Pilność, a także Przypisany/Dotknięty użytkownik na podstawie ich adresu e-mail. Za pomocą adresu e-mail użytkownika można powiązać w innych integracjach M365, w których wiadomość e-mail jest używana do identyfikowania użytkownika.

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
Adres URL portalu ciąg Adres URL portalu programu Service Manager Prawda
ApiKey securestring Klucz APIKey dla tego interfejsu API Prawda

Limity ograniczania

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

Akcje

Aktualizowanie zdarzenia

Aktualizowanie zdarzenia
Aktualizowanie żądania obsługi

Aktualizowanie żądania obsługi
Aktualizowanie żądania zmiany

Aktualizowanie żądania zmiany
Dodawanie komentarza do elementu roboczego

Dodawanie komentarzy dziennika akcji do elementu roboczego
Pobieranie elementu roboczego

Pobieranie danych elementu roboczego przy użyciu identyfikatora
Problem z aktualizacją

Problem z aktualizacją
Rekord wydania aktualizacji

Aktualizowanie wydaniaRekordu
Tworzenie problemu

Tworzenie problemu
Tworzenie rekordu wydania

Tworzenie rekordu wydania
Tworzenie zdarzenia

Tworzenie zdarzenia
Tworzenie żądania obsługi

Tworzenie żądania obsługi
Tworzenie żądania zmiany

Tworzenie żądania zmiany
Usuwanie elementu roboczego

Usuwanie elementu roboczego

Aktualizowanie zdarzenia

Identyfikator operacji:
UpdateIncident

Aktualizowanie zdarzenia

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu roboczego
 Id True string

Identyfikator elementu roboczego
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority integer

Priority
Classification
 Classification string

Classification
Pilność
 Urgency string

Pilność
Wpływ
 Impact string

Wpływ
Źródło
 Source string

Źródło
Grupa wsparcia
 SupportGroup string

Grupa wsparcia
Status
 Status string

Status
Użytkownik, którego dotyczy problem
 RequestedWorkItem string

Użytkownik, którego dotyczy problem
Przypisany użytkownik
 AssignedWorkItem string

Przypisany użytkownik

Zwraca

Body
WorkItem_CreatedIRResponse

Aktualizowanie żądania obsługi

Identyfikator operacji:
UpdateServiceRequest

Aktualizowanie żądania obsługi

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu roboczego
 Id True string

Identyfikator elementu roboczego
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority integer

Priority
Classification
 Classification string

Classification
Pilność
 Urgency string

Pilność
Wpływ
 Impact string

Wpływ
Źródło
 Source string

Źródło
Grupa wsparcia
 SupportGroup string

Grupa wsparcia
Status
 Status string

Status
Użytkownik, którego dotyczy problem
 RequestedWorkItem string

Użytkownik, którego dotyczy problem
Przypisany użytkownik
 AssignedWorkItem string

Przypisany użytkownik

Zwraca

Body
WorkItem_CreatedSRResponse

Aktualizowanie żądania zmiany

Identyfikator operacji:
UpdateChangeRequest

Aktualizowanie żądania zmiany

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu roboczego
 Id True string

Identyfikator elementu roboczego
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority string

Priority
Area
 Area string

Area
Wpływ
 Impact string

Wpływ
Ryzyko
 Risk string

Ryzyko
Status
 Status string

Status
Przypisany użytkownik
 AssignedWorkItem string

Przypisany użytkownik

Zwraca

Body
WorkItem_CreatedSRResponse

Dodawanie komentarza do elementu roboczego

Identyfikator operacji:
AddCommentLog

Dodawanie komentarzy dziennika akcji do elementu roboczego

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu roboczego
 id True string

Identyfikator elementu roboczego
Comment
 Description string

Comment
Dodane przez
 EnteredBy string

Dodane przez
Jest prywatny
 IsPrivate boolean

Jest prywatny
Typ komentarza
 ActionType string

Typ komentarza

Zwraca

Body
WorkItem_ActionLogResponse

Pobieranie elementu roboczego

Identyfikator operacji:
GetWorkItem

Pobieranie danych elementu roboczego przy użyciu identyfikatora

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu roboczego
 WorkItemId True string

Identyfikator elementu roboczego

Zwraca

Body
WorkItem_GetResponse

Problem z aktualizacją

Identyfikator operacji:
UpdateProblem

Problem z aktualizacją

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu roboczego
 Id True string

Identyfikator elementu roboczego
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority string

Priority
Źródło
 Source string

Źródło
Kategoria
 Category string

Kategoria
Wpływ
 Impact string

Wpływ
Pilność
 Urgency string

Pilność
Status
 Status string

Status
Przypisany użytkownik
 AssignedWorkItem string

Przypisany użytkownik

Zwraca

Body
WorkItem_CreatedIRResponse

Rekord wydania aktualizacji

Identyfikator operacji:
UpdateReleaseRecord

Aktualizowanie wydaniaRekordu

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu roboczego
 Id True string

Identyfikator elementu roboczego
Title
 Title string

Title
Description
 Description string

Description
Typ
 Type string

Typ
Kategoria
 Category string

Kategoria
Wpływ
 Impact string

Wpływ
Ryzyko
 Risk string

Ryzyko
Priority
 Priority string

Priority
Status
 Status string

Status
Przypisany użytkownik
 AssignedWorkItem string

Przypisany użytkownik

Zwraca

Body
WorkItem_CreatedSRResponse

Tworzenie problemu

Identyfikator operacji:
CreateProblem

Tworzenie problemu

Parametry

Nazwa Klucz Wymagane Typ Opis
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority string

Priority
Źródło
 Source string

Źródło
Kategoria
 Category string

Kategoria
Wpływ
 Impact string

Wpływ
Pilność
 Urgency string

Pilność
Status
 Status string

Status
Przypisany użytkownik
 AssignedWorkItem string

Przypisany użytkownik

Zwraca

Body
WorkItem_CreatedIRResponse

Tworzenie rekordu wydania

Identyfikator operacji:
CreateReleaseRecord

Tworzenie rekordu wydania

Parametry

Nazwa Klucz Wymagane Typ Opis
Title
 Title string

Title
Description
 Description string

Description
Typ
 Type string

Typ
Kategoria
 Category string

Kategoria
Wpływ
 Impact string

Wpływ
Ryzyko
 Risk string

Ryzyko
Priority
 Priority string

Priority
Status
 Status string

Status
Przypisany użytkownik
 AssignedWorkItem string

Przypisany użytkownik

Zwraca

Body
WorkItem_CreatedSRResponse

Tworzenie zdarzenia

Identyfikator operacji:
CreateIncident

Tworzenie zdarzenia

Parametry

Nazwa Klucz Wymagane Typ Opis
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority integer

Priority
Classification
 Classification True string

Classification
Pilność
 Urgency True string

Pilność
Wpływ
 Impact True string

Wpływ
Źródło
 Source True string

Źródło
Grupa wsparcia
 SupportGroup string

Grupa wsparcia
Status
 Status string

Status
Użytkownik, którego dotyczy problem
 RequestedWorkItem string

Użytkownik, którego dotyczy problem
Przypisany użytkownik
 AssignedWorkItem string

Przypisany użytkownik

Zwraca

Body
WorkItem_CreatedIRResponse

Tworzenie żądania obsługi

Identyfikator operacji:
CreateServiceRequest

Tworzenie żądania obsługi

Parametry

Nazwa Klucz Wymagane Typ Opis
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority string

Priority
Area
 Area True string

Area
Pilność
 Urgency True string

Pilność
Źródło
 Source True string

Źródło
Grupa wsparcia
 SupportGroup string

Grupa wsparcia
Status
 Status string

Status
Użytkownik, którego dotyczy problem
 RequestedWorkItem string

Użytkownik, którego dotyczy problem
Przypisany użytkownik
 AssignedWorkItem string

Przypisany użytkownik

Zwraca

Body
WorkItem_CreatedSRResponse

Tworzenie żądania zmiany

Identyfikator operacji:
CreateChangeRequest

Tworzenie żądania zmiany

Parametry

Nazwa Klucz Wymagane Typ Opis
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority string

Priority
Area
 Area string

Area
Wpływ
 Impact string

Wpływ
Ryzyko
 Risk string

Ryzyko
Status
 Status string

Status
Przypisany użytkownik
 AssignedWorkItem string

Przypisany użytkownik

Zwraca

Body
WorkItem_CreatedSRResponse

Usuwanie elementu roboczego

Identyfikator operacji:
DeleteWorkItem

Usuwanie elementu roboczego

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu roboczego
 Id True string

Identyfikator elementu roboczego

Zwraca

Nazwa Ścieżka Typ Opis
komunikat
 message string

komunikat
sukces
 success boolean

sukces
dane
 data string

dane
wyjątek
 exception string

wyjątek
Identyfikator baseid
 BaseId string

Identyfikator baseid

Wyzwalacze

Po dodaniu nowego komentarza

Po dodaniu nowego komentarza
Po utworzeniu nowego elementu roboczego

Po utworzeniu nowego elementu roboczego

Po dodaniu nowego komentarza

Identyfikator operacji:
CreateActionLogWebhook

Po dodaniu nowego komentarza

Parametry

Nazwa Klucz Wymagane Typ Opis
Typ komentarza
 WorkItemClassType True string

Typ komentarza

Zwraca

Body
WorkItem_ActionLogWebhookResponse

Po utworzeniu nowego elementu roboczego

Identyfikator operacji:
CreateWebhook

Po utworzeniu nowego elementu roboczego

Parametry

Nazwa Klucz Wymagane Typ Opis
Typ elementu roboczego
 WorkItemClassType True string

Typ klasy elementu roboczego

Zwraca

Body
WorkItem_WebhookResponse

Definicje

WorkItem_CreatedSRResponse

Nazwa Ścieżka Typ Opis
Id
 Id string

Id
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority object

Priority
Classification
 Classification object

Classification
Pilność
 Urgency object

Pilność
Wpływ
 Impact object

Wpływ
Źródło
 Source object

Źródło
Grupa wsparcia
 SupportGroup object

Grupa wsparcia
Status
 Status object

Status
Przypisany użytkownik
 AssignedWorkItem object

Przypisany użytkownik
Użytkownik, którego dotyczy problem
 RequestedWorkItem object

Użytkownik, którego dotyczy problem

WorkItem_CreatedIRResponse

Nazwa Ścieżka Typ Opis
Id
 Id string

Id
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority integer

Priority
Pilność
 Urgency object

Pilność
Wpływ
 Impact object

Wpływ
Źródło
 Source object

Źródło
Grupa wsparcia
 SupportGroup object

Grupa wsparcia
Status
 Status object

Status
Przypisany użytkownik
 AssignedWorkItem object

Przypisany użytkownik
Użytkownik, którego dotyczy problem
 RequestedWorkItem object

Użytkownik, którego dotyczy problem

WorkItem_GetResponse

Nazwa Ścieżka Typ Opis
Id
 Id string

Id
Title
 Title string

Title
Description
 Description string

Description
Priority
 PriorityText string

Priority
Classification
 Classification object

Classification
Pilność
 Urgency object

Pilność
Wpływ
 Impact object

Wpływ
Źródło
 Source object

Źródło
Grupa wsparcia
 SupportGroup object

Grupa wsparcia
Status
 Status object

Status
Przypisany użytkownik
 AssignedWorkItem object

Przypisany użytkownik
Użytkownik, którego dotyczy problem
 RequestedWorkItem object

Użytkownik, którego dotyczy problem

WorkItem_WebhookResponse

Nazwa Ścieżka Typ Opis
Id
 Id string

Id
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority

Priority
Classification
 Classification object

Classification
Pilność
 Urgency object

Pilność
Wpływ
 Impact object

Wpływ
Źródło
 Source object

Źródło
Grupa wsparcia
 SupportGroup object

Grupa wsparcia
Status
 Status object

Status
Przypisany użytkownik
 AssignedWorkItem object

Przypisany użytkownik
Użytkownik, którego dotyczy problem
 RequestedWorkItem object

Użytkownik, którego dotyczy problem

WorkItem_ActionLogResponse

Nazwa Ścieżka Typ Opis
Id
 Id string

Id
Title
 Title string

Title
Dotyczy biletu problemu
 AppliesToTroubleTicket

Wpisy dziennika akcji dla zdarzenia i problemu
Dotyczy elementu roboczego
 AppliesToWorkItem

Wpisy dziennika akcji dla elementów roboczych

WorkItem_ActionLogWebhookResponse

Nazwa Ścieżka Typ Opis
Identyfikator elementu roboczego
 WorkItemID string

Identyfikator elementu roboczego
Wprowadzone przez
 EnteredBy string

Wprowadzone przez
Jest prywatny
 IsPrivate boolean

Jest prywatny
Comment
 Description string

Comment
Data wprowadzona
 EnteredDate string

Data wprowadzona
Data ostatniej modyfikacji
 LastModified string

Data ostatniej modyfikacji