Pour télécharger l'exemple complet de code, consultez notre site Partage de code.

Les modèles et les mises en page répondent au même objectif d'automatisation du processus de signature électronique en réduisant le temps nécessaire à l'envoi de documents comprenant plusieurs blocs de signature et champs de données. Les modèles sont idéaux pour une utilisation au niveau de la transaction; vous pouvez prédéfinir vos signataires, vos documents, les emplacements de signature et les flux de travail de signature électronique afin de rationaliser le processus de signature électronique. Une mise en page, quant à elle, est un type de modèle qui vous permet de créer des emplacements prédéfinis pour vos blocs de signature et vos champs de données dans un document. Il agit comme un « marqueur » de l'emplacement des blocs de signature et des champs de données dans le document. Les mises en page sont utiles pour les utilisateurs qui envoient fréquemment des formulaires qui peuvent être légèrement différents selon le destinataire, mais dont les blocs de signature et les champs de données restent au même endroit dans tout le document. De plus, vous pouvez utiliser plusieurs mises en page par document, et les appliquer à des pages individuelles dans votre transaction.

Trouver vos modèles dans l'interface utilisateur

Tout d'abord, localisez vos modèles dans l'interface utilisateur Web OneSpan Sign. Pour ce faire, connectez-vous à votre compte OneSpan Sign, puis cliquez sur Modèles. Après avoir exécuté votre code, tous vos modèles apparaîtront ici.

Création d'un nouveau modèle

L'exemple de code ci-dessous montre comment créer un nouveau modèle, avec un document et deux signataires.

La première étape consiste à créer votre client OneSpan Sign. Veillez à remplacer les API_KEY et API_URL par vos valeurs.

Ensuite, construisez votre paquet de documents. Une fois que votre paquet est construit, faites appel à votre TemplateService pour créer votre modèle. Le code suivant va créer un modèle :

 EslClient eslClient = new EslClient( API_KEY, API_URL );   DocumentPackage documentPackage = newPackageNamed("My template from scratch Java SDK")   .withVisibility(Visibility.ACCOUNT)   //.withVisibility(Visibility.SENDER)   .withSigner(newSignerPlaceholder(new Placeholder("PlaceholderId1")))   .withSigner(newSignerPlaceholder(new Placeholder("PlaceholderId2")))   .withDocument(newDocumentWithName("My Document")   .fromFile("YOUR_FILE_PATH")   .withSignature(signatureFor(new Placeholder("PlaceholderId1"))   .onPage(0)   .atPosition(100, 140))   .withSignature(signatureFor(new Placeholder("PlaceholderId2"))   .onPage(0)   .atPosition(100, 205)))   .build();   PackageId templateId = eslClient.getTemplateService().createTemplate(documentPackage); 

Si vous définissez la propriété Visibility à SENDER (Visibility.SENDER) , votre modèle ne sera accessible qu'à l'expéditeur du paquet. Si vous souhaitez partager votre modèle avec vos autres expéditeurs, vous devrez changer la visibilité à Visibility.ACCOUNT.

Création d'un nouveau modèle à partir d'une transaction

Vous pouvez également créer un modèle en utilisant une transaction existante comme base pour votre modèle. Pour cela, vous aurez besoin de l'packageId de votre transaction. Ensuite, vous faites appel à votre TemplateService pour créer votre modèle.

 PackageId packageId = new PackageId("d9355f04-9bb2-4219-b9fa-734f2650a939");   PackageId templateFromPackage = eslClient.getTemplateService().createTemplateFromPackage(packageId, "New Template From Package" ); 

Résultats

Après avoir exécuté votre code, vous verrez votre modèle nouvellement créé dans votre compte OneSpan Sign.

Pour télécharger l'exemple complet de code, consultez notre site Partage de code.

Les modèles et les mises en page répondent au même objectif d'automatisation du processus de signature électronique en réduisant le temps nécessaire à l'envoi de documents comprenant plusieurs blocs de signature et champs de données. Les modèles sont idéaux pour une utilisation au niveau de la transaction; vous pouvez prédéfinir vos signataires, vos documents, les emplacements de signature et les flux de travail de signature électronique afin de rationaliser le processus de signature électronique. Une mise en page, quant à elle, est un type de modèle qui vous permet de créer des emplacements prédéfinis pour vos blocs de signature et vos champs de données dans un document. Il agit comme un « marqueur » de l'emplacement des blocs de signature et des champs de données dans le document. Les mises en page sont utiles pour les utilisateurs qui envoient fréquemment des formulaires qui peuvent être légèrement différents selon le destinataire, mais dont les blocs de signature et les champs de données restent au même endroit dans tout le document. De plus, vous pouvez utiliser plusieurs mises en page par document, et les appliquer à des pages individuelles dans votre transaction.

Trouver vos modèles dans l'interface utilisateur

Tout d'abord, localisez vos modèles dans l'interface utilisateur Web OneSpan Sign. Pour ce faire, connectez-vous à votre compte OneSpan Sign, puis cliquez sur Modèles. Après avoir exécuté votre code, tous vos modèles apparaîtront ici.

Création d'un nouveau modèle

L'exemple de code ci-dessous montre comment créer un nouveau modèle, avec un document et deux signataires.

La première étape consiste à créer votre client OneSpan Sign. Veillez à remplacer les API_KEY et API_URL par vos valeurs.

Ensuite, construisez votre paquet de documents. Une fois que votre paquet est construit, faites appel à votre TemplateService pour créer votre modèle. Le code suivant va créer un modèle :

 EslClient eslClient = new EslClient(API_KEY, API_URL);   DocumentPackage documentPackage = PackageBuilder   .NewPackageNamed("My template from scratch .NET SDK")   .withVisibility(Visibility.ACCOUNT)   //.withVisibility(Visibility.SENDER)   .WithSigner(SignerBuilder.NewSignerPlaceholder(new Placeholder("PlaceholderId1")))   .WithSigner(SignerBuilder.NewSignerPlaceholder(new Placeholder("PlaceholderId2")))   .WithDocument(DocumentBuilder.NewDocumentNamed("My Document")   .FromStream(fs, DocumentType.PDF)   .WithSignature(SignatureBuilder   .SignatureFor(new Placeholder("PlaceholderId1"))   .OnPage(0)   .AtPosition(100, 140))   .WithSignature(SignatureBuilder   .SignatureFor(new Placeholder("PlaceholderId2"))   .OnPage(0)   .AtPosition(100, 205)))   .Build();   PackageId templateId = eslClient.CreateTemplate(documentPackage); 

Si vous définissez la propriété Visibility à SENDER (Visibility.SENDER) , votre modèle ne sera accessible qu'à l'expéditeur du paquet. Si vous souhaitez partager votre modèle avec vos autres expéditeurs, vous devrez changer la visibilité à Visibility.ACCOUNT.

Création d'un nouveau modèle à partir d'une transaction

Vous pouvez également créer un modèle en utilisant une transaction existante comme base pour votre modèle. Pour cela, vous aurez besoin de l'packageId de votre transaction. Ensuite, vous faites appel à votre TemplateService pour créer votre modèle.

 PackageId packageId = new PackageId("d9355f04-9bb2-4219-b9fa-734f2650a939");   PackageId templateFromPackage = eslClient.CreateTemplateFromPackage(packageId, "New Template From Package"); 

Résultats

Après avoir exécuté votre code, vous verrez votre modèle nouvellement créé dans votre compte OneSpan Sign.

Pour télécharger l'exemple complet de code, consultez notre site Partage de code.

Les modèles et les mises en page répondent au même objectif d'automatisation du processus de signature électronique en réduisant le temps nécessaire à l'envoi de documents comprenant plusieurs blocs de signature et champs de données. Les modèles sont idéaux pour une utilisation au niveau de la transaction; vous pouvez prédéfinir vos signataires, vos documents, les emplacements de signature et les flux de travail de signature électronique afin de rationaliser le processus de signature électronique. Une mise en page, quant à elle, est un type de modèle qui vous permet de créer des emplacements prédéfinis pour vos blocs de signature et vos champs de données dans un document. Il agit comme un « marqueur » de l'emplacement des blocs de signature et des champs de données dans le document. Les mises en page sont utiles pour les utilisateurs qui envoient fréquemment des formulaires qui peuvent être légèrement différents selon le destinataire, mais dont les blocs de signature et les champs de données restent au même endroit dans tout le document. De plus, vous pouvez utiliser plusieurs mises en page par document, et les appliquer à des pages individuelles dans votre transaction.

Trouver vos modèles dans l'interface utilisateur

Tout d'abord, localisez vos modèles dans l'interface utilisateur Web OneSpan Sign. Pour ce faire, connectez-vous à votre compte OneSpan Sign, puis cliquez sur Modèles. Après avoir exécuté votre code, tous vos modèles apparaîtront ici.

Création d'un nouveau modèle

L'exemple de code ci-dessous montre comment créer un nouveau modèle, avec un document et deux signataires.

L'exemple de code JSON ci-dessous peut être inclus dans votre formulaire en plusieurs parties POST pour créer un nouveau modèle. Pour obtenir plus d'informations sur les formulaires en plusieurs parties, voir Création et envoi d'une transaction.

Ces données utiles de requête JSON contiennent de nombreuses propriétés vides qui ne sont pas nécessaires pour créer un nouveau modèle. Elles sont incluses ici pour vous donner une liste d'options disponibles et pour montrer comment elles sont analysées dans le JSON.

Requête HTTP

POST /api/packages

En-têtes HTTP

Accept: application/json
Content-Type: multipart/form-data   
Authorization: Basic api_key 

Données utiles de la demande

 ------WebKitFormBoundary1bNO60n7FqP5WO4t   Content-Disposition: form-data; name="file"; filename="testDocumentExtraction.pdf"   Content-Type: application/pdf   %PDF-1.5   %µµµµ   1 0 obj   <>>>   endobj....   ------WebKitFormBoundary1bNO60n7FqP5WO4t   Content-Disposition: form-data; name="payload"   {   "name": "My template from scratch REST",   "visibility": "ACCOUNT",   "description": "",   "roles": [   {   "name": "PlaceholderId1",   "index": 0,   "id": "PlaceholderId1"   },   {   "name": "PlaceholderId2",   "index": 0,   "id": "PlaceholderId2"   }   ],   "type": "TEMPLATE",   "due": null,   "autocomplete": true,   "emailMessage": "",   "documents": [   {   "approvals": [   {   "role": "PlaceholderId1",   "fields": [   {   "page": 0,   "subtype": "FULLNAME",   "width": 200,   "binding": null,   "extract": false,   "left": 175,   "top": 165,   "validation": null,   "height": 50,   "data": null,   "type": "SIGNATURE",   "value": ""   }   ]   },   {   "role": "PlaceholderId2",   "fields": [   {   "page": 0,   "subtype": "FULLNAME",   "width": 200,   "binding": null,   "extract": false,   "extractAnchor": null,   "left": 550,   "top": 165,   "validation": null,   "height": 50,   "data": null,   "type": "SIGNATURE",   "value": ""   }   ]   }   ],   "name": "YOUR_FILE_NAME"   }   ]   }   ------WebKitFormBoundary1bNO60n7FqP5WO4t-- 

Pour une description complète de chaque champ, voir le tableau des données utiles de la demande ci-dessous.

Données utiles de la réponse

 {   "id": "9sKhW-h-qS9m6Ho3zRv3n2a-rkI="   } 

Si vous définissez la propriété Visibility à SENDER (Visibility.SENDER) , votre modèle ne sera accessible qu'à l'expéditeur du paquet. Si vous souhaitez partager votre modèle avec vos autres expéditeurs, vous devrez changer la visibilité à Visibility.ACCOUNT.

Création d'un nouveau modèle à partir d'une transaction

Vous pouvez également créer un modèle en utilisant une transaction existante comme base pour votre modèle. Pour cela, vous aurez besoin de l'packageId de votre transaction.

Requête HTTP

POST /api/packages/{packageId}/clone

En-têtes HTTP

Accept: application/json   
Content-Type: application/json   
Authorization: Basic api_key 

Données utiles de la demande

 {   "name": "your_cloned_template",   "description": "",   "emailMessage": "",   "autocomplete": true,   "settings": {   "ceremony": {   "inPerson": false   }   },   "type": "TEMPLATE",   "sender": {   "lastName": "Sender_Last_Name",   "firstName": "Sender_First_Name",   "email": "[email protected]"   },   "visibility": "ACCOUNT",   "due": null,   "language": "en"   } 

Résultats

Après avoir exécuté votre code, vous verrez votre modèle nouvellement créé dans votre compte OneSpan Sign.

Tableau des données utiles de la demande

Propriété Type Modifiable Requis Par défaut Exemples de valeurs
statut chaîne de caractères Oui Non ÉBAUCHE ÉBAUCHE / ENVOYÉ / COMPLÉTÉ / ARCHIVÉ / DÉCLINÉ / REFUSÉ / EXPIRÉ
ComplétionAuto booléen Oui Non vrai vrai / faux
type chaîne de caractères Oui Non PACKAGE PAQUET / MODÈLE / MISE EN PAGE
nom chaîne de caractères Oui Oui s.o. Exemple d'attributs de document
supprimé booléen Oui Non faux vrai / faux
visibilité chaîne de caractères Oui Non COMPTE COMPTE / EXPÉDITEUR
MessageCourriel chaîne de caractères Oui Non s.o. Veuillez signer dans les plus brefs délais.
description chaîne de caractères Oui Non s.o. Ce modèle a été créé de toutes pièces
documents
nom chaîne de caractères Oui Non s.o. exemple de document
approbations
champs
sous-type chaîne de caractères Oui Non s.o. NOM COMPLET / INITIALES / CAPTURE / CAPTURE_MOBILE / ÉTIQUETTE / CHAMP DE TEXTE / ZONE DE TEXTE / CASE / DATE / RADIO / LISTE
type chaîne de caractères Oui Non s.o. SIGNATURE / ENTRÉE
liaison chaîne de caractères Oui Non nul {approval.signed} / {signer.title} / {signer.name} / {signer.company}
extrait booléen Oui Non faux vrai / faux
hauteur entier Oui Non 50 50 / 100 / 150 ...
gauche entier Oui Non 0 50 / 100 / 150 ...
page entier Oui Non 0 0 / 1 / 2 ...
haut entier Oui Non 0 50 / 100 / 150 ...
largeur entier Oui Non 200 50 / 100 / 150 ...
rôle chaîne de caractères Oui Non s.o. Client1
rôles
id chaîne de caractères Oui Non s.o. Client1
nom chaîne de caractères Oui Non s.o. Client1
type chaîne de caractères Oui Non SIGNER SIGNATAIRE / EXPÉDITEUR
signataires
courriel chaîne de caractères Oui Oui s.o. courriel.pré[email protected]
Prénom chaîne de caractères Oui Oui s.o. John
Nom de famille chaîne de caractères Oui Oui s.o. Smith
téléphone chaîne de caractères Oui Non s.o. 514-555-8888
id chaîne de caractères Oui Non s.o. Client1
entreprise chaîne de caractères Oui Non s.o. Acme Inc.
titre chaîne de caractères Oui Non s.o. Directeur général

Pour télécharger l'exemple complet de code, consultez notre site Partage de code.

Les modèles et les mises en page répondent au même objectif d'automatisation du processus de signature électronique en réduisant le temps nécessaire à l'envoi de documents comprenant plusieurs blocs de signature et champs de données. Les modèles sont idéaux pour une utilisation au niveau de la transaction; vous pouvez prédéfinir vos signataires, vos documents, les emplacements de signature et les flux de travail de signature électronique afin de rationaliser le processus de signature électronique. Une mise en page, quant à elle, est un type de modèle qui vous permet de créer des emplacements prédéfinis pour vos blocs de signature et vos champs de données dans un document. Il agit comme un « marqueur » de l'emplacement des blocs de signature et des champs de données dans le document. Les mises en page sont utiles pour les utilisateurs qui envoient fréquemment des formulaires qui peuvent être légèrement différents selon le destinataire, mais dont les blocs de signature et les champs de données restent au même endroit dans tout le document. De plus, vous pouvez utiliser plusieurs mises en page par document, et les appliquer à des pages individuelles dans votre transaction.

Trouver vos modèles dans l'interface utilisateur

Tout d'abord, localisez vos modèles dans l'interface utilisateur Web OneSpan Sign. Pour ce faire, connectez-vous à votre compte OneSpan Sign, puis cliquez sur Modèles. Après avoir exécuté votre code, tous vos modèles apparaîtront ici.

Création d'un nouveau modèle

L'exemple de code ci-dessous montre comment créer un nouveau modèle, avec un document et deux signataires.

  ESignLiveSDK sdk = new ESignLiveSDK();   ESignLiveAPIObjects.Package_x pkg = new ESignLiveAPIObjects.Package_x();   pkg.name = 'Create Template From Scratch - ' + Datetime.now().format();   //Set as template   pkg.type = ESignLiveAPIObjects.PackageType.TEMPLATE;   //Create Template   String packageId = sdk.createPackage(pkg);   System.debug('PackageId: ' + packageId);   //Add Signer   String placeholder1Id = 'placeholder1';   ESignLiveAPIObjects.Role placeholder1 = new ESignLiveAPIObjects.Role();   placeholder1.id = placeholder1Id;   placeholder1.name = placeholderId;   sdk.helper.createRole(packageId, placeholder1);   //create role to template   //Add Document   StaticResource sr = [SELECT Id, Body FROM StaticResource WHERE Name = 'testdoc1' LIMIT 1];   Map<String,Blob> doc = new Map<String,Blob>();   doc.put('Sample Document', sr.Body);   ESignLiveAPIObjects.Document document = new ESignLiveAPIObjects.Document();   document.name = 'Sample Contract';   document.id = 'document1';   sdk.createDocuments(packageId, document, doc);   //upload document to template   //Add Signature   ESignLiveAPIObjects.Field field = new ESignLiveAPIObjects.Field();   field.left = 208;   field.width = 200;   field.height = 50;   field.top = 518;   field.page = 0;   field.subtype = 'CAPTURE';   field.type = 'SIGNATURE';   ESignLiveAPIObjects.Approval approval = new ESignLiveAPIObjects.Approval();   approval.fields = new List<ESignLiveAPIObjects.Field>{field};   approval.role = placeholder1Id;   String signatureResponse = sdk.addSignature(packageId, 'document1', approval);   //add approval and fields to template 

Création d'un nouveau modèle à partir d'une transaction

Vous pouvez également créer un modèle en utilisant une transaction existante comme base pour votre modèle. Pour cela, vous aurez besoin de l'packageId de votre transaction. Ensuite, vous faites appel à votre sdk.helper pour créer votre modèle.

  ESignLiveAPIObjects.Package_x template = new ESignLiveAPIObjects.Package_x();   template.name = 'Create Template From Package - ' + Datetime.now().format();   template.type = ESignLiveAPIObjects.PackageType.TEMPLATE;   template = sdk.helper.createPackageFromTemplate(template, packageId);   System.debug('template id: ' + template.id); 

Créez package from template et create template from package partagent la même fonction.

Résultats

Après avoir exécuté votre code, vous verrez votre modèle nouvellement créé dans votre compte OneSpan Sign.