Développeur OneSpan Sign : Mise à niveau dans le SDK .NET

Duo Liang, juillet 29, 2020

OneSpan Sign Developer: Upgrade in .NET SDK

OneSpan Sign offre des API simples et flexibles basées sur REST que votre application intégrée peut utiliser. De plus, nos kits de développement logiciel (SDK), qui bénéficient d'une prise en charge complète, comprennent des fonctionnalités API préétablies, ce qui facilite encore l'ajout de fonctionnalités de signature électronique à votre plateforme. Si vous développez avec une plateforme .NET, il est absolument recommandé de commencer avec notre SDK .NET pour réduire la complexité de l'intégration.

À partir de la version 11.33, nous sommes ravis de fournir un SDK .NET mis à niveau et compatible avec .NET Core et .NET framework. Dans ce blog, nous allons présenter les principales caractéristiques de cette mise à niveau et passer en revue les détails techniques. C'est parti !

Caractéristiques principales de OneSpan Sign Version 11.33

.NET Standard 2.0

La norme .NET est une spécification commune des API .NET qui peuvent être mises en œuvre par diverses implémentations .NET - .NET framework, .NET core, etc. L'une des améliorations étonnantes de cette mise à niveau est que nous prenons désormais en charge toutes les implémentations conformes à la norme .NET 2.0

7-29-1

Note

Utilisez le tableau ci-dessus pour déterminer si votre projet répond à la norme .NET 2.0 (référence : Microsoft Official Guide).
Pour les projets .NET framework, la configuration minimale requise du SDK est la version 4.5
Pour identifier le cadre .NET installé sur votre système, suivez les instructions trouvées sur le site de documentation de Microsoft.

Support multi-plateforme

Le SDK prenant en charge un plus grand nombre d'implémentations .NET, il est possible de faire en sorte que votre code .NET s'exécute sur différents appareils et systèmes, tels que Windows, macOS, Linux et même les plateformes mobiles. Cela renforce considérablement votre pouvoir d'intégration.

SDK relooké

Outre les nombreuses améliorations fonctionnelles, nous avons également donné une nouvelle image à notre SDK, notamment aux noms des espaces de nommage et des classes, afin d'offrir aux intégrateurs une expérience de développement plus cohérente et plus professionnelle. Ces changements peuvent affecter vos projets existants

Téléchargez la dernière version du SDK

Le SDK .NET est à nouveau hébergé sur NuGet. Consultez la page des paquets sur la galerie NuGet, où vous trouverez toutes les versions historiques du SDK depuis la version 11.33.
Si vous utilisez NuGet pour gérer les dépendances du projet, utilisez la commande ci-dessous dans la console Package Manager pour installer la dernière version du SDK .NET :

Installer-Package OneSpanSign.Sdk -Version 11.35.0

Remarque: Pour les autres options d'installation via les outils clients NuGet, vous trouverez toutes les commandes disponibles à partir du lien du paquet NuGet ci-dessus.

Si vous préférez gérer les références en important des fichiers .dll, vous pouvez cliquer sur le lien "Download Package" de la galerie NuGet. Ceci va télécharger un paquet NuGet (.nupkg). En décompressant ce paquet et en explorant le chemin "/lib/net45" ou "/lib/netstandard2.0", vous y trouverez le fichier .dll compilé.

Si vous êtes intéressé par le code source du SDK, nous avons également créé un nouveau dépôt Github

L'exemple de code

L'intégration avec le kit SDK .NET mis à niveau est aussi simple que l'expérience précédente. Si vous n'êtes pas familier avec notre SDK .NET, ou si c'est la première fois que vous créez un paquet de manière programmatique, l'extrait de code ci-dessous montre comment procéder.

using OneSpanSign.Sdk ; using OneSpanSign.Sdk.Builder ; using System ; using System.Diagnostics ; namespace ConsoleApp { class Program { private static string apiUrl = "https://sandbox.esignlive.com/api" ; private static string apiKey = "{votre_key_api}" ; static void Main(string[] args) { OssClient ossClient = new OssClient(apiKey, apiUrl) ; DocumentPackage newPackage = PackageBuilder.NewPackageNamed("Example Package created from new .NET SDK") .DescribedAs("It's a test package") .WithEmailMessage("Please sign ASAP !")
                .WithSigner(SignerBuilder.NewSignerWithEmail("[email protected]") .WithFirstName("John") .WithLastName("Smith")) .WithDocument(DocumentBuilder.NewDocumentNamed("Document1") .FromFile("{your_file_path}") .WithSignature(SignatureBuilder.SignatureFor("[email protected]") .OnPage(0).AtPosition(100,100).WithSize(150,50))) .WithStatus(DocumentPackageStatus.SENT) .Build() ; var packageId = ossClient.CreatePackageOneStep(newPackage) ; Debug.WriteLine("packageId : {0}", packageId) ; } } }

Migrer à partir du SDK précédent

Si votre projet a déjà été intégré à un SDK .NET antérieur à la version 11.33 et que votre équipe décide de mettre à niveau le SDK, l'une des principales préoccupations est que vous devez modifier les noms des espaces de noms et des classes dans votre code. C'est essentiel pour s'assurer que votre code se compile avec le dernier paquet SDK

Pour migrer de "esl.sdk.net" vers "oss.sdk.net" voir les changements ci-dessous :

L'espace de nom a changé de "Silanis.ESL.SDK" à "OneSpanSign.Sdk".
L'espace de nom a changé de "Silanis.ESL.API" à "OneSpanSign.API".
La classe a été renommée de "EslClient" en "OssClient".
La classe a été renommée de "EslException" en "OssException".
La classe a été renommée de "EslServerException" en "OssServerException".
La classe a été renommée de "EslEnumeration" en "OssEnumeration".

Si vous rencontrez un problème d'intégration avec le dernier SDK .NET ou de mise à niveau de votre projet existant, ou si vous avez d'autres questions concernant l'intégration de OneSpan Sign dans votre application, n'hésitez pas à poster votre problème sur nos forums de la communauté des développeurs. Vos commentaires sont importants pour nous !