OneSpan Signe Comment: Personnaliser la cérémonie de signature

Avec OneSpan Sign, vous avez la possibilité de personnaliser plusieurs aspects de la cérémonie de signature pour répondre aux besoins de votre application. Cela vous permet d'intégrer plus facilement l'expérience de signature d'eSignLive dans votre application. Dans ce blog, je vais vous montrer comment personnaliser la cérémonie de signature avec le Java SDK, .NET SDK, et REST API.

Paramètres de niveau des paquets de documents

Avant d'entrer dans le code, je vais vous donner une brève description de chaque paquet disponible et les paramètres de mise en page de la cérémonie. Il est important de noter qu'il n'est pas nécessaire de spécifier l'un de ces paramètres. Ils seront par défaut aux valeurs indiquées ci-dessous si elles ne sont pas spécifiées. Paramètres de paquet de documents [tableau id 3 /] Paramètres de mise en page de la cérémonie ci-dessous est la disposition de la cérémonie de signature par défaut de OneSpan Sign. Chacune des sections est étiquetée pour plus de commodité.  

Paramètres du paquet de documents

Paramètres de mise en page des cérémonies

Vous trouverez ci-dessous la disposition de la cérémonie de signature par défaut de OneSpan Sign. Chacune des sections est étiquetée pour plus de commodité.

Le code

Comme je l'ai mentionné ci-dessus, je vais vous montrer comment personnaliser la cérémonie de signature avec le Java SDK, .NET SDK, et REST API. Allez-y et passez à la section qui s'applique à votre méthode. Je vais couvrir les mêmes informations dans chaque segment. Le code complet pour ce blog peut être trouvé dans le Partage de Code Communautaire Développeur: Java, .NET, et REST.

OneSpan Sign Developer Community

Rejoignez la communauté OneSpan Sign Developer! Forums, blogs, documentation, téléchargements SDK, et plus encore.

Joignez-vous aujourd'hui

Java SDK

Je vais commencer par le Java SDK. Le code de l'échantillon ci-dessous vous montre comment modifier le bloc de paramètres. Si vous avez besoin d'une comparaison avec la création d'objet de document de base ou si c'est la première fois la création d'un paquet avec le Java SDK, voir ce blogprécédent .

.withSettings(DocumentPackageSettingsBuilder.newDocumentPackageSettings()
			.avecInPerson()
			.avecOptOut()
			.withOptOutReason ("Termes de déclin.")
			.sansLanguageDropDown()
			.hideOwnerInPersonDropDown()
			.disableFirstAffidavit()
			.disableSecondAffidavit()
			.avecDecline()
			.sansWatermark()
			.avecCaptureText()
			.avecHandOverLinkHref("http://www.google.com")
			.withHandOverLinkText ("Exit to site")
			.withHandOverLinkTooltip ("Vous serez redirigé vers la page d'accueil de Google")
			.avecDocumentToolbarDownloadButton()
			.avecDialogOnComplete()							
.withCeremonyLayoutSettings(CeremonyLayoutSettings.newCeremonyLayoutSettings()
				.avecNavigator()
				.sansGlobalNavigation()
				.sansBreadCrumbs()
				.avecSessionBar()
				.avecTitre()
				.avecProgressBar()
				.avecIFrame()
				.avecGlobalConfirmButton()
				.sansGlobalDownloadButton()
				.sansGlobalSaveAsLayoutButton()
				.withLogoSource("http://www.logo-maker.net/images/common/company-logo8.gif"))

SDK .NET

Ensuite, je vais couvrir le .NET SDK. Le code de l'échantillon ci-dessous vous montre comment modifier le bloc de paramètres. Si vous avez besoin d'une comparaison avec la création d'objet document de base ou si c'est la première fois la création d'un paquet avec le .NET SDK, voir ce blogprécédent .

. WithSettings (DocumentpackageSettings.NewDocumentPackageSettings()
                        . WithInPerson()
                        . AvecOptOut()
                        . WithOptOutReason ("Déclin termes.")
                        . SansLanguageDropDown()
                        . HideownerInPersonDropDown()
                        . DésactiverFirstAffidavit()
                        . DésactiverSecondAffidavit()
                        . AvecDecline()
                        . Sans Watermark()
                        . WithCaptureText()
                        . WithHandOverLinkHref("http://www.google.com")
                        . WithHandOverLinkText (« Exit to site »)
 			. WithHandOverLinkTooltip ("Vous serez redirigé vers la page d'accueil de Google")
                        . SansDocumentToolbarDownloadButton()
                        . SansDialogOnComplete()
              . WithceremonyLayoutSettings(CeremonyLayoutSettings.NewCeremonyLayoutSettings()
                                . AvecNavigator()
                                . SansGlobalNavigation()
                                . SansBreadCrumbs()
                                . AvecSessionBar()
                                . AvecTitle()
                                . AvecProgressBar()
                                . AvecIFrame()
                                . AvecGlobalConfirmButton()
                                . SansGlobalDownloadButton()
                                . SansGlobalSaveAsLayoutButton()
                                . WithLogoImageSource ("http://www.logo-maker.net/images/common/company-logo8.gif"))

API REST

Enfin, je couvrirai l'API REST. L'exemple JSON ci-dessous vous montre comment modifier l'objet paramètres. J'ai inclus qui va créer un nouveau paquet de documents avec des paramètres d'exemple pour plus de commodité. Si vous avez besoin d'une comparaison avec la création d'objets de document de base ou si c'est la première fois la création d'un paquet avec l'API REST, voir ce blogprécédent .

{
  "réglages":
    "cérémonie":
      "événements":
        "complet":
          "dialogue": vrai,
          "rediriger": ""
        }
      },
      "inPerson": vrai,
      "declineButton": vrai,
      "declineRaisons": [],
      "disableDeclineOther": faux,
      "disableDownloadForUncompletedPackage": faux,
      "disableFirstInPersonAffidavit": vrai,
      "disableInPersonAffidavit": faux,
      "disableOptOutOther": faux,
      "disableSecondInPersonAffidavit": vrai,
      "documentToolbarOptions":
        "downloadButton": vrai
      },
      "handover":
        "titre": "Vous serez redirigé vers la page d'accueil de Google",
        "href": "http://www.google.com",
        "texte": "Exit to site"
      },
      "hideCaptureText": faux,
      "hideLanguageDropdown": vrai,
      "hidePackageOwnerInPerson": vrai,
      "hideWatermark": vrai,
      "maxAuthFailsAllowed": 3,
      "optOutButton": vrai,
      "optOutReasons": [
        "Refuser les termes."
      ],
      "style": nul,
      "mise en page":
        "footer":
        "iframe": vrai,
        "navigateur": vrai,
        "brandingBar":
          "logo":
            "src": "/sites/default/files/blog/images/company-logo8.gif",
            "lien": ""
          }
        },
        "en-tête":
          "feedback": vrai,
          "globalActions":
            "confirmer": vrai,
            "télécharger": faux,
            "hideEvidenceSummary": faux,
            "saveasLayout": faux
          },
          "titleBar":
            "titre": vrai,
            "progressBar": vrai
          },
          "breadcrumbs": faux,
          "globalNavigation": faux,
          "sessionBar": vrai
        }
      }
    }
  },
  "type": "PACKAGE",
  "statut": "DRAFT",
  "nom": "Customizing Signing Ceremony"
}

Exécution de votre code

Vous pouvez maintenant aller de l'avant et exécuter votre code. Selon les paramètres que vous avez choisis, votre résultat final peut être différent du mien. Si vous avez suivi mon exemple, ci-dessous est une capture d'écran de ce que vous pourriez vous attendre:

Et voilà. Vous avez réussi à personnaliser la cérémonie de signature.

Si vous avez des questions concernant ce blog ou toute autre chose concernant l'intégration de OneSpan Sign dans votre application, visitez les forums de la communauté des développeurs:

https://developer.onespan.com. C'est moi qui l'ai fait. Merci de lire! Si vous avez trouvé ce message utile, s'il vous plaît le partager sur Facebook, Twitter, ou LinkedIn.

Haris Haidary
Évangéliste technique junior
LinkedIn - France Twitter (en)