ALVAO

Ce connecteur est disponible dans les produits et régions suivants :

Service	classe	Régions
Copilot Studio	Premium	Toutes les régions Power Automate , à l’exception des éléments suivants :      - Us Government (GCC)      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)
Applications logiques	Norme	Toutes les régions Logic Apps , à l’exception des suivantes :      - Régions Azure Government      - Régions Azure Chine      - Us Department of Defense (DoD)
Power Apps	Premium	Toutes les régions Power Apps , à l’exception des suivantes :      - Us Government (GCC)      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)
Power Automate	Premium	Toutes les régions Power Automate , à l’exception des éléments suivants :      - Us Government (GCC)      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)

Contact
Nom	Prise en charge d’ALVAO
URL	https://www.alvao.com/en/support-and-services
Messagerie électronique	support@alvao.com

Métadonnées du connecteur
Éditeur	ALVAO
Site internet	https://www.alvao.com
Politique de confidentialité	https://www.alvao.com/en/privacystatement
Catégories	Collaboration ;Opérations informatiques

Avec ce connecteur, vous pouvez utiliser Power Automate, Power Apps ou Azure Logic Apps pour automatiser des actions dans Alvao ou pour intégrer Alvao à d’autres applications. Le connecteur vous permet de démarrer des automatisations liées non seulement au flux de travail des tickets dans le Service Desk, mais également au cycle de vie des ressources inscrites dans la gestion des ressources. Les actions du connecteur vous permettent ensuite de déplacer le flux de travail de ticket ou de gérer le cycle de vie des ressources.

Prerequisites

Vous devez être un client ALVAO (SaaS ou local) avec une version d’ALVAO au moins 11.1 et disposer de l’API REST disponible à partir d’Internet.

Comment obtenir des informations d’identification

1. Créez un compte d’application dans Alvao WebAppUsers - Administration - .
2. Définissez au moins l’option Name and Surname, User name puis activez l’option Application account - Other applications.
3. Définissez un mot de passe sur ce compte.
4. Définissez les autorisations appropriées pour que le compte fonctionne avec des tickets ou des ressources.
5. Utilisez le compte et Password le User name compte pour créer une connexion à ce connecteur.

Remarque : Vous aurez également besoin de l’URL de votre API REST Alvao que vous trouverez dans Alvao WebAppSettings - Web servicesAdministration - - .

Bien démarrer avec votre connecteur

Après avoir créé la connexion, vous pouvez utiliser différents déclencheurs ou actions.

Par exemple, accordez l’autorisation de lire un dossier sur SharePoint à l’aide d’un flux automatisé en fonction de l’approbation d’un ticket dans le Service Desk Alvao :

1. Utilisez le When a ticket transitions to a status déclencheur et spécifiez le nom du processus et l’état dans lequel déclencher le flux.
2. Ensuite, ajoutez l’action Get Ticket et, en tant qu’entrée, entrez l’entrée Ticket ID disponible à partir du déclencheur.
3. Ensuite, utilisez par exemple l’e-mail du demandeur que vous avez obtenu à partir de l’action, puis utilisez-le pour rechercher l’utilisateur dans M365 et lui attribuer les autorisations appropriées.

D’autres actions peuvent également vous aider à utiliser des automatisations dans Asset Management. Par exemple, les actions de création d’une ressource, la modification des valeurs de ses propriétés ou son déplacement dans le Registre. Si vous devez importer régulièrement des ressources à partir d’un autre système, vous pouvez utiliser l’action Import objects from CSV.

Problèmes connus et limitations

• Tous les déclencheurs sont disponibles uniquement dans ALVAO 11.2 ou version ultérieure.
• Ces actions sont disponibles uniquement dans ALVAO 11.2 ou version ultérieure :
  • Créer un objet
  • Obtenir un objet
  • Obtenir des objets
  • Mettre à jour les propriétés d’objet
  • Déplacer des objets
  • Obtenir des utilisateurs
  • Importer des objets à partir de CSV
• Certaines actions nécessitent un ID d’entité en tant qu’entrée, qui doit exister dans Alvao. Ces ID sont généralement trouvés dans l’application WebApp Alvao à la fin de l’URL sur leurs détails ou leurs pages de modification.

Erreurs courantes et solutions

• 403 Interdit : vérifiez si le compte d’application utilisé dispose de toutes les autorisations nécessaires pour effectuer l’action. Vérifiez également les informations d’identification utilisées dans la connexion.
• 404 Introuvable : vérifiez que tous les paramètres d’entrée sont corrects et que l’URL de l’API REST est correcte dans la connexion. Vérifiez si l’action est disponible dans votre version d’ALVAO.

Questions fréquentes (FAQ)

