signoAPI for Windows – Installation

The signoAPI is supplied exclusively as an executable installation file (signoAPI_x.x.x.exe) via download. The dialog-based installation is started by executing the downloaded installation file. The installation requires local administrator rights and is carried out via the InstallShield wizard dialogs.

Features

The following features are included in the setup and can be selected or deselected individually:

• signoAPIComponents

  • SignPDF3

  • STImgCtl

  • signcap

  • signview

  • signoMobileCapture

• SourceCode

  • SignPDFDemo

    • SignPDFDemoCSharp

    • SignPDFDemoCPlusPlus

  • STImgCtlDemoCSharp

  • signoMobileCaptureDemoCSharp

• OnlineDocumentation

  • OnlineDocumentationEnglish

  • OnlineDocumentationGerman

Installation steps

The installation of signoAPI involves the following steps:

1. Language selection: German or English

2. Welcome dialog

3. Display and confirmation of the end user licence agreement (EULA)

4. Display and confirmation of the privacy policy

5. Selection of the installation folder

6. Selection of the setup type: full or custom

7. Only for custom setup: Selection of features

8. Confirmation of the start of the installation

9. Installation completed

Modify or uninstall

By running the installation file again, changes can be made to signoAPI, for example to install additional features or to uninstall signoAPI. The dialog then contains the following steps:

1. Welcome dialog

2. Selection:

   • Change program

   • Repair program

   • Remove program

3. Only for changing the program: Selection of features

4. Confirmation to start installation/uninstallation

5. Installation completed

Silent installation

The installation can also be performed without displaying dialog boxes and without user interaction. To do this, the installation file must be called in the command line (command prompt) with the parameter “/s". Additional settings can be configured using additional parameters.

Installation of all features or update

If you only want to update to a new version while retaining the current feature list, or perform an initial installation with all features, run the following command:

signoAPI_x.x.x.exe /s /v"/qn"

Installation of specific features

To install only specific features, the “ADDLOCAL” parameter can be used.

signoAPI_x.x.x.exe /s /v"ADDLOCAL=SignPDF3,STImgCtl /qn"

Installation without specific features

If only specific features are not to be installed, first add all features with “ADDLOCAL” and then use “REMOVE” to exclude the desired features.

signoAPI_x.x.x.exe /s /v" ADDLOCAL=ALL REMOVE=OnlineDocumentationGerman,signoMobileCapture,STImgCtlDemo /qn"

Changing the installed features at a later time

To change which features are installed, you can use the “ADDLOCAL” parameter to add features and the “REMOVE” parameter to remove them.

signoAPI_x.x.x.exe /s /v"ADDLOCAL=OnlineDocumentationEnglish REMOVE=signcap,signview /qn"

Uninstallation

To uninstall, the option “/x” must be added to the call.

signoAPI_x.x.x.exe /s /x /v"/qn"

Manual installation

Usually, all files are set up by the signoAPI installation program. However, it is also possible to install individual components manually. To do this, files may need to be stored in the same directory as the base DLL, and various libraries may need to be registered with regsvr32. Details can be found in the documentation for each individual component.

Licensing

The signoAPI is delivered in an unregistered state. Before activation, some signoAPI functions cannot be used at all, while others are restricted, for example with a demo stamp inserted in images and PDF displays.

If you have any questions regarding the acquisition of a licence key, please speak to your signotec contact.

There are two different types of licence keys:

Hardware-dependent single-user licences

For licences of this type, an authorization key (software code) is generated during installation. This is linked to specific hardware components and is only valid for one computer (single user).
After you have purchased a single-user licence, you can request a licence key and enter it using the “Signotec-Lizenz.exe” program provided.
If a valid licence key is available, it is stored in the computer’s registry and all components of the signoAPI are activated, with the demo stamp removed.

Hardware-independent company licences

Licenses of this type are hardware-independent company licences that are not bound to one particular computer/workstation and whose keys are not stored in the registry.

The licence key must be set programmatically for each component used at runtime. The details are described in the documentation for each component in the “Setup” chapter.

32-bit and 64-bit applications

The components and their dependencies are available for both 32-bit (x86) and 64-bit (x64). Windows 64-bit allows parallel installation of both versions of the signoAPI setup.

The x86 version can be used on both 32-bit and 64-bit versions of Windows. The x64 version can only be used on 64-bit versions of Windows.

Since the two versions of the components do not differ in name or interface, only one version has to be referenced.

When running the components, it must be ensured that the components are registered for the relevant target platform in the system. The following table shows which version of the components must be used for specific operating system and application versions: