how to implement "New Signer experience with local language support "

We got email from onespan new feature ..."Local Language Support"... and want to implement this. 

Please suggest steps and java code for this. We have implmneted using JavaSDK.

Hi there,

In short,

(1) you need to add localized email templates to your account by contacting our support team([email protected])

(2) make sure your SDK is later than 11.31, then include below snippet:

.withSigner(newSignerWithEmail(email1)

.withFirstName("One1")

.withLastName("Span1")

.withLocalLanguage())

For more detailed information, go check my blog "Local Language Support"

Duo

Is it possible to set on Package level? not on signer level?

We are setting language on Package level.

 packageToBuild = PackageBuilder.newPackageNamed(OfferId).withLanguage(localeLang).autocomplete(false).expiresAt(ValidTill).describedAs(DocId);

Unfortunately, the Local language is not available at package level, below are some thoughts and tips when you use the local language:
(1)I would prefer NOT to understand the local language as an option among the language lists, because the local language can only be applied to 3 email templates and thank you summary page now, anywhere else will still be applied by the signer language.

(2)because of the first point, specifying local language is not as easy as set language as "local". If you consider it from the API's perspective, below is the JSON enabling local language for a signer:

{
  "data": {
    "localLanguage": "local"
  },
  "id": "Role1",
  "signers": [
    {
      "company": "OneSpan Sign",
      "email": "[email protected]",
      "firstName": "1.firstname",
      "lastName": "1.lastname"
    }
  ]
}

The setting is passed at the "data" node, on top of the signer's "language", so OneSpan Sign knows which language to trace back for other UI labels and the email templates.

Duo

What would be package language code if we are going to set local language at Signer level.

packageToBuild = PackageBuilder.newPackageNamed(OfferId).withLanguage("en").autocomplete(false).expiresAt(ValidTill).describedAs(DocId);
 

Hi, 

We are using below  to add signer in package

DocumentSignerSigner = SignerBuilder.newSignerWithEmail(SignerEmail);

there is no method ".withLocalLanguage())" in SignerBuilder.

Please let me know how to go ahead.

Hi , 

I am using sdk 11.31 but there is no method 

.withLocalLanguage()

please suggest.

I just checked the SDK's git repo, and found that the code was released at 11.32 version, so please make sure that your Java SDK version is equal or later than 11.32.

(11.32 SDK is not yet released at the documentation page, but you can already found it at maven)

Duo

Hi, 

how to download jar files from maven?

Thanks

Go check this link, and download the first of the list "sdk-11.32-jar-with-dependencies.jar ":
 

Duo

Hi Duo, 

I tried with "sdk-11.32-jar-with-dependencies.jar " but it did not work. 

I have attached screenshot.

.withLocalLanguage(); is not availble.

Thanks, 

Hi,

Could you remove the "sdk-11.31.jar", "sdk-11.31-javadoc.jar" and "sdk-11.31-sources.jar" from the build path? I believe it's because the "SignerBuilder" object's reference still points to the old SDK, that's why there's no such newly added functions.

Duo

Hi Duo, 

I tried but it did not work. 

could you please check at your side why it did not consider local template.

Below package id on sandbox.

Packageid : 195ZLn1YXqZO5Rh4jQFUV1Ilfng=

Below is my java code.

  if(PackageLanguage == "local")

{
        DocumentSignerSigner.withLocalLanguage();
  }
 DocumentSigner=   DocumentSignerSigner.build();
eslClient.getPackageService().addSigner(package_id, DocumentSigner);

                        

Hi Danish,

Please be informed that:

"If the signer is a sender registered in OneSpan Sign, the language set in the sender’s profile will determine the signer language, therefore the local language won’t be applied to the senders."

I checked in the backoffice and the Signer1 in your package (with gmail address) is happened to be a sender in the US2 sandbox environment, you can try with another email and see if the local templates applied to him/her.

Duo

Hi Duo, 

Please check below Package id.

ESEA_jtvCMiZrJ1nbtMoCmIxuo0=

Hi Duo, 

Could you please let me know if local is received at your end.

packageId:

7GrRErtBAB8xjJQFCFdE8EI4yms=

I tried above but email not received in local language. 

Hi Danish,

I've checked both of the packages, and both of them did not receive the local language. What I saw unexpected from the package JSON is:

"data":{"localLanguage":null}   (signer's data node was set by null instead of "local")

If you check the package JSON at your end, you'll also see the same. So I am wondering if your outbound call caused this, or the "data" node is not taken by OneSpan Sign side and turned out to be null. 

Please let me know if you want further assistance, in which case, you can create a ticket with support team([email protected]) and share your ticket number. I will work with them on your case. Potentially, we can set up an online session to let me see your project, check your outbound call, and verify in OneSpan Sign backoffice in real time.

Duo

Hi Duo, 

How to check JSON at my end. I am using JAVA SDK.

Case CS0023638 

Thanks, Danish

Thanks Danish,

I've seen your ticket. Before we jump to a session, I'd like to share with you how to enable the logging capability of the Java SDK. There are already error tracking codes existing in the SDK, utilizing the "java.util.logging.Logger". So in order to enable the function, you'd add a "logging.properties" file to your source folder includes settings similar to below:
 

# Example logging.properties file
# To show eSignLive.com logs on the console, set the following JVM property:
# -Djava.util.logging.config.file=logging.properties
 
# Create console handler
com.silanis.esl.handlers=java.util.logging.ConsoleHandler
 
# The eSignLive.com log level is set to FINE
com.silanis.esl.level=FINEST 
 
# Set the default logging level for the root logger
.=FINEST
 
# The Console Handler log level must be set to FINE or lower
java.util.logging.ConsoleHandler.level=FINEST
 
# --- Console Handler Properties ---
java.util.logging.ConsoleHandler.formatter=java.util.logging.SimpleFormatter
java.util.logging.SimpleFormatter.format=%1$tb %1$td, %1$tY %1$tl:%1$tM:%1$tS %1$Tp %2$s [%4$s] %5$s%n

And specify the system property by below code:
    static {
        System.setProperty("java.util.logging.config.file", "./relative_path/logging.properties");
    }

In example above, I used the "java.util.logging.ConsoleHandler", which will print all the logs to the console whenever the SDK invokes an API.

Duo

Hi duo, 

Could you please let me know why email not coming in Dutch.

package : WgFhnlJVhzHxUg_O1uCuRjdrb8A=

before we were receiving email in Dutch.

Hi Danish,

After a quick check, the signer with gmail domain is a sender under the US2 sandbox, so if you can create another testing email(outlook or mailinator domain should be fine), the behavior should be consistent to before.

Duo

Hi Duo,

I have used another Id but still same issue. few things coming in dutch and remaining is in english

Packageid: 

MPIdVL_H‑HauhwylknhwUOzIvNY=