Udostępnij przez

Zarządzanie usługami Aranda (wersja zapoznawcza)

Zwiększ produktywność firmy i przekształć środowisko użytkowników dzięki pakietowi Aranda Service Management Suite, rozwiązaniu wielodostępnemu, które umożliwia zarządzanie, integrowanie i automatyzowanie procesów biznesowych i usług.

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 Aranda Software
adres URL https://arandasoft.com/
Email soporte@arandasoft.com
Metadane łącznika
Publisher Aranda Software Corporation
Witryna internetowa https://arandasoft.com/
Zasady ochrony prywatności https://arandasoft.com/politica-de-privacidad/
Kategorie Zarządzanie biznesem; Kolaboracja

Pakiet Aranda Service Management Suite (ASMS)

Zwiększ produktywność firmy i przekształć środowisko użytkowników dzięki pakietowi Aranda Service Management Suite, rozwiązaniu wielodostępnemu, które umożliwia zarządzanie, integrowanie i automatyzowanie procesów biznesowych i usług. Twórz, wyszukuj i aktualizuj rekordy przechowywane w dowolnym obszarze roboczym (projekcie) usługi ASMS, w tym zdarzenia, wymagania i zmiany.

Pre-requisites

Pamiętaj o następujących wymaganiach wstępnych, aby kontynuować:

  • Subskrypcja i wystąpienie pakietu Aranda Service Management Suite (ASMS). Zacznij tutaj: https://arandasoft.com/
  • Aktywna subskrypcja usługi Microsoft Power Automate z funkcjami łącznika Premium.

Uzyskiwanie poświadczeń

  • Aby przeprowadzić uwierzytelnianie, użyj tokenu integracji. W poniższym linku znajdziesz informacje na temat uzyskiwania tokenu integracji

Wprowadzenie do łącznika

  1. Wymaga subskrypcji pakietu Aranda Service Management Suite (ASMS).

  2. Uzyskiwanie tokenu integracji

  3. Pobierz adres URL wystąpienia interfejsu API ASMS zarządzania usługami Aranda (ApiAsms).

  4. Ustanów połączenie z łącznikiem Aranda Service Management Suite.

  5. Wybierz jedną z następujących funkcji oferowanych przez łącznik:

    Bilet

  6. Aby uzyskać szczegółową dokumentację dotyczącą łącznika, zapoznaj się z artykułem https://docs.arandasoft.com/connectors

Tego łącznika można używać w następujących przypadkach:

  1. Tworzenie, wyszukiwanie i aktualizowanie biletów, między innymi dostępnych akcji.
  2. Uzyskaj możliwość śledzenia biletu.
  3. Pobierz załączniki związane z biletem.
  4. Wyszukaj artykuły z bazy wiedzy (KB) w pakiecie Aranda Service Management Suite.
  5. Pobierz załączniki z artykułów bazy wiedzy (KB).
  6. Tworzenie, wyszukiwanie i aktualizowanie elementów konfiguracji (CI).
  7. Dzięki niej organizacje mogą rozwiązywać wewnętrzne żądania pomocy technicznej, zarządzać i usprawniać proces rozwiązywania problemów technicznych.
  8. Umożliwia śledzenie komunikacji między osoby żądające i agentami pomocy technicznej.
  9. Zaoferuj automatyczne odpowiedzi, aby poinformować osoby żądających o stanie biletu.

Odpowiedź pomyślna

Code Name Description
200 OK Żądanie zakończyło się pomyślnie
204 Brak treści W żądaniu nie znaleziono żadnych danych

Typowe błędy i środki zaradcze

Code Name Description Rozwiązanie
400 NieprawidłoweŻądanie KryteriaNeedsSomeArguments Sprawdź, czy parametry wyszukiwania nie są puste
400 NieprawidłoweŻądanie InvalidAdditionalFieldId Sprawdź, czy identyfikatory dodatkowych pól są poprawne
400 NieprawidłoweŻądanie InvalidItemType Typ sprawy jest niepoprawny, zmień identyfikator typu sprawy
400 NieprawidłoweŻądanie Nieprawidłowy identyfikator projektu Identyfikator projektu jest niepoprawny, zmień identyfikator projektu, do którego skojarzysz przypadek
400 NieprawidłoweŻądanie InvalidStateId Sprawdzanie stanu dodanego podczas tworzenia lub aktualizowania biletu
400 NieprawidłoweŻądanie InvalidUploadType Wystąpił błąd podczas dołączania pliku. Zażądaj pomocy od administratora systemu
400 NieprawidłoweŻądanie RequestNeedsSomeArguments Sprawdź wymagane pola biletu i dodaj odpowiednią wartość w łączniku
400 NieprawidłoweŻądanie SearchListIsRequired Zażądaj pomocy od administratora systemu
400 NieprawidłoweŻądanie Nazwa parametru: {Nazwa parametru} Sprawdź, czy właściwości wymienione w błędzie nie mają wartości null
400 NieprawidłoweŻądanie Jest nazwą parametru null: {Name parameter} Sprawdź, czy właściwości wymienione w błędzie nie mają wartości null
400 NieprawidłoweŻądanie ItemTypeIsRequired Dodaj typ wielkości liter
400 NieprawidłoweŻądanie ModelIdIsEmpty Dodaj parametr modelId. Jest to wymagane.
400 NieprawidłoweŻądanie StateIdIsEmpty Dodaj parametr stateId. Jest to wymagane.
400 NieprawidłoweŻądanie ServiceIdIsEmpty Dodaj parametr serviceId. Jest to wymagane.
400 NieprawidłoweŻądanie CategoryIdIsEmpty Dodaj parametr categoryId. Jest to wymagane.
400 NieprawidłoweŻądanie TypesListNeedsSomeArguments Wymaga dodania typu przypadku podczas wyszukiwania biletów, zażądaj pomocy od administratora systemu
400 NieprawidłoweŻądanie Dodatkowe Pola "{PARAMETER_NAME}"Wymagane Dodatkowe pole "{PARAMETER_NAME}" jest obowiązkowe
400 NieprawidłoweŻądanie ModelNotActive Model skojarzony z przypadkiem nie jest aktywny
400 NieprawidłoweŻądanie FailedToCloseTaskPendingCloseTasksPredecessors Jeśli spróbujesz zamknąć sprawę, a przypadek nadrzędny ma oczekujące zadania do zamknięcia
400 NieprawidłoweŻądanie Zduplikowany obiekt Ciągła integracja już istnieje w bazie danych
400 NieprawidłoweŻądanie Nazwa parametru EmptyValue: {PARAMETER_NAME} Wymagany jest parametr {PARAMETER_NAME}
400 NieprawidłoweŻądanie EmptyEnumeration Nazwa parametru: {PARAMETER_NAME} Parametr {PARAMETER_NAME} jest listą i jest wymagany
403 Zakazany DoNotHavePermissionForThisAction Skontaktuj się z administratorem systemu, aby przypisać uprawnienia
Code Name Description Rozwiązanie
500 Błąd Wewnętrzny Serwera Zażądaj pomocy od administratora systemu
500 Błąd Wewnętrzny Serwera FailureExportExcel Zażądaj pomocy od administratora systemu
500 Błąd Wewnętrzny Serwera FailureGetAdditionalFields Zażądaj pomocy od administratora systemu
500 Błąd Wewnętrzny Serwera FailureGetCategoriesByService Zażądaj pomocy od administratora systemu
500 Błąd Wewnętrzny Serwera FailureGetChangeFSC Zażądaj pomocy od administratora systemu
500 Błąd Wewnętrzny Serwera FailureGetFields Zażądaj pomocy od administratora systemu
500 Błąd Wewnętrzny Serwera FailureGetFieldsList Zażądaj pomocy od administratora systemu
500 Błąd Wewnętrzny Serwera FailureGetFiles Zażądaj pomocy od administratora systemu
500 Błąd Wewnętrzny Serwera FailureGetLookupValues Zażądaj pomocy od administratora systemu
500 Błąd Wewnętrzny Serwera FailureGetMailTemplates Zażądaj pomocy od administratora systemu
500 Błąd Wewnętrzny Serwera FailureGetModelByCategory Zażądaj pomocy od administratora systemu
500 Błąd Wewnętrzny Serwera FailureGetOperators Zażądaj pomocy od administratora systemu
500 Błąd Wewnętrzny Serwera FailureGetReassignmentReasons Zażądaj pomocy od administratora systemu
500 Błąd Wewnętrzny Serwera FailureGetSimilarItems Zażądaj pomocy od administratora systemu
500 Błąd Wewnętrzny Serwera FailureSearchQuickManagement Zażądaj pomocy od administratora systemu

Często zadawane pytania

  1. Jak pobrać identyfikatory atrybutów wymaganych do korzystania z różnych akcji w łączniku (np. projekt, usługa, kategoria, grupa, specjalista)?

    Identyfikatory można pobrać na wiele sposobów:

    • Za pomocą programu Aranda Query Manager można utworzyć raport, który wysyła zapytania do tabeli Aranda Service Management Suite (ASMS), w której znajdują się wymagane dane. Jeśli potrzebujesz wskazówek dotyczących obiektów danych w rozwiązaniu, odwiedź poniższy link https://docs.arandasoft.com/docs/database.html i zidentyfikuj wersję bazy danych Aranda odpowiadającą instalacji usługi ASMS.
    • Jeśli używasz instalacji lokalnej usługi ASMS, możesz wykonać zapytanie dotyczące tabeli ASMS, w której znajdują się wymagane dane za pośrednictwem klienta SQL.
    • Za pośrednictwem Centrum pomocy technicznej usługi Aranda utwórz wniosek o pomoc techniczną za pośrednictwem kanałów kontaktowych wskazanych w poniższej witrynie internetowej Pomocy technicznej.

  2. Jaki jest maksymalny rozmiar plików do dołączenia w przypadku korzystania z akcji "Dodaj załącznik"?

    Maksymalny rozmiar zależy od określonej konfiguracji wystąpienia/instalacji usługi ASMS. Poproś administratora usługi ASMS.

  3. Jaki jest poziom dostępu do danych wymagany przez konto technika, którego token jest używany w konfiguracji połączenia USŁUGI ASMS wymaganego przez łącznik?

    Poziom dostępu jest taki sam jak konto technika używane w usłudze ASMS w regularnych odstępach czasu. Innymi słowy, na podstawie ról i uprawnień odpowiedniego technika w usłudze ASMS, dostęp do danych można uzyskać za pomocą łącznika.

  4. Czy konto technika, którego token będzie używany w łączniku ma nazwę lub współbieżne?

    Ponieważ łącznik może uzyskać dostęp do powiązanego wystąpienia usługi ASMS wiele razy na godzinę, zdecydowanie zaleca się, aby konto było typem nazwanym.

  5. Czy tworzenie lub modyfikowanie przypadków przy użyciu łącznika jest zgodne z tymi samymi regułami sprawdzania poprawności danych w interfejsie usługi ASMS?

    Tak, jest to zgodne z tymi samymi regułami walidacji. Na przykład podczas tworzenia przypadku dla określonego projektu, usługi i kategorii, jeśli należy wypełnić pola natywne i dodatkowe, te dane są również wymagane podczas przesyłania sprawy za pośrednictwem łącznika.

  6. Czy łącznik może być używany dla wystąpień usługi ASMS w środowiskach chmurowych i lokalnych?

    Tak, można go używać zarówno w instalacjach chmurowych, jak i lokalnych usługi ASMS. W instalacjach lokalnych należy wziąć pod uwagę łączność między serwerem ASMS i środowiskiem usługi Power Automate.

  7. Mam licencję usługi Power Automate, która umożliwia korzystanie tylko z łączników w warstwie Standardowa. Czy mogę użyć łącznika usługi ASMS?

    Nie jest możliwe, łącznik ASMS jest typem Premium.

  8. Chcę utworzyć przepływy w usłudze Power Automate, które zaczynają się od zdarzeń w usłudze ASMS (np. w przypadku utworzenia przypadku, gdy przypadek zostanie przypisany do określonej grupy). Czy można użyć wyzwalaczy rozpoczynających się od zdarzeń występujących w usłudze ASMS?

    Tak, możliwe jest. Zalecane są następujące kroki:

    • Zainicjuj wyzwalacz "Po odebraniu żądania HTTP" i utwórz schemat JSON treści żądania zawierający strukturę danych, która ma zostać odebrana z usługi ASMS. Po utworzeniu wyzwalacza otrzymasz adres URL HTTP POST (adres URL elementu webhook) do użycia w wystąpieniu usługi ASMS. Nie zapomnij rozważyć mechanizmu uwierzytelniania w celu uzyskania dostępu do adresu URL elementu webhook (np. tokenu).
    • Utwórz regułę biznesową w usłudze ASMS dla zestawu warunków, które po spełnieniu powinny zainicjować przepływ w usłudze Power Automate. Jako akcję w regule wybierz pozycję "Wywołaj element webhook" i w docelowym adresie URL wywołania wprowadź wcześniej uzyskany adres URL elementu WebHook, parametry do wysłania i treść żądania (które muszą być zgodne ze schematem JSON treści żądania). Aby uzyskać więcej informacji na temat wywoływania elementu webhook z reguły w usłudze ASMS, odwiedź następujący link: Reguła elementu webhook
    • Przetestuj utworzoną regułę i sprawdź, czy żądanie HTTP jest wysyłane do adresu URL elementu webhook i inicjuje przepływ w usłudze Power Automate.

  9. Czy można wywoływać punkty końcowe interfejsu API REST usługi ASMS jako akcje z przepływów w usłudze Power Automate?

    Tak, możliwe jest. Użyj akcji "HTTP" i wypełnij wymagane dane (między innymi identyfikator URI, metoda, nagłówki, treść).

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
Hostowanie usługi ASMS ciąg Hostowanie usługi ASMS Prawda
Token autoryzacji securestring Token autoryzacji Prawda

Limity ograniczania

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

Akcje

Aktualizowanie elementu konfiguracji

Zaktualizuj identyfikatory CI w usłudze Aranda CMDB.
Dodaj notatkę do wielkości liter

Dodaj notatkę do określonego rekordu przypadku w usłudze ASMS.
Dodawanie załącznika do wielkości liter

Dołącz plik do określonego rekordu przypadku w usłudze ASMS.
Pobieranie elementu konfiguracji

Uzyskaj ciągłą integrację według nazwy i numeru seryjnego.
Pobieranie załącznika artykułu

Pobierz załącznik związany z artykułem.
Pobieranie załącznika sprawy

Pobierz załącznik związany z artykułem.
Przypadek aktualizacji

Aktualizuje rekord dla przypadku usługi ASMS.
Przypadki wyszukiwania

Pobiera listę rekordów przypadków usługi ASMS w zależności od kryteriów wyszukiwania dodanych w zapytaniu.
Tworzenie elementu konfiguracji

Tworzenie interfejsów CI w usłudze Aranda CMDB.
Utwórz przypadek

Utwórz nowy rekord przypadku w usłudze ASMS.
Uzyskiwanie historii przypadków

Historia przypadków domyślnie nie jest uwzględniana.
Uzyskiwanie wielkości liter

Pobiera rekord metadanych przypadku usługi ASMS.
Wyszukaj artykuły

Pobiera listę artykułów na podstawie kryteriów wyszukiwania dodanych w zapytaniu.
Wyszukaj elementy konfiguracji

Pobiera listę rekordów CIs bazy danych CMDB w zależności od kryteriów wyszukiwania dodanych w zapytaniu.

Aktualizowanie elementu konfiguracji

Identyfikator operacji:
UpdateCI

Zaktualizuj identyfikatory CI w usłudze Aranda CMDB.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa lub ciągła integracja szeregowa
 request True string

Wprowadź nazwę lub numer seryjny elementu konfiguracji.
Description
 description string

Szczegółowy opis ciągłej integracji.
Serial
 serial string

Serial
Tag zasobu
 assetTag string

Tag zasobu.
Kategoria
 categoryId integer

Wybierz kategorię lub wprowadź ręcznie identyfikator kategorii.
Identyfikator odpowiedzialny
 responsibleId integer

Identyfikator odpowiedzialny.
Identyfikator stanu
 stateId integer

Identyfikator stanu.
Numer licencji
 licenseNumber string

Numer licencji.
Identyfikator producenta
 manufacturerId integer

Identyfikator producenta.
Marka
 brandId integer

Wybierz markę lub wprowadź ręcznie identyfikator marki.
Model
 modelId integer

Wybierz model lub wprowadź ręcznie identyfikator modelu.
Identyfikator dostawcy
 providerId integer

Identyfikator dostawcy.
Identyfikator przyczyny
 reasonId integer

Identyfikator przyczyny.
Cena
 price number

Cena.
RFID
 rfid string

RFID
Data akceptacji
 acceptDate date-time

Data akceptacji.
Data dostarczenia do firmy
 checkInDate date-time

Data dostarczenia do firmy.
Początkowa data odpowiedzialności
 responsibilityDate date-time

Początkowa data odpowiedzialności.
Kod kreskowy
 barCode string

Kod kreskowy.
Mierzenie wartości jednostki
 unitSize string

Mierzenie wartości jednostki.
Jednostka miary
 unitId integer

Wybierz jednostkę miary lub wprowadź ręcznie identyfikator jednostki miary.
Identyfikator centrum kosztów
 costCenterId integer

Identyfikator centrum kosztów.
Wpływ
 impactId integer

Wybierz wpływ lub wprowadź ręcznie identyfikator wpływu.
Ryzyko
 riskId integer

Wybierz ryzyko lub wprowadź ręcznie identyfikator ryzyka.
Identyfikator lokalizacji
 locationId integer

Identyfikator lokalizacji.
fieldId
 fieldId string

Identyfikator pola
values
 values array of string

Wartość

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator elementu konfiguracji
 id integer

Identyfikator elementu konfiguracji.

Dodaj notatkę do wielkości liter

Identyfikator operacji:
AttachNote

Dodaj notatkę do określonego rekordu przypadku w usłudze ASMS.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator według projektu
 ticketId True string

Kod rekordu
Uwaga / Notatka
 message True string

Uwaga, która ma zostać dołączona do rekordu.

Dodawanie załącznika do wielkości liter

Identyfikator operacji:
AttachFile

Dołącz plik do określonego rekordu przypadku w usłudze ASMS.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator według projektu
 ticketId True string

Kod rekordu
File
 file True byte

Plik bajtowy.
Nazwa pliku
 fileName True string

Nazwa pliku (np. 'Vacation_Approval_Form.docx').

Pobieranie elementu konfiguracji

Identyfikator operacji:
GetCI

Uzyskaj ciągłą integrację według nazwy i numeru seryjnego.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa lub ciągła integracja szeregowa
 request True string

Wprowadź nazwę lub numer seryjny elementu konfiguracji.

Zwraca

Nazwa Ścieżka Typ Opis
Pole dodatkowe
 additionalFields array of object

Pole dodatkowe.
identyfikator
 additionalFields.fieldId integer

identyfikator pola
nazwa
 additionalFields.nameField string

nazwa pola
values
 additionalFields.values array of string

Dodatkowe wartości pól
:ID
 additionalFields.valueDetails.id integer

Specyfikacja pól typu listy lub wykazu: identyfikator
:Wartość
 additionalFields.valueDetails.value string

Specyfikacja pól typu listy lub wykazu: Wartość
Tag zasobu
 assetTag string

Tag zasobu.
Kod kreskowy
 barCode string

Kod kreskowy.
identyfikator
 brand.id integer

Identyfikator marki.
nazwa
 brand.name string

Nazwa marki.
identyfikator
 category.id integer

Identyfikator kategorii.
nazwa
 category.name string

Nazwa kategorii.
identyfikator
 costCenter.id integer

Identyfikator centrum kosztów.
nazwa
 costCenter.name string

Nazwa centrum kosztów.
Data akceptacji
 acceptDate date-time

Data akceptacji.
Data dostarczenia do firmy
 checkinDate date-time

Data dostarczenia do firmy.
Początkowa data odpowiedzialności
 responsibilityDate date-time

Początkowa data odpowiedzialności.
Data utworzenia
 createdDate date-time

Data utworzenia.
Data modyfikacji
 modifiedDate date-time

Data modyfikacji.
Description
 description string

Szczegółowy opis ciągłej integracji.
Identyfikator ciągłej integracji
 id integer

Identyfikator systemu rekordu.
identyfikator
 impact.id integer

Identyfikator wpływu.
nazwa
 impact.name string

Nazwa wpływu.
Numer licencji
 licenseNumber string

Numer licencji.
identyfikator
 manufacturer.id integer

Identyfikator producenta.
nazwa
 manufacturer.name string

Nazwa producenta.
identyfikator
 model.id integer

Identyfikator modelu.
nazwa
 model.name string

Nazwa modelu.
Nazwa ciągłej integracji
 name string

Nazwa elementu konfiguracji.
Projekty
 projects array of object

Projekty.
identyfikator
 projects.id integer

identyfikator.
identyfikator
 provider.id integer

Identyfikator producenta.
nazwa
 provider.name string

Nazwa producenta.
identyfikator
 reason.id integer

Identyfikator przyczyny.
nazwa
 reason.name string

Nazwa przyczyny
identyfikator
 responsible.id integer

