Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The next screenshot shows these configurations:

Image RemovedCustomization SettingImage Added

If the feature is available for your organization, you can:

...

Code Block
languagejava
themeEclipse
button[data-id='SignOnPhone'] {
    visibility: hidden;
}

#sopProtocolLink{
visibility:hidden;
}

.inSigningProgress{
visibility:hidden;
}

#qrcodeImage > canvas{
  visibility:hidden;
  display: none;
}

If you removed both Mouse and SignOnPhone, the device selection looks like:

Image Removed

Without those configuration the following settings will be visible:

Image Removed


Info

Please note that since version 22.28 it is possible to disable and enable SignOnPhone and Mouse via the customization.zip in the global_variables.xml with the following two variables:

Code Block
languagexml
themeEclipse
<variable name="DisableSignOnPhone"/>
<variable name="DisableMouseForBiometricSignature"/> 



If you removed both Mouse and SignOnPhone and no other device for signing was found, the device selection looks like:


Signing Device OverviewImage Added

Without those configuration (Mouse and SignOnPhone enabled) the following settings will be visible:

Signing Device Overview Without ConfigurationImage Added


For an instance-wide custom.css (For an instance-wide custom.css (not within Customization.zip) you could change the descriptive text above/instead the QR code image with following CSS definition:

...

Code Block
languagexml
themeEclipse
<variable name="lighterGrayColorprimaryColor" value="#{[color:#d3d0d0#00A69D]}#" comment="
	default: #d3d0d0
	used as thumbnail background, page navigation background, disabled form fields, menu button hover effects#00A69D Primary color of the SAW Viewer affecting several major elements and referenced in different shades like 'primaryLightestColor' or 'primaryLighterColor' (see 'ADVANCED' section)
" category="Basic" />

With this one:

Code Block
languagexml
themeEclipse
<variable name="lighterGrayColorprimaryColor" value="#{[color:#8b8989#000088]}#" comment="
	default: #d3d0d0
	used as thumbnail background, page navigation background, disabled form fields, menu button hover effects#000088  Primary color of the SAW Viewer affecting several major elements and referenced in different shades like 'primaryLightestColor' or 'primaryLighterColor' (see 'ADVANCED' section)
" category="Basic" />

After the page navigation background color we are now changing the document background color. Therefor, search for the following line and change it to the lines below:

Replace the following line:

Replace the following line:

Code Block
Code Block
languagexml
themeEclipse
<variable name="lightestGrayColorsecondaryColor" value="#{[color:#ebeaea#35364A]}#" comment="
	default: #ebeaea
	mainly used for the document background and menu backgrounds #35364A Secondary color of the SAW Viewer affecting most icons, some buttons and used as counterpart of 'primaryColor'
" category="Basic" />
  

With this one:

Code Block
languagexml
themeEclipse
<variable name="lightestGrayColorsecondaryColor" value="#{[color:#EEE9E9#000088]}#" comment="
	default: #ebeaea
	mainly used for the document background and menu backgrounds#000088  Secondary color of the SAW Viewer affecting most icons, some buttons and used as counterpart of 'primaryColor'
" category="Basic" />

...


  

Replace the following linelines:

Code Block
languagexml
themeEclipse
<variable name="defaultColorguidanceButtonNextColor" value="#{[colorcolorvar:#661864secondaryColor]}#" comment="
	default: #661864
	affects the cancel button border, active page navigation bar items, top small bar, focused element in the document, upload progress bars, finished message background color, active page border, active thumbnail border, icons and headers in dialogs, batch signing progressbar foreground, SignOnPhone background color
" category="" />

With this one:

" category="Expert" />
<variable name="guidanceButtonPreviousColor" value="#{[colorvar:secondaryColor]}#" comment="" category="Expert" />
<variable name="menuOverlayButtonColor" value="#{[colorvar:secondaryColor]}#" comment="" category="Expert" />

With this one:

Code Block
languagexml
themeEclipse
<variable name="guidanceButtonNextColor" value="#{[colorvar:whiteColor]}#" comment="" category="Expert" />
<variable name="guidanceButtonPreviousColor" value="#{[colorvar:whiteColor]}#" comment="" category="Expert" />
<variable name="menuOverlayButtonColor" value="#{[colorvar:whiteColor]}#" comment="" category="Expert
Code Block
languagexml
themeEclipse
<variable name="defaultColor" value="#{[color:#000088]}#" comment="
	default: #661864
	affects the cancel button border, active page navigation bar items, top small bar, focused element in the document, upload progress bars, finished message background color, active page border, active thumbnail border, icons and headers in dialogs, batch signing progressbar foreground, SignOnPhone background color
" category="" />

After this configurations the viewer should look like the following:

Image RemovedCustomization Sample ViewImage Added


 For changing the Logo you have to put your Logo in the subfolder /files. Then you have to change the variables.xml to set the new files (e.g. my-logo-large.png and my-logo-small.png).

...

  • For the loading screen
  • and for the top bar


Loading screenTop bar



Image RemovedLoading ScreenImage Added


Image RemovedTop BarImage Added


section
Info

It may take some minutes until the new design is applied to your eSignAnyWhere Viewer.

Viewer Preferences

Info

Note that changes of the viewer preferences will be effective within some minutes after uploading the changed Customization.zip file. The changes are applied also on existing envelopes. Note that changes may have legal effect even on older envelopes (e.g. enabling/disabling the SkipFinishConfirmDialog, FinishWorkstepOnOpen, AcceptAgreementDisabledUntilRequiredActionsDone but also others); consider the impact of a change carefully.


NameDescriptionValuesNote
MessageForwardingDialogBehaviourEither ‘Show’ or ‘Allow’; If ‘Show’ is set and forwarding JS PostMessages to e.g. a parent iFrame when setting PostmessageClient query parameter the user will get asked if he/she wants to allow this. When ‘Allow’ is set, the user will not get asked and sending messages to the iFrame automatically gets allowed.Possible values: 0, 1 (default)
ShowPageNavigationBarAllows to disable the page navigation bar on the left side of the viewerPossible values: 0, 1 (default)Deprecated => Use ShowPageNavigationButtons instead
ShowThumbnailsIf enabled, the thumbnail display will be visible, otherwise falsePossible values: 0, 1 (default)
SkipFinishConfirmDialogIf enabled, finish action will be executed immediately without confirm dialogPossible values: 0 (default), 1
SkipDocumentDialogIf enabled, the download document dialog after finishing the workstep will be skippedPossible values: 0 (default), 1
ShowImagesInFullWidthIf enabled, available width will be used for images which might stretch themPossible values: 0 (default), 1
DisableGeolocationIf enabled, Geolocation won’t be used for webservice callsPossible values: 0 (default), 1
ShowDocumentDownloadDialogAfterAutomaticFinishIf enabled, the “Download documents dialog” after automatically finishing the workstep will be shown (e.g. acknowledge receipt scenario)Possible values: 0 (default), 1
AttachmentsMaxFileSizeAllows to configure the maximum file size for attachments in kBytesPossible values: Any integer value, (default: 2048)Not possible via customization
SkipPreviewImageOnDisposableCertificateAllows to disable the preview image of the signature when using the Namirial Disposable certificate functionalityPossible values: 0, 1 (default)
LoadCustomJsIf enabled, a Custom.js file will be loaded when the page is opened allowing to configure customized dataPossible values: 0 (default), 1Not possible via customization
AllowCustomButtonsIf enabled, custom buttons can be added via xyzmo.Customization pluginPossible values: 0 (default), 1Not possible via customization
GuidingBehaviorDefines how the viewer should guide through the tasksPossible values: GuideOnlyRequiredTasks, GuideRequiredAndOptionalTasks (default), GuideDisabled
FormFieldsGuidingBehaviorDefining how the viewer should guide through form fieldsPossible values: AllowSubmitAlways (default), AllowSubmitOnlyAfterAllRequiredFieldsAreDone
ShowVersionNumberDefining if the viewer should show the version numberPossible values: 0, 1 (default)Deprecated => Use ShowStatusBar instead
EnableWarningPopupOnLeaveDefining if the viewer should display a warning popup when the user leaves the pagePossible values: 0, 1 (default)
WarningPopupDisplayAfterDefining when the warning popup should be displayedPossible values: FillOrSignField (default), Authentication, Always, Agreement
FinishWorkstepOnOpenIf set to 1 the workstep is automatically finished when opened in the viewer, if finishing is possiblePossible values: 0 (default), 1Not possible via customization
MultipleSignatureTypesAndBatchSigningSettings / IsUseBatchSigningCheckedByDefaultIf enabled, the “Use batch signing” checkbox inside the dialog when signing a signature field is checked by defaultPossible values: 0, 1 (default)
MultipleSignatureTypesAndBatchSigningSettings / IsRememberSignatureTypeCheckedByDefaultIf enabled, the “Remember signature type” checkbox inside the dialog when signing a signature field is checked by defaultPossible values: 0 (default), 1
MultipleSignatureTypesAndBatchSigningSettings / IsRememberBatchSigningDecisionCheckedByDefaultIf enabled, the “remember batch signing decision” checkbox inside the dialog when signing a signature field is checked by defaultPossible values: 0 (default), 1
MultipleSignatureTypesAndBatchSigningSettings / SkipMultipleSignatureTypesAndBatchSigningDialogIfBatchSigningPossibleIf enabled, and the IsUseBatchSigningCheckedByDefault is also enabled, the dialog to confirm the batch signing (and optionally choosing the signature type) will be skipped if either the signature type to use has been remembered earlier or a preferred type is setPossible values: 0 (default), 1
AutoFinishAfterRequiredTasksDoneIf enabled, finish action will be automatically triggered after last required task is donePossible values: 0 (default), 1
GuidingBehaviorOnFinishedTaskDefines the guiding behavior after a task has been completed (e.g. signature field has been signed). This flag is not taken into account if the guiding is disabledPossible values: NoMove, MoveToNext (default), MoveToNextAndActivate
SkipThankYouDialogIf enabled, hints that the document can now be finished after all required tasks have been done, will be shownPossible values: 0 (default), 1Deprecated => Use ShowFinishPossibleHint instead
DisplayRejectButtonInLeftBar (replaced by DisplayRejectButtonInTopBar in SSP 4.15.54 or higher)If enabled, the ‘reject’ button will be displayed in the left bar below the ‘finish’ button as wellPossible values: 0 (default), 1
NativeAppsUrlSchemeDefines the url scheme for the native SAW Viewer applications (needed for customized SAW Viewer apps)Possible values: Any custom URL scheme (default: esignanywhere)Not possible via customization
DocumentViewingModeDefines whether the envelope is displayed in its entirety or if only a specific document is shown at a timePossible values: EndlessPaperAllDocuments (default), EndlessPaperPerDocument
ThumbnailModeDefines the appearance of the thumbnail view: all pages of the entire document are shown, or only the first page of each document within an envelopePossible values: ShowAllPages (default), ShowFirstPageOnly
ShowTopBarDefines if the top bar should be visible or not. If disabled, also the ‘GuidingBehavior’ and the ‘DisplayRejectButtonInTopBar’ will be deactivated.Possible values: 0, 1 (default)
DisplayRejectButtonInTopBar (replaces DisplayRejectButtonInLeftBar from 4.15.54)If enabled, the ‘reject’ button will be displayed in the top bar next to the ‘finish’ button as well.Possible values: 0 (default), 1
PhoneNumberInputSettings/DefaultCountryIf ‘auto’ is defined, the first one of the list is preselected or use ISO 3166-1 alpha-2 code (f.e. ‘it’)Possible values: auto (default), ISO 3166-1 alpha-2 code (f.e. ‘it’)
PhoneNumberInputSettings/PreferredCountryListIf ‘auto’ is defined, the first one of the list is preselected or use ISO 3166-1 alpha-2 code (f.e. ‘it’)Possible values: it,ro,at,de (default), ISO 3166-1 alpha-2 code (f.e. ‘it’)
TriggerBankIdDesktopAppDefines if the BankID desktop app should be triggered from the browser when authenticating via BankID.Possible values: 0 (default), 1Not possible via customization
ShowPageGapDefines whether or not to show a small gap between pages containing some bits of information (like corresponding document and page x/y) in Desktop/Tablet UIPossible values: 0, 1 (default)
AutoStartGuidingDefines if the guiding (if disabled at all) should be started directly upon start.Possible values: 0 (default), 1
ShowFinishPossibleHintIf enabled, hints that the document can now be finished after all required tasks have been done, will be shownPossible values: 0, 1 (default)
ShowStartGuidingHintIf enabled, a hint to the next button is shown, where the guide can be startedPossible values: 0, 1 (default)
ShowStatusBarDefines if the status bar at the bottom should be visible or not. If disabled, product and version number and biometric signature device selection window is not availablePossible values: 0, 1 (default)
ShowPageNavigationButtonsallows to disable the page navigation buttons on the left side of the viewerPossible values: 0, 1 (default)
ShowZoomButtonsallows to disable the zoom buttons on the left side of the viewerPossible values: 0, 1 (default)
ShowNoGeolocationWarningDefines if a warning should be shown in case the browser does not allow to retrieve the geolocation.Possible values: 0 (default), 1Not possible via customization
SkipRejectConfirmDialogIf enabled, reject action will be executed immediately without confirm dialogPossible values: 0 (default), 1
DisableSignOnPhoneDefines if SignOnPhone (if configured appropriately) should be offered as an option to sign biometrically.Possible values: 0 (default), 1
DisableMouseForBiometricSignatureDefines if 'Mouse' should be offered as an option to sign biometrically upon using SIGNificant Device Driver.Possible values: 1 (default), 0
SignatureComplexityChecks/Draw2Sign/MinimumPacketsMinimum count/amount of packets for a signature. Default is empty value or 0 => All signatures are accepted in terms of lengthDefault: 0 (disabled)
SignatureComplexityChecks/Draw2Sign/MinimumTimeInMs

Minimum time in milliseconds for a signature. Default is empty value or 0 => All signatures are accepted in terms of duration

Default: 0 (disabled)

...


Document Policies

These policies, also called "Global Policies" sometimes, define which of the features of a client are allowed on a signer activity - in case the client application supports this feature. Please note that the SignAnyWhere Viewer does not support all of these.

NameDescriptionValuesSAW-Viewer
AllowSaveDocumentIs the client allowed to save the workstep documentPossible values: 0 (default), 1(tick)
AllowSaveAuditTrailIs the client allowed to save the audittrail documentPossible values: 0 (default), 1(tick)
AllowRotatingPagesIs the client allowed to rotate the pages of the documentPossible values: 0 , 1 (default)(error)
AllowAppendFileToWorkstepIs the client allowed to append a file to the workstepPossible values: 0 (default), 1(error)
AllowAppendTasksToWorkstepIs the client allowed to add append tasks to the workstepPossible values: 0 (default), 1(error)
AllowEmailDocumentIs the client allowed to email the workstep documentPossible values: 0 (default), 1(error)
AllowPrintDocumentIs the client allowed to print the workstep documentPossible values: 0 (default), 1

...

(tick)
AllowFinishWorkstepIs the client allowed to finish the workstepPossible values: 0 , 1 (default)(tick)
AllowRejectWorkstepIs the client allowed to reject the workstepPossible values: 0 (default), 1(tick)
AllowRejectWorkstepDelegationIs the client allowed to reject the workstep with reject type ‘Delegation’Possible values: 0 , 1 (default)(tick)
AllowUndoLastActionIs the client allowed to undo actionsPossible values: 0 (default), 1(tick)
AllowColorizePdfFormsIs the client allowed to colorize pdf formsPossible values: 0 (default), 1(error)
AllowReloadOfFinishedWorkstepIs the client allowed to view/download the document after finishingPossible values: 0 , 1 (default)(tick)
AllowAdhocPdfAttachmentsIs the client allowed to add adhoc attachmentsPossible values: 0 (default), 1

...

(tick)
AllowAdhocSignaturesIs the client allowed to add signatures which are not defined in the tasksPossible values: 0 (default), 1(error)
AllowAdhocStampingsIs the client allowed to add stampings which are not defined in the tasksPossible values: 0 (default), 1(error)
AllowAdhocFreeHandAnnotationsIs the client allowed to add adhoc freehand annotationsPossible values: 0 (default), 1(error)
AllowAdhocTypewriterAnnotationsIs the client allowed to add adhoc typewriter annotationsPossible values: 0 (default), 1(error)
AllowAdhocPictureAnnotationsIs the client allowed to add adhoc picture annotationsPossible values: 0 , 1 (default)(error)
AllowAdhocPdfPageAppendingIs the client allowed to append adhoc documentsPossible values: 0 (default), 1(error)

...

Configurations

Configurations for API integrations, where you directly configure the workstep per recipient.

WorkstepIdStampConfiguration

In the configuration of the workstep you can define the stamp imprint:

Section
Code Block
languagexml
themeEclipse
<workstepIdStampConfiguration>
    <referenceCorner>Upper_Left</referenceCorner>
    <color>White</color>
    <location width="340" height="15" marginLeft="3" marginTop="3" />
</workstepIdStampConfiguration>

NotificationConfiguration

Also the notification configuration is possible via the workstep configuration.

Code Block
languagexml
themeEclipse
<NotificationConfiguration>
    <NotificationEventsNotToSend>
        <NotificationEvent>ActionCalledEvent</NotificationEvent>
        <NotificationEvent>WorkstepCreated</NotificationEvent>
        <NotificationEvent>SignWorkstepDocument</NotificationEvent>
    </NotificationEventsNotToSend>
    <NotificationUrl>http://localhost:52094/ReceiverSample.aspx?WorkstepId=##WorkstepId##&EventType=##EventType##&Source=##Source##&Time=##Time##&Description=##Description</NotificationUrl>
</NotificationConfiguration>

StampImprintConfiguration

You also can define the stamp imprint for signature fields configuration.

Code Block
languagexml
themeEclipse
  <AllowedSignatureTypes>
                <sigType id="..." type="Picture">
                  <allowedCapturingMethods>Click2Sign</allowedCapturingMethods>
                  <StampImprintConfiguration>
                               <DisplayExtraInformation>1</DisplayExtraInformation>
                               <DisplayEmail>1</DisplayEmail>
                               <DisplayIp>0</DisplayIp>
                               <DisplayName>1</DisplayName>
                               <DisplaySignatureDate>1</DisplaySignatureDate>
                               <FontFamily>Times New Roman</FontFamily>
                               <FontSize>11</FontSize>
                  </StampImprintConfiguration>
                </sigType>
  </AllowedSignatureTypes>
</sig>
Section

Opening a workstep with the SAW Viewer is quite easy. Just reference to the SAW Viewer endpoint and use a workstepid parameter.

<http|https>://<server>/<virtualDirectory>/SignAnywhere.html?WorkstepId=<WorkstepId>

Parameters

...

ParameterValuesDescription
setLng(de|en|it|…)defines the UI language, if not defined the browser language is used if available, otherwise fallback to English
isRemoteDesktop(0|1)defines if Device Driver should establish a connection to DeviceDriver Client Components. Required in Citrix environments when not configured in _global.xml
ignoreDeviceDriver(0|1)defines that no device driver should be loaded. Was implemented for situations where SignOnPhone should be used.

...

SignAnyWhere Viewer Client Finish Action

You can configure a client finish action to be redirected to an predefined URL for the signer.

...

Code Block
languagexml
themeEclipse
  <FinishAction>
    ...
    <ClientAction CallClientActionOnlyAfterSuccessfulSync="1" clientName="SIGNificant SignAnywhere">http://myurl.com</ClientAction>
    ...
  </FinishAction>