Freigeben über


Aranda Service Management

Steigern Sie die Produktivität Ihres Unternehmens und transformieren Sie die Benutzerfreundlichkeit mit Aranda Service Management Suite, der mehrinstanzenfähigen Lösung, mit der Sie Geschäftsprozesse und -dienste verwalten, integrieren und automatisieren können.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     - Azure Government Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Aranda Software
URL https://arandasoft.com/
Email soporte@arandasoft.com
Connectormetadaten
Herausgeber Aranda Software Corporation
Webseite https://arandasoft.com/
Datenschutzrichtlinie https://arandasoft.com/politica-de-privacidad/
Kategorien Unternehmensführung; Zusammenarbeit

Aranda Service Management Suite (ASMS)

Steigern Sie die Produktivität Ihres Unternehmens und transformieren Sie die Benutzerfreundlichkeit mit Aranda Service Management Suite, der mehrinstanzenfähigen Lösung, mit der Sie Geschäftsprozesse und -dienste verwalten, integrieren und automatisieren können. Erstellen, Suchen und Aktualisieren von Datensätzen, die in einem beliebigen Arbeitsbereich (Projekt) von ASMS gespeichert sind, einschließlich Vorfällen, Anforderungen, Änderungen, Aufgaben und Ressourcen, unter anderem.

Voraussetzungen

Bitte beachten Sie die folgenden Voraussetzungen, um fortzufahren:

  • Ein Abonnement und eine Instanz von Aranda Service Management Suite (ASMS). Beginnen Sie hier: https://arandasoft.com/
  • Ein aktives Microsoft Power Automate-Abonnement mit Premium-Connectorfunktionen.

Abrufen von Anmeldeinformationen

  • Verwenden Sie zum Durchführen der Authentifizierung das Integrationstoken. Im folgenden Link finden Sie Informationen zum Abrufen des Integrationstokens.

Erste Schritte mit Ihrem Connector

  1. Erfordert ein Abonnement von Aranda Service Management Suite (ASMS).

  2. Abrufen des Integrationstokens

  3. Rufen Sie die Instanz-URL der Aranda Service Management ASMS-API (ApiAsms) ab.

  4. Herstellen einer Verbindung mit dem Aranda Service Management Suite-Connector.

  5. Wählen Sie eine der folgenden Funktionen aus, die vom Connector angeboten werden:

    Fahrkarte

  6. Ausführliche Dokumentation zum Connector finden Sie unter https://docs.arandasoft.com/connectors/en/

Sie können diesen Connector in den folgenden Fällen verwenden:

  1. Erstellen, Suchen und Aktualisieren von Tickets unter anderem verfügbaren Aktionen.
  2. Erhalten Sie die Ticketablaufverfolgung.
  3. Laden Sie Anlagen im Zusammenhang mit einem Ticket herunter.
  4. Suchen Sie nach Knowledge Base-Artikeln (KB) in Aranda Service Management Suite.
  5. Laden Sie Anlagen aus Knowledge Base-Artikeln (KB) herunter.
  6. Erstellen, Suchen und Aktualisieren von Konfigurationselementen (CIs).
  7. Es ermöglicht Organisationen, die Ticketauflösung zu beschleunigen, indem sie die Compliance auf Serviceebene verwaltet und optimiert.
  8. Ermöglicht die Nachverfolgung der Kommunikation zwischen Anforderern und Supportmitarbeitern.
  9. Bieten Sie automatisierte Antworten auf Informierer über den Status ihres Tickets.
  10. Erstellen, Suchen und Aktualisieren von Aufgaben, die einem Ticket zugeordnet sind.

Bekannte Probleme und Einschränkungen mit Aktionen

  1. Bei Verwendung der Aktion "Suchfälle " werden nur die ersten 50 Fälle im Zusammenhang mit den hinzugefügten Suchkriterien abgerufen.
  2. Bei Verwendung der Aktionskonfigurationselemente für die Suche werden nur die ersten 50 Konfigurationselemente im Zusammenhang mit den hinzugefügten Suchkriterien abgerufen.
  3. Bei Verwendung der Aktionssuche werden nur die ersten 20 Artikel im Zusammenhang mit den hinzugefügten Suchkriterien abgerufen.
  4. Bei Verwendung der Aktion "Suchaufgaben " werden nur die ersten 50 Aufgaben im Zusammenhang mit den hinzugefügten Suchkriterien abgerufen.
  5. Bei Verwendung der Aktion "Fall erstellen" können die Eigenschaften "Dienst", "Kategorie", "Gruppen" usw. ihre Werte verlieren und diese Eigenschaften aufgrund der Schachtelung und Abhängigkeit zwischen den Ticketeigenschaften als NULL verlassen. Wenn Sie den Wert der Ticketeigenschaft zurücksetzen möchten, klicken Sie erneut darauf, und wählen Sie den richtigen Wert aus der Dropdownliste aus (wenn ein geschachtelter Wert erforderlich ist), oder geben Sie manuell einen richtigen Bezeichner ein (z. B. die "Dienst-ID" für die Eigenschaft "Service")
  6. Wenn Sie die Aktion " Konfigurationselement erstellen " verwenden, kann das Risiko aktualisiert werden, wenn es sich um ein erforderliches Feld in der Aranda CMDB-Konfiguration handelt.
  7. Die Eigenschaftendropdowns zeigen nur 100 Elemente an. Wenn Sie ein Element hinzufügen müssen, das nicht in der Liste enthalten ist, müssen Sie den Bezeichner im System hinzufügen. Für zusätzliche Felder müssen Sie den Namen hinzufügen, der in der Fach- oder Administratorkonsole angezeigt wird.
  8. Zum Hinzufügen oder Ändern eines einfachen oder zusätzlichen Datumstypfelds von Fällen, Aufgaben oder CIs ist es erforderlich, das Datum mithilfe der tools built-in-Tools von Power Automate zu transformieren oder zu konvertieren.

Häufige Fehler und Abhilfemaßnahmen

Code Name Description Lösung
400 Fehlerhafte Anfrage CriteriaNeedsSomeArguments Überprüfen Sie, ob die Suchparameter nicht leer sind.
400 Fehlerhafte Anfrage InvalidAdditionalFieldId Überprüfen Sie, ob die IDs der zusätzlichen Felder korrekt sind.
400 Fehlerhafte Anfrage InvalidItemType Der Falltyp ist falsch, ändern Sie die Falltyp-ID.
400 Fehlerhafte Anfrage InvalidProjectId Die Projekt-ID ist falsch, ändern Sie die Projekt-ID, der Sie den Fall zuordnen möchten.
400 Fehlerhafte Anfrage InvalidStateId Überprüfen des hinzugefügten Status beim Erstellen oder Aktualisieren eines Tickets
400 Fehlerhafte Anfrage InvalidUploadType Fehler beim Anfügen einer Datei, Anfordern von Unterstützung durch einen Systemadministrator
400 Fehlerhafte Anfrage RequestNeedsSomeArguments Überprüfen Sie die erforderlichen Felder des Tickets, und fügen Sie den entsprechenden Wert dieser im Connector hinzu.
400 Fehlerhafte Anfrage SearchListIsRequired Anfordern von Unterstützung durch einen Systemadministrator
400 Fehlerhafte Anfrage Parametername: {Name parameter} Überprüfen Sie, ob die im Fehler erwähnten Eigenschaften nicht null sind.
400 Fehlerhafte Anfrage Ist null-Parametername: {Name parameter} Überprüfen Sie, ob die im Fehler erwähnten Eigenschaften nicht null sind.
400 Fehlerhafte Anfrage ItemTypeIsRequired Falltyp hinzufügen
400 Fehlerhafte Anfrage ModelIdIsEmpty Fügen Sie den parameter "modelId" hinzu. Es ist erforderlich.
400 Fehlerhafte Anfrage StateIdIsEmpty Fügen Sie den parameter stateId hinzu. Es ist erforderlich.
400 Fehlerhafte Anfrage ServiceIdIsEmpty Fügen Sie den Parameter "serviceId" hinzu. Es ist erforderlich.
400 Fehlerhafte Anfrage CategoryIdIsEmpty Fügen Sie den categoryId-Parameter hinzu. Es ist erforderlich.
400 Fehlerhafte Anfrage TypesListNeedsSomeArguments Erfordert das Hinzufügen des Falltyps bei der Suche nach Tickets, Anfordern von Unterstützung von einem Systemadministrator
400 Fehlerhafte Anfrage '{PARAMETER_NAME}' AdditionalFieldIsRequired Das zusätzliche Feld "{PARAMETER_NAME}" ist obligatorisch.
400 Fehlerhafte Anfrage ModelNotActive Das dem Fall zugeordnete Modell ist nicht aktiv.
400 Fehlerhafte Anfrage FailedToCloseTaskPendingCloseTasksPredecessors Wenn Sie versuchen, den Fall zu schließen, und der übergeordnete Fall über ausstehende Aufgaben zum Schließen verfügt
400 Fehlerhafte Anfrage DuplicatedObject Der Ci ist bereits in der Datenbank vorhanden.
400 Fehlerhafte Anfrage EmptyValue-Parametername: {PARAMETER_NAME} Der Parameter "{PARAMETER_NAME}" ist erforderlich.
400 Fehlerhafte Anfrage Name des EmptyEnumeration-Parameters: {PARAMETER_NAME} Der Parameter "{PARAMETER_NAME}" ist eine Liste und ist erforderlich.
400 Fehlerhafte Anfrage InvalidParentId Der übergeordnete Fall der Aufgabe ist ungültig.
400 Fehlerhafte Anfrage CharacterExceedLimit Der Vorgang wird als Feldaufgabe definiert, und der Betreff überschreitet 100 Zeichen.
400 Fehlerhafte Anfrage ParentIsClosed Versuch, die Aufgabe für einen geschlossenen übergeordneten Fall zu erstellen
400 Fehlerhafte Anfrage ServiceNotFound Die Eigenschaft "serviceId" ist ungültig.
400 Fehlerhafte Anfrage CategoryNotFound Die Eigenschaft "categoryId" ist ungültig.
400 Fehlerhafte Anfrage ModelNotFound Die Eigenschaft "categoryId" ist ungültig.
400 Fehlerhafte Anfrage StateNotFound Die Eigenschaft "stateId" ist ungültig.
400 Fehlerhafte Anfrage ItemBlocked Die Versionsinformationen des Objekts stimmen nicht mit den Informationen in der Datenbank überein: Der Wert der gesendeten "itemVersion"-Eigenschaft unterscheidet sich vom Wert des Felds Rev in der ASDK_ITEM Tabelle.
400 Fehlerhafte Anfrage InvalidFinalDate Wenn sowohl die Eigenschaften "endDate" als auch "startDate" Werte aufweisen, kann der Wert von "endDate" nicht früher als "startDate" sein.
400 Fehlerhafte Anfrage Das registrierte Datum "startDate" ist vor dem aktuellen Datum "DateTime-UtcNow"
400 Fehlerhafte Anfrage Ausstehende Aufgaben Wenn der in der Anforderung konfigurierte Status einem endgültigen Status entspricht, kann er nicht bearbeitet werden, da er verwandte Vorgängeraufgaben enthält, die nicht abgeschlossen wurden.
403 Verboten DoNotHavePermissionForThisAction Wenden Sie sich an Ihren Systemadministrator, um Berechtigungen zuzuweisen.
Code Name Description Lösung
500 Interner Serverfehler Anfordern von Unterstützung durch einen Systemadministrator
500 Interner Serverfehler FailureExportExcel Anfordern von Unterstützung durch einen Systemadministrator
500 Interner Serverfehler FailureGetAdditionalFields Anfordern von Unterstützung durch einen Systemadministrator
500 Interner Serverfehler FailureGetCategoriesByService Anfordern von Unterstützung durch einen Systemadministrator
500 Interner Serverfehler FailureGetChangeFSC Anfordern von Unterstützung durch einen Systemadministrator
500 Interner Serverfehler FailureGetFields Anfordern von Unterstützung durch einen Systemadministrator
500 Interner Serverfehler FailureGetFieldsList Anfordern von Unterstützung durch einen Systemadministrator
500 Interner Serverfehler FailureGetFiles Anfordern von Unterstützung durch einen Systemadministrator
500 Interner Serverfehler FailureGetLookupValues Anfordern von Unterstützung durch einen Systemadministrator
500 Interner Serverfehler FailureGetMailTemplates Anfordern von Unterstützung durch einen Systemadministrator
500 Interner Serverfehler FailureGetModelByCategory Anfordern von Unterstützung durch einen Systemadministrator
500 Interner Serverfehler FailureGetOperators Anfordern von Unterstützung durch einen Systemadministrator
500 Interner Serverfehler FailureGetReassignmentReasReasons Anfordern von Unterstützung durch einen Systemadministrator
500 Interner Serverfehler FailureGetSimilarItems Anfordern von Unterstützung durch einen Systemadministrator
500 Interner Serverfehler FailureSearchQuickManagement Anfordern von Unterstützung durch einen Systemadministrator

Häufig gestellte Fragen

  1. Wie rufen Sie die IDs der Attribute ab, die für die Verwendung der verschiedenen Aktionen im Connector erforderlich sind (z. B. Projekt, Dienst, Kategorie, Gruppe, Spezialist)?

    Die IDs können auf viele Arten abgerufen werden:

    • Mit Aranda Query Manager können Sie einen Bericht erstellen, der die Tabelle Aranda Service Management Suite (ASMS) abfragt, in der sich die erforderlichen Daten befinden. Wenn Sie Anleitungen zu den Datenobjekten in der Lösung benötigen, besuchen Sie den folgenden Link https://docs.arandasoft.com/en/docs/database.html , und identifizieren Sie die Aranda-Datenbankversion, die Ihrer ASMS-Installation entspricht.
    • Wenn Sie eine LOKALE ASMS-Installation verwenden, können Sie die ASMS-Tabelle abfragen, in der sich die erforderlichen Daten über einen SQL-Client befinden.
    • Über aranda Support Center erstellen Sie eine Supportanfrage über die kontaktkanäle, die auf der folgenden Website Support angegeben sind.
  2. Wie groß ist die maximale Größe von Dateien, die angefügt werden sollen, wenn sie die Aktion "Anlage hinzufügen" verwenden?

    Die maximale Größe hängt von der spezifischen Konfiguration Ihrer ASMS-Instanz/-installation ab. Bitten Sie Ihren ASMS-Administrator.

  3. Was ist die Datenzugriffsebene, die vom Technikerkonto benötigt wird, deren Token in der Konfiguration der asMS-Verbindung verwendet wird, die vom Connector benötigt wird?

    Die Zugriffsebene entspricht dem Technikerkonto, das in ASMS regelmäßig verwendet wird. Anders ausgedrückt: Basierend auf den Rollen und Berechtigungen des entsprechenden Technikers in ASMS können die Daten mit dem Connector aufgerufen werden.

  4. Sollte das Technikerkonto, dessen Token im Connector verwendet wird, benannt oder gleichzeitig sein?

    Da der Connector mehrmals pro Stunde auf die zugehörige ASMS-Instanz zugreifen kann, wird dringend empfohlen, dass das Konto ein benannter Typ ist.

  5. Entspricht die Erstellung oder Änderung von Fällen, die den Connector verwenden, den gleichen Datenüberprüfungsregeln, die in der ASMS-Schnittstelle vorhanden sind?

    Ja, es folgt den gleichen Gültigkeitsprüfungsregeln. Wenn beispielsweise ein Fall für ein bestimmtes Projekt, einen Dienst und eine Kategorie erstellt wird, wenn systemeigene und zusätzliche Felder ausgefüllt werden müssen, sind diese Daten auch erforderlich, wenn der Fall über den Connector übermittelt wird.

  6. Kann der Connector für ASMS-Instanzen in Cloud- und lokalen Umgebungen verwendet werden?

    Ja, es kann sowohl in Cloud- als auch in lokalen Installationen von ASMS verwendet werden. In lokalen Installationen müssen Sie die Konnektivität zwischen dem ASMS-Server und Ihrer Power Automate Umgebung berücksichtigen.

  7. Ich habe eine Power Automate-Lizenz, mit der ich nur Standardconnectors verwenden kann. Kann ich den ASMS-Connector verwenden?

    Es ist nicht möglich, der ASMS-Verbinder ist Premium-Typ.

  8. Ich möchte Flüsse in Power Automate erstellen, die von Ereignissen in ASMS beginnen (z. B. wenn ein Fall erstellt wurde, wenn ein Fall einer bestimmten Gruppe zugewiesen ist). Ist es möglich, Trigger zu verwenden, die von Ereignissen beginnen, die in ASMS auftreten?

    Ja, es ist möglich. Die folgenden Schritte werden empfohlen:

    • Initialisieren Sie einen Trigger "Wenn eine HTTP-Anforderung empfangen wird" und erstellen Sie ein Anforderungstext-JSON-Schema, das die datenstruktur enthält, die von ASMS empfangen werden soll. Nachdem der Trigger erstellt wurde, erhalten Sie eine HTTP POST-URL (WebHook-URL), die in Ihrer ASMS-Instanz verwendet werden soll. Vergessen Sie nicht, den Authentifizierungsmechanismus für den Zugriff auf die WebHook-URL (z. B. Token) zu berücksichtigen.
    • Erstellen Sie eine Geschäftsregel in ASMS für die Reihe von Bedingungen, die bei Erfüllung des Ablaufs in Power Automate initiieren sollen. Wählen Sie als Aktion innerhalb der Regel "Webhook aufrufen" aus, und geben Sie in der Aufrufziel-URL die zuvor abgerufene WebHook-URL, die zu sendenden Parameter und den Text der Anforderung ein (die dem Anforderungstext-JSON-Schema entsprechen müssen). Weitere Informationen zum Aufrufen eines Webhooks aus einer Regel in ASMS finden Sie unter dem folgenden Link: Webhook-Regel
    • Testen Sie die erstellte Regel, und überprüfen Sie, ob eine HTTP-Anforderung an die WebHook-URL gesendet wird, und initialisiert den Fluss in Power Automate.
  9. Kann ich ASMS-REST-API-Endpunkte als Aktionen aus Flüssen in Power Automate?

    Ja, es ist möglich. Verwenden Sie die "HTTP"-Aktion, und füllen Sie die erforderlichen Daten darin aus (URI, Methode, Headers, Body usw.).

  10. Kann ich einen eigenständigen Aufgabendatensatz erstellen? (Eine Aufgabe ohne übergeordnetes Ticket im Zusammenhang)

    Nein, es ist nicht möglich. Bei Verwendung der Aktion "Aufgabe erstellen" ist es obligatorisch, den übergeordneten Datensatzcode anzugeben.

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Description Erforderlich
Host ASMS Schnur Host ASMS Richtig
Autorisierungstoken securestring Autorisierungstoken Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Anlage zu Groß-/Kleinschreibung hinzufügen

Fügen Sie eine Datei an einen bestimmten Falldatensatz in ASMS an.

Artikel durchsuchen

Ruft eine Liste von Artikeln basierend auf den Suchkriterien ab, die in der Abfrage hinzugefügt wurden.

Aufgabe abrufen

Abrufen eines Aufgabendatensatzes in ASMS

Aufgabe aktualisieren

Aktualisiert einen Datensatz für eine ASMS-Aufgabe.

Aufgabe erstellen

Erstellen Sie einen neuen Aufgabendatensatz in ASMS, der einem Fall zugeordnet ist.

Fall abrufen

Ruft einen Datensatz der Metadaten eines ASMS-Falls ab.

Fall erstellen (V2)

Erstellen Sie einen neuen Falldatensatz in ASMS.

Fall erstellen [VERALTET]

Erstellen Eines neuen Falldatensatzes in ASMS (veraltet).

Fallverlauf abrufen

Fallverlauf abrufen, standardmäßig sind keine Notizen enthalten.

Herunterladen der Artikelanlage

Laden Sie anlage im Zusammenhang mit dem Artikel herunter.

Herunterladen der Fallanlage

Laden Sie anlage im Zusammenhang mit dem Artikel herunter.

Konfigurationselement abrufen

Rufen Sie CI anhand des Namens und der seriellen Datei ab.

Konfigurationselement aktualisieren (V2)

Aktualisieren Sie CIs in der Aranda CMDB.

Konfigurationselement aktualisieren [VERALTET]

Aktualisieren Sie CIs in der Aranda CMDB (veraltet).

Konfigurationselement erstellen (V2)

Erstellen Sie CIs in der Aranda CMDB.

Konfigurationselement erstellen [VERALTET]

Erstellen Sie CIs in der Aranda CMDB (veraltet).

Notiz zum Fall hinzufügen

Fügen Sie einen Hinweis zu einem bestimmten Falldatensatz in ASMS hinzu.

Suchaufgabe

Ruft eine Liste von Aufgaben im Zusammenhang mit einem Suchkriterium ab.

Suchfälle

Ruft eine Liste von ASMS-Falldatensätzen ab, je nachdem, welche Suchkriterien in der Abfrage hinzugefügt wurden.

Suchkonfigurationselemente

Ruft eine Liste von CMDB-CIs-Datensätzen ab, je nachdem, welche Suchkriterien in der Abfrage hinzugefügt wurden.

Update case [DEPRECATED]

Aktualisiert einen Datensatz für einen ASMS-Fall (veraltet).

Updatefall (V2)

Aktualisiert einen Datensatz für einen ASMS-Fall.

Anlage zu Groß-/Kleinschreibung hinzufügen

Fügen Sie eine Datei an einen bestimmten Falldatensatz in ASMS an.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID nach Projekt
ticketId True string

Code des Datensatzes

Datei
file True file

Dateidaten

Gibt zurück

Name Pfad Typ Beschreibung
Anlagen-ID
id integer

Systembezeichner für den Datensatz.

Dateiname
name string

Dateiname der Anlage.

Artikel durchsuchen

Ruft eine Liste von Artikeln basierend auf den Suchkriterien ab, die in der Abfrage hinzugefügt wurden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Project
projectId True integer

Wählen Sie ein Projekt aus, oder geben Sie manuell einen Projektbezeichner ein.

Suchartikel
search True string

Suchen Sie nach einem Artikel anhand ihres Titels, Schlüsselworts oder einer Beschreibung.

Kategorie
folderId integer

Wählen Sie eine Kategorie aus, oder geben Sie manuell einen Kategoriebezeichner ein.

Typ
typeId integer

Wählen Sie einen Typ aus, oder geben Sie manuell einen Typbezeichner ein.

Gibt zurück

Name Pfad Typ Beschreibung
array of object
Title
title string

Titel.

Description
description string

Beschreibung.

Content
content html

Artikelinhalt mit Rich-Text.

Inhalt ohne HTML
contentNoHtml string

Artikelinhalt ohne Rich-Text.

Artikel-Schlüsselwort
keyword string

Artikel-Schlüsselwort.

Artikel-ID
identifier string

Artikelbezeichner.

Erstellungsdatum
createdDate string

Erstellungsdatum.

Änderungsdatum
lastModifiedDate string

Änderungsdatum.

Klassen-ID
classId integer

Klassenbezeichner.

Artikel-ID
id integer

Systembezeichner für den Datensatz.

ID
type.id integer

Typbezeichner.

name
type.name string

Geben Sie den Namen ein.

URL
url string

URL

Artikel "Anlagen"
attachments array of object

Anlagen im Zusammenhang mit dem Artikel.

ID
attachments.id integer

Anlagenbezeichner.

name
attachments.name string

Anlagenname.

Aufgabe abrufen

Abrufen eines Aufgabendatensatzes in ASMS

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Vorgangs-ID
taskId True string

Bezeichner für den Datensatz.

Gibt zurück

Name Pfad Typ Beschreibung
Zusätzliches Feld
additionalFields array of object

Zusätzliches Feld.

ID
additionalFields.fieldId integer

Zusätzlicher Feldbezeichner.

name
additionalFields.nameField string

Zusätzlicher Feldname.

values
additionalFields.values array of string

Zusätzliche Feldwerte.

:ID
additionalFields.valueDetails.id integer

Spezifikation für Listen- oder Katalogtypfelder: Bezeichner.

:Wert
additionalFields.valueDetails.value string

Spezifikation für Listen- oder Katalogtypfelder: Wert.

Attachments
attachments array of object

Anlagen im Zusammenhang mit der Aufgabe.

Erstellungsdatum
attachments.created string

Erstellungsdatum (ISO 8601)

Beschreibung
attachments.description string

Beschreibung der angefügten Datei

ID
attachments.id integer

Anlagenbezeichner.

ist öffentlich
attachments.isPublic boolean

Bestimmt, ob die angefügte Datei öffentlich oder privat ist, wobei private Dateien nur von Spezialisten und öffentlichen Dateien angezeigt werden können, von Kunden und Spezialisten.

name
attachments.name string

Anlagenname.

Größe
attachments.size integer

Entspricht der Größe in Byte der angefügten Datei.

ID
author.id integer

Autorbezeichner.

name
author.name string

Name des Autors.

Lösungsaufgabe
commentary string

Lösungsaufgabe.

Beschreibungsaufgabe
description string

Beschreibungsaufgabe.

Dauer
duration number

Vorgangsdauer in Minuten.

Finale
estimatedDate.final date-time

Geschätztes Enddatum.

Ersten
estimatedDate.initial date-time

Geschätzter Anfangstermin.

Enddatum
finalDate date-time

Bestimmt das Abschlussdatum des Vorgangs.

ID
group.id integer

Gruppen-ID.

name
group.name string

Gruppenname.

Vorgangs-ID
id integer

Systembezeichner für den Datensatz.

Anfangstermin des Vorgangs
initialDate string

Anfangstermin des Vorgangs.

Ist geschlossen
isClosed boolean

Bestimmt, ob der Vorgang geschlossen wurde.

Ist Priorität oder Notfall
isPriorityOrEmergency boolean

Ermitteln Sie, ob es sich um eine Priorität oder einen Notfall handelt.

Typ
item.type string

Aufgabentyp.

Ausgabe
item.version integer

Aufgabenversion.

ID
model.id integer

Modellbezeichner.

name
model.name string

Modellname.

Erstellungsdatum.
openedDate date-time

Erstellungsdatum.

ID
parent.id integer

Systembezeichner für den Fall.

Code
parent.idByProject string

Bezeichner für den Fall.

Typ
parent.itemType string

Falltyp

Typ-ID
parent.itemTypeId string

Bezeichner für den Falltyp.

Progress
progress float

Fortschritt.

ID
project.id integer

Bezeichner des Hauptfallprojekts.

name
project.name string

Name des Hauptfallprojekts.

Finale
realDate.final date-time

Ist-Fertigstellungsdatum

Ersten
realDate.initial date-time

Tatsächliches Startdatum

ID
reason.id integer

Grundbezeichner.

name
reason.name string

Grundname

ID
responsible.id integer

Verantwortlicher Bezeichner.

name
responsible.name string

Verantwortlicher Name.

ID
state.id integer

Statusbezeichner.

name
state.name string

Statusname.

: Vorheriger Zustand
state.previousState integer

Vorheriger Zustand.

: Status-ID der Aufgabenerstellung
state.wasCreated integer

Bestimmt die Status-ID, mit der die Aufgabe erstellt wurde.

: Name des Vorgangserstellungsstatus
state.wasCreatedName string

Bestimmt den Statusnamen, mit dem die Aufgabe erstellt wurde.

Vorgangstitel
subject string

Vorgangstitel.

ID nach Projekt
idByProject string

ID nach Projekt für den Datensatz.

Aufgabe aktualisieren

Aktualisiert einen Datensatz für eine ASMS-Aufgabe.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Vorgangs-ID
taskId True string

Bezeichner für den Datensatz.

Übergeordneter Falltyp
caseType True string

Wählen Sie einen übergeordneten Falltyp aus, oder geben Sie manuell einen übergeordneten Falltypnamen ein.

Model
modelId True integer

Wählen Sie ein Modell aus, oder geben Sie manuell einen Modellbezeichner ein.

body
body True dynamic

Gibt zurück

Name Pfad Typ Beschreibung
Vorgangs-ID
id integer

Vorgangs-ID

ID nach Projekt
idByProject string

ID nach Projekt für den Datensatz

Aufgabe erstellen

Erstellen Sie einen neuen Aufgabendatensatz in ASMS, der einem Fall zugeordnet ist.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Übergeordneter Fallcode
idByProject True string

Code des Hauptfalls, dem die Aufgabe zugeordnet wird.

Übergeordneter Falltyp
caseType True string

Wählen Sie einen übergeordneten Falltyp aus, oder geben Sie manuell einen übergeordneten Falltypnamen ein.

Model
modelId True integer

Wählen Sie ein Modell aus, oder geben Sie manuell einen Modellbezeichner ein.

body
body True dynamic

Gibt zurück

Name Pfad Typ Beschreibung
Vorgangs-ID
id integer

Vorgangs-ID

ID nach Projekt
idByProject string

ID nach Projekt für den Datensatz

Fall abrufen

Ruft einen Datensatz der Metadaten eines ASMS-Falls ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID nach Projekt
ticketId True string

Code des Datensatzes

Gibt zurück

Name Pfad Typ Beschreibung
Fall-ID
id integer

Systembezeichner für den Datensatz.

ID nach Projekt
idByProject string

ID nach Projekt für den Datensatz.

Betreff
subject string

Betreff:

Description
description string

Detaillierte Beschreibung des Falls.

Lösung
commentary string

Falllösung.

Projektkennung
projectId integer

Projektbezeichner.

Project
projectName string

Projektname.

Falltyp
itemTypeName string

Name des Groß-/Kleinschreibungstyps.

Falltyp-ID
itemTypeId integer

Bezeichner des Falltyps.

Dienst-ID
serviceId integer

Dienstbezeichner.

Dienstleistung
serviceName string

Dienstname.

Modell-ID
modelId integer

Modellbezeichner.

Model
modelName string

Modellname.

Kategorie-ID
categoryId integer

Kategoriebezeichner.

Kategoriename
categoryName string

Kategorie.

Antragsteller-ID
applicantId integer

Antragstellerbezeichner.

Kunden-ID
customerId integer

Client-ID.

Kunde
customerName string

Clientname.

Unternehmens-ID
companyId integer

Firmenbezeichner.

Firma
companyName string

Firmenname.

CI-KENNUNG
ciId integer

CI-ID.

CI
ciName string

CI-Name.

SLA-ID
slaId integer

SLA-ID.

Service Level Agreement (SLA)
slaName string

SLA-Name.

Status-ID
stateId integer

Statusbezeichner.

Der Status
stateName string

Statusname.

Grund-ID
reasonId integer

Grundbezeichner.

Ursache
reasonName string

Grundname.

Gruppen-ID
groupId integer

Gruppen-ID.

Gruppe
groupName string

Gruppenname.

Verantwortliche ID
responsibleId integer

Verantwortlicher Bezeichner.

Verantwortlich
responsibleName string

Verantwortlicher Name.

Registrierungstyp-ID
registryTypeId integer

Registrierungstypbezeichner.

Registrierungstyp
registryTypeName string

Registrierungstypname.

Auswirkungs-ID
impactId integer

Auswirkungsbezeichner.

Auswirkung
impactName string

Auswirkungsname.

Dringlichkeits-ID
urgencyId integer

Dringlichkeits-ID.

Dringlichkeit
urgencyName string

Dringlichkeitsname.

Prioritäts-ID
priorityId integer

Prioritäts-ID.

Priority
priorityName string

Prioritätsname.

Risiko-ID
riskId integer

Risikobezeichner.

Risiko
riskName string

Risikoname.

Anbieter-ID
providerId integer

Anbieterbezeichner.

Provider
providerName string

Anbietername.

UC-ID
ucId integer

UC-Bezeichner.

UC
ucName string

UC-Name.

Id des Organisationsbereichs
unitId integer

Bezeichner des Organisationsbereichs.

Organisationsbereich
unitName string

Name des Organisationsbereichs.

OLA-ID
olaId integer

OLA-Id.

OLA
olaName string

OLA-Name.

Registrierungsdatum
openedDate string

Registrierungsdatum.

Geschlossen am
closedDate string

Abschlussdatum.

Enddatum
finalDate string

Enddatum (nur für Vorgangsdatensätze).

Anfangstermin
initialDate string

Anfangstermin (nur für Vorgangsdatensätze).

Kosten
cost number

Kosten.

Reale Kosten
realCost number

Reale Kosten.

Geschätzte Kosten
estimatedCost number

Geschätzte Kosten.

Preis
price number

Preis.

Schnittstellenbezeichner
interfaceId string

Schnittstellenbezeichner.

Geschlossen
isClosed boolean

Geschlossen.

Progress
currentProgress number

Fortschritt.

Reales Datum
realDate string

Reales Datum.

Geschätztes Datum
estimatedDate string

Geschätztes Datum.

Autor-ID
authorId integer

Autorbezeichner.

Autor
authorName string

Name des Autors.

Attachments
attachments array of object

Anlagen im Zusammenhang mit dem Fall.

ID
attachments.id integer

Anlagenbezeichner.

name
attachments.name string

Anlagenname.

Zusätzliches Feld
additionalFields array of object

Zusätzliches Feld.

ID
additionalFields.fieldId integer

Feldbezeichner.

name
additionalFields.nameField string

Flurname.

values
additionalFields.values array of string

Zusätzliche Feldwerte.

:ID
additionalFields.valueDetails.id integer

Spezifikation für Listen- oder Katalogtypfelder: Bezeichner.

:Wert
additionalFields.valueDetails.value string

Spezifikation für Listen- oder Katalogtypfelder: Wert.

Fall erstellen (V2)

Erstellen Sie einen neuen Falldatensatz in ASMS.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Project
projectId True integer

Wählen Sie ein Projekt aus, oder geben Sie manuell einen Projektbezeichner ein.

Anfragetyp
caseType True string

Wählen Sie einen Falltyp aus, oder geben Sie manuell einen Falltypnamen ein.

Dienstleistung
serviceId True integer

Wählen Sie einen Dienst aus, oder geben Sie manuell einen Dienstbezeichner ein.

Kategorie
categoryId True integer

Wählen Sie einen Dienst aus, oder geben Sie manuell einen Dienstbezeichner ein.

body
body True dynamic

Gibt zurück

Name Pfad Typ Beschreibung
Fall-ID
id integer

Fallbezeichner

ID nach Projekt
idByProject string

ID nach Projekt für den Datensatz

Fall erstellen [VERALTET]

Erstellen Eines neuen Falldatensatzes in ASMS (veraltet).

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Betreff
subject True string

Betreff:

Description
description string

Detaillierte Beschreibung des Falls.

Anfragetyp
itemType True string

Wählen Sie einen Falltyp aus, oder geben Sie manuell einen Falltypnamen ein.

Project
projectId True integer

Wählen Sie ein Projekt aus, oder geben Sie manuell einen Projektbezeichner ein.

Dienstleistung
serviceId True integer

Wählen Sie einen Dienst aus, oder geben Sie manuell einen Dienstbezeichner ein.

Kategorie
categoryId True integer

Wählen Sie eine Kategorie aus, oder geben Sie manuell einen Kategoriebezeichner ein.

Ursache
reasonId integer

Wählen Sie einen Grund aus, oder geben Sie manuell einen Grundbezeichner ein.

Gruppe
groupId integer

Wählen Sie eine Gruppe aus, oder geben Sie manuell einen Gruppenbezeichner ein.

Verantwortlich
responsibleId integer

Wählen Sie einen verantwortlichen Namen aus, oder geben Sie manuell einen verantwortlichen Bezeichner ein.

Firma
companyId integer

Wählen Sie ein Unternehmen aus, oder geben Sie manuell einen Firmenbezeichner ein.

Provider
providerId integer

Wählen Sie einen Anbieter aus, oder geben Sie manuell einen Anbieterbezeichner ein.

Organisationsbereich
unitId integer

Wählen Sie einen Organisationsbereich aus, oder geben Sie manuell einen Organisationsbereichsbezeichner ein.

Antragsteller-ID
applicantId integer

Antragstellerbezeichner.

Kunden-ID
customerId integer

Client-ID.

CI-ID
ciId integer

CI-ID.

Registrierungstyp
registryTypeId integer

Wählen Sie einen Registrierungstyp aus, oder geben Sie manuell einen Registrierungstypbezeichner ein.

Dringlichkeit
urgencyId integer

Wählen Sie eine Dringlichkeit aus, oder geben Sie manuell einen Dringlichkeitsbezeichner ein.

Auswirkung
impactId integer

Wählen Sie eine Auswirkung aus, oder geben Sie manuell einen Auswirkungsbezeichner ein.

ID
fieldId string

Feldbezeichner.

values
values array of string

Wert.

Gibt zurück

Name Pfad Typ Beschreibung
Fall-ID
id integer

Fallbezeichner

ID nach Projekt
idByProject string

ID nach Projekt für den Datensatz

Fallverlauf abrufen

Fallverlauf abrufen, standardmäßig sind keine Notizen enthalten.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID nach Projekt
ticketId True string

Code des Datensatzes

Notizen einschließen
addNote string

Wählen Sie den Typ der Notiz aus, die Sie hinzufügen möchten.

Gibt zurück

Name Pfad Typ Beschreibung
array of object
Aktionstaste
actionId string

Aktionstaste

Maßnahme
actionName string

Name der Aktivität oder Aktion, die im Lebenszyklus des Tickets ausgeführt wurde.

Autor-ID
authorId integer

Autorbezeichner.

Autor
authorName string

Autor, der die Änderung vorgenommen hat.

Erstellungsdatum.
created date-time

Datum, an dem die Aktion aufgetreten ist.

Geänderter Feldname
fieldName string

Geänderter Feldname.

Neuer Wert
newValue html

Stellt den neuen Wert der Eigenschaft dar.

Alter Wert
oldValue html

Wert, der geändert wurde.

Notiztyp
noteType string

Stellt den Typ der Notiz dar (nur für den Aktionsschlüssel "Notiz").

Bezeichner für verwandte Elemente
relatedItemId string

Stellt den Bezeichner dar, wenn eine Relation hinzugefügt wird. (nur für den Aktionsschlüssel 'AddedRelated').

Herunterladen der Artikelanlage

Laden Sie anlage im Zusammenhang mit dem Artikel herunter.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Artikel-ID
articleId True integer

Artikelbezeichner.

Anlagen-ID
fileId integer

Stellt den Bezeichner der Anlage dar.

Gibt zurück

Der Inhalt der Anlage.

Dateiinhalt
binary

Herunterladen der Fallanlage

Laden Sie anlage im Zusammenhang mit dem Artikel herunter.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID nach Projekt
ticketId True string

Code des Datensatzes

Anlagen-ID
fileId integer

Stellt den Bezeichner der Anlage dar.

Gibt zurück

Der Inhalt der Anlage.

Dateiinhalt
binary

Konfigurationselement abrufen

Rufen Sie CI anhand des Namens und der seriellen Datei ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Name oder serielle CI
request True string

Geben Sie den Namen oder die seriell des Konfigurationselements ein.

Gibt zurück

Name Pfad Typ Beschreibung
Zusätzliches Feld
additionalFields array of object

Zusätzliches Feld.

ID
additionalFields.fieldId integer

Feldbezeichner

name
additionalFields.nameField string

Flurname

values
additionalFields.values array of string

Zusätzliche Feldwerte

:ID
additionalFields.valueDetails.id integer

Spezifikation für Listen- oder Katalogtypfelder: Bezeichner

:Wert
additionalFields.valueDetails.value string

Spezifikation für Listen- oder Katalogtypfelder: Wert

Asset-Tag
assetTag string

Asset-Tag.

Strichcode
barCode string

Strichcode.

ID
brand.id integer

Markenbezeichner.

name
brand.name string

Markenname.

ID
group.id integer

Gruppen-ID.

name
group.name string

Gruppenname.

ID
category.id integer

Kategoriebezeichner.

name
category.name string

Kategoriename.

ID
costCenter.id integer

Kostenstellenbezeichner.

name
costCenter.name string

Kostenstellenname.

Annahmedatum
acceptDate date-time

Annahmedatum.

Lieferdatum an das Unternehmen
checkinDate date-time

Lieferdatum an das Unternehmen.

Anfangstermin der Verantwortung
responsibilityDate date-time

Anfangstermin der Verantwortung.

Erstellungsdatum
createdDate date-time

Erstellungsdatum.

Änderungsdatum
modifiedDate date-time

Änderungsdatum.

Description
description string

Detaillierte Beschreibung des CI.

CI-KENNUNG
id integer

Systembezeichner für den Datensatz.

ID
impact.id integer

Auswirkungsbezeichner.

name
impact.name string

Auswirkungsname.

Lizenznummer
licenseNumber string

Lizenznummer.

ID
manufacturer.id integer

Hersteller-ID.

name
manufacturer.name string

Herstellername.

ID
model.id integer

Modellbezeichner.

name
model.name string

Modellname.

CI-Name
name string

Name des Konfigurationselements.

Projekte
projects array of object

Projekte.

ID
projects.id integer

Bezeichner.

ID
provider.id integer

Hersteller-ID.

name
provider.name string

Herstellername.

ID
reason.id integer

Grundbezeichner.

name
reason.name string

Grundname

ID
responsible.id integer

Verantwortlicher Bezeichner.

name
responsible.name string

Verantwortlicher Name.

ID
risk.id integer

Risikobezeichner.

name
risk.name string

Risikoname.

RFID
rfid string

RFID

Serie
serial string

Serie

ID
state.id integer

Statusbezeichner.

name
state.name string

Statusname.

Temporärer Elementbezeichner
tempItemId integer

Temporärer Elementbezeichner.

CI-Typ
type string

Konfigurationselementtyp.

ID
unit.id integer

Einheitenbezeichner.

name
unit.name string

Einheitenname.

Maßeinheitswert
unitSize string

Maßeinheitswert.

Nutzungsdauer
usefulLife integer

Nützliches Leben.

Version
version integer

Ausgabe

Konfigurationselement aktualisieren (V2)

Aktualisieren Sie CIs in der Aranda CMDB.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Project
projectId True integer

Wählen Sie ein Projekt aus, oder geben Sie manuell einen Projektbezeichner ein.

Kategorie
categoryId True integer

Wählen Sie eine Kategorie aus, oder geben Sie manuell einen Kategoriebezeichner ein.

Name oder serielle CI
request True string

Geben Sie den Namen oder die seriell des Konfigurationselements ein.

body
body True dynamic

Gibt zurück

Name Pfad Typ Beschreibung
Konfigurationselementbezeichner
id integer

Konfigurationselementbezeichner.

Konfigurationselement aktualisieren [VERALTET]

Aktualisieren Sie CIs in der Aranda CMDB (veraltet).

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Name oder serielle CI
request True string

Geben Sie den Namen oder die seriell des Konfigurationselements ein.

Description
description string

Detaillierte Beschreibung des CI.

Serie
serial string

Serie

Asset-Tag
assetTag string

Asset-Tag.

Kategorie
categoryId integer

Wählen Sie eine Kategorie aus, oder geben Sie manuell einen Kategoriebezeichner ein.

Verantwortliche ID
responsibleId integer

Verantwortlicher Bezeichner.

Status-ID
stateId integer

Statusbezeichner.

Lizenznummer
licenseNumber string

Lizenznummer.

Hersteller-ID
manufacturerId integer

Hersteller-ID.

Marke
brandId integer

Wählen Sie eine Marke aus, oder geben Sie manuell einen Markenbezeichner ein.

Model
modelId integer

Wählen Sie ein Modell aus, oder geben Sie manuell einen Modellbezeichner ein.

Anbieter-ID
providerId integer

Anbieterbezeichner.

Grund-ID
reasonId integer

Grundbezeichner.

Preis
price number

Preis.

RFID
rfid string

RFID

Annahmedatum
acceptDate date-time

Annahmedatum.

Lieferdatum an das Unternehmen
checkInDate date-time

Lieferdatum an das Unternehmen.

Anfangstermin der Verantwortung
responsibilityDate date-time

Anfangstermin der Verantwortung.

Strichcode
barCode string

Strichcode.

Maßeinheitswert
unitSize string

Maßeinheitswert.

Maßeinheit
unitId integer

Wählen Sie eine Maßeinheit aus, oder geben Sie manuell einen Messeinheitsbezeichner ein.

Kostenstellen-ID
costCenterId integer

Kostenstellenbezeichner.

Auswirkung
impactId integer

Wählen Sie eine Auswirkung aus, oder geben Sie manuell einen Auswirkungsbezeichner ein.

Risiko
riskId integer

Wählen Sie ein Risiko aus, oder geben Sie manuell einen Risikobezeichner ein.

Speicherort-ID
locationId integer

Standortbezeichner.

fieldId
fieldId string

Feldbezeichner

values
values array of string

Wert

Gibt zurück

Name Pfad Typ Beschreibung
Konfigurationselementbezeichner
id integer

Konfigurationselementbezeichner.

Konfigurationselement erstellen (V2)

Erstellen Sie CIs in der Aranda CMDB.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Project
projectId True integer

Wählen Sie ein Projekt aus, oder geben Sie manuell einen Projektbezeichner ein.

Kategorie
categoryId True integer

Wählen Sie eine Kategorie aus, oder geben Sie manuell einen Kategoriebezeichner ein.

body
body True dynamic

Gibt zurück

Name Pfad Typ Beschreibung
Konfigurationselementbezeichner
id integer

Konfigurationselementbezeichner.

Konfigurationselement erstellen [VERALTET]

Erstellen Sie CIs in der Aranda CMDB (veraltet).

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Name
name True string

Name

Description
description string

Detaillierte Beschreibung des CI.

Serie
serial string

Seriell.

Asset-Tag
assetTag string

Asset-Tag.

Project
projectId True integer

Wählen Sie ein Projekt aus, oder geben Sie manuell einen Projektbezeichner ein.

Kategorie
categoryId True integer

Wählen Sie eine Kategorie aus, oder geben Sie manuell einen Kategoriebezeichner ein.

Verantwortliche ID
responsibleId True integer

Verantwortlicher Bezeichner.

Lizenznummer
licenseNumber string

Lizenznummer.

Hersteller
manufacturerId integer

Wählen Sie einen Hersteller aus, oder geben Sie manuell einen Herstellerbezeichner ein.

Marke
brandId integer

Wählen Sie eine Marke aus, oder geben Sie manuell einen Markenbezeichner ein.

Model
modelId integer

Wählen Sie ein Modell aus, oder geben Sie manuell einen Modellbezeichner ein.

Anbieter-ID
providerId integer

Wählen Sie einen Anbieter aus, oder geben Sie manuell einen Anbieterbezeichner ein.

Grund-ID
reasonId integer

Grundbezeichner.

Preis
price number

Preis.

RFID
rfid string

RFID

Annahmedatum
acceptDate date-time

Annahmedatum.

Lieferdatum an das Unternehmen
checkInDate date-time

Lieferdatum an das Unternehmen.

Anfangstermin der Verantwortung
responsibilityDate date-time

Anfangstermin der Verantwortung.

Strichcode
barCode string

Strichcode.

Maßeinheitswert
unitSize string

Maßeinheitswert.

Maßeinheit
unitId integer

Wählen Sie eine Maßeinheit aus, oder geben Sie manuell einen Messeinheitsbezeichner ein.

Kostenstelle
costCenterId integer

Wählen Sie ein Kostencenter aus, oder geben Sie manuell einen Kostenstellenbezeichner ein.

Auswirkung
impactId integer

Wählen Sie eine Auswirkung aus, oder geben Sie manuell einen Auswirkungsbezeichner ein.

Risiko
riskId integer

Wählen Sie ein Risiko aus, oder geben Sie manuell einen Risikobezeichner ein.

Standort
locationId integer

Wählen Sie einen Speicherort aus, oder geben Sie manuell einen Standortbezeichner ein.

fieldId
fieldId string

Feldbezeichner.

values
values array of string

Wert

Gibt zurück

Name Pfad Typ Beschreibung
Konfigurationselementbezeichner
id integer

Konfigurationselementbezeichner.

Notiz zum Fall hinzufügen

Fügen Sie einen Hinweis zu einem bestimmten Falldatensatz in ASMS hinzu.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID nach Projekt
ticketId True string

Code des Datensatzes

Hinweis
message True string

Hinweis, der an den Datensatz angefügt werden soll.

Suchaufgabe

Ruft eine Liste von Aufgaben im Zusammenhang mit einem Suchkriterium ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Zu filternde Felder
field True string

Zu filternde Vorgangsfeld (z. B. 'stateName').

Suchoperator
operator True string

Suchoperator.

Zu findende Wert
value True string

Feldwert, der gesucht werden soll.

Beziehung zwischen Filtern
logicOperator True string

Gibt die Beziehung zwischen Suchkriterien an.

Gibt zurück

Name Pfad Typ Beschreibung
array of object
ID
author.id integer

Autorbezeichner.

Name
author.name string

Name des Autors

Geschlossen am
closedDate date-time

Geschlossen am

Description
description string

Detaillierte Beschreibung des Vorgangs.

ID
group.id integer

Gruppen-ID.

Name
group.name string

Gruppenname.

Vorgangs-ID
id integer

Systembezeichner für den Datensatz.

Ist geschlossen
isClosed boolean

Bestimmt, ob der Vorgang geschlossen wurde.

ID
model.id integer

Modellbezeichner.

Name
model.name string

Modellname.

Erstellungsdatum
openedDate date-time

Erstellungsdatum.

ID
parent.id integer

Systembezeichner für den übergeordneten Fall.

Fallcode
parent.idByProject string

ID nach Projekt für den übergeordneten Fall.

ID
project.id integer

Projektbezeichner des übergeordneten Falls.

Name
project.name string

Name des übergeordneten Projektprojekts.

ID
responsible.id integer

Verantwortlicher Bezeichner.

Name
responsible.name string

Verantwortlicher Name.

ID
state.id integer

Statusbezeichner.

Name
state.name string

Statusname.

Betreff
subject string

Vorgangsbetreff.

ID nach Projekt
idByProject string

ID nach Projekt für den Datensatz.

Suchfälle

Ruft eine Liste von ASMS-Falldatensätzen ab, je nachdem, welche Suchkriterien in der Abfrage hinzugefügt wurden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Beziehung zwischen Filtern
logicOperator True string

Gibt die Beziehung zwischen Suchkriterien an.

Zu filternde Felder
field True string

Fallfeld zum Filtern (z. B. 'stateName').

Suchoperator
operator True string

Suchoperator.

Zu findende Wert
value True string

Feldwert, der gesucht werden soll.

Gibt zurück

Name Pfad Typ Beschreibung
array of object
Fall-ID
id integer

Systembezeichner für den Datensatz.

ID nach Projekt
idByProject string

ID nach Projekt für den Datensatz.

Betreff
subject string

Fallbetreff.

Description
description string

Detaillierte Beschreibung des Falls.

Projektkennung
projectId integer

Projektbezeichner.

Project
projectName string

Projektname.

Anfragetyp
itemTypeName string

Name des Groß-/Kleinschreibungstyps.

Falltyp-ID
itemTypeId integer

Bezeichner des Falltyps.

Dienst-ID
serviceId integer

Dienstbezeichner.

Dienstleistung
serviceName string

Dienstname.

Modell-ID
modelId integer

Modellbezeichner.

Model
modelName string

Modellname.

Kategorie-ID
categoryId integer

Kategoriebezeichner.

Kategorie
categoryName string

Kategoriename.

Antragsteller-ID
applicantId integer

Antragstellerbezeichner.

CI-KENNUNG
ciId integer

Konfigurationselementbezeichner.

CI
ciName string

Name des Hauptkonfigurationselements.

Kunden-ID
customerId integer

Client-ID.

Kunde
customerName string

Clientname.

Unternehmens-ID
companyId integer

Firmenbezeichner.

Firma
companyName string

Firmenname.

SLA-ID
slaId integer

SLA-ID.

Service Level Agreement (SLA)
slaName string

SLA-Name.

Status-ID
stateId integer

Statusbezeichner.

Der Status
stateName string

Statusname.

Grund-ID
reasonId integer

Grundbezeichner.

Ursache
reasonName string

Grundname.

Gruppen-ID
groupId integer

Gruppen-ID.

Gruppe
groupName string

Gruppenname.

Verantwortliche ID
responsibleId integer

Verantwortlicher Bezeichner.

Verantwortlich
responsibleName string

Verantwortlicher Name.

Auswirkungs-ID
impactId integer

Auswirkungsbezeichner.

Auswirkung
impactName string

Auswirkungsname.

Registrierungsdatum
openedDate string

Registrierungsdatum.

Autor-ID
authorId integer

Autorbezeichner.

Autor
authorName string

Name des Autors.

Suchkonfigurationselemente

Ruft eine Liste von CMDB-CIs-Datensätzen ab, je nachdem, welche Suchkriterien in der Abfrage hinzugefügt wurden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Beziehung zwischen Filtern
logicOperator True string

Gibt die Beziehung zwischen Suchkriterien an.

Zu filternde Felder
field True string

CI-Feld zum Filtern (z. B. 'stateName')

Suchoperator
operator True string

Suchoperator.

Zu findende Wert
value True string

Feldwert, der gesucht werden soll.

Gibt zurück

Name Pfad Typ Beschreibung
array of object
Annahmedatum
acceptDate date-time

Annahmedatum

Asset-Tag
assetTag string

Asset-Tag

Verantwortlicher Name
responsibleName string

Verantwortlicher Name

ID
category.id integer

Kategoriebezeichner

name
category.name string

Kategoriename

Lieferdatum an das Unternehmen
checkinDate date-time

Lieferdatum an das Unternehmen.

Erstellungsdatum
createdDate date-time

Erstellungsdatum

Description
description string

Detaillierte Beschreibung des CI.

CI-KENNUNG
id integer

Systembezeichner für den Datensatz.

ID
impact.id integer

Auswirkungsbezeichner

name
impact.name string

Auswirkungsname

Änderungsdatum
modifiedDate date-time

Änderungsdatum

CI-Name
name string

Name des Konfigurationselements.

Anfangstermin der Verantwortung
responsibilityDate date-time

Anfangstermin der Verantwortung.

Serie
serial string

Serie

ID
state.id integer

Statusbezeichner.

name
state.name string

Statusname.

CI-Typ
type string

Konfigurationselementtyp.

Update case [DEPRECATED]

Aktualisiert einen Datensatz für einen ASMS-Fall (veraltet).

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID nach Projekt
ticketId True string

Code des Datensatzes

Betreff
subject string

Betreff:

Description
description string

Detaillierte Beschreibung des Falls.

Lösung
commentary string

Falllösung.

Dienst-ID
serviceId integer

Dienstbezeichner.

Kategorie-ID
categoryId integer

Kategoriebezeichner.

Status-ID
stateId integer

Statusbezeichner.

Grund-ID
reasonId integer

Grundbezeichner.

Gruppen-ID
groupId integer

Gruppen-ID.

Verantwortliche ID
responsibleId integer

Verantwortlicher Bezeichner.

Antragsteller-ID
applicantId integer

Antragstellerbezeichner.

Kunden-ID
customerId integer

Client-ID.

Unternehmens-ID
companyId integer

Firmenbezeichner.

CI-KENNUNG
ciId integer

CI-ID.

Anbieter-ID
providerId integer

Anbieterbezeichner.

Id des Organisationsbereichs
unitId integer

Bezeichner des Organisationsbereichs.

Registrierungstyp
registryTypeId integer

Wählen Sie einen Registrierungstyp aus, oder geben Sie manuell einen Registrierungstypbezeichner ein.

Dringlichkeit
urgencyId integer

Wählen Sie eine Dringlichkeit aus, oder geben Sie manuell einen Dringlichkeitsbezeichner ein.

Auswirkung
impactId integer

Wählen Sie eine Dringlichkeit aus, oder geben Sie manuell einen Auswirkungsbezeichner ein.

Schnittstelle
interfaceId string

Beziehung des Falls mit Dritten.

Feldbezeichner
fieldId string

Feldbezeichner.

Werte
values array of string

Werte.

Gibt zurück

Name Pfad Typ Beschreibung
Ergebnis
result boolean

Ergebnis

Updatefall (V2)

Aktualisiert einen Datensatz für einen ASMS-Fall.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID nach Projekt
ticketId True string

Code des Datensatzes

Project
projectId integer

Wählen Sie ein Projekt aus, oder geben Sie manuell einen Projektbezeichner ein.

Anfragetyp
caseType string

Wählen Sie einen Falltyp aus, oder geben Sie manuell einen Falltypnamen ein.

Dienstleistung
serviceId integer

Wählen Sie einen Dienst aus, oder geben Sie manuell einen Dienstbezeichner ein.

Kategorie
categoryId integer

Wählen Sie einen Dienst aus, oder geben Sie manuell einen Dienstbezeichner ein.

Staat
stateId integer

Wählen Sie einen Dienst aus, oder geben Sie manuell einen Dienstbezeichner ein.

body
body True dynamic

Gibt zurück

Name Pfad Typ Beschreibung
Ergebnis
result boolean

Ergebnis

Definitionen

binär

Dies ist der grundlegende Datentyp "binary".