Identyfikator odpowiedzialny.
nazwa
 responsible.name string

Nazwa odpowiedzialna.
identyfikator
 risk.id integer

Identyfikator ryzyka.
nazwa
 risk.name string

Nazwa ryzyka.
RFID
 rfid string

RFID
Serial
 serial string

Serial
identyfikator
 state.id integer

Identyfikator stanu.
nazwa
 state.name string

Nazwa stanu.
Identyfikator elementu tymczasowego
 tempItemId integer

Identyfikator elementu tymczasowego.
Typ ciągłej integracji
 type string

Typ elementu konfiguracji.
identyfikator
 unit.id integer

Identyfikator jednostki.
nazwa
 unit.name string

Nazwa jednostki.
Mierzenie wartości jednostki
 unitSize string

Mierzenie wartości jednostki.
Okres eksploatacji
 usefulLife integer

Okres eksploatacji.
wersja
 version integer

wersja

Pobieranie załącznika artykułu

Identyfikator operacji:
DownloadArticleFile

Pobierz załącznik związany z artykułem.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator artykułu
 articleId True integer

Identyfikator artykułu.
Identyfikator załącznika
 fileId True integer

Reprezentuje identyfikator załącznika.

Zwraca

Zawartość załącznika.

Zawartość pliku
binary

Pobieranie załącznika sprawy

Identyfikator operacji:
DownloadCaseFile

Pobierz załącznik związany z artykułem.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator według projektu
 ticketId True string

Kod rekordu
Identyfikator załącznika
 fileId True integer

Reprezentuje identyfikator załącznika.

Zwraca

Zawartość załącznika.

Zawartość pliku
binary

Przypadek aktualizacji

Identyfikator operacji:
UpdateCase

Aktualizuje rekord dla przypadku usługi ASMS.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator według projektu
 ticketId True string

Kod rekordu
Temat
 subject string

Temat.
Description
 description string

Szczegółowy opis przypadku.
Rozwiązanie
 commentary string

Rozwiązanie przypadku.
Identyfikator usługi
 serviceId integer

Identyfikator usługi.
Identyfikator kategorii
 categoryId integer

Identyfikator kategorii.
Identyfikator stanu
 stateId integer

Identyfikator stanu.
Identyfikator przyczyny
 reasonId integer

Identyfikator przyczyny.
Identyfikator grupy
 groupId integer

Identyfikator grupy.
Identyfikator odpowiedzialny
 responsibleId integer

Identyfikator odpowiedzialny.
Identyfikator wnioskodawcy
 applicantId integer

Identyfikator wnioskodawcy.
ID klienta
 customerId integer

Identyfikator klienta.
Identyfikator firmy
 companyId integer

Identyfikator firmy.
Identyfikator ciągłej integracji
 ciId integer

Identyfikator ciągłej integracji.
Identyfikator dostawcy
 providerId integer

Identyfikator dostawcy.
Identyfikator obszaru organizacyjnego
 unitId integer

Identyfikator obszaru organizacyjnego.
Typ rejestru
 registryTypeId integer

Wybierz typ rejestru lub wprowadź ręcznie identyfikator typu rejestru.
Pilność
 urgencyId integer

Wybierz pilność lub wprowadź ręcznie identyfikator pilności.
Wpływ
 impactId integer

Wybierz pilność lub wprowadź ręcznie identyfikator wpływu.
Interfejs
 interfaceId string

związek sprawy ze stronami trzecimi.
Identyfikator pola
 fieldId string

Identyfikator pola.
Wartości
 values array of string

Wartości.

Zwraca

Nazwa Ścieżka Typ Opis
wynik
 result boolean

Wynik

Przypadki wyszukiwania

Identyfikator operacji:
SearchTickets

Pobiera listę rekordów przypadków usługi ASMS w zależności od kryteriów wyszukiwania dodanych w zapytaniu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Relacja między filtrami
 logicOperator True string

Określa relację między kryteriami wyszukiwania.
Pole do filtrowania
 field True string

Pole wielkości liter do filtrowania (np. "stateName").
Operator wyszukiwania
 operator True string

Operator wyszukiwania.
Wartość do znalezienia
 value True string

Wartość pola do znalezienia.

Zwraca

Nazwa Ścieżka Typ Opis
array of object
Identyfikator sprawy
 id integer

Identyfikator systemu rekordu.
Identyfikator według projektu
 idByProject string

Identyfikator według projektu dla rekordu.
Temat
 subject string

Temat sprawy.
Description
 description string

Szczegółowy opis przypadku.
Identyfikator projektu
 projectId integer

Identyfikator projektu.
Projekt
 projectName string

Nazwa projektu.
Typ przypadku
 itemTypeName string

Nazwa typu wielkości liter.
Identyfikator typu sprawy
 itemTypeId integer

Identyfikator typu sprawy.
Identyfikator usługi
 serviceId integer

Identyfikator usługi.
Usługa
 serviceName string

Nazwa usługi.
Identyfikator modelu
 modelId integer

Identyfikator modelu.
Model
 modelName string

Nazwa modelu.
Identyfikator kategorii
 categoryId integer

Identyfikator kategorii.
Kategoria
 categoryName string

Nazwa kategorii.
Identyfikator wnioskodawcy
 applicantId integer

Identyfikator wnioskodawcy.
Identyfikator ciągłej integracji
 ciId integer

Identyfikator elementu konfiguracji.
CI
 ciName string

Główna nazwa elementu konfiguracji.
ID klienta
 customerId integer

