Breadcrumbs

signoAPI für Windows – Installation

Das signoAPI wird ausschließlich als ausführbare Installationsdatei (signoAPI_x.x.x.exe) per Download ausgeliefert. Die dialogbasierte Installation wird durch Ausführen der heruntergeladenen Installationsdatei gestartet. Die Installation erfordert lokale Administratorrechte und erfolgt über die Dialoge des InstallShield Wizard.

Features

Die folgenden Features sind im Setup enthalten und können einzeln an- oder abgewählt werden:

  • signoAPIComponents

  • SourceCode

    • SignPDFDemo

      • SignPDFDemoCSharp

      • SignPDFDemoCPlusPlus

    • STImgCtlDemoCSharp

    • signoMobileCaptureDemoCSharp

  • OnlineDocumentation

    • OnlineDocumentationEnglish

    • OnlineDocumentationGerman

Sollen zu einem späteren Zeitpunkt weitere Funktionen installiert werden, kann die Installation einfach durch erneutes Ausführen der Setup-Datei mit einer angepassten Installation wiederholt werden.

Installationsschritte

Die Installation des signoAPI beinhaltet folgende Schritte:

  1. Sprachauswahl: Deutsch oder Englisch

  2. Willkommensdialog

  3. Anzeige und Bestätigung des Endnutzer-Lizenzvertrags (EULA)

  4. Anzeige und Bestätigung der Datenschutzerklärung

  5. Auswahl des Installationsordners

  6. Auswahl des Setuptyps: vollständig oder benutzerdefiniert

  7. nur bei benutzerdefiniertem Setup: Auswahl der Features

  8. Bestätigung zum Beginn der Installation

  9. Installation abgeschlossen

Ändern oder Deinstallation

Durch erneutes Ausführen der Installationsdatei können Änderungen am signoAPI durchgeführt werden, zum Beispiel um weitere Features zu installieren oder um das signoAPI zu deinstallieren. Der Dialog enthält dann die folgenden Schritte:

  1. Willkommensdialog

  2. Auswahl:

    • Programm ändern

    • Programm reparieren

    • Programm entfernen

  3. nur bei Programm ändern: Auswahl der Features

  4. Bestätigung zum Beginn der Installation/Deinstallation

  5. Installation abgeschlossen

Silent Installation

Die Installation kann auch ohne Einblendung von Dialogfenstern und ohne Benutzerinteraktion durchgeführt werden. Dazu muss die Installationsdatei in der Kommandozeile (Eingabeaufforderung) mit dem Parameter “/s” aufgerufen werden. Weitere Einstellungen können mit zusätzlichen Parametern gesetzt werden.

Installation aller Features oder Update

Soll lediglich ein Update auf eine neue Version unter Beibehaltung der aktuellen Feature-Liste oder eine Erstinstallation mit allen Features durchgeführt werden, kann dafür der folgende Aufruf verwendet werden:

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

Installation spezifischer Features

Um nur spezifische Features zu installieren, kann der Parameter “ADDLOCAL” verwendet werden.

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

Installation ohne spezifische Features

Sollen nur spezifische Features nicht installiert werden, müssen zunächst mit “ADDLOCAL” alle Features hinzugefügt und dann mit “REMOVE” die gewünschten Features ausgeschlossen werden.

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

Nachträgliches Ändern der installierten Features

Um zu ändern, welche Features installiert sind, können der Parameter “ADDLOCAL” zum Hinzufügen und der Parameter “REMOVE” zum Entfernen verwendet werden.

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

Deinstallation

Zum Deinstallieren muss die Option “/x” zum Aufruf hinzugefügt werden.

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

Installation von Hand

Üblicherweise werden alle Dateien vom Installationsprogramm der signoAPI eingerichtet. Es ist aber auch möglich, einzelne Komponenten von Hand zu installieren. Dazu müssen unter Umständen Dateien im gleichen Verzeichnis mit der Basis-DLL abgelegt werden, und verschiedene Bibliotheken mit regsvr32 registriert werden. Die Details dazu finden sich jeweils in der Dokumentation der einzelnen Komponente.

Lizenzierung

Die signoAPI wird im unregistrierten Zustand ausgeliefert. Vor der Freischaltung sind manche Funktionen der signoAPI gar nicht verwendbar, andere nur eingeschränkt, zum Beispiel indem ein Demostempel in Bildern und PDF-Anzeigen eingefügt wird.

Für Fragen bezüglich des Erwerbs eines Lizenzschlüssels wenden Sie sich bitte an Ihren Kontakt bei signotec.

Es existieren zwei unterschiedliche Arten von Lizenzschlüsseln:

Hardwaregebundene Einzelplatzlizenzen

Bei Lizenzen dieses Typs wird bei der Installation ein Autorisationsschlüssel (Software Code) generiert. Dieser ist an bestimmte Komponenten der Hardware gebunden und ist immer nur für einen Rechner gültig (Einzelplatz).
Mittels des mitgelieferten Programms „Signotec-Lizenz.exe“ kann nach Erwerb einer Einzelplatzlizenz ein Lizenzschlüssel beantragt und eingetragen werden.
Ist ein gültiger Lizenzschlüssel vorhanden, so wird dieser in der Registry des Computers hinterlegt und alle Komponenten der signoAPI sind damit freigeschaltet und vom Demostempel befreit.

Hardwareunabhängige Unternehmenslizenzen

Bei Lizenzen dieses Typs handelt es sich um hardwareunabhängige Unternehmenslizenzen, die nicht an einen Rechner/Arbeitsplatz gebunden sind und bei der der Schlüssel nicht in der Registry hinterlegt wird.

Der Lizenzschlüssel muss programmatisch für jede verwendete Komponente zur Laufzeit gesetzt werden. Die Details sind jeweils in der Dokumentation der jeweiligen Komponente im Kapitel “Einrichtung” beschrieben.

32- und 64-Bit-Anwendungen

Die Komponenten und ihre Abhängigkeiten sind sowohl für 32 Bit (x86) als auch für 64 Bit (x64) verfügbar. Unter Windows 64 Bit können beide Varianten vom signoAPI-Setup parallel installiert werden.

Die x86-Variante kann sowohl auf 32 Bit- als auch auf 64 Bit-Versionen von Windows verwendet werden. Die x64-Variante kann ausschließlich auf 64 Bit-Versionen von Windows verwendet werden.

Da sich die beiden Varianten der Komponenten weder im Namen noch in der Schnittstelle unterscheiden, muss jeweils nur eine Variante referenziert werden.

Bei der Ausführung ist zu beachten, dass die Komponenten für die jeweilige Zielplattform im System registriert sind. In der folgenden Tabelle ist aufgeführt, welche Variante der Komponenten für bestimmte Betriebssystem- bzw. Anwendungsvarianten verwendet werden muss:

Betriebssystem

Anwendung

signotec-Komponente

x86 (32 Bit)

x86 (32 Bit)

x86 (32 Bit)

x64 (64 Bit)

nicht unterstützt

Any CPU

x86 (32 Bit)

Any CPU (32 Bit bevorzugen)

x86 (32 Bit)

x64 (64 Bit)

x86 (32 Bit)

x86 (32 Bit)

x64 (64 Bit)

x64 (64 Bit)

Any CPU

x64 (64 Bit)

Any CPU (32 Bit bevorzugen)

x86 (32 Bit)