Cette rubrique explique comment utiliser le flux d’approbation interne de votre entreprise pour valider les tickets de base de données DMS et centraliser le point d’entrée des approbations au sein de votre système d’entreprise.
et centraliser le point d’entrée des approbations au sein de votre système d’entreprise
La solution présentée dans cette rubrique s’applique uniquement aux instances en mode de collaboration sécurisée. Pour les instances configurées avec d’autres modes de contrôle, les modifications de données ne nécessitent pas d’approbation par ticket.
Contexte
Afin de garantir la sécurité de l’environnement de production et des données de votre entreprise, DMS propose un système d’approbation intégré pour les tickets. Par exemple, lorsque vous soumettez un ticket de modification de données, vous ne pouvez effectuer la modification qu’après approbation du ticket.
La plupart des entreprises utilisent leur propre système de flux d’approbation interne. Si vous soumettez des tickets de modification de données dans DMS, vous devez coordonner les workflows entre DMS et votre système interne. Cette démarche peut s’avérer fastidieuse et compliquer les audits futurs.
L’intégration de DMS à votre flux d’approbation interne améliore l’efficacité opérationnelle.
Prérequis
L’instance de base de données cible doit être en mode de collaboration sécurisée.
Ajoutez les adresses IP DMS suivantes à la liste d’autorisation (whitelist) du serveur sur lequel votre webhook est déployé :
8.136.163.64/29, 116.62.200.158.
Présentation de la solution
-
Créez un flux d’approbation dédié
Créez un nœud d’approbation et un modèle d’approbation dans DMS pour le personnel de votre entreprise.
-
Configurez les règles de sécurité
Associez le modèle d’approbation dédié aux règles de sécurité de l’instance cible. Toutes les modifications ultérieures apportées à l’instance doivent respecter ces règles.
-
Configurez les notifications d’approbation
Sélectionnez les modules fonctionnels qui doivent envoyer des notifications à votre système d’entreprise et configurez l’URL du webhook pour recevoir ces messages.
Soumettez un ticket de base de données
-
Approuvez le ticket dans votre système d’entreprise
Lorsqu’un utilisateur crée un ticket dans DMS et lance le processus d’approbation, DMS envoie un message à votre système d’entreprise via le webhook configuré.
-
Effectuez la modification de données dans DMS
Une fois le ticket approuvé par votre système d’entreprise, l’utilisateur peut procéder à la modification des données dans DMS.
Diagramme d’interaction
Étape 1 : Créer un flux d’approbation dédié
Étape 1,1 : Créer un nœud d’approbation
Connectez-vous à DMS 5.0.
-
Placez le pointeur sur l’icône
située dans le coin supérieur gauche, puis sélectionnez .RemarqueSi vous utilisez la console DMS en mode normal, sélectionnez dans la barre de navigation supérieure.
-
Dans l’onglet Approval Node, cliquez sur Add Approval Node.
RemarqueSi un nœud d’approbation pour l’approbateur cible existe déjà, ignorez cette étape.
Définissez les champs Node Name, Remarks et Approver, puis cliquez sur Submit.
Étape 1,2 : Créer un modèle d’approbation
-
Dans l’onglet Approval Template, cliquez sur Create Approval Template.
RemarqueSi un modèle d’approbation pertinent existe déjà, ignorez cette étape.
-
Définissez les champs Template Name, Remarks et Approval Node, puis cliquez sur Submit.
Les nœuds d’approbation sont configurés dans une table comprenant les colonnes Approval Order, Node Type (par exemple, Custom) et Node Name. Vous pouvez ajouter un nouveau nœud en cliquant sur Add Node ou supprimer un nœud existant en cliquant sur Remove.
Étape 2 : Configurer les règles de sécurité
-
Placez le pointeur sur l’icône
située dans le coin supérieur gauche, puis sélectionnez .RemarqueSi vous utilisez la console DMS en mode normal, sélectionnez dans la barre de navigation supérieure.
-
Localisez les règles de sécurité de l’instance cible en mode de collaboration sécurisée, puis cliquez sur Edit à côté de la règle concernée.
RemarqueDans la zone des instances de base de données située sur le côté gauche de la console DMS, cliquez avec le bouton droit sur le nom de l’instance et sélectionnez View Details pour afficher les règles de sécurité associées à l’instance.
-
Dans la liste des fonctionnalités, sélectionnez celle pour laquelle vous souhaitez définir le modèle d’approbation (comme l’exportation de données ou la demande d’autorisation), puis modifiez sa règle.
L’exemple suivant illustre la procédure de modification du modèle d’approbation pour une modification de données :
Dans le volet de navigation de gauche, cliquez sur SQL Correct.
Cliquez sur Edit à côté du modèle d’approbation par défaut pour les modifications de données.
-
Cliquez sur Switch Approval Template, sélectionnez le modèle que vous avez créé, puis cliquez sur Submit.
Dans le volet de modification du paramètre Default approval template for data changes, la zone affiche les détails des nœuds du workflow pour le modèle sélectionné, notamment Approval Order, Node Type et Node Name.
Étape 3 : Configurer les notifications d’approbation
Étape 3,1 : Activer les notifications de module
-
Placez le pointeur sur l’icône
située dans le coin supérieur gauche, puis sélectionnez .RemarqueSi vous utilisez la console DMS en mode normal, sélectionnez dans la barre de navigation supérieure.
-
Activez les notifications pour le module fonctionnel que vous souhaitez intégrer à votre flux d’approbation interne.
Dans la zone de filtre Module/Business Type, sélectionnez le module cible, tel que Ticket/Data Change. Ensuite, dans la colonne Status de la liste des notifications, activez l’interrupteur correspondant à l’élément souhaité.
Étape 3,2 : Configurer les notifications utilisateur
Dans DMS, configurez les notifications webhook pour l’approbateur cible (celui que vous avez ajouté au nœud d’approbation à l’étape 1). Lorsqu’un utilisateur lance une demande d’approbation de ticket, DMS envoie un message au webhook.
Pour savoir comment configurer les notifications webhook, consultez les rubriques Utiliser des notifications webhook personnalisées et Configurer les informations personnelles et la méthode de notification.
Étape 4 : Soumettre un ticket de base de données dans DMS
Pour plus d’informations, consultez la rubrique Présentation de la solution de données.
Étape 5 : (Facultatif) Rediriger l’approbation DMS vers un système interne
Une fois le flux d’approbation établi dans DMS ou votre système interne, appelez l’API SetWorkflowExtraInfo pour définir l’URL de votre flux d’approbation interne dans DMS. Si vous souhaitez masquer les boutons d’action d’approbation du ticket, définissez les paramètres pertinents sur false. Par exemple, pour désactiver le bouton d’acceptation, définissez le paramètre RenderAgree sur false.
Après avoir défini l’URL du flux d’approbation, cliquez sur View approval details dans la section d’approbation des tickets DMS pour ouvrir la page de votre flux d’approbation interne.
Étape 6 : Approuver les tickets DMS dans votre système d’entreprise
Étape 6,1 : Identifier la condition de déclenchement de l’événement
Lorsque le champ messageEvent.event du corps du message POST envoyé par DMS est défini sur Pending Approval, un événement d’approbation a été déclenché. Une fois cette condition identifiée, votre système d’entreprise peut lancer son flux d’approbation interne. Une fois le workflow terminé, poursuivez avec les opérations suivantes.
Étape 6,2 : Obtenir l’ID du flux d’approbation
Appelez l’API GetOrderBaseInfo pour obtenir l’ID du flux d’approbation du ticket. Pour le paramètre OrderId, utilisez la valeur du champ messageEvent.taskId issue du corps du message webhook.
Étape 6,3 : Approuver le ticket
Appelez l’API ApproveOrder pour approuver le ticket.
Étape 7 : Effectuer la modification de données dans DMS
Si le ticket est approuvé dans votre système d’entreprise avec le résultat Agreed, l’utilisateur peut poursuivre les opérations suivantes dans DMS.