Identyfikator klienta.
Client
 customerName string

Nazwa klienta.
Identyfikator firmy
 companyId integer

Identyfikator firmy.
Firma
 companyName string

Nazwa firmy.
Identyfikator umowy SLA
 slaId integer

Identyfikator umowy SLA.
SLA
 slaName string

Nazwa umowy SLA.
Identyfikator stanu
 stateId integer

Identyfikator stanu.
Status
 stateName string

Nazwa stanu.
Identyfikator przyczyny
 reasonId integer

Identyfikator przyczyny.
Przyczyna
 reasonName string

Nazwa przyczyny.
Identyfikator grupy
 groupId integer

Identyfikator grupy.
Grupa
 groupName string

Nazwa grupy.
Identyfikator odpowiedzialny
 responsibleId integer

Identyfikator odpowiedzialny.
Odpowiedzialny
 responsibleName string

Nazwa odpowiedzialna.
Identyfikator wpływu
 impactId integer

Identyfikator wpływu.
Wpływ
 impactName string

Nazwa wpływu.
Data rejestru
 openedDate string

Data rejestru.
Identyfikator autora
 authorId integer

Identyfikator autora.
Author
 authorName string

Nazwa autora.

Tworzenie elementu konfiguracji

Identyfikator operacji:
CreateCI

Tworzenie interfejsów CI w usłudze Aranda CMDB.

Parametry

Nazwa Klucz Wymagane Typ Opis
Name
 name True string

Name
Description
 description string

Szczegółowy opis ciągłej integracji.
Serial
 serial string

Seryjny.
Tag zasobu
 assetTag string

Tag zasobu.
Projekt
 projectId True integer

Wybierz projekt lub wprowadź ręcznie identyfikator projektu.
Kategoria
 categoryId True integer

Wybierz kategorię lub wprowadź ręcznie identyfikator kategorii.
Identyfikator odpowiedzialny
 responsibleId True integer

Identyfikator odpowiedzialny.
Numer licencji
 licenseNumber string

Numer licencji.
Producent
 manufacturerId integer

Wybierz producenta lub wprowadź ręcznie identyfikator producenta.
Marka
 brandId integer

Wybierz markę lub wprowadź ręcznie identyfikator marki.
Model
 modelId integer

Wybierz model lub wprowadź ręcznie identyfikator modelu.
Identyfikator dostawcy
 providerId integer

Wybierz dostawcę lub wprowadź ręcznie identyfikator dostawcy.
Identyfikator przyczyny
 reasonId integer

Identyfikator przyczyny.
Cena
 price number

Cena.
RFID
 rfid string

RFID
Data akceptacji
 acceptDate date-time

Data akceptacji.
Data dostarczenia do firmy
 checkInDate date-time

Data dostarczenia do firmy.
Początkowa data odpowiedzialności
 responsibilityDate date-time

Początkowa data odpowiedzialności.
Kod kreskowy
 barCode string

Kod kreskowy.
Mierzenie wartości jednostki
 unitSize string

Mierzenie wartości jednostki.
Jednostka miary
 unitId integer

Wybierz jednostkę miary lub wprowadź ręcznie identyfikator jednostki miary.
Centrum kosztów
 costCenterId integer

Wybierz centrum kosztów lub wprowadź ręcznie identyfikator centrum kosztów.
Wpływ
 impactId integer

Wybierz wpływ lub wprowadź ręcznie identyfikator wpływu.
Ryzyko
 riskId integer

Wybierz ryzyko lub wprowadź ręcznie identyfikator ryzyka.
Lokalizacja
 locationId integer

Wybierz lokalizację lub wprowadź ręcznie identyfikator lokalizacji.
fieldId
 fieldId string

Identyfikator pola.
values
 values array of string

Wartość

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator elementu konfiguracji
 id integer

Identyfikator elementu konfiguracji.

Utwórz przypadek

Identyfikator operacji:
CreateCase

Utwórz nowy rekord przypadku w usłudze ASMS.

Parametry

Nazwa Klucz Wymagane Typ Opis
Temat
 subject True string

Temat.
Description
 description string

Szczegółowy opis przypadku.
Typ przypadku
 itemType True string

Wybierz typ przypadku lub wprowadź ręcznie nazwę typu sprawy.
Projekt
 projectId True integer

Wybierz projekt lub wprowadź ręcznie identyfikator projektu.
Usługa
 serviceId True integer

Wybierz usługę lub wprowadź ręcznie identyfikator usługi.
Kategoria
 categoryId True integer

Wybierz kategorię lub wprowadź ręcznie identyfikator kategorii.
Przyczyna
 reasonId integer

Wybierz przyczynę lub wprowadź ręcznie identyfikator przyczyny.
Grupa
 groupId integer

Wybierz grupę lub wprowadź ręcznie identyfikator grupy.
Odpowiedzialny
 responsibleId integer

Wybierz odpowiedzialne lub wprowadź ręcznie odpowiedzialny identyfikator.
Firma
 companyId integer

Wybierz firmę lub wprowadź ręcznie identyfikator firmy.
Provider
 providerId integer

Wybierz dostawcę lub wprowadź ręcznie identyfikator dostawcy.
Obszar organizacyjny
 unitId integer

Wybierz obszar organizacyjny lub wprowadź ręcznie identyfikator obszaru organizacyjnego.
Identyfikator wnioskodawcy
 applicantId integer

Identyfikator wnioskodawcy.
ID klienta
 customerId integer

Identyfikator klienta.
Identyfikator ciągłej integracji
 ciId integer

Identyfikator ciągłej integracji.
Typ rejestru
 registryTypeId integer

Wybierz typ rejestru lub wprowadź ręcznie identyfikator typu rejestru.
Pilność
 urgencyId integer

Wybierz pilność lub wprowadź ręcznie identyfikator pilności.
Wpływ
 impactId integer

Wybierz wpływ lub wprowadź ręcznie identyfikator wpływu.
identyfikator
 fieldId string

Identyfikator pola.
values
 values array of string

Wartość.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator sprawy
 id integer

Identyfikator przypadku
Identyfikator według projektu
 idByProject string

Identyfikator według projektu dla rekordu

Uzyskiwanie historii przypadków

Identyfikator operacji:
CaseHistory

Historia przypadków domyślnie nie jest uwzględniana.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator według projektu
 ticketId True string

Kod rekordu
Uwzględnij notatki
 addNote string

Wybierz typ notatki, którą chcesz dodać.

Zwraca

Nazwa Ścieżka Typ Opis
array of object
Klucz akcji
 actionId string

Klucz akcji
Akcja
 actionName string

Nazwa działania lub akcji wykonywanej w cyklu życia biletu.
Identyfikator autora
 authorId integer

Identyfikator autora.
Author
 authorName string

Autor, który dokonał zmiany.
Data utworzenia
 created date-time

Data wystąpienia akcji.
Zmodyfikowana nazwa pola
 fieldName string

Zmodyfikowana nazwa pola.
Nowa wartość
 newValue html

Reprezentuje nową wartość właściwości.
Stara wartość
 oldValue html

Wartość, która została zmodyfikowana.
Typ notatki
 noteType string

Reprezentuje typ notatki (tylko dla akcji "Uwaga").
Identyfikator elementu pokrewnego
 relatedItemId string

Reprezentuje identyfikator po dodaniu relacji. (tylko dla klucza akcji "AddedRelated").

Uzyskiwanie wielkości liter

Identyfikator operacji:
GetCase

Pobiera rekord metadanych przypadku usługi ASMS.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator według projektu
 ticketId True string

Kod rekordu

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator sprawy
 id integer

Identyfikator systemu rekordu.
Identyfikator według projektu
 idByProject string

Identyfikator według projektu dla rekordu.
Temat
 subject string

Temat.
Description
 description string

Szczegółowy opis przypadku.
Rozwiązanie
 commentary string

Rozwiązanie przypadku.
Identyfikator projektu
 projectId integer

Identyfikator projektu.
Projekt
 projectName string

Nazwa projektu.
Typ wielkości liter
 itemTypeName string

Nazwa typu wielkości liter.
Identyfikator typu sprawy
 itemTypeId integer

Identyfikator typu sprawy.
Identyfikator usługi
 serviceId integer

Identyfikator usługi.
Usługa
 serviceName string

Nazwa usługi.
Identyfikator modelu
 modelId integer

Identyfikator modelu.
Model
 modelName string

Nazwa modelu.
Identyfikator kategorii
 categoryId integer

Identyfikator kategorii.
Nazwa kategorii
 categoryName string

Kategoria.
Identyfikator wnioskodawcy
 applicantId integer

Identyfikator wnioskodawcy.
ID klienta
 customerId integer

Identyfikator klienta.
Client
 customerName string

Nazwa klienta.
Identyfikator firmy
 companyId integer

Identyfikator firmy.
Firma
 companyName string

Nazwa firmy.
Identyfikator ciągłej integracji
 ciId integer

Identyfikator ciągłej integracji.
CI
 ciName string

Nazwa ciągłej integracji.
Identyfikator umowy SLA
 slaId integer

Identyfikator umowy SLA.
SLA
 slaName string

Nazwa umowy SLA.
Identyfikator stanu
 stateId integer

Identyfikator stanu.
Status
 stateName string

Nazwa stanu.
Identyfikator przyczyny
 reasonId integer

Identyfikator przyczyny.
Przyczyna
 reasonName string

Nazwa przyczyny.
Identyfikator grupy
 groupId integer

Identyfikator grupy.
Grupa
 groupName string

Nazwa grupy.
Identyfikator odpowiedzialny
 responsibleId integer

Identyfikator odpowiedzialny.
Odpowiedzialny
 responsibleName string

Nazwa odpowiedzialna.
Identyfikator typu rejestru
 registryTypeId integer

Identyfikator typu rejestru.
Typ rejestru
 registryTypeName string

Nazwa typu rejestru.
Identyfikator wpływu
 impactId integer

Identyfikator wpływu.
Wpływ
 impactName string

Nazwa wpływu.
Identyfikator pilności
 urgencyId integer

Identyfikator pilności.
Pilność
 urgencyName string

Nazwa pilności.
Identyfikator priorytetu
 priorityId integer

Identyfikator priorytetu.
Priority
 priorityName string

Nazwa priorytetu.
Identyfikator ryzyka
 riskId integer

Identyfikator ryzyka.
Ryzyko
 riskName string

Nazwa ryzyka.
Identyfikator dostawcy
 providerId integer

Identyfikator dostawcy.
Provider
 providerName string

Nazwa dostawcy.
Identyfikator UC
 ucId integer

Identyfikator UC.
UC
 ucName string

Nazwa UC.
Identyfikator obszaru organizacyjnego
 unitId integer

Identyfikator obszaru organizacyjnego.
Obszar organizacyjny
 unitName string

Nazwa obszaru organizacyjnego.
Identyfikator OLA
 olaId integer

Identyfikator OLA.
OLA
 olaName string

Nazwa OLA.
Data rejestru
 openedDate string

Data rejestru.
Data zamknięcia:
 closedDate string

Data zamknięcia.
Data końcowa
 finalDate string

Data końcowa (tylko dla rekordów zadań).
Data początkowa
 initialDate string

Data początkowa (tylko dla rekordów zadań).
Koszty
 cost number

Koszty.
Koszt rzeczywisty
 realCost number

Koszt rzeczywisty.
Szacowany koszt
 estimatedCost number

Szacowany koszt.
Cena
 price number

Cena.
Identyfikator interfejsu
 interfaceId string

Identyfikator interfejsu.
Zamknięty
 isClosed boolean

Zamknięty.
Progress
 currentProgress number

Postęp.
Data rzeczywista
 realDate string

Rzeczywista data.
Szacowana data
 estimatedDate string

Szacowana data.
Identyfikator autora
 authorId integer

Identyfikator autora.
Author
 authorName string

Nazwa autora.
Załączniki
 attachments array of object

Załączniki związane z przypadkiem.
identyfikator
 attachments.id integer

Identyfikator załącznika.
nazwa
 attachments.name string

Nazwa załącznika.
Pole dodatkowe
 additionalFields array of object

Pole dodatkowe.
identyfikator
 additionalFields.fieldId integer

identyfikator pola.
nazwa
 additionalFields.nameField string

nazwa pola.
values
 additionalFields.values array of string

Dodatkowe wartości pól.
:ID
 additionalFields.valueDetails.id integer

Specyfikacja pól typu listy lub wykazu: identyfikator.
:Wartość
 additionalFields.valueDetails.value string

Specyfikacja pól typu listy lub wykazu: Wartość.

Wyszukaj artykuły

Identyfikator operacji:
GetArticle

Pobiera listę artykułów na podstawie kryteriów wyszukiwania dodanych w zapytaniu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Projekt
 projectId True integer

Wybierz projekt lub wprowadź ręcznie identyfikator projektu.
Wyszukaj artykuł
 search True string

Wyszukaj artykuł według tytułu, słowa kluczowego lub opisu.
Kategoria
 folderId integer

Wybierz kategorię lub wprowadź ręcznie identyfikator kategorii.
Typ
 typeId integer

Wybierz typ lub wprowadź ręcznie identyfikator typu.

Zwraca

Nazwa Ścieżka Typ Opis
array of object
Title
 title string

Tytuł.
Description
 description string

Description.
Content
 content html

Zawartość.
Słowo kluczowe artykułu
 keyword string

Słowo kluczowe artykułu.
Identyfikator artykułu
 identifier string

Identyfikator artykułu.
Data utworzenia
 createdDate string

Data utworzenia.
Data modyfikacji
 lastModifiedDate string

Data modyfikacji.
Identyfikator klasy
 classId integer

Identyfikator klasy.
Identyfikator artykułu
 id integer

Identyfikator systemu rekordu.
identyfikator
 type.id integer

Identyfikator typu.
nazwa
 type.name string

Wpisz nazwę.
adres URL
 url string

adres URL
Artykuł dotyczący załączników
 attachments array of object

Załączniki związane z artykułem.
identyfikator
 attachments.id integer

Identyfikator załącznika.
nazwa
 attachments.name string

Nazwa załącznika.

Wyszukaj elementy konfiguracji

Identyfikator operacji:
SearchCIs

Pobiera listę rekordów CIs bazy danych CMDB w zależności od kryteriów wyszukiwania dodanych w zapytaniu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Relacja między filtrami
 logicOperator True string

Określa relację między kryteriami wyszukiwania.
Pole do filtrowania
 field True string

Pole ciągłej integracji do filtrowania (np. "stateName")
Operator wyszukiwania
 operator True string

Operator wyszukiwania.
Wartość do znalezienia
 value True string

Wartość pola do znalezienia.

Zwraca

Nazwa Ścieżka Typ Opis
array of object
Data akceptacji
 acceptDate date-time

Data akceptacji
Tag zasobu
 assetTag string

Tag zasobu
Nazwa odpowiedzialna
 responsibleName string

Nazwa odpowiedzialna
identyfikator
 category.id integer

Identyfikator kategorii
nazwa
 category.name string

Nazwa kategorii
Data dostarczenia do firmy
 checkinDate date-time

Data dostarczenia do firmy.
Data utworzenia
 createdDate date-time

Data utworzenia
Description
 description string

Szczegółowy opis ciągłej integracji.
Identyfikator ciągłej integracji
 id integer

Identyfikator systemu rekordu.
identyfikator
 impact.id integer

Identyfikator wpływu
nazwa
 impact.name string

Nazwa wpływu
Data modyfikacji
 modifiedDate date-time

Data modyfikacji
Nazwa ciągłej integracji
 name string

Nazwa elementu konfiguracji.
Początkowa data odpowiedzialności
 responsibilityDate date-time

Początkowa data odpowiedzialności.
Serial
 serial string

Serial
identyfikator
 state.id integer

Identyfikator stanu.
nazwa
 state.name string

Nazwa stanu.
Typ ciągłej integracji
 type string

Typ elementu konfiguracji.

Definicje

binarny

Jest to podstawowy typ danych "binary".