ALVAO

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 Bereiche:      - 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 Bereiche:      - US Government (GCC)      - US Government (GCC High)      - China Cloud betrieben von 21Vianet      - US Department of Defense (DoD)

Kontakt
Name	ALVAO Support
URL	https://www.alvao.com/en/support-and-services
Email	support@alvao.com

Connectormetadaten
Herausgeber	ALVAO
Webseite	https://www.alvao.com
Datenschutzrichtlinie	https://www.alvao.com/en/privacystatement
Kategorien	Zusammenarbeit;IT-Vorgänge

Mit diesem Connector können Sie Power Automate, Power Apps oder Azure Logic Apps verwenden, um Aktionen in Alvao zu automatisieren oder Alvao in andere Anwendungen zu integrieren. Mit dem Connector können Sie Automatisierungen starten, die nicht nur an den Workflow von Tickets im Service Desk gebunden sind, sondern auch mit dem Lebenszyklus von Ressourcen, die im Asset Management registriert sind. Connectoraktionen ermöglichen es Ihnen dann, den Ticketworkflow zu verschieben oder den Ressourcenlebenszyklus zu verwalten.

Voraussetzungen

Sie müssen ein ALVAO-Kunde (SaaS oder On-Prem) mit einer Version von ALVAO mindestens 11.1 sein und über eine REST-API im Internet verfügen.

So erhalten Sie Anmeldeinformationen

1. Erstellen Sie ein Anwendungskonto in Alvao WebAppUsers - Administration - .
2. Legen Sie mindestens den Name and Surname, User name und aktivieren Sie die Option Application account - Other applications.
3. Legen Sie ein Kennwort auf dieses Konto fest.
4. Legen Sie die entsprechenden Berechtigungen für das Konto fest, um mit Tickets oder Ressourcen zu arbeiten.
5. Verwenden Sie das User name Konto und Password das Konto, um eine Verbindung mit diesem Connector zu erstellen.

Hinweis: Sie benötigen auch die URL zu Ihrer Alvao REST-API, die Sie finden Alvao WebAppSettingsWeb services - Administration - - können.

Erste Schritte mit Ihrem Connector

Nach dem Erstellen der Verbindung können Sie verschiedene Trigger oder Aktionen verwenden.

Erteilen Sie z. B. die Berechtigung zum Lesen eines Ordners in SharePoint mithilfe eines automatisierten Flusses basierend auf der Genehmigung eines Tickets im Alvao Service Desk:

1. Verwenden Sie den When a ticket transitions to a status Trigger, und geben Sie den Namen des Prozesses und den Zustand an, in dem der Fluss ausgelöst werden soll.
2. Fügen Sie dann die Get Ticket Aktion hinzu, und geben Sie als Eingabe den Ticket ID verfügbaren aus dem Trigger ein.
3. Verwenden Sie dann beispielsweise die E-Mail-Adresse des Antragstellers, die Sie von der Aktion erhalten haben, und verwenden Sie sie, um den Benutzer in M365 zu finden und ihm entsprechende Berechtigungen zuzuweisen.

Andere Aktionen können Ihnen auch bei Automatisierungen in der Bestandsverwaltung helfen. Z. B. Aktionen zum Erstellen einer Ressource, Ändern der Werte seiner Eigenschaften oder Verschieben innerhalb der Registrierung. Wenn Sie Ressourcen regelmäßig aus einem anderen System importieren müssen, können Sie die Aktion Import objects from CSVverwenden.

Bekannte Probleme und Einschränkungen

• Alle Trigger sind nur in ALVAO 11.2 oder höher verfügbar.
• Diese Aktionen sind nur in ALVAO 11.2 oder höher verfügbar:
  • Objekt erstellen
  • Objekt abrufen
  • Abrufen von Objekten
  • Aktualisieren von Objekteigenschaften
  • Verschieben von Objekten
  • Abrufen von Benutzern
  • Importieren von Objekten aus CSV
• Einige Aktionen erfordern eine Entitäts-ID als Eingabe, die in Alvao vorhanden sein muss. Diese IDs befinden sich in der Regel im Alvao WebApp am Ende der URL auf ihren Detail- oder Bearbeitungsseiten.

Häufige Fehler und Abhilfemaßnahmen

• 403 Verboten – Überprüfen Sie, ob das verwendete Anwendungskonto über alle erforderlichen Berechtigungen zum Ausführen der Aktion verfügt. Überprüfen Sie auch die in der Verbindung verwendeten Anmeldeinformationen.
• 404 Nicht gefunden – Überprüfen Sie, ob alle Eingabeparameter korrekt sind und die REST-API-URL in der Verbindung korrekt ist. Überprüfen Sie, ob die Aktion in Ihrer Version von ALVAO verfügbar ist.

Häufig gestellte Fragen

Benutzerdefinierte Felder

Der Connector unterstützt außerdem das Lesen und Schreiben von Werten aus/in benutzerdefinierte Ticketfelder. Benutzerdefinierte Felder können nicht in der allgemeinen Connectordefinition beschrieben werden, daher müssen Sie die folgenden Techniken für die Verarbeitung verwenden.

Verwenden Sie Ausdrücke in der Get ticket Aktion, um einen Wert des benutzerdefinierten Felds eines Tickets zu lesen. Verwenden Sie z. B. den Ausdruck, um den Wert des Felds "TicketCategory" zu lesen:

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

Verwenden Sie die Update ticket Aktion mit einer benutzerdefinierten JSON-Spezifikation, um einen Wert in das benutzerdefinierte Feld eines Tickets zu schreiben. Wenn Sie z. B. den Wert "Monitorfehler" in das Feld "TicketCategory" schreiben möchten, verwenden Sie diese Spezifikation im Custom Items Feld:

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

Hinweis: Das Zeichen "@" wird aufgrund der Escapezeichen verdoppelt.

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	Schnur	Angeben der Host-URL Ihrer ALVAO REST-API	Richtig
Nutzername	Schnur	Der Benutzername für das ALVAO-Anwendungskonto	Richtig
Kennwort	securestring	Das Kennwort für das ALVAO-Anwendungskonto	Richtig

Drosselungsgrenzwerte

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

Aktionen

Abrufen von Benutzern	Gibt Benutzer und deren Eigenschaften entsprechend den OData-Parametern zurück.
Abrufen von Objekten	Gibt Objekte mit ihren Eigenschaften entsprechend den OData-Parametern zurück.
Aktualisieren von Objekteigenschaften	Aktualisiert Objekteigenschaften.
Datensatz im Ticketprotokoll erstellen	Erstellt einen Datensatz im Ticketprotokoll.
Importieren von Objekten aus CSV	Importiert Objekte, die im CSV-Format bereitgestellt werden. Ähnliche Funktionen wie das ImportUtil-Hilfsprogramm.
Objekt abrufen	Gibt ein Objekt mit seinen Eigenschaften zurück.
Objekt erstellen	Erstellt ein neues Objekt aus der angegebenen Vorlage unter dem angegebenen Objekt.
Objekt verschieben	Verschiebt ein Objekt zu einem angegebenen Ziel.
Ticket abrufen	Gibt Ticketeigenschaften zurück.
Ticket aktualisieren	Aktualisiert Ticketspalten. Legen Sie nur eigenschaften fest, die geändert werden sollen. So ändern Sie SLA-Sätze entweder slaId oder slaName. Wenn Sie den Antragsteller ändern möchten, legen Sie entweder nur die Anforderungs-ID oder alle Daten im Anforderer fest (nicht registrierter Benutzer).
Ticket erstellen	Erstellt ein neues Ticket.
Ticket in einen anderen Dienst verschieben	Verschiebt das Ticket zu einem anderen Dienst. Entweder Dienst-ID oder Dienstname ist erforderlich.
Zuweisen eines Tickets zu Solver- oder Solverteam	Weist das Ticket dem Solver- oder Solver-Team zu.
Ändern des Ticketstatus	Ändert den Ticketstatus. Sie kann auch zum Auflösen oder erneuten Öffnen des Tickets verwendet werden. Entweder "Status-ID" oder "Statusname" ist erforderlich.

Abrufen von Benutzern

Abrufen von Objekten

Aktualisieren von Objekteigenschaften

Datensatz im Ticketprotokoll erstellen

Importieren von Objekten aus CSV

Objekt abrufen

Objekt erstellen

Objekt verschieben

Ticket abrufen

Ticket aktualisieren

Ticket erstellen

Ticket in einen anderen Dienst verschieben

Zuweisen eines Tickets zu Solver- oder Solverteam

Ändern des Ticketstatus

Auslöser

Beim Erstellen eines Objekts	Dieser Vorgang wird ausgelöst, wenn ein Objekt einer bestimmten Art erstellt wird.
Wenn ein Objekt verschoben wird	Dieser Vorgang wird ausgelöst, wenn ein Objekt einer bestimmten Art an eine andere Position in der Objektstruktur verschoben wird.
Wenn ein Ticket zu einem Status wechselt	Dieser Vorgang wird ausgelöst, wenn ein Ticket zu einem bestimmten Status wechselt.
Wenn ein Ticketfeldwert geändert wird	Dieser Vorgang wird ausgelöst, wenn ein bestimmter Ticketfeldwert geändert wird.
Wenn ein Wert einer Objekteigenschaft geändert wird	Dieser Vorgang wird ausgelöst, wenn ein Wert einer bestimmten Objekteigenschaft geändert wird.

Beim Erstellen eines Objekts

Wenn ein Objekt verschoben wird

Wenn ein Ticket zu einem Status wechselt

Wenn ein Ticketfeldwert geändert wird

Wenn ein Wert einer Objekteigenschaft geändert wird

Definitionen

SD. Fahrkarte

Webhook.UpdatedTicket

BIN. Objekt

BIN. ObjectExpanded

BIN. ObjectsExpandedApiResponse

BIN. ImportCsvResponse

Common.Person

Common.UsersApiResponse

Schnur