Pour télécharger l'exemple complet de code, consultez notre site Partage de code. Le PDF utilisé dans cette rubrique se trouve ici. Vous pouvez également voir cette fonctionnalité dans notre démonstration interactive.

À cette fin, gardez à l'esprit que :

  • L'URL du service de notifications Push est la suivante :

    http://{SERVER_NAME:PORT}/PostEvent.svc/PostESLEvent

    Ici, {SERVER_NAME:PORT} est un espace réservé pour le nom du serveur et le numéro de port.

  • Le service peut être hébergé sur le port de votre choix.
  • Le nom et le port du serveur doivent être accessibles depuis Internet.
  • Vous pouvez ouvrir votre pare-feu exclusivement à l'adresse IP de OneSpan Sign. Si c'est le cas, vous pouvez obtenir cette adresse IP à partir de notre équipe de soutien.
  • Cette URL doit être utilisée dans Compte OneSpan Sign > URL de rappel dans la configuration du connecteur.
  • PostESLEvent est la méthode du service qui reçoit HTTP POST des demandes avec des données utiles JSON comme données d'événement.

Cette rubrique décrit comment intégrer des champs de texte dans un document, mais la même procédure peut être utilisée pour intégrer tout type de champ non lié. Pour obtenir plus d'informations sur les types de champs non liés disponibles, consultez Champs de construction de formulaire.

Si vous avez besoin d'une comparaison avec la procédure de création d'objets de base, ou si c'est la première fois que vous créez une transaction, consultez la rubrique Création et envoi d'une transaction.

L'exemple de code ci-dessous vous montre comment modifier le bloc de document pour intégrer des champs de texte. La méthode withName() est utilisée pour saisir le nom du champ du formulaire PDF dans lequel vous souhaitez intégrer du texte, tel qu'il est nommé dans votre formulaire PDF. La méthode withValue() est utilisée comme le texte que vous souhaitez estampiller sur votre document.

 .withDocument(DocumentBuilder.newDocumentWithName("Sample Contract")   .enableExtraction()   .fromStream(fs, DocumentType.PDF)   .withInjectedField(FieldBuilder.textField()   .withName("Text1")   .withValue("200 E MAIN ST, PHOENIX AZ, 85123 USA"))   .withInjectedField(FieldBuilder.textField()   .withName("Text2")   .withValue("Lawn mower"))   .withInjectedField(FieldBuilder.textField()   .withName("Text3")   .withValue("Fertilizer"))   .withInjectedField(FieldBuilder.textField()   .withName("Text4")   .withValue("100"))   .withInjectedField(FieldBuilder.textField()   .withName("Text5")   .withValue("12 12 12"))) 

Résultats

Une fois que vous aurez exécuté votre code, vos champs de texte apparaîtront dans les documents de votre transaction.

Pour télécharger l'exemple complet de code, consultez notre site Partage de code. Le PDF utilisé dans cette rubrique se trouve ici. Vous pouvez également voir cette fonctionnalité dans notre démonstration interactive.

À cette fin, gardez à l'esprit que :

  • L'URL du service de notifications Push est la suivante :

    http://{SERVER_NAME:PORT}/PostEvent.svc/PostESLEvent

    Ici, {SERVER_NAME:PORT} est un espace réservé pour le nom du serveur et le numéro de port.

  • Le service peut être hébergé sur le port de votre choix.
  • Le nom et le port du serveur doivent être accessibles depuis Internet.
  • Vous pouvez ouvrir votre pare-feu exclusivement à l'adresse IP de OneSpan Sign. Si c'est le cas, vous pouvez obtenir cette adresse IP à partir de notre équipe de soutien.
  • Cette URL doit être utilisée dans Compte OneSpan Sign > URL de rappel dans la configuration du connecteur.
  • PostESLEvent est la méthode du service qui reçoit HTTP POST des demandes avec des données utiles JSON comme données d'événement.

Cette rubrique décrit comment intégrer des champs de texte dans un document, mais la même procédure peut être utilisée pour intégrer tout type de champ non lié. Pour obtenir plus d'informations sur les types de champs non liés disponibles, consultez Champs de construction de formulaire.

Si vous avez besoin d'une comparaison avec la procédure de création d'objets de base, ou si c'est la première fois que vous créez une transaction, consultez la rubrique Création et envoi d'une transaction.

L'exemple de code ci-dessous vous montre comment modifier le bloc de document pour intégrer des champs de texte. La méthode withName() est utilisée pour saisir le nom du champ du formulaire PDF dans lequel vous souhaitez intégrer du texte, tel qu'il est nommé dans votre formulaire PDF. La méthode withValue() est utilisée comme le texte que vous souhaitez estampiller sur votre document.

 .WithDocument(DocumentBuilder.NewDocumentNamed("sample contract")   .EnableExtraction()   .FromStream(fs, DocumentType.PDF)   .WithInjectedField(FieldBuilder.TextField()   .WithId("Text1")   .WithName("Text1")   .WithValue("200 E MAIN ST, PHOENIX AZ, 85123 USA"))   .WithInjectedField(FieldBuilder.TextField()   .WithId("Text2")   .WithName("Text2")   .WithValue("Lawn mower"))   .WithInjectedField(FieldBuilder.TextField()   .WithId("Text3")   .WithName("Text3")   .WithValue("Fertilizer"))   .WithInjectedField(FieldBuilder.TextField()   .WithId("Text4")   .WithName("Text4")   .WithValue("100"))   .WithInjectedField(FieldBuilder.TextField()   .WithId("Text5")   .WithName("Text5")   .WithValue("12 12 12")) 

Résultats

Une fois que vous aurez exécuté votre code, vos champs de texte apparaîtront dans les documents de votre transaction.

Pour télécharger l'exemple complet de code, consultez notre site Partage de code. Le PDF utilisé dans cette rubrique se trouve ici. Vous pouvez également voir cette fonctionnalité dans notre démonstration interactive.

À cette fin, gardez à l'esprit que :

  • L'URL du service de notifications Push est la suivante :

    http://{SERVER_NAME:PORT}/PostEvent.svc/PostESLEvent

    Ici, {SERVER_NAME:PORT} est un espace réservé pour le nom du serveur et le numéro de port.

  • Le service peut être hébergé sur le port de votre choix.
  • Le nom et le port du serveur doivent être accessibles depuis Internet.
  • Vous pouvez ouvrir votre pare-feu exclusivement à l'adresse IP de OneSpan Sign. Si c'est le cas, vous pouvez obtenir cette adresse IP à partir de notre équipe de soutien.
  • Cette URL doit être utilisée dans Compte OneSpan Sign > URL de rappel dans la configuration du connecteur.
  • PostESLEvent est la méthode du service qui reçoit HTTP POST des demandes avec des données utiles JSON comme données d'événement.

Cette rubrique décrit comment intégrer des champs de texte dans un document, mais la même procédure peut être utilisée pour intégrer tout type de champ non lié. Pour obtenir plus d'informations sur les types de champs non liés disponibles, consultez Champs de construction de formulaire.

Si vous avez besoin d'une comparaison avec la procédure de création d'objets de base, ou si c'est la première fois que vous créez une transaction, consultez la rubrique Création et envoi d'une transaction.

L'exemple de code ci-dessous vous montre comment modifier le bloc de document pour intégrer des champs de texte. La méthode withName() est utilisée pour saisir le nom du champ du formulaire PDF dans lequel vous souhaitez intégrer du texte, tel qu'il est nommé dans votre formulaire PDF. La méthode withValue() est utilisée comme le texte que vous souhaitez estampiller sur votre document.

L'exemple JSON ci-dessous vous montre comment modifier l'objet document pour injecter des champs de texte. Dans l'objet Champs, l'attribut Nom est le nom du champ du formulaire PDF dans lequel vous souhaitez injecter du texte. L'attribut valeur est l'endroit où vous saisissez le texte que vous voulez injecter dans votre document .

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"   {   "documents": [   {   "fields": [   {   "value": "200 E MAIN ST, PHOENIX AZ, 85123 USA",   "name": "Text1"   },   {   "value": "Lawn mower",   "name": "Text2"   },   {   "value": "Fertilizer",   "name": "Text3"   },   {   "value": "100",   "name": "Text4"   },   {   "value": "12 12 12",   "name": "Text5"   }   ],   "extract": true,   "name": "Sample Contract"   }   ],   "type": "PACKAGE",   "status": "DRAFT",   "roles": [   {   "id": "client",   "index": 0,   "type": "SIGNER",   "signers": [   {   "email": "[email protected]",   "firstName": "John",   "lastName": "Smith",   "id": "client"   }   ],   "name": "client"   },   {   "id": "contractor",   "index": 1,   "type": "SENDER",   "signers": [   {   "email": "[email protected]",   "firstName": "Haris",   "lastName": "Haidary",   "id": "contractor"   }   ],   "name": "contractor"   }   ],   "name": "Field Injection Example"   }   ------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="   } 

Résultats

Une fois que vous aurez exécuté votre code, vos champs de texte apparaîtront dans les documents de votre transaction.

Tableau des données utiles de la demande

PropriétéTypeModifiableRequisPar défautExemples de valeurs
statutchaîne de caractèresOuiNonÉBAUCHEÉBAUCHE / ENVOYÉ / TERMINÉ / ARCHIVÉ / REFUSÉ / DÉSINCRIPTION / EXPIRÉ
typechaîne de caractèresOuiNonPAQUETPAQUET / MODÈLE / MISE EN PAGE
nomchaîne de caractèresOuiOuis.o.Exemple d'injection de champ
documents
nomchaîne de caractèresOuiNons.o.Exemple de contrat
extraitbooléenOuiNonfauxfaux / vrai
champs
valeurchaîne de caractèresOuiNons.o.200 E MAIN ST, PHOENIX AZ, 85123 USA
nomchaîne de caractèresOuiNons.o.Texte1
rôles
idchaîne de caractèresOuiNons.o.Client1
nomchaîne de caractèresOuiNons.o.Client1
typechaîne de caractèresOuiNonSIGNATAIRESIGNATAIRE / EXPÉDITEUR
signataires
courrielchaîne de caractèresOuiOuis.o.courriel.pré[email protected]
Prénomchaîne de caractèresOuiOuis.o.John
Nom de famillechaîne de caractèresOuiOuis.o.Smith
téléphonechaîne de caractèresOuiNons.o.514-555-8888
idchaîne de caractèresOuiNons.o.Client1
entreprisechaîne de caractèresOuiNons.o.Acme Inc.
titrechaîne de caractèresOuiNons.o.Directeur général

Pour télécharger l'exemple complet de code, consultez notre site Partage de code. Le PDF utilisé dans cette rubrique se trouve ici. Vous pouvez également voir cette fonctionnalité dans notre démonstration interactive.

À cette fin, gardez à l'esprit que :

  • L'URL du service de notifications Push est la suivante :

    http://{SERVER_NAME:PORT}/PostEvent.svc/PostESLEvent

    Ici, {SERVER_NAME:PORT} est un espace réservé pour le nom du serveur et le numéro de port.

  • Le service peut être hébergé sur le port de votre choix.
  • Le nom et le port du serveur doivent être accessibles depuis Internet.
  • Vous pouvez ouvrir votre pare-feu exclusivement à l'adresse IP de OneSpan Sign. Si c'est le cas, vous pouvez obtenir cette adresse IP à partir de notre équipe de soutien.
  • Cette URL doit être utilisée dans Compte OneSpan Sign > URL de rappel dans la configuration du connecteur.
  • PostESLEvent est la méthode du service qui reçoit HTTP POST des demandes avec des données utiles JSON comme données d'événement.

Cette rubrique décrit comment intégrer des champs de texte dans un document, mais la même procédure peut être utilisée pour intégrer tout type de champ non lié. Pour obtenir plus d'informations sur les types de champs non liés disponibles, consultez Champs de construction de formulaire.

Si vous avez besoin d'une comparaison avec la procédure de création d'objets de base, ou si c'est la première fois que vous créez une transaction, consultez la rubrique Création et envoi d'une transaction.

L'exemple de code ci-dessous vous montre comment construire l'objet Document pour injecter des champs de texte. L'attribut Nom du champ permet de saisir le nom du champ du formulaire PDF auquel vous souhaitez injecter du texte. L'attribut de valeur du champ est le texte que vous souhaitez apposer sur votre document.

  String documentId = 'document1';   StaticResource sr = [SELECT Id, Body FROM StaticResource WHERE Name = 'test_field_injection' LIMIT 1];   Map<String,Blob> doc = new Map<String,Blob>();   doc.put(documentId, sr.Body);   ESignLiveAPIObjects.Document document = new ESignLiveAPIObjects.Document();   document.name = documentId;   document.id = documentId;   document.extract = true;   //set field injection   ESignLiveAPIObjects.Field field1 = new ESignLiveAPIObjects.Field();   field1.name = 'Text1';   field1.value = '200 E MAIN ST, PHOENIX AZ, 85123 USA';   ESignLiveAPIObjects.Field field2 = new ESignLiveAPIObjects.Field();   field2.name = 'Text2';   field2.value = 'Lawn mower';   ESignLiveAPIObjects.Field field3 = new ESignLiveAPIObjects.Field();   field3.name = 'Text3';   field3.value = 'Fertilizer';   ESignLiveAPIObjects.Field field4 = new ESignLiveAPIObjects.Field();   field4.name = 'Text4';   field4.value = '100';   ESignLiveAPIObjects.Field field5 = new ESignLiveAPIObjects.Field();   field5.name = 'Text5';   field5.value = '12 12 12';   document.fields = new List<ESignLiveAPIObjects.Field>{field1,field2,field3,field4,field5};   sdk.createDocuments(packageId, document, doc); 

Résultats

Une fois que vous aurez exécuté votre code, vos champs de texte apparaîtront dans les documents de votre transaction.