Signe OneSpan pour les nouveaux utilisateurs: Comment créer et envoyer votre premier paquet (.NET SDK)

Michael Williams, juin 30, 2015

Jusqu’à présent, j’ai couvert des exemples simples d’utilisation de l’interface d’un signe OneSpan et Java SDK. Je vais maintenant continuer avec quelques blogs simples montrant l’utilisation de la OneSpan Sign .NET SDK. Ce blog couvrira la création et l'envoi d'un paquet de documents. Si vous n'avez pas de compte Sandbox, consultez mon premier blog pour savoir comment vous pouvez vous inscrire.

Exigences

Avant de pouvoir écrire votre code, vous devrez configurer votre environnement pour utiliser le .NET SDK.

Téléchargement du .NET SDK

Si vous n'avez pas encore téléchargé le .NET SDK, vous devrez le faire avant de pouvoir continuer avec ce guide. Le lien suivant vous mènera à une page où vous pouvez télécharger le .NET SDK et fournit également un lien vers quelques exemples d'utilisation de la .NET SDK sur GitHub. Dézifiez le SDK à l'endroit de votre choix.

Télécharger le .NET SDK

Téléchargement de Microsoft Visual Studio

Pour ce blog, je vais utiliser Microsoft Visual Studio 2013. Si vous ne l'avez pas déjà, vous pouvez télécharger la version communautaire, gratuitement, sur le lien, ci-dessous. Je vais utiliser C comme la langue avec les bibliothèques .NET. Vous pouvez utiliser n'importe quel autre environnement qui vous permettrait d'utiliser C et .NET, mais tout dans ce blog décraura en utilisant Visual Studio.

Télécharger Microsoft Visual Studio Community 2013

Créer et envoyer un paquet

Maintenant que vous avez les outils nécessaires, il est temps de commencer. 

OneSpan Sign Developer Community

OneSpan Sign Developer Community

Rejoignez la communauté OneSpan Sign Developer! Forums, blogs, documentation, téléchargements SDK, et plus encore.

Joignez-vous aujourd'hui

Créez et configurez votre projet CMD

Après l'ouverture de Visual Studio, rendez-vous sur File - Nouveau projet. J'ai choisi Windows - Projet vide à partir des modèles et nommé mon projet "CreateAndSendPackage".

 

VisualStudioCreateProject (en)

 

Sélectionnez OK. Vous verrez maintenant votre solution/projet dans l'Explorer de solution.

Ensuite, ajoutez le SDK .NET comme référence en cliquant à droite sur Références, dans votre projet, dans l'Exploration solutions. Choisissez "Ajouter la référence..." Dans le dialogue qui apparaît, choisissez "Parcourir", sélectionnez le "Parcourir..." bouton en bas, naviguer à l'endroit où vous décompressé le SDK .NET, sélectionnez les trois fichiers .dll, et choisissez Ajouter.

 

AddReference (en)

 

Enfin, cliquez à droite sur votre projet, sélectionnez Ajouter - Nouvel élément..., sélectionnez la section Code dans le fichier de code, nommez le fichier comme vous voulez (je l'ai appelé «CreateAndSendPackge.cs»), et sélectionnez Ajouter.

 

AddCodeFile (en)

 

Vous verrez maintenant ce fichier dans votre projet dans l'Explorer de solution.

Le code

Ouvrez le fichier .cs que vous venez de créer et entrez le code suivant.

en utilisant le système;
l’utilisation de System.IO;
en utilisant Silanis.ESL.SDK;
en utilisant Silanis.ESL.SDK.Builder;

namespace CreateAndSendPackage
{
    classe CreateAndSendPackage
    {
        apiUrl de chaîne statique privée -"https://sandbox.esignlive.com/api";
        USE https://apps.e-signlive.com/api POUR PRODUCTION
        apiKey de chaîne statique privée - "YOUR_API_KEY";
            
        public statique vide Main(corde[] args)
        {
            EslClient eslClient - nouveau EslClient (apiKey, apiUrl);

            FileStream fs - File.OpenRead ("PATH_TO_YOUR_PDF");

            DocumentPackage superDuperPackage - PackageBuilder
              . NewPackageNamed ("Test Package .NET")
                . WithSettings (DocumentPackageSettingsBuilder
                    . NewDocumentPackageParamètres())
                    . WithSigner (SignerBuilder
                         . NewSignerWithEmail ("[email protected]")
                                . WithFirstName ("Signer First Name")
                                . WithLastName ("Signer Nom de famille")
                                . WithCustomId ("Signer"))
                    . WithSigner (SignerBuilder
                         . NewSignerWithEmail ("[email protected]")
                                . WithFirstName ("Votre prénom")
                                . WithLastName ("Your Last Name"))
. WithDocument (DocumentBuilder.NewDocumentNamed("sampleAgreement")
                                  . FromStream(fs, DocumentType.PDF)
                                  . WithSignature (SignatureBuilder
                                       . SignaturePour ("[email protected]")
                                         . OnPage(0)
                                         . AtPosition(175, 165))
                                  . WithSignature (SignatureBuilder
                                       . SignaturePour ("[email protected]")
                                         . OnPage(0)
                                         . AtPosition(550, 165))
                                  )
                    . Build ();

            PackageId packageId - eslClient.CreatePackage(superDuperPackage);
            eslClient.SendPackage(packageId);
        }

    }
}

 

En regardant le code un peu plus près, les premières lignes définissent les bibliothèques que vous allez utiliser.

 

en utilisant le système;
l’utilisation de System.IO;
en utilisant Silanis.ESL.SDK;
en utilisant Silanis.ESL.SDK.Builder;

 

Les prochaines lignes définissent vos paramètres de connexion pour OneSpan Sign. Assurez-vous de remplacer YOUR_API_KEY par votre clé API. Vous pouvez trouver cette valeur en vous connectant à OneSpan Sign et en allant à l’onglet ACCOUNT.

 

apiUrl de chaîne statique privée -"https://sandbox.esignlive.com/api";
USE https://apps.e-signlive.com/api POUR PRODUCTION
apiKey de chaîne statique privée - "YOUR_API_KEY";

 

Pour cet exemple très simple, le reste du code se produira à l'intérieur de la méthode principale. La première chose que vous faites est de vous connecter au client OneSpan Sign en utilisant l’URL API et la clé API que vous avez définieci ci-dessus.

EslClient eslClient - nouveau EslClient (apiKey, apiUrl);

 

Dans la ligne suivante, vous créez un FileStream et lisez dans le fichier que vous voulez télécharger avec votre colis. Assurez-vous de remplacer le texte du placeholder par l'emplacement de votre fichier PDF.

 

FileStream fs - File.OpenRead ("PATH_TO_YOUR_PDF");

 

Ensuite, le paquet est créé.

 

DocumentPackage superDuperPackage - PackageBuilder
     . NewPackageNamed ("Test Package .NET")
     . WithSettings (DocumentpackageSettings.NewDocumentPackageSettings())

Ensuite, les signataires sont ajoutés au paquet.

. WithSigner(SignerBuilder.NewSignerWithEmail("[email protected]")
                      . WithFirstName ("Signer First Name")
                      . WithLastName ("Signer Nom de famille")
                      . WithCustomId ("Signer"))
          . WithSigner(SignerBuilder.NewSignerWithEmail("[email protected]")
                      . WithFirstName ("Votre prénom")
                      . WithLastName ("Your Last Name"))

Ensuite, le document est ajouté, y compris les boîtes de signature pour les signataires requis.

. WithDocument (DocumentBuilder.NewDocumentNamed("sampleAgreement")
                        . FromStream(fs, DocumentType.PDF)
                        . WithSignature (SignatureBuilder
                        . SignaturePour ("signer.email.com")
                           . OnPage(0)
                           . AtPosition(175, 165))
                       . WithSignature (SignatureBuilder
                       . SignaturePour ("your.email.com")
                           . OnPage(0)
                           . AtPosition(550, 165))
                       )

 

Avec le paquet complètement défini, vous construisez maintenant le paquet et l'envoyer.

 

. Build ();

PackageId packageId - eslClient.CreatePackage(superDuperPackage);
eslClient.SendPackage(packageId);

 

Voilà, c'est toi qui l'as. Il suffit d'exécuter ce code en sélectionnant Démarrer à partir de la barre d'outils. Après cela, vous devriez être en mesure de vous connecter à OneSpan Sign et afficher le paquet que vous venez de créer.

 

Boîte de réceptionShowingPackageCreatedWithCSharp

 

Merci pour la lecture! Si vous avez des questions ou des fonctionnalités que vous souhaitez voir couvertes du point de vue d'un nouvel utilisateur, n'hésitez pas à poster dans la section commentaires. Liens vers tous les messages de cette série de blog peut être trouvé, ci-dessous. Si vous voulez voir plus de messages de moi, voir ma page d'auteur.

Michael Williams
Twitter - France Facebook - France LinkedIn (en)

 

eSignLive pour les nouveaux utilisateurs Blog Series