Configuration des langues
  • 02 Mar 2025
  • 6 Minutes à lire
  • Sombre
    Lumière
  • PDF

Configuration des langues

  • Sombre
    Lumière
  • PDF

Résumé de l’article

SDK Java .NET SDK API REST APEX SDK

SDK Java

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

Les langues disponibles lors de la création d'une transaction, ou pendant l'Signer Experience, peuvent être personnalisées. Les langues suivantes sont disponibles dans OneSpan Sign :

Langue

Valeur du code

български (bulgare)

[bg]

English (United States)

[en]

English (United Kingdom)

[en-GB]

Dansk (danois)

[da]

Deutsch (allemand)

[de]

Español (América Latina)

[es]

Español (España)

[es-ES]

Français (French)

[fr]

Italiano (italien)

[it]

Nederlands (néerlandais)

[nl]

Norsk - Bokmål (norvégien)

[nb]

Português (portugais)

[pt]

Polski (Polish)

[pl]

Română (roumain)

[ro]

Pусский (russe)

[ru]

Ελληνικά (grec)

[el]

中文简体 (chinois - simplifié)

[zh-CN]

中文繁體 (chinois - traditionnel)

[zh-TW]

日本語 (japonais)

[ja]

한국어 (coréen)

[ko]

اللغة العربية (arabe)

Disponible uniquement dans l'Expérience du signataire

[ar]

Changement de langue au niveau de la transaction

Pour modifier la langue d'une transaction, vous devez modifier l'objet DocumentPackage. Le code suivant permet d'effectuer ce qui suit :

DocumentPackage pkg = PackageBuilder
    .newPackageNamed("Example Package " + System.currentTimeMillis())
    .withLanguage(Locale.FRENCH)
    .build();

Notez que la langue est définie au niveau de la transaction. La langue sera modifiée pour tous les destinataires de la transaction.

Changer une langue au niveau du signataire

Vous pouvez également modifier vos paramètres de langue au niveau du signataire. Le code suivant permet d'effectuer ce qui suit :

Notez que le paramètre de langue au niveau du signataire remplacera le paramètre de langue au niveau de la transaction.

Signer signer2 = SignerBuilder
    .newSignerWithEmail("signer2@example.com")
    .withLanguage(Locale.FRENCH)
    .build();

Résultats

Voici un exemple qui vous montre comment construire une transaction tout en modifiant les paramètres linguistiques au niveau de la transaction et du signataire.

DocumentPackage superDuperPackage = PackageBuilder
    .newPackageNamed("Package Language Example")
    .describedAs("This is a package created using the OneSpan Sign SDK")
    .withLanguage(Locale.ENGLISH)
    .withSigner(SignerBuilder
        .newSignerWithEmail("signer1@example.com")
        .withFirstName("John")
        .withLastName("Smith")
        .withTitle("Managing Director")
        .withCompany("ABC Bank"))
    .withSigner(SignerBuilder
        .newSignerWithEmail("signer2@example.com")
        .withFirstName("Mary")
        .withLastName("Doe")
        .withTitle("Applicant")
        .withCompany("Acme Inc.")
        .withLanguage(Locale.ENGLISH))
    .withDocument(DocumentBuilder
        .newDocumentWithName("First Document")
        .fromFile("your_file_path")
        .withSignature(SignatureBuilder
            .signatureFor("signer1@example.com")
            .onPage(0)
            .atPosition(100, 100))
        .withSignature(SignatureBuilder
            .signatureFor("signer2@example.com")
            .onPage(0)
            .atPosition(200, 100)))
    .build();

.NET SDK

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

Les langues disponibles lors de la création d'une transaction, ou pendant l'Signer Experience, peuvent être personnalisées. Les langues suivantes sont disponibles dans OneSpan Sign :

Langue

Valeur du code

български (bulgare)

[bg]

English (United States)

[en]

English (United Kingdom)

[en-GB]

Dansk (danois)

[da]

Deutsch (allemand)

[de]

Español (América Latina)

[es]

Español (España)

[es-ES]

Français (French)

[fr]

Italiano (italien)

[it]

Nederlands (néerlandais)

[nl]

Norsk - Bokmål (norvégien)

[nb]

Português (portugais)

[pt]

Polski (Polish)

[pl]

Română (roumain)

[ro]

Pусский (russe)

[ru]

Ελληνικά (grec)

[el]

中文简体 (chinois - simplifié)

[zh-CN]

中文繁體 (chinois - traditionnel)

[zh-TW]

日本語 (japonais)

[ja]

한국어 (coréen)

[ko]

اللغة العربية (arabe)

Disponible uniquement dans l'Expérience du signataire

[ar]

Changement de langue au niveau de la transaction

Pour modifier la langue d'une transaction, vous devez modifier l'objet DocumentPackage. Le code suivant permet d'effectuer ce qui suit :

DocumentPackage pkg = PackageBuilder
    .NewPackageNamed("Example Package " + System.DateTime.Now)
    .WithLanguage(new CultureInfo("fr"))
    .Build();

Notez que la langue est définie au niveau de la transaction. La langue sera modifiée pour tous les destinataires de la transaction.

Changer une langue au niveau du signataire

Vous pouvez également modifier vos paramètres de langue au niveau du signataire. Le code suivant permet d'effectuer ce qui suit :

Notez que le paramètre de langue au niveau du signataire remplacera le paramètre de langue au niveau de la transaction.

Signer signer2 = SignerBuilder
    .NewSignerWithEmail("signer2@example.com")
    .WithLanguage(new CultureInfo("fr"))
    .Build();

Résultats

Voici un exemple qui vous montre comment construire une transaction tout en modifiant les paramètres linguistiques au niveau de la transaction et du signataire.

DocumentPackage superDuperPackage = PackageBuilder
    .NewPackageNamed("Package Language Example")
    .DescribedAs("This is a package created using the OneSpan Sign SDK")
    .WithLanguage(new CultureInfo("fr"))
    .ExpiresOn(DateTime.Now.AddMonths(1))
    .WithEmailMessage("This message should be delivered to all signers")
    .WithSigner(SignerBuilder
        .NewSignerWithEmail("signer1@example.com")
        .WithFirstName("John")
        .WithLastName("Smith")
        .WithTitle("Managing Director")
        .WithCompany("ABC Bank"))
    .WithSigner(SignerBuilder
        .NewSignerWithEmail("signer2@example.com")
        .WithFirstName("Mary")
        .WithLastName("Doe")
        .WithTitle("Applicant")
        .WithCompany("Acme Inc.")
        .WithLanguage(new CultureInfo("fr")))
    .WithDocument(DocumentBuilder
        .NewDocumentNamed("First Document")
        .FromFile("your_file_path")
        .WithSignature(SignatureBuilder
            .SignatureFor("signer1@example.com")
            .OnPage(0)
            .AtPosition(100, 100))
        .WithSignature(SignatureBuilder
            .SignatureFor("signer2@example.com")
            .OnPage(0)
            .AtPosition(200, 100)))
    .Build();

API REST

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

Les langues disponibles lors de la création d'une transaction, ou pendant l'Signer Experience, peuvent être personnalisées. Les langues suivantes sont disponibles dans OneSpan Sign :

Langue

Valeur du code

български (bulgare)

[bg]

English (United States)

[en]

English (United Kingdom)

[en-GB]

Dansk (danois)

[da]

Deutsch (allemand)

[de]

Español (América Latina)

[es]

Español (España)

[es-ES]

Français (French)

[fr]

Italiano (italien)

[it]

Nederlands (néerlandais)

[nl]

Norsk - Bokmål (norvégien)

[nb]

Português (portugais)

[pt]

Polski (Polish)

[pl]

Română (roumain)

[ro]

Pусский (russe)

[ru]

Ελληνικά (grec)

[el]

中文简体 (chinois - simplifié)

[zh-CN]

中文繁體 (chinois - traditionnel)

[zh-TW]

日本語 (japonais)

[ja]

한국어 (coréen)

[ko]

اللغة العربية (arabe)

Disponible uniquement dans l'Expérience du signataire

[ar]

Changement de langue au niveau de la transaction

La requête suivante vous montre comment construire vos données utiles JSON afin de modifier les paramètres de langue au niveau de la transaction et du signataire :

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"

{
  "status": "DRAFT",
  "language": "fr",
  "roles": [
    {
      "id": "Signer1",
      "type": "SIGNER",
      "signers": [
        {
          "id": "Signer1",
          "firstName": "John",
          "lastName": "Smith",
          "email": "signer1@example.com"
        }
      ],
      "name": "Signer1"
    },
    {
      "id": "Signer2",
      "type": "SIGNER",
      "signers": [
        {
          "id": "Signer2",
          "firstName": "Mary",
          "lastName": "Doe",
          "email": "signer2@example.com",
          "language": "en"
        }
      ],
      "name": "Signer2"
    }
  ],
  "type": "PACKAGE",
  "name": "Example Package"
}

------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="   } 

Notez que la langue est définie au niveau de la transaction. La langue sera modifiée pour tous les destinataires de la transaction.

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É

langue

chaîne de caractères

Oui

Non

en

en / fr / es ...

type

chaîne de caractères

Oui

Non

PACKAGE

PAQUET / MODÈLE / MISE EN PAGE

nom

chaîne de caractères

Oui

Non

s.o.

Exemple de paquet

rôles

id

chaîne de caractères

Oui

Non

s.o.

Signataire1

type

chaîne de caractères

Oui

Non

SIGNER

SIGNATAIRE / EXPÉDITEUR

nom

chaîne de caractères

Oui

Non

s.o.

Signataire1

signataires

courriel

chaîne de caractères

Oui

Oui

s.o.

courriel32@exemple.com

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

id

chaîne de caractères

Oui

Non

s.o.

Signataire1

langue

chaîne de caractères

Oui

Non

en

en / fr / es ...

APEX SDK

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

Les langues disponibles lors de la création d'une transaction, ou pendant l'Signer Experience, peuvent être personnalisées. Les langues suivantes sont disponibles dans OneSpan Sign :

Langue

Valeur du code

български (bulgare)

[bg]

English (United States)

[en]

English (United Kingdom)

[en-GB]

Dansk (danois)

[da]

Deutsch (allemand)

[de]

Español (América Latina)

[es]

Español (España)

[es-ES]

Français (French)

[fr]

Italiano (italien)

[it]

Nederlands (néerlandais)

[nl]

Norsk - Bokmål (norvégien)

[nb]

Português (portugais)

[pt]

Polski (Polish)

[pl]

Română (roumain)

[ro]

Pусский (russe)

[ru]

Ελληνικά (grec)

[el]

中文简体 (chinois - simplifié)

[zh-CN]

中文繁體 (chinois - traditionnel)

[zh-TW]

日本語 (japonais)

[ja]

한국어 (coréen)

[ko]

اللغة العربية (arabe)

Disponible uniquement dans l'Expérience du signataire

[ar]

Changement de langue au niveau de la transaction

L'exemple de code Apex ci-dessous vous montre comment modifier l'objet Package_x afin de modifier les paramètres de langue d'une transaction :

ESignLiveSDK sdk = new ESignLiveSDK();

// Create package
ESignLiveAPIObjects.Package_x pkg = new ESignLiveAPIObjects.Package_x();
pkg.name = 'Test Configure Package Language - ' + Datetime.now().format();
pkg.status = ESignLiveAPIObjects.PackageStatus.DRAFT;
pkg.language = 'fr'; // configure package language

String packageId = sdk.createPackage(pkg);
System.debug('PackageId: ' + packageId);

Notez que la langue est définie au niveau de la transaction. La langue sera modifiée pour tous les destinataires de la transaction.


Cet article vous a-t-il été utile ?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
ESC

Ozzy, facilitant la découverte de connaissances grâce à l’intelligence conversationnelle