Champs personnalisés

Le connecteur prend également en charge la lecture et l’écriture de valeurs depuis/vers des champs personnalisés de ticket. Les champs personnalisés ne peuvent pas être décrits dans la définition générale du connecteur. Vous devez donc utiliser les techniques suivantes pour les traiter.

Pour lire une valeur du champ personnalisé d’un ticket, utilisez des expressions dans l’action Get ticket . Par exemple, pour lire la valeur du champ TicketCategory, utilisez l’expression :

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

Pour écrire une valeur dans le champ personnalisé d’un ticket, utilisez l’action Update ticket avec une spécification JSON personnalisée. Par exemple, pour écrire la valeur « surveiller l’échec » dans le champ TicketCategory, utilisez cette spécification dans le Custom Items champ :

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

Remarque : le caractère « @ » est doublé en raison de l’échappement.

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Par défaut	Paramètres de création de connexion.	Toutes les régions	Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom	Type	Descriptif	Obligatoire
Host	ficelle	Spécifier l’URL de l’hôte de votre API REST ALVAO	Vrai
Nom d’utilisateur	ficelle	Nom d’utilisateur du compte d’application ALVAO	Vrai
Mot de passe	securestring	Mot de passe du compte d’application ALVAO	Vrai

Limitations

Nom	Appels	Période de renouvellement
Appels d’API par connexion	100	60 secondes

Actions

Affecter un ticket à l’équipe du solveur ou du solveur	Affecte un ticket à l’équipe solveur ou solveur.
Créer un enregistrement dans le journal des tickets	Crée un enregistrement dans le journal des tickets.
Créer un objet	Crée un objet à partir d’un modèle spécifié sous l’objet spécifié.
Créer un ticket	Crée un ticket.
Déplacer un objet	Déplace un objet vers une destination spécifiée.
Déplacer un ticket vers un autre service	Déplace le ticket vers un autre service. L’ID de service ou le nom du service est requis.
Importer des objets à partir de CSV	Importe les objets fournis au format CSV. Fonctionnalités similaires à l’utilitaire ImportUtil.
Mettre à jour le ticket	Met à jour les colonnes de ticket. Définissez uniquement les propriétés à modifier. Pour modifier le sla set slaId ou slaName. Pour modifier le demandeur, définissez l’ID du demandeur uniquement ou toutes les données du demandeur (utilisateur non inscrit).
Mettre à jour les propriétés d’objet	Met à jour les propriétés de l’objet.
Modifier l’état du ticket	Modifie l’état du ticket. Il peut également être utilisé pour résoudre ou rouvrir le ticket. L’ID d’état ou le nom d’état est requis.
Obtenir des objets	Retourne des objets avec ses propriétés en fonction des paramètres OData.
Obtenir des utilisateurs	Retourne les utilisateurs et leurs propriétés en fonction des paramètres OData.
Obtenir un objet	Renvoie l’objet avec ses propriétés.
Obtenir un ticket	Retourne les propriétés du ticket.

Affecter un ticket à l’équipe du solveur ou du solveur

Créer un enregistrement dans le journal des tickets

Créer un objet

Créer un ticket

Déplacer un objet

Déplacer un ticket vers un autre service

Importer des objets à partir de CSV

Mettre à jour le ticket

Mettre à jour les propriétés d’objet

Modifier l’état du ticket

Obtenir des objets

Obtenir des utilisateurs

Obtenir un objet

Obtenir un ticket

Déclencheurs

Lorsqu’un objet est créé	Cette opération est déclenchée lorsqu’un objet d’un certain type est créé.
Lorsqu’un objet est déplacé	Cette opération est déclenchée lorsqu’un objet d’un certain type est déplacé vers une position différente dans l’arborescence d’objets.
Lorsqu’un ticket passe à un état	Cette opération est déclenchée lorsqu’un ticket passe à un certain état.
Lorsqu’une valeur de champ de ticket est modifiée	Cette opération est déclenchée lorsqu’une certaine valeur de champ de ticket est modifiée.
Lorsqu’une valeur d’une propriété d’objet est modifiée	Cette opération est déclenchée lorsqu’une valeur d’une propriété d’objet est modifiée.

Lorsqu’un objet est créé

Lorsqu’un objet est déplacé

Lorsqu’un ticket passe à un état

Lorsqu’une valeur de champ de ticket est modifiée

Lorsqu’une valeur d’une propriété d’objet est modifiée

Définitions

SD. Billet

Webhook.UpdatedTicket

SUIS. Objet

SUIS. ObjectExpanded

SUIS. ObjectsExpandedApiResponse

SUIS. ImportCsvResponse

Common.Person

Common.UsersApiResponse

ficelle