Processus de Certification
Pourquoi la certification ?
Comme mentionné dans le Pourquoi développer des API ? section, l'objectif principal des API DCP est de soutenir les opérations commerciales et la croissance des concessionnaires de BRP.
Dans ce contexte, il est important que l'implémentation de l'API DCP suive l'interface et les comportements définis et que l'intégration dans le DSP soutienne les objectifs commerciaux.
La validation se fait par un processus de certification qui valide chaque intégration d'API.
Aperçu de la certification
Les activités de certification sont adaptées en fonction de la complexité et de la criticité de l'API DCP. Il existe trois catégories d'API DCP :
- Les API utilisées par le DSP pour récupérer des données, telles que le catalogue de pièces,
- Les API utilisées par le DSP pour envoyer des données au BRP, par exemple, l'inventaire des pièces du concessionnaire.
- Les API sont utilisées pour des transactions, telles que la commande de pièces.
Dans chaque catégorie, la complexité de l'API DCP peut être :
- Faible: petite quantité de données et appels API simples, tels que la spécification d'unité.
- Moyenne: Les données sont plus critiques, ou il y a de nombreux appels différents, tels que le localisateur de pièces.
- Élevée: Les données sont plus complexes/critiques, et/ou il y a de nombreux appels API différents, tels que les données des transactions de détail.
Les activités de certification pour chaque API DCP sont décrites en détail dans le Catalogue API section.
Une fois toutes les activités de certification terminées, la dernière étape de certification est la phase pilote du concessionnaire.
Phases de Certification
Phase 1 : Développement
Dans cette phase, vous commencez le développement basé sur la documentation de l'API DCP fournie sur ce portail.
Après avoir lu la documentation de l'API, une réunion de lancement peut être organisée si vous avez des questions.
Au cours de cette phase, vous pouvez utiliser des maquettes pour valider l'intégration de base de l'API DCP et, lorsque vous êtes plus avancé dans l'intégration, utiliser l'environnement de test pour effectuer des appels à l'API.
❗❗ Lors du démarrage des travaux sur une API DCP, nous devons demander l'accès en créant un ticket de certification, comme décrit dans le Activités de Certification avec JIRA section trouvée ci-dessous.
Phase 2 : Assurance Qualité
Au cours de cette phase, des activités de test, de vérification et de validation sont effectuées pour confirmer que l'API DCP est correctement intégrée dans le DSP. Les exigences du DSP spécifiées pour l'API DCP ont également été vérifiées pour répondre aux exigences commerciales. Voir la section Catalogue API pour une introduction aux exigences du DSP.
Un ensemble différent d'activités de certification est défini pour chaque catégorie d'API et combinaison de complexité. Les activités de certification sont :
- Une démonstration de la fonction dans le DSP.
- Validation des données reçues par le BRP.
- Cas de test formels.
Sauf indication contraire, ces activités sont effectuées en utilisant l'environnement de test de l'API DCP et l'environnement de test DSP.
Lors de l'exécution des tests, toutes les fonctions de l'API et du DSP, y compris les travaux DSP qui appellent automatiquement l'API, doivent être disponibles et vérifiées.
Par exemple, le API des pièces doit être appelé quotidiennement pour récupérer les modifications du catalogue des pièces. Le travail appelant le API des pièces doit être activé pendant les tests de phase 2.
Phase 3 : Pilote de concessionnaire
En utilisant quelques concessionnaires, la phase pilote de concessionnaire valide l'intégration et la fonctionnalité DSP dans l'environnement de production.
La phase pilote des concessionnaires vise à confirmer que l'intégration de l'API DCP fonctionne comme prévu dans l'environnement de production réel et avec les concessionnaires utilisant le DSP pour leurs opérations normales.
Pendant la phase pilote des concessionnaires, les principales activités consistent à démontrer la fonctionnalité du DSP et à valider les données reçues par BRP.
👉 La démonstration peut être faite en envoyant des captures d'écran ou des fichiers ou en organisant une session en direct pour démontrer la fonctionnalité de votre DSP.
Les conditions pilotes des concessionnaires varient en fonction de la portée de l'API DCP, mais elles sont normalement menées avec 1 à 5 concessionnaires pendant 1 à 3 semaines.
Lors de la réalisation de la phase pilote des concessionnaires, toutes les fonctions de l'API et du DSP, y compris les tâches DSP qui appellent automatiquement l'API, doivent être disponibles et vérifiées.
Par exemple, l'API Parts doit être appelée quotidiennement pour récupérer les modifications du catalogue de pièces. La tâche appelant l'API Parts doit être activée pendant la phase pilote des concessionnaires.
Statut de certification de l'API DCP
L'équipe DCP suit le statut de certification DSP de chaque API, qui est mis à la disposition des concessionnaires via le Centre de connaissances BOSSWeb.
Un DSP ne peut pas offrir une fonctionnalité d'API DCP aux concessionnaires tant que le processus de certification n'est pas terminé.
Activités de certification avec Jira
Pour aider à la planification et au suivi des activités de certification, DCP a mis en place un système de billetterie utilisant Jira.
Vous avez accès au Jira DCP lorsque vous êtes prêt à commencer le développement de la première API. Une réunion de lancement est organisée avec votre équipe de développement pour présenter le portail de documentation DCP et le système de tickets DSCP Jira.
👉 Le Jira DCP est également utilisé pour poser des questions, demander de l'aide et ajouter/retirer des membres de l'équipe. Référez-vous à la section Obtenir de l'aide pour plus d'informations.
Cette section décrit comment utiliser les tickets de certification pour gérer vos activités de certification.
❗❗ Il est important de créer le ticket Jira pour une certification API uniquement lorsque vous commencez à travailler sur l'API ❗❗
En d'autres termes, n'utilisez pas les tickets Jira DCP pour créer un backlog !
Flux de travail
Le flux de travail du ticket de certification est présenté dans l'image ci-dessous.
Lorsque vous êtes prêt à commencer à travailler sur une API, allez sur le portail Jira DCP et ouvrez un ticket pour l'API.
❗❗ Créez le ticket Jira uniquement lorsque vous commencez à travailler sur l'API ❗❗
L'équipe DCP active vos identifiants sur l'API dans l'environnement QA et change l'état du ticket en En développement.
Lorsque vous êtes prêt à commencer la phase d'assurance qualité (test), changez l'état du ticket en En test. Si vous avez des preuves de test à fournir, comme des captures d'écran, joignez les fichiers au ticket.
Lorsque l'équipe DCP valide les résultats des tests, l'état du ticket est changé en En préparation de pilote de concessionnaire. Pendant cette phase, vous préparez le pilote de concessionnaire avec les concessionnaires, et l'équipe DCP active vos identifiants sur l'API dans l'environnement de production.
Lorsque le pilote de concessionnaire commence, vous changez l'état du ticket en En pilote de concessionnaire. Si vous avez des preuves de test à fournir, comme des captures d'écran, joignez les fichiers au ticket.
Une fois que l'équipe DCP valide les résultats du pilote de concessionnaire, elle change l'état du ticket en Certifié pour indiquer que l'API est certifiée.
👉 Chaque fois que vous changez l'état du ticket ou entrez un commentaire, l'équipe DCP reçoit une notification.
Cela fonctionne aussi dans l'autre sens : chaque fois que l'équipe DCP change l'état du ticket ou entre dans un commentaire, votre équipe reçoit une notification.
Le portail Jira
Comment Accéder
Une fois que vous avez signé l'accord DCP, un membre de l'équipe DCP créera un groupe pour votre entreprise dans Jira, et vous et vos membres d'équipe recevrez une invitation par e-mail.
L'e-mail contient un lien pour s'inscrire au système de billetterie Jira. Une fois que vous cliquez sur le lien, vous serez dirigé vers la plateforme Jira pour créer votre compte.
✏ 👉 Ne pas désactiver la notification par e-mail ! Si vous le faites, vous ne serez pas informé lorsque le ticket sera mis à jour.
Menu Principal
Lorsque vous allez sur le portail DCP Jira, l'écran suivant apparaîtra une fois que vous vous serez connecté.
❗❗ Avant de créer un ticket, vérifiez que vous êtes dans le portail DCP Jira ❗❗
Vérifiez la section Assurez-vous d'être dans le portail DCP! ci-dessous.
Cliquez sur le menu d'Intégration API.
Intégration API
La page de Certification et de Support DCP s'affiche.
- Sélectionnez AIntégration API dans la liste Contactez-nous à propos de.
- Cliquez sur Certification d'Intégration API.
- Le formulaire de ticket de Certification d'Intégration API s'affiche.
Formulaire de Ticket de Certification d'Intégration API
Un formulaire s'affiche où vous devez entrer les détails de la demande.
Pour aider à gérer le ticket, le champ de titre doit ressembler à ceci:
Certification API - [nom de votre organisation] - [nom de l'API]
Par exemple :
Certification API - MyDMS - Informations DSP
Ensuite, sélectionnez l'API dans le Dans quelle API souhaitez-vous obtenir une certification ? liste.
Enfin, fournissez des estimations approximatives pour les dates de début et de fin afin de nous aider à suivre votre calendrier de certification et à mieux vous soutenir.
Cliquez sur Envoyer pour soumettre votre ticket.
Comment changer l'état d'un ticket de certification
Comme mentionné dans le Flux de travail section, vous devez changer l'état d'un ticket de certification à 2 étapes du flux de travail :
- Lorsque vous êtes prêt à commencer la phase d'assurance qualité (test), changez l'état du ticket en En Test. Si vous avez des preuves de test à fournir, comme des captures d'écran, joignez les fichiers au ticket.
- Lorsque le pilote de concessionnaire commence, vous changez l'état du ticket en En Pilote de Concessionnaire. Si vous avez des preuves de test à fournir, comme des captures d'écran, joignez les fichiers au ticket.
Pour changer l'état du ticket, ouvrez-le et regardez sur le côté droit du formulaire, mis en évidence en vert dans l'image ci-dessous.
Dans cet exemple, cliquez sur le Move to Dealer Pilot, et une fenêtre s'ouvrira. Vous pouvez entrer un commentaire et cliquer sur Move to Dealer Pilot.
L'équipe DCP reçoit une notification du changement d'état.
Assurez-vous d'être sur le portail DCP!
Le DCP Jira utilise Jira Service Management (JSM).
🛑 Vous avez accès à tous les projets JSM chez BRP!
Donc, avant de créer un ticket, assurez-vous d'être dans le DCP Certification and Support portail.
Lorsque vous êtes dans le portail DCP Jira, cliquez sur le Help Center lien dans le coin supérieur gauche. Vous serez redirigé vers la page principale de BRP JSM, où vous pouvez voir tous les portails!
Il sera ignoré si vous créez un ticket dans un portail autre que le DCP Certification and Support portail!
Si vous êtes sur la Help Center page principale, la manière la plus sûre de trouver le DCP Certification and Support portail est d'utiliser le champ de recherche et de chercher DCP.
Une liste de ressources d'aide est affichée.
Vous pouvez ouvrir l'un des formulaires DCP à partir du résultat de recherche ou aller au DCP Certification and Support portail.
Feuille de route de développement
À moins que vous et DCP n'ayez convenu d'une feuille de route différente, les API doivent être développées et certifiées dans l'ordre présenté ci-dessous.
DMS
Priorité | Nom de l'API |
|---|---|
1 | |
2 | |
3 | |
4 | |
5 | |
6 | |
7 | |
8 | |
9 | |
10 | |
11 | |
12 | |
13 | |
14 | |
15 | |
16 | |
17 |
GRC
Priorité | Nom de l'API |
|---|---|
1 | |
2 | |
3 | API des promotions (optionnel) |
4 | API d'unités (optionnel) |
5 | API des pièces (optionnel) |