Développeur de panneaux OneSpan : Outil d'envoi - Partie 2

Duo Liang, septembre 4, 2020

Afin de réduire la charge administrative et d'économiser votre temps précieux lors de la gestion d'un grand nombre d'expéditeurs sous le compte de votre organisation, OneSpan Sign propose un outil pour les expéditeurs. Cet outil automatise votre processus d'approvisionnement et de mise à jour des expéditeurs. Dans la première partie de cette série, nous avons présenté quelques précautions d'utilisation et les étapes de préparation d'un fichier CSV transmettant les données de l'expéditeur à l'outil

Reprenant là où nous nous sommes arrêtés, cette deuxième partie montre comment utiliser l'outil et résoudre les problèmes sous-jacents

Avant de commencer

L'outil de l'expéditeur est une intégration Java basée sur le service OneSpan Sign API qui s'exécute côté client. Voici une liste de contrôle pratique des éléments à vérifier avant de commencer :

Téléchargez la dernière version de l'outil à partir du partage de code de la communauté des développeurs
Soumettez un ticket d'assistance si vous gérez un grand nombre d'expéditeurs
Préparez un fichier CSV contenant toutes les informations sur l'expéditeur

Effectuez les sous-tâches détaillées dans le blog de la partie 1, et nous sommes prêts à utiliser l'outil d'envoi.

Exécution de l'outil d'envoi

L'outil d'envoi lance un assistant intuitif étape par étape. Une fois le fichier Jar exécutif lancé, la première étape consiste à sélectionner une instance OneSpan Sign et à saisir la clé API ou les informations d'identification de l'utilisateur admin. En outre, si votre machine se connecte par le biais d'une passerelle, des paramètres proxy correspondants sont également nécessaires. Ces paramètres garantissent que les appels API peuvent atteindre le serveur OneSpan Sign.

Cliquez sur le bouton "Tester la connexion", et l'instance OneSpan Sign sélectionnée sera testée avec les informations d'identification données

9-4-1

L'étape suivante est facultative. Il extrait les emails d'expéditeurs existants sous votre compte dans un fichier CSV. Vous pouvez couper et coller la colonne dans votre propre fichier CSV comme point de départ pour préparer vos données d'expéditeur.

9-4-2

Après avoir entièrement préparé le fichier CSV, passez à l'étape suivante où vous serez invité à sélectionner le fichier CSV via l'explorateur de fichiers. Dans ce guide, nous allons simplement utiliser le fichier CSV créé dans le blog précédent :

9-4-3

Pour les expéditeurs "société" et "statut", vous avez la possibilité de les spécifier en tant que colonnes CSV pour chaque expéditeur. Ici, nous définissons simplement les valeurs par défaut via l'interface utilisateur de l'outil :

9-4-4

Lors du traitement d'une invitation, une coche apparaîtra après chaque ligne d'expéditeur en temps réel dès qu'un nouvel expéditeur aura été invité avec succès

9-4-5

Examiner le rapport sur les résultats

Une fois l'outil d'envoi terminé, il génère un rapport ainsi qu'un fichier journal dans le même dossier que le fichier CSV d'entrée.

Le fichier de rapport confirme le résultat de la mise à jour de chaque utilisateur. Les opérations échouées seront marquées dans la colonne "Succès" avec leur message d'erreur.

9-4-6

Les problèmes les plus courants sont les suivants :

L'e-mail a déjà été enregistré comme expéditeur sous un autre compte
Vous avez atteint la limite d'expéditeur de votre compte

Le fichier journal enregistre tous les appels d'API sortants et leurs réponses, ce qui est utile lors du dépannage de problèmes pour lesquels le message d'erreur ne décrit pas suffisamment bien le problème

Note :

Comme le fichier journal peut contenir des informations sensibles concernant le profil de l'expéditeur, il est important de le supprimer après avoir confirmé que tous les expéditeurs ont été correctement mis à jour.

Ce guide devrait vous fournir suffisamment d'informations pour utiliser l'outil. Si vous avez rencontré des problèmes lors de l'utilisation de l'outil, vérifiez d'abord le rapport de résultats et le fichier journal. N'hésitez pas à poster un message si vous avez besoin d'une aide supplémentaire

Si vous avez des questions concernant ce blog ou toute autre chose concernant l'intégration de OneSpan Sign dans votre application, visitez les Forums communautairesdes développeurs . Vos commentaires sont importants pour nous!