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/ |
| 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
Erfordert ein Abonnement von Aranda Service Management Suite (ASMS).
Abrufen des Integrationstokens
Rufen Sie die Instanz-URL der Aranda Service Management ASMS-API (ApiAsms) ab.
Herstellen einer Verbindung mit dem Aranda Service Management Suite-Connector.
Wählen Sie eine der folgenden Funktionen aus, die vom Connector angeboten werden:
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:
- Erstellen, Suchen und Aktualisieren von Tickets unter anderem verfügbaren Aktionen.
- Erhalten Sie die Ticketablaufverfolgung.
- Laden Sie Anlagen im Zusammenhang mit einem Ticket herunter.
- Suchen Sie nach Knowledge Base-Artikeln (KB) in Aranda Service Management Suite.
- Laden Sie Anlagen aus Knowledge Base-Artikeln (KB) herunter.
- Erstellen, Suchen und Aktualisieren von Konfigurationselementen (CIs).
- Es ermöglicht Organisationen, die Ticketauflösung zu beschleunigen, indem sie die Compliance auf Serviceebene verwaltet und optimiert.
- Ermöglicht die Nachverfolgung der Kommunikation zwischen Anforderern und Supportmitarbeitern.
- Bieten Sie automatisierte Antworten auf Informierer über den Status ihres Tickets.
- Erstellen, Suchen und Aktualisieren von Aufgaben, die einem Ticket zugeordnet sind.
Bekannte Probleme und Einschränkungen mit Aktionen
- Bei Verwendung der Aktion "Suchfälle " werden nur die ersten 50 Fälle im Zusammenhang mit den hinzugefügten Suchkriterien abgerufen.
- Bei Verwendung der Aktionskonfigurationselemente für die Suche werden nur die ersten 50 Konfigurationselemente im Zusammenhang mit den hinzugefügten Suchkriterien abgerufen.
- Bei Verwendung der Aktionssuche werden nur die ersten 20 Artikel im Zusammenhang mit den hinzugefügten Suchkriterien abgerufen.
- Bei Verwendung der Aktion "Suchaufgaben " werden nur die ersten 50 Aufgaben im Zusammenhang mit den hinzugefügten Suchkriterien abgerufen.
- 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")
- 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.
- 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.
- 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
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.
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.
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.
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.
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.
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.
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.
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.
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.).
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".