Créer une transaction à partir d’un modèle

Pour télécharger l’exemple complet de code, consultez notre site de partage de code .

Les modèles et mises en page remplissent le même objectif : automatiser le processus de signature électronique en réduisant le temps nécessaire pour envoyer des documents incluant plusieurs blocs de signature et champs de données. Les modèles sont idéaux à utiliser au niveau de la transaction – vous pouvez prédéfinir vos signataires, documents, emplacements de signature et flux de travail de signature électronique pour simplifier le processus de signature électronique. Une mise en page, en revanche, 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 au sein d’un document. Il agit comme un « marqueur » où les blocs de signature et les champs de données se placent dans le document. Les mises en page sont utiles pour les utilisateurs qui envoient fréquemment des formulaires légèrement différents selon le destinataire, mais les blocs de signature et les champs de données restent au même endroit tout au long du document. De plus, vous pouvez utiliser plusieurs mises en page par document et les appliquer à des pages individuelles dans votre transaction.

Ce sujet explique comment créer une transaction à partir d’un modèle existant. Si vous n’avez pas encore créé de modèle, consultez la section Création d’un modèle.

Pour commencer, récupérez l’identifiant du modèle que vous souhaitez utiliser pour votre transaction. Votre identifiant de modèle peut être trouvé en naviguant dans le modèle dans l’interface utilisateur et en consultant la barre d’adresse, ou en utilisant le client OneSpan Sign.

Une fois que vous avez récupéré votre identifiant de modèle , vous pouvez créer un nouvel ID de paquet. Le code suivant le fera ainsi :

PackageId templateId = new PackageId("ncE7Lf7h9EMvqEm7FMayLvJTJ68=");

Ensuite, créez votre objet DocumentPackage avec tous les paramètres que vous souhaitez mettre à jour, comme indiqué dans le code d’exemple ci-dessous. Tout paramètre non spécifié dans l’objet DocumentPackage utilisera les paramètres du modèle. Dans cet exemple, les placeholders de signature sont remplacés par un signataire.

Enfin, utilisez le OneSpan Sign Template Service pour créer votre transaction à partir de votre modèle.

DocumentPackage newPackage = PackageBuilder.newPackageNamed(PACKAGE_NAME)
            .describedAs(PACKAGE_DESCRIPTION)
            .withEmailMessage(PACKAGE_EMAIL_MESSAGE)
            .withSigner(SignerBuilder.newSignerWithEmail(email2)
            .withFirstName(PACKAGE_SIGNER_FIRST)
            .withLastName(PACKAGE_SIGNER_LAST)
            .replacing(new Placeholder(PLACEHOLDER_ID)))
            .build();

            PackageId packageId = eslClient.getTemplateService().createPackageFromTemplate(templateId, newPackage);

Résultats

Après avoir exécuté votre code, vous verrez votre nouvelle transaction créée sur la page OneSpan Sign Drafts .

Pour télécharger l’exemple complet de code, consultez notre site de partage de code .

Les modèles et mises en page remplissent le même objectif : automatiser le processus de signature électronique en réduisant le temps nécessaire pour envoyer des documents incluant plusieurs blocs de signature et champs de données. Les modèles sont idéaux à utiliser au niveau de la transaction – vous pouvez prédéfinir vos signataires, documents, emplacements de signature et flux de travail de signature électronique pour simplifier le processus de signature électronique. Une mise en page, en revanche, 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 au sein d’un document. Il agit comme un « marqueur » où les blocs de signature et les champs de données se placent dans le document. Les mises en page sont utiles pour les utilisateurs qui envoient fréquemment des formulaires légèrement différents selon le destinataire, mais les blocs de signature et les champs de données restent au même endroit tout au long du document. De plus, vous pouvez utiliser plusieurs mises en page par document et les appliquer à des pages individuelles dans votre transaction.

Ce sujet explique comment créer une transaction à partir d’un modèle existant. Si vous n’avez pas encore créé de modèle, consultez la section Création d’un modèle.

Pour commencer, récupérez l’identifiant du modèle que vous souhaitez utiliser pour votre transaction. Votre identifiant de modèle peut être trouvé en naviguant dans le modèle dans l’interface utilisateur et en consultant la barre d’adresse, ou en utilisant le client OneSpan Sign.

Une fois que vous avez récupéré votre identifiant de modèle , vous pouvez créer un nouvel ID de paquet. Le code suivant le fera ainsi :

PackageId templateId = new PackageId("ncE7Lf7h9EMvqEm7FMayLvJTJ68=");

Ensuite, créez votre objet DocumentPackage avec tous les paramètres que vous souhaitez mettre à jour, comme indiqué dans le code d’exemple ci-dessous. Tout paramètre non spécifié dans l’objet DocumentPackage utilisera les paramètres du modèle. Dans cet exemple, les placeholders de signature sont remplacés par un signataire.

Enfin, utilisez le OneSpan Sign Template Service pour créer votre transaction à partir de votre modèle.

DocumentPackage newPackage = PackageBuilder.NewPackageNamed(PackageName)
            .DescribedAs(PACKAGE_DESCRIPTION)
            .WithEmailMessage(PACKAGE_EMAIL_MESSAGE)
            .WithSigner(SignerBuilder.NewSignerWithEmail(email2)
            .WithFirstName(PACKAGE_SIGNER_FIRST)
            .WithLastName(PACKAGE_SIGNER_LAST)
            .Replacing(new Placeholder(PLACEHOLDER_ID)))
            .Build();

            packageId = eslClient.CreatePackageFromTemplate(templateId, newPackage);

Résultats

Après avoir exécuté votre code, vous verrez votre nouvelle transaction créée sur la page OneSpan Sign Drafts .

Pour télécharger l’exemple complet de code, consultez notre site de partage de code .

Les modèles et mises en page remplissent le même objectif : automatiser le processus de signature électronique en réduisant le temps nécessaire pour envoyer des documents incluant plusieurs blocs de signature et champs de données. Les modèles sont idéaux à utiliser au niveau de la transaction – vous pouvez prédéfinir vos signataires, documents, emplacements de signature et flux de travail de signature électronique pour simplifier le processus de signature électronique. Une mise en page, en revanche, 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 au sein d’un document. Il agit comme un « marqueur » où les blocs de signature et les champs de données se placent dans le document. Les mises en page sont utiles pour les utilisateurs qui envoient fréquemment des formulaires légèrement différents selon le destinataire, mais les blocs de signature et les champs de données restent au même endroit tout au long du document. De plus, vous pouvez utiliser plusieurs mises en page par document et les appliquer à des pages individuelles dans votre transaction.

Ce sujet explique comment créer une transaction à partir d’un modèle existant. Si vous n’avez pas encore créé de modèle, consultez la section Création d’un modèle.

Pour commencer, récupérez l’identifiant du modèle que vous souhaitez utiliser pour votre transaction. Votre identifiant de modèle peut être trouvé en naviguant dans le modèle dans l’interface utilisateur et en consultant la barre d’adresse, ou en utilisant le client OneSpan Sign.

Une fois que vous avez récupéré votre identifiant de modèle , vous pouvez créer un nouvel ID de paquet. Créez votre objet DocumentPackage avec tous les paramètres que vous souhaitez mettre à jour, comme montré dans le code d’exemple ci-dessous. Tout paramètre non spécifié dans l’objet DocumentPackage utilisera les paramètres du modèle. Dans cet exemple, les placeholders de signature sont remplacés par un signataire.

ESignLiveAPIObjects.Package_x pkg = new ESignLiveAPIObjects.Package_x();

            // Set basic package info
            pkg.name = 'Create Package From Template - ' + Datetime.now().format();
            pkg.description = 'This is a package created from template.';
            pkg.emailMessage = 'This is an email message.';

            // Build actual Role in replacement of placeholder
            String placeholder1Id = 'placeholder1';
            ESignLiveAPIObjects.Role role1 = new ESignLiveAPIObjects.Role();
            ESignLiveAPIObjects.Signer signer1 = new ESignLiveAPIObjects.Signer();

            signer1.firstName = 'signer1_firstname';
            signer1.lastName = 'signer1_lastname';
            signer1.email = 'signer1@mailiantor.com';
            signer1.id = placeholder1Id;

            role1.signers = new List<ESignLiveAPIObjects.Signer>{signer1};
            role1.id = placeholder1Id;

            // Use role id to match placeholder
            pkg.roles = new List<ESignLiveAPIObjects.Role>{role1};
            pkg = sdk.helper.createPackageFromTemplate(pkg, 'E-_tmDsICwCkM2vqFuzVxF7NVQQ=');

            System.debug('Package id: ' + pkg.id);

Résultats

Après avoir exécuté votre code, vous verrez votre nouvelle transaction créée sur la page OneSpan Sign Drafts .