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:
-
Sprachauswahl: Deutsch oder Englisch
-
Willkommensdialog
-
Anzeige und Bestätigung des Endnutzer-Lizenzvertrags (EULA)
-
Anzeige und Bestätigung der Datenschutzerklärung
-
Auswahl des Installationsordners
-
Auswahl des Setuptyps: vollständig oder benutzerdefiniert
-
nur bei benutzerdefiniertem Setup: Auswahl der Features
-
Bestätigung zum Beginn der Installation
-
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:
-
Willkommensdialog
-
Auswahl:
-
Programm ändern
-
Programm reparieren
-
Programm entfernen
-
-
nur bei Programm ändern: Auswahl der Features
-
Bestätigung zum Beginn der Installation/Deinstallation
-
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:
signoAPI_x.x.x.exe /s /v"/qn"
Installation spezifischer Features
Um nur spezifische Features zu installieren, kann der Parameter “ADDLOCAL” verwendet werden.
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.
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.
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.
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) |