Configuration des fuseaux horaires

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

Les transactions peuvent être configurées pour s’afficher dans un fuseau horaire spécifique. Cela signifie que les composantes temporelles visibles, comme les champs d’horodatage et de date de signature, seront formatées et affichées selon le fuseau horaire spécifié. Cela peut se faire aux niveaux suivants :

• Par compte

• Par fuseau horaire de l’expéditeur

• Par fuseau horaire du forfait

Pour une liste des fuseaux horaires de format long pris en charge, veuillez télécharger cette pièce jointe :

Spécifier les fuseaux horaires par compte

Spécifier le fuseau horaire au niveau du compte modifie le fuseau horaire par défaut pour tout nouvel expéditeur du compte vers le fuseau horaire nouvellement spécifié. Vous pouvez configurer cela en contactant notre équipe de support.

Spécification des fuseaux horaires par expéditeur

Spécifier un fuseau horaire au niveau de l’émetteur est utile lorsque plusieurs expéditeurs sont dans différents fuseaux horaires. Une fois cela fait, toute nouvelle transaction créée par votre expéditeur héritera de la configuration horaire que vous avez configurée pour eux.

Le code suivant le fera ainsi :

SenderInfo updatedSender = 
SenderInfoBuilder.newSenderInfo("xx@example.com")
.withTimezoneId("America/Toronto").build();

eslClient.getAccountService().updateSender(updatedSender,"sender_id");

Spécifier les fuseaux horaires par forfait

Les transactions sont généralement par défaut selon le fuseau horaire de l’expéditeur qui crée la transaction. Cependant, vous pouvez contourner cela en fixant un fuseau horaire spécifique pour la transaction.

Vous pouvez aussi créer un modèle avec un fuseau horaire spécifique. Toute transaction créée à partir de ce modèle héritera alors de ce fuseau horaire.

Lors de la création d’une transaction, vous pouvez définir un identifiant de fuseau horaire en appelant la fonction WithTimezoneId() via l’objet PackageBuilder . Le code suivant vous montre comment créer une transaction avec le fuseau horaire EST, tout en ajoutant une signature et un champ de date.

DocumentPackage pkg = PackageBuilder.newPackageNamed("Test Time Zone")
        .withSigner(SignerBuilder.newSignerWithEmail("signer1@example.com" )
                .withFirstName("signer1 firstname")
                .withLastName("signer1 lastname")
                )
        .withDocument(DocumentBuilder.newDocumentWithName("document 1")
        		.fromFile("file_path")
        		.withSignature(SignatureBuilder.signatureFor("signer1@example.com")
        				.onPage(0)
        				.atPosition(100, 300)
.withSize(200, 75))
                )
        .withTimezoneId("America/Toronto")
        .build();
 
PackageId packageId = eslClient.createPackageOneStep(pkg);
eslClient.sendPackage(packageId);

Résultats

Voici un exemple de ce à quoi vous pouvez vous attendre une fois votre code exécuté.

Voici les formats de date utilisés pour les champs de signature :

{
 "signatureFormat": "e-Signed by $signer_name; \n on $date;",
 "signatureDateFormat":"yyyy-MM-dd HH:mm:ss z"
} 

Et pour le champ de date :

{
 "aws.document.autofield.date.format" : "yyyy-MM-dd HH:mm:ss z"
}

Vous pouvez faire mettre à jour ces formats selon vos besoins en contactant notre équipe de support.

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

Les transactions peuvent être configurées pour s’afficher dans un fuseau horaire spécifique. Cela signifie que les composantes temporelles visibles, comme les champs d’horodatage et de date de signature, seront formatées et affichées selon le fuseau horaire spécifié. Cela peut se faire aux niveaux suivants :

• Par compte

• Par fuseau horaire de l’expéditeur

• Par fuseau horaire du forfait

Pour une liste des fuseaux horaires de format long pris en charge, veuillez télécharger cette pièce jointe :

Spécifier les fuseaux horaires par compte

Spécifier le fuseau horaire au niveau du compte modifie le fuseau horaire par défaut pour tout nouvel expéditeur du compte vers le fuseau horaire nouvellement spécifié. Vous pouvez configurer cela en contactant notre équipe de support.

Spécification des fuseaux horaires par expéditeur

Spécifier un fuseau horaire au niveau de l’émetteur est utile lorsque plusieurs expéditeurs sont dans différents fuseaux horaires. Une fois cela fait, toute nouvelle transaction créée par votre expéditeur héritera de la configuration horaire que vous avez configurée pour eux.

Le code suivant le fera ainsi :

            //update existing sender's time zone
            SenderInfo updatedSender = SenderInfoBuilder.NewSenderInfo("xx@example.com")
                    .WithTimezoneId("JST")
                    .Build();
            eslClient.AccountService.UpdateSender(updatedSender, "GAfpUrfGLFQL");
        }

Spécifier les fuseaux horaires par forfait

Les transactions sont généralement par défaut selon le fuseau horaire de l’expéditeur qui crée la transaction. Cependant, vous pouvez contourner cela en fixant un fuseau horaire spécifique pour la transaction.

Vous pouvez aussi créer un modèle avec un fuseau horaire spécifique. Toute transaction créée à partir de ce modèle héritera alors de ce fuseau horaire.

Lors de la création d’une transaction, vous pouvez définir un identifiant de fuseau horaire en appelant la fonction WithTimezoneId() via l’objet PackageBuilder . Le code suivant vous montre comment créer une transaction avec le fuseau horaire EST, tout en ajoutant une signature et un champ de date.

            DocumentPackage pkg = PackageBuilder.NewPackageNamed("Test Time Zone" + new DateTime())
               .WithSigner(SignerBuilder.NewSignerWithEmail("signer1@example.com")
                       .WithFirstName("signer1 firstname")
                       .WithLastName("signer1 lastname")
                       )
               .WithDocument(DocumentBuilder.NewDocumentNamed("document 1")
                       .FromFile(FILE_PATH)
                       .WithSignature(SignatureBuilder.SignatureFor("signer1@example.com")
                               .OnPage(0)
                               .AtPosition(100, 300)
                               .WithSize(200, 75))
                       )
               .WithTimezoneId("America/Toronto")
               .Build();
            PackageId packageId = eslClient.CreatePackageOneStep(pkg);
            eslClient.SendPackage(packageId);

Résultats

Voici un exemple de ce à quoi vous pouvez vous attendre une fois votre code exécuté.

Voici les formats de date utilisés pour les champs de signature :

{
 "signatureFormat": "e-Signed by $signer_name; \n on $date;",
 "signatureDateFormat":"yyyy-MM-dd HH:mm:ss z"
} 

Et pour le champ de date :

{
 "aws.document.autofield.date.format" : "yyyy-MM-dd HH:mm:ss z"
}

Vous pouvez faire mettre à jour ces formats selon vos besoins en contactant notre équipe de support.

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

Les transactions peuvent être configurées pour s’afficher dans un fuseau horaire spécifique. Cela signifie que les composantes temporelles visibles, comme les champs d’horodatage et de date de signature, seront formatées et affichées selon le fuseau horaire spécifié. Cela peut se faire aux niveaux suivants :

• Par compte

• Par fuseau horaire de l’expéditeur

• Par fuseau horaire du forfait

Pour une liste des fuseaux horaires de format long pris en charge, veuillez télécharger cette pièce jointe :

Spécifier les fuseaux horaires par compte

Spécifier le fuseau horaire au niveau du compte modifie le fuseau horaire par défaut pour tout nouvel expéditeur du compte vers le fuseau horaire nouvellement spécifié. Vous pouvez configurer cela en contactant notre équipe de support.

Spécification des fuseaux horaires par expéditeur

Spécifier un fuseau horaire au niveau de l’émetteur est utile lorsque plusieurs expéditeurs sont dans différents fuseaux horaires. Une fois cela fait, toute nouvelle transaction créée par votre expéditeur héritera de la configuration horaire que vous avez configurée pour eux.

Le code suivant le fera ainsi :

Requête HTTP

POST /api/account/senders/{senderId}

En-têtes HTTP

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

{
    "timezoneId" : "JST"
}

Pour les nouveaux expéditeurs, vous pouvez d’abord les inviter puis mettre à jour leur réglage de fuseau horaire en deux étapes différentes, consultez le guide de l’expéditeur pour savoir comment inviter les expéditeurs.

Spécifier les fuseaux horaires par forfait

Les transactions sont généralement par défaut selon le fuseau horaire de l’expéditeur qui crée la transaction. Cependant, vous pouvez contourner cela en fixant un fuseau horaire spécifique pour la transaction.

Vous pouvez aussi créer un modèle avec un fuseau horaire spécifique. Toute transaction créée à partir de ce modèle héritera alors de ce fuseau horaire.

Requête HTTP

POST /api/packages

En-têtes HTTP

Autorisation : Basic api_key

Accepter : application/json

Type de contenu : multipart/form-data

Charge utile de 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"
{
   "roles":[
      {
         "id":"Role1",
         "signers":[
            {
               "email":"signer1@example.com",
               "firstName":"1.firstname",
               "lastName":"1.lastname",
               "company":"OneSpan Sign"
            }
         ]
      },
      {
         "id":"Role2",
         "signers":[
            {
               "email":"signer2@example.com",
               "firstName":"2.firstname",
               "lastName":"2.lastname",
               "company":"OneSpan Sign"
            }
         ]
      }
   ],
   "documents":[
      {
         "approvals":[
            {
               "role":"Role1",
               "fields":[
                  {
                     "page":0,
                     "top":100,
                     "subtype":"FULLNAME",
                     "height":50,
                     "left":100,
                     "width":200,
                     "type":"SIGNATURE"
                  }
               ]
            },
            {
               "role":"Role2",
               "fields":[
                  {
                     "page":0,
                     "top":300,
                     "subtype":"FULLNAME",
                     "height":50,
                     "left":100,
                     "width":200,
                     "type":"SIGNATURE"
                  }
               ]
            }
         ],
         "name":"Test Document"
      }
   ],
   "name":"Text Timezone Setting",
   "type":"PACKAGE",
   "timezoneId":"JST",
   "language":"en",
   "emailMessage":"",
   "description":"New Package",
   "autocomplete":true,
   "status":"SENT"
}
------WebKitFormBoundary1bNO60n7FqP5WO4t--

Charge utile de réponse

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

Voici un exemple de ce à quoi vous pouvez vous attendre une fois votre code exécuté.

Voici les formats de date utilisés pour les champs de signature :

{
 "signatureFormat": "e-Signed by $signer_name; \n on $date;",
 "signatureDateFormat":"yyyy-MM-dd HH:mm:ss z"
} 

Et pour le champ de date :

{
 "aws.document.autofield.date.format" : "yyyy-MM-dd HH:mm:ss z"
}

Vous pouvez faire mettre à jour ces formats selon vos besoins en contactant notre équipe de support.