Settings
In the app settings, a number of options can be defined. They will be described in the following sections.
Archiving
You can specify where the signed documents are stored using the Archiving settings.
Archive type
Under “archive type” you can define whether the files to be archived are saved on the local file system or uploaded to an “upload server”. File system is selected by default.
File system: The files are stored on the device’s internal storage based on the configured outgoing folder.
Upload server: The files are transferred to an upload server that handles further management of the documents. Further information can be found in the following section “Server URL”.
OneDrive: The files are retrieved, saved and archived via OneDrive. When starting the app, you will be asked to log in to OneDrive to access the files. After successful login, the available folders and files are displayed. The “My files” and “Shared files” tabs can also be used to switch between the different areas in OneDrive in order to access personal or shared files. When archiving, the files are overwritten or a timestamp is added to the same folder, depending on the setting.
It is not possible to use the “File System” option with an external storage card for saving files due to the modified rooting rights of Android 4.4 (KitKat) and later.
Server URL
If you selected “Upload Server” as the archive type, the URL of the server must be entered here. This option is disabled by default.
The upload takes place as a multipart upload, which must be accepted by the server. The service that accepts the document could be structured as in the following example.
Public Class Upload
Inherits System.Web.UI.Page
Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
Try
For Each file As String In Request.Files
Dim hpf As HttpPostedFile
hpf = Request.Files(file)
If hpf.ContentLength > 0 Then
My.Computer.FileSystem.WriteAllText(
"c:\temp\logfile.log",
AppDomain.CurrentDomain.BaseDirectory & "archiv/" & Replace(hpf.FileName, "\", ""),
True
)
Dim sFilename As String = AppDomain.CurrentDomain.BaseDirectory & "archiv\" & Replace(hpf.FileName, "\", "")
hpf.SaveAs(sFilename)
Response.Write("<?xml version=" + """" + "1.0" + """" + "?><ok/>")
Response.Flush()
Response.End()
End If
Next
Catch ex As Exception
' Exception Handling could go here
End Try
End Sub
End ClassLog out on exit
This function is only available if OneDrive has been selected as the archive type. If this option is activated, the login to OneDrive is reset when the app is closed, so that a new login to OneDrive is required each time the app is started. This can be useful, for example, if the same device is used by several people.
Add timestamp to file
This setting determines whether a timestamp in the format “YYYY-MM-DD_hhmmss” should be appended to the document name when archiving. This option will also be applied when you send e-mails.
This option is enabled by default.
Create an XFDF file
This option allows you to store an XFDF file in the destination folder when archiving files.
The XFDF file is given the same name as the PDF file. The values are read from the form fields of the document to be archived and written into the XFDF file in a standardized XML format. For example, if the document contains a text field with the name “Customer” and the value “Mustermann,” the entry <field name="Customer"><value>Mustermann</value></field> is written to the XFDF file.
This option is disabled by default.
Open original file
This setting determines whether the original file should be reopened unchanged after archiving. This option can only be activated if the ”Do not delete original file” option has been selected.
If the option “Open file selection dialog after archiving/saving” is activated, it is only relevant if the document was not opened via the file selection dialog of signoSign/mobile, but from an e-mail, for example.
This option is disabled by default.
Folders
In the Folders settings you can specify which directory is to be used when displaying the documents and where they will be saved when archiving, if “File system” was selected as the archive type.
Incoming folder
This option defines the directory in which signoSign/mobile searches for documents.
All PDF files in this directory are offered for selection when the app is started and can be opened, edited and signed. The directory “/storage/emulated/0” is selected by default.
The following options are available for specifying the directory:
Select folder: Tap this button to define the currently selected directory as incoming folder. The path is displayed above the directory structure under “Folder:”.
Previous folder: Tap this button to navigate to one directory level higher or lower.
New folder: This button can be used to create a new directory that the app will then switch to automatically.
Outgoing folder
You can use this option to specify the directory that will be used as the archive directory by signoSign/mobile. This setting is only relevant if you have selected “File system” as the archive type.
The directory “/storage/emulated/0” is selected by default. The same options are available for defining the directory as described in the previous section, “Incoming folder”.
Signature
Various signature options can be configured in the signature settings.
Capturing and saving biometric data
This setting specifies whether biometric data (such as x-coordinates, y-coordinates, pressure, time) should be captured and saved in a document in encrypted form when a signature is captured.
This option is disabled by default.
The biometric data is very valuable for signature verification by a handwriting expert, as it enables detailed verification of authorship. It is therefore recommended to activate this setting.
Start signing directly
This option determines whether the signing process should be started immediately after selecting the Sign button without the selection dialog (Sign, Add signature or Add signature & image) being displayed. To enable this, the document must contain at least one signature field, as otherwise, the selection dialog will appear. Signature fields that are selected directly are not affected by this setting.
This option is disabled by default.
Lock Sign button after last signature
This setting determines whether the “Sign” button should be deactivated after a signature has been inserted in the last empty signature field. It is then no longer possible to add further manual signature fields.
This option is disabled by default.
If this setting is activated and the document does not contain any signature fields, the document cannot be signed.
Signature color
This setting determines the color of the signature when it is captured and saved in the document.
The following colors are available:
Red
Green
Blue
Yellow
Purple
Black
Orange
Grey
The color is “blue” by default.
Show signature with pressure points
This option specifies whether the pressure levels are taken into account in the display when a signature is captured.
If this option is activated, the signature is displayed thicker or thinner depending on how hard you press when writing. If this option is deactivated, the signature is always displayed in the same thickness.
This option is disabled by default.
This option is only useful if a device with pressure levels is used, e.g. a device with pen support.
This setting is purely visual and has no influence on the recording of the pressure levels within the biometric data, provided that the recording of biometric data is activated.
Set max pressure
If the signature is to be displayed with pressure points, it makes sense to specify the device’s pressure levels, since they can vary depending on the particular device.
You can use this option to determine the maximum pressure level of the device so that the app can calculate the pressure curve.
Pressure must be applied to the display to record the pressure level. The recorded value is displayed under “Maximum measured pressure”. The maximum pressure value determined is saved in the app and can only be overwritten or reset by uninstalling the application.
The pressure values are recorded via the device’s digitizer. As a rule, a device with pen input is recommended for precise recording of pressure values. Further information is available from the device manufacturer.
Show part of the document in PDF during signing
This option determines whether the area defined as the signature field should be displayed when the signature is entered. Alternatively, the normal signature dialog is displayed as a write-only area.
This option is disabled by default.
Sign only with stylus (S Pen)
This option specifies that signatures may only be captured with the Samsung “S Pen” stylus. If enabled, it is not possible to enter a signature using the touch function or using another stylus.
This option is disabled by default.
Timestamp
In this area, you can specify whether a timestamp should be inserted in the signature field together with the signature. The timestamp will always be displayed under the signature on the left.
This option is disabled by default.
Timestamp color
This setting determines the color of the timestamp in the signature field.
The following colors are available:
Red
Green
Blue
Yellow
Purple
Black
Orange
Grey
The color is black by default.
Transparent image in signature
An image can be captured and embedded in the signature field using the “Add Signature & Image” feature. This setting determines whether the image is inserted transparently or opaquely.
This option is enabled by default.
This setting only affects images that are captured with a signature. Images that are captured and inserted independently of the signature are not affected and are always inserted without transparency.
Signature certificate
The PDF documents are digitally signed in accordance with the PDF standard.
A certificate is required for the digital signature.
To store a certificate, the certificate file can be selected as PKCS#12 (.p12 or .pfx) in the file system. Following selection, the path for the certificate will appear under the setting.
A demo certificate is stored by default , which can be used for test purposes. Before using the app productively, the demo certificate should be replaced by your own certificate.
Password
At this point, the password needs to be entered for the selected certificate. The colored display shows whether the password has been entered correctly. If the text is green, the password is correct. If the text is displayed in red, the password is incorrect.
If the password is entered incorrectly, the configuration can be exited, but a signature is not possible.
Biometric certificate
The biometric data for a signature, such as the amount of pressure, x and y-coordinates and time, is encrypted using an internal public key certificate and incorporated into the document.
Biometric data is very valuable for signature verification in the event of a dispute and enables signatures to be compared.
To store your own certificate, the certificate can be selected as a .PEM or .CER file in the file system. Following selection, the path for the certificate will appear under the setting.
By default, a public key certificate for the encryption of the biometric data is included, with the private key stored at a notary’s office. Even signotec, as the developer, does not have access to this private key, so only the notary is able to decrypt the signatures.
Changing the certificate can have a major impact on the security and authenticity of the signatures. The certificate contained by default should only be changed if it can be ensured that the new certificate has equivalent security in terms of safekeeping.
SMTP e-mail
You can specify whether an e-mail should be sent automatically when archiving a document in the SMTP settings. If this is the case, the SMTP access data and the e-mail information must be configured.
Send e-mails automatically
This option determines whether the document should be sent by e-mail automatically during archiving. If this setting is enabled, the SMTP and e-mail settings are activated and must be configured.
During archiving, an attempt is made to send the e-mail according to the settings. If an error occurs during sending, an error message is displayed.
This option is disabled by default.
Manual sending of e-mails is not configured in the settings, as it is performed by installed e-mail apps.
User name
Specifies the user name for authentication on the SMTP server.
Password
Specifies the password for authentication on the SMTP server.
SMTP server
Defines the SMTP outgoing mail server, e.g. smtp.office365.com.
Use SSL
Determines whether SSL or TLS encryption is used for sending e-mails.
This option is disabled by default.
Port
Defines the port of the SMTP server via which the e-mails are sent.
Sender
Defines the e-mail address that is used as the sender of the e-mail.
In most cases, the sender is identical to the user name. If a different configuration is used here, it must be ensured that the SMTP server allows this.
Recipient
Defines the recipient’s e-mail address.
Only one e-mail address can be configured.
If the option to read e-mail addresses from form fields is used, these are also taken into account. Further information on this can be found in the section Determining e-mail recipients from a form field.
Subject
Specifies the subject of the e-mail.
Message
Specifies the content (text) of the e-mail.
Attach XFDF file
This setting determines whether a generated XFDF file should be attached in addition to the PDF file during automatic e-mail dispatch if the “Create an XFDF file” option is activated.
This option is disabled by default.
This option only affects automatic e-mail dispatch. When e-mails are sent manually, the XFDF file is not sent regardless of this setting.
Show
The settings under Show can be used to define the buttons that are shown/hidden when a signature is captured. Logging can also be set.
Logging
The app allows you to create a log in order to better analyze any errors that may arise. The log is created as a CSV file.
The following options are available:
No log: No log file is created.
Error log: A log file is created that only contains any errors that may arise.
Error & information log: A log file is created that contains any errors that may arise and additional information.
Debug log: A log is created that contains all processes of the application. You should only activate this variant if instructed to do so by signotec Support. This option also severely impairs the performance of the app.
“No log” is selected by default.
Log folder
This option defines the directory in which the log files are created.
The directory “/storage/emulated/0” is selected by default. The name of the log file has the following structure: “YYYY-MM-DD_signoSignMobile.csv”
This setting is only relevant if logging has been enabled.
Show [...] button
The “Show [...] button” options determine whether a specific button is shown or hidden.
The following buttons are available for configuration:
Show “Open” button
Show “Image” button
Show “Notes” button
Show “Send” button
Show “Settings” button
Show “Help” button
Show “Print” button
Show “Archiving” button
Show “Save” button
Show “Close” button
Show button
Hiding the “Settings” button means that it is no longer possible to open the settings! The button can only be restored by reinstalling it, which causes all configurations to be lost.
User-defined action
In the settings for the user-defined action, you can optionally specify whether an additional button is to be shown or hidden and which action is to be executed.
The user-defined action starts a function of another app. The respective app manufacturers are responsible for the functionality and integration of the functions of other apps.
Show “Action” button (user-defined)
Specifies whether the button for the user-defined action should be displayed. This option is disabled by default.
Display text of the user-defined action button
Defines the name of the button for the user-defined action (archiving). Nothing is entered here by default, so the button is called “Action”.
PackageName of the user-defined action button function
Defines the “PackageName” of the app that is to be called when the user-defined action is executed. Nothing is stored here by default.
ClassName of the package for the user-defined action button
Defines which “ClassName” is to be transferred to the other app (PackageName). Nothing is stored here by default.
General
The general settings can be used to specify how and by what means images can be inserted, what will happen after the document is archived or when sending of the document is permitted.
Capturing images
This setting can be used to specify the sources that can be used to capture or select images.
The following options are available:
Camera: Images that are to be inserted can only be captured using the camera.
Gallery: Images that are to be inserted can only be selected from the gallery. Images can also be captured in the gallery selection using the camera. They will then be available for selection in the gallery.
Camera & gallery: Images that are to be inserted can be captured using the camera or selected from the gallery. A selection dialog is displayed.
The default setting is “camera”.
Inserting images
This setting specifies how the images should be added to the document.
The following options are available:
Draw a border: An area in the document can be specified for the image to be inserted.
Insert on new pages: Captured or selected images are inserted at the end of the document as new pages. A maximum of two images are inserted per page.
Selection dialog: A selection dialog is displayed where either “Draw a border” or “Insert on new pages” can be selected.
“Draw a border” is selected by default.
A maximum of one image can be captured or selected for the “Draw a border” option, irrespective of the source. A maximum of ten images per process can be inserted for the “Insert on new pages” option.
Original file
This setting specifies what happens to the original document (without changes) after it is archived (with changes).
The following options are available:
Delete original file: The open document will be deleted after it is archived, the app is closed, or another document is opened.
Do not delete original file: The open document will not be deleted after it is archived, the app is closed, or another document is opened.
Delete original file after archiving/saving: The open document will be deleted after it is archived. The open document will not be deleted after the app is closed or another document is opened.
“Delete original file after archiving/saving” is selected by default.
This option can only be changed if a document has not been opened.
Open file selection on archiving/saving
You can use this setting to specify whether the app is closed or the file selection (incoming folder) is shown after the signed document is saved. This option is disabled by default.
Send
This setting determines when sending/sharing of the document is permitted. You can choose from the following options:
Always permit: The document can be sent, for example by e-mail, at any time.
If all signature fields have been signed: The document can only be shared if all the document’s signature fields have been signed and the document no longer contains any empty signature fields. If this condition is not met, the button will be deactivated.
If all mandatory fields have been signed: The document can only be shared if all the document’s mandatory signature fields have been signed and the document no longer contains any empty mandatory fields. Optional signature fields do not have to be signed. If this condition is not met, the button will be deactivated.
“Always permit” is selected by default.
Notes only with stylus/S pen
This option specifies that notes may only be inserted with the Samsung “S Pen” stylus. If enabled, it is not possible to enter a signature using the touch function or using another stylus.
This option is disabled by default.
Permissions
In the permission settings, you can see which permissions have been allowed or denied.
Access to photos, media and files
This permission is required for use of the app as otherwise documents cannot be displayed, opened, edited and saved.
Access to the location
This permission is optional and is needed if the GPS coordinates are to be included in the properties of the signature.
Access to contacts
This permission is optional and is needed if the user name of the device is to be included in the properties of the signature.
Access to camera
This permission is optional and is needed if images or signatures with image data are to be inserted into the document.
Open app permissions
This button can be used to call up the Android settings in the app, in order to manage the permissions there for example.
Security
Access to the settings can be restricted in the security settings.
Protect settings by password
To protect the configuration from unauthorized access, password protection can be enabled for the settings. Only users who know the password can access the settings. This option is disabled by default.
Password
This is where the password for protecting the settings is set. There is no default entry here.