Erfolgreiche ePaper selbst erstellen
Machen Sie aus Ihren PDF Publikationen ein blätterbares Flipbook mit unserer einzigartigen Google optimierten e-Paper Software.
<strong>opsi</strong>-<strong>winst</strong> <strong>Handbuch</strong><br />
6.3.13 (String-) Funktionen für die Lizenzverwaltung<br />
27 / 93<br />
• DemandLicenseKey(‘poolId [, productId [,windowsSoftwareId]])‘<br />
Über die <strong>opsi</strong>-Webservicefunktion getAndAssignSoftwareLicenseKey wird vom <strong>opsi</strong> Service abgefragt, ob es für den<br />
Computer eine reservierte Lizenz gibt.<br />
Die Datenbasis auf Grund deren die Lizenzen vergeben werden, kann die Computer ID sein, die Produkt ID oder die<br />
Windows Software ID (diese Möglichkeiten bestehen, wenn diese Vorgaben in der Lizenzkonfiguration definiert ist).<br />
poolId, productId, windowsSoftwareId sind Strings (bzw. String-Ausdrücke). Wenn die licensePoolId nicht explizit<br />
gesetzt ist, bleibt der erste Parameter ein leerer String "". Das gilt auch für die anderen IDs – sofern diese nicht näher<br />
definiert werden.<br />
Die Funktion gibt den Lizenzschlüssel zurück, der aus der Datenbasis ausgewählt wurde.<br />
Beispiele:<br />
set $mykey$ = DemandLicenseKey ("pool_office2007")<br />
set $mykey$ = DemandLicenseKey ("", "office2007")<br />
set $mykey$ = DemandLicenseKey ("", "", "{3248F0A8-6813-11D6-A77B}")<br />
• FreeLicenseKey (‘poolId [, productId [,windowsSoftwareId]]])‘<br />
Über die Funktion freeSoftwareLicenseKey des <strong>opsi</strong> Services wird die aktuell belegte Lizenz frei gegeben. Diese<br />
Syntax ist analog zum Syntax DemandLicenseKey zu sehen: Beispiel:<br />
DefVar $<strong>opsi</strong>result$<br />
set $<strong>opsi</strong>result$ = FreeLicenseKey ("pool_office2007")<br />
$<strong>opsi</strong>result$ wird zu einem leeren String umgesetzt, wenn kein Fehler auftritt und wenn eine Fehler auftritt, wird der<br />
Fehlertext ausgegeben.<br />
6.3.14 Abrufen der Fehlerinformationen von Serviceaufrufen<br />
• getLastServiceErrorClass<br />
liefert einen String zurück, welcher den Namen der Fehlerklasse des letzten Serviceaufrufs zurück. Wenn der letzte<br />
Serviceaufruf keine Fehlermeldung verursacht hat, gibt die Funktion den Wert "None" zurück.<br />
• getLastServiceErrorMessage<br />
liefert einen String zurück, welcher die Fehlermeldung des letzten Serviceaufrufs entspricht. Wenn der letzte Serviceaufruf<br />
keine Fehlermeldung verursacht hat, gibt die Funktion den Wert "None" zurück.<br />
Da die Nachrichtenstrings sich immer mal wieder ändern, wird für die Logik des Grundskriptes die Verwendung des<br />
Klassennamen empfohlen.<br />
Beispiel:<br />
if getLastServiceErrorClass = "None"<br />
comment "kein Fehler aufgetreten"<br />
endif