Guide de certification de la solution ISV

La certification des solutions ISV est un processus où les exigences techniques, fonctionnelles, de documentation et autres sont vérifiées par rapport aux normes d’application importantes. Ce processus est destiné à assurer la satisfaction du client final dans la validité technique de votre solution ajoutera donc une valeur marketing supplémentaire à votre produit. L’intensité globale et la durée de ce processus dépendent du type, de la taille, de la complexité de la solution et de nombreux autres facteurs. Ces variables sont ce qui nous empêche souvent de prévoir des estimations pour répondre à la question la plus courante: « Combien de temps faut-il pour certifier notre solution? ». En tant qu’éditeur de service Internet, vous pouvez accélérer le processus de manière significative en faisant quelques devoirs à l’avance. Il s’agit d’un article sur la meilleure façon de préparer et de soumettre un cas de certification pour éviter la plupart des pièges que nous rencontrons qui ralentissent considérablement le processus.

Enregistrement de la solution

Avant de pouvoir faire quoi que ce soit concernant votre solution, elle doit être enregistrée par Acumatica. À cette fin, veuillez nous contacter par e-mail: certification@acumatica.com et partager les informations suivantes:

Code de solution (capitales latines) – L’identification unique de la solution, suivie de la version de la solution, doit être utilisée comme nom du package de déploiement.

Remarque: La version de votre solution doit contenir deux blocs de crochets [XX.XXX.XXXX][YY. AÏ. YY]
où [XX.XXX.XXXX] (obligatoire) – construction minimale d’Acumatica que vous certifiez (par exemple 19.105.0032),
et [YY. AÏ. YY] (facultatif) - votre version interne de la solution / package. Par conséquent, nous nous attendons à ce que votre package de personnalisation soit nommé comme suit : SolutionCode[XX.XXX.XXXX][YY. AÏ. YY].zip

Initiales (majuscules latines, 2-4 lettres) – Tous les Objets Acumatica créé par votre package de personnalisation doit être nommé en commençant par les initiales de votre solution, également en majuscules. Cela comprend, sans s’y limiter :
- CPP
- BLC Extensions
- DAC
- Extensions DAC (s’il s’agit d’une extension DAC Acumatica liée, le nom doit commencer par le préfixe Usr suivi des initiales de la solution)
- Vues de données publiques
- Actions publiques
- Points de terminaison des services Web
- ScreenIDs
- Interrogations génériques
- Rapports
- ID d’objets introduits sur des écrans Acumatica personnalisés
Nom de la solution - Ligne lisible par l’homme, qui indique généralement l’ÉDITEUR / Propriétaire du produit et l’objectif de votre solution, qui sera affichée sur notre marché.
Domaine d’intérêt - Faites-nous savoir quelles sont les capacités de votre solution afin que nous puissions la catégoriser de manière appropriée. Vous pouvez vérifier si les informations sur votre solution sont correctement remplies dans la section Gestion de la solution du portail. À cette fin, vous devez vous connecter sur le portail des partenaires et confirmer que tout est correct.

Gérer les solutions ISV.

Cliquez sur Gérer les solutions ISV (1) pour ouvrir l’écran.

Section des solutions ISV avec le code de la solution et le nom de la solution.

Veuillez vérifier que le code de la solution (1), les initiales (2) et le nom de la solution (3) ont été spécifiés comme prévu. Si vous souhaitez que certains éléments soient corrigés, veuillez nous contacter.

Préparation de la soumission

Les exigences pour la soumission de contenu peuvent varier en fonction du type de solution et d’autres particularités. Vous trouverez ici une liste générale de ce que nous nous attendons à voir dans votre soumission avec quelques notes et commentaires:

Objets de solution Fichier Excel (si vous personnalisez Acumatica). Dans ce fichier, il doit déclarer tous les objets introduits, les entités référencées et les scénarios d’intégration. Pourquoi en avons-nous besoin? Eh bien, ce document sert à plusieurs fins. Tout d’abord, il nous fournit une référence nécessaire. Nous vérifions si tout ce qui est indiqué dans le document répond à nos exigences et dans quelle mesure ces déclarations sont en corrélation avec la solution réelle. De plus, il nous donne des informations qui nous permettront de prévoir quelles solutions pourraient coexister dans un cas et où se trouvent les risques potentiels (par exemple, deux solutions remplaçant la même action Acumatica). Veuillez prendre des précautions supplémentaires en remplissant cette feuille de calcul. Acumatica a partiellement automatisé ce processus et nous vous permettons maintenant de télécharger un fichier pré-rempli qui pourrait vous faire économiser plusieurs heures d’analyse du code.
Scénarios d’intégration Fichier Excel (si vous utilisez l’API Web Services). Ici, votre solution doit être documentée dans le type de demandes utilisées, les entités impliquées, le but d’une demande, etc. Les demandes d’API qui sont effectuées de manière séquentielle et interdépendante doivent être regroupées dans un scénario d’intégration. Cela nous aidera à avoir une compréhension de base de ce que fait la solution. La spécification des conditions de filtrage et du nombre de demandes nous permet de savoir à l’avance si la solution sera conforme à nos exigences d’intégration.
Preuve de certification Fichier Excel. Ce fichier doit inclure les noms et l’insigne de certification des membres de l’équipe qui ont participé au développement de la solution. Il est obligatoire que les développeurs de solutions certifiées soient eux-mêmes certifiés. Idéalement, l’aspect de l’éducation et de la certification subséquente aurait dû avoir lieu avant le développement réel. Cela garantit une efficacité accrue du processus et de la qualité de la solution en comprenant et en utilisant les meilleures pratiques décrites dans les cours. Ainsi, même si la solution est prête, le processus de certification ne sera pas déclenché tant que les développeurs n’acquerront pas les badges de certification de solution (type) nécessaires et appropriés. Les badges requis pour les solutions connectées peuvent être trouvés ici: https://acumatica.litmos.com/home/LearningPath/78762Remarque: Si vous récupérez uniquement les données d’Acumatica, les développeurs ne sont tenus de réussir que les cours I300 et I310 de ce chemin d’apprentissage. Le badge requis pour les solutions intégrées se trouve ici: https://acumatica.litmos.com/home/LearningPath/86186Remarque: Pour accéder à ces cours, les développeurs doivent avoir accès au portail partenaire. Les badges de certification déclarés dans le dossier seront vérifiés par rapport à l’état actuel de notre système interne de suivi de l’éducation.
Guide d’installation et de configuration. C’est ici que vous décrivez le processus d’installation et de configuration initiale jusqu’à ce que l’état prêt à l’emploi soit atteint. Nous attendons le format d’un guide étape par étape avec quelques captures d’écran pour une meilleure compréhension. Nous vous recommandons également d’ajouter des sections sur la désinstallation, la mise à niveau et la maintenance de votre solution. Si vous gérez des informations d’identification ou d’autres données sensibles, veuillez ajouter une section dans ce document, en clarifiant comment vous accomplissez ces choses (cryptage, stockage, etc.)
Package de personnalisation (si vous l’avez). Veuillez vous assurer que le fichier ZIP porte un nom à l’aide du schéma suivant : SOLUTIONCODE[XX.XXX.XXXX][YY. AÏ. YY] où SOLUTIONCODE est code de solution spécifié dans le Gestionnaire de solution (voir Enregistrement de la solution), XX.XXX.XXXX - la version Acumatica minimale prise en charge (par exemple 20.101.0032), YY. AÏ. YY - version ISV gratuite. Veuillez également vous assurer que tous les éléments de code sont convertis en un .DLL avant l’exportation.
Guide de l’utilisateur (si nécessaire). Si votre solution introduit /personnalise les écrans Acumatica à côté des pages wiki incluses dans le package de personnalisation, nous nous attendons à un fichier séparé, décrivant la fonctionnalité à l’utilisateur final. Il peut être compilé dans un document avec le guide d’installation et de configuration.
Code source (si vous personnalisez Acumatica). Cela ne s’appliquera que si votre personnalisation déploie des DLL personnalisées. Veuillez fournir une archive ZIP de la solution Visual Studio pour rendre la soumission plus facile et plus rapide. Si vous utilisez des DLL tierces, n’oubliez pas de joindre la liste d’entre eux en spécifiant les DLL de licence distribuées avec eux. Avant d’empaqueter la solution, assurez-vous que vous n’avez pas d’avertissements, que ce soit par Acuminator ou par les outils d’analyse de code intégrés de Visual Studio. Si vous considérez que la correction d’avertissements cause plus de problèmes que d’avantages ou ne voyez pas la solution, veuillez documenter votre explication et nous la soumettre également. S’il vous plaît demander nos conseils sur stackoverflow ou créer un cas de support. Remarque: Toutes les solutions soumises à la certification seront vérifiées par la dernière version d’Acuminator. Par conséquent, nous vous recommandons fortement d’utiliser cet outil tout au long du développement.
Test de vérification des fonctionnalités clés. Veuillez fournir des scénarios de test, où vous déclarez les étapes qui doivent être effectuées par l’utilisateur final et le comportement attendu de la solution. Si les données SalesDemo ne fournissent pas suffisamment de données, veuillez fournir l’instantané avec tous les enregistrements nécessaires à votre solution. Dans le cas où cette solution interagit avec des systèmes tiers, veuillez également fournir des informations d’identification pour un bac à sable. Alternativement, nous pouvons organiser une réunion et par partage d’écran, nous vous demanderons d’effectuer les actions qui vérifieront la fonctionnalité de la solution.

Ceux-ci incluent un ensemble d’éléments que nous nous attendons à trouver dans votre soumission de certification de solution, bien que dans certaines circonstances, nous puissions demander plus d’informations si nécessaire.

Une fois tout cela terminé, vous serez prêt à soumettre le cas. Ici, vous pouvez gagner beaucoup de temps et une partie du va-et-vient en effectuant un auto-test. Voici le processus que nous préférons:

Déployer une toute nouvelle instance d’Acumatica
Importer votre projet de personnalisation
Presse Validations dans l’écran Projets de personnalisation et choisissez Valider le projet mis en évidence
Cliquez sur votre projet pour accéder à sa liste d’éléments
Cliquez sur Fichier -> Valider le préfixe de projet
Dans la fenêtre contextuelle suivante, entrez les initiales attribuées à votre solution dans Solution Manager (voir Enregistrement de la solution) et appuyez sur le bouton Enregistrer au bas de la fenêtre.
Cliquez sur le bouton activé Valider les éléments du projet

Si toutes les validations n’ont produit aucun avertissement ou exception, vous pouvez aller de l’avant et créer un nouveau cas de certification. Si certains problèmes sont apparus lors de l’auto-test, veuillez les corriger avant de les soumettre.

Créer votre dossier de certification

Dès que vous avez préparé tous les éléments nécessaires décrits ci-dessus, vous pouvez enfin créer votre dossier de certification. Connectez-vous au portail des partenaires et accédez à Programme de partenariat Gérer les solutions ISV de la même manière que nous l’avons décrite précédemment.
Inscription. Choisissez dans la liste la solution que vous souhaitez être certifié.
Changement à l' Onglet Solution/Référentiel (1) et cliquez sur Solution de téléchargement (2)
Dans la fenêtre contextuelle Solution de téléchargement , spécifiez Acumatica Build Version (1) et votre version ISV interne (2). Ceci n’est pas maintenu par Acumatica et n’est nécessaire que pour votre référence.
Cliquez sur le bouton Projet de personnalisation (3) et choisissez le package de personnalisation. De la même manière, vous pouvez joindre la documentation (4), la personnalisation du portail ou l’application 3ème partie.
Cliquez sur le bouton Télécharger (5) après avoir rempli tous les champs requis et vérifiez que le téléchargement s’est terminé avec succès et la solution avec les versions spécifiques apparaissant dans la liste.
Maintenant, sélectionnez cette ligne et cliquez sur le bouton Créer un cas de certification dans le Solution/Référentiel onglet. Dans la fenêtre contextuelle suivante, sélectionnez le Contrat. Si vous avez plus d’un contrat disponible dans le sélecteur, veuillez choisir celui avec le Abonnement ADN du partenaire ISV dans la description. Après avoir choisi le contrat et cliqué sur OK, vous seriez redirigé sur le nouveau Détails du cas fenêtre.

Remarque: Pour plus de correspondance sur le cas avec l’équipe technique d’Acumatica, veuillez utiliser le bouton Ajouter un commentaire dans le cas ou répondre à tous la fonction de votre agent de messagerie sur l’e-mail entrant de votre TAM avec l’identifiant de cas dans le sujet. Veuillez vous assurer que la ligne d’objet reste inchangée et que la liste des destinataires contient l’e-mail de votre gestionnaire de compte technique ainsi que support@acumatica.com. Pour télécharger explicitement des paquets retravaillés, veuillez utiliser le bouton Ajouter un commentaire et joindre le package dans la section Fichiers.

Voici une liste de contrôle minimaliste de ce que nous nous attendons à voir dans la soumission:

Documentation :

√ fichier Excel de Solution Objects (si vous personnalisez Acumatica)
√ fichier Excel des scénarios d’intégration (si vous utilisez l’API des services Web)
√ fichier Excel de preuve de certification.
√ Guide d’installation et de configuration.
√ Guide de l’utilisateur (si nécessaire)

Personnalisation :

√ package de personnalisation (si vous l’avez).
√ Code source (si le package de personnalisation inclut des DLL de solution).
√ données de démonstration pour les tests (si nécessaire)

Nous espérons qu’en utilisant cette approche manuelle et décrite, la certification de votre solution sera fluide et prendra le moins de temps possible.

Toute question relative à cet article ou au processus de certification global, n’hésitez pas à nous contacter sur certification@acumatica.com. Nous serons plus qu’heureux de vous aider.

*Remarque: Cet article n’est pas destiné à remplacer / réinterpréter les directives officielles de certification du logiciel Acumatica ISV disponibles ici.