1.2 Funktionen

1.2 Funktionen

Es gibt 5 unterschiedliche Funktionsarten:

Standardfunktionen

Diese Funktionen gehören zum Funktionsumfang des IPS-Kernsystems und stellen die Voraussetzung für die STP- und infraSetupFunktion. Debug-Funktionen gehören zu den Standardfunktionen

STPFunktionen

STPFunktionen stehen nur zur Verfügung, wenn sie mit Hilfe von #UseDllExtension=infraStp.dll geladen werden.

XML-Funktionen

XML-Funktionen stehen nur zur Verfügung, wenn sie mit Hilfe von #UseDllExtension=ipsxml.dll geladen werden.

infraSetupFunktion

Diese Funktionen stehen nur zur Verfügung, wenn das IPS-Kernsystem von der InstallEngine geladen wurde.

Diese Funktionsart steht nicht in den Unterskripten zur Verfügung.

Werden sie dennoch verwendet gab es eine Syntax - Fehlermeldung.

Folgende InfraSetupFunktionen können zwar auch nicht in Unterskripten verwendet werden, erzeugen aber keinen Syntaxfehler beim Parsen:

GlobCreateString	GlobUpdateString	GlobCreateLong
GlobUpdateLong	GlobCreateDouble	GlobUpdateDouble
InitInfraSysMsg	QuerySizeInfo	RemoveLastBackSlash
CreateSecString	PatchBinaryFile	ReadBinaryFile
WriteBinaryFile	AppendToBinaryFile	MergeBinaryFile
PatchDD	MoveFiles

infraSetupVariablen

Neben den infraSetupFunktionen existieren auch einige globale Variablen ausschließlich im Kontext der InstallEngine und nicht bei der Skript-Ausführung aus infra:

str$TARGETDIR	Zielpfad der Installation
str$WORKINGDIR	Arbeitsverzeichnis, aus dem Setup gestartet wurde (kann sich im Setup-Verlauf ändern)
str$SOURCEDSK	Laufwerk, auf dem sich Setup.exe befindet
str$SOURCEDIR	Verzeichnis, in dem sich Setup.exe befindet
str$SUPPORTDIR	Temporäres Verzeichnis, in dem das Setup-System entpackt wurde
str$WINDIR	Windows-Verzeichnis
str$WINSYSDIR	Windows-System32-Verzeichnis
str$SETUPTYPE	Aktueller Installationstyp
str$USERNAME	Windows Benutzername
str$INFRANeedVersion	Angaben „INFRANeedVersion“ aus infupd.ini
str$INFRAVersion	Angabe „INFRAVersion“ aus infupd.ini
str$INFRAKeepVersion	Angabe „INFRAKeepVersion“ aus infupd.ini
str$INFRASetupLogFile	Von Setup verwendete LOG-Datei
str$CommandLine	Beim Aufruf von Setup angegbene Parameter
str$ActualScriptFile	Aktuelle Script-Datei

Dialogfunktion

Die Funktionsart „Dialogfunktion“ ist in ACIPSDLG.DLL implementiert.

Diese DLL muss mit #UseDllExtension=ACIPSDLG.DLL in dem Skript geladen werden, in dem die Dialogfunktionen benutzt werden.

Die Dialogfunktionen können auch in den Unterskripten ausgeführt werden, wenn das Unterskript aus dem Skriptteil aufgerufen wird, in dem die Anweisung #UseDllExtension=ACIPSDLG.DLL steht.

IpsGuiFunktionen

Die Funktionsart „IpsGuiFunktionen“ steht nur in Verbindung mit den Programmen 9994Datenmanipulationen über STP-Dateien" bzw. "449 Kundenaufträge mit IPS übernehmen", das im Standard nicht enthalten ist, zur Verfügung.

1.2.1 #UseDllExtension= - Laden von erweitertem Funktionsumfang

1.2.2 Abort – Abbruch einer Installation

1.2.3 AbortEnd – Abbruch einer Installation durch Skripter

1.2.4 AbortLoop – Installation nochmals von Anfang

1.2.5 AddFolderIcon – Anlegen eines Ordners für Programmsymbole

1.2.6 AddLong/AddDouble – Addition für numerische Werte

1.2.7 AddIniString – Hinzufügen eines IniFileWertes

1.2.8 AddString – Addition für String Werte

1.2.9 AppendLF – Anhängen von LF an Stringvariable

1.2.10 AppendString – Strings verketten

1.2.11 AppendToBinaryFile – Buffer an Datei hängen

1.2.12 AppendToPath – Verzeichnispfade verketten

1.2.13 AskDestPath – Dialog zur Auswahl eines Pfades

1.2.14 AskOptions Dialog mit variabler Anzahl Optionen

1.2.15 AskOptionsWD –Dialog mit variabler (max. 5) Anzahl Optionen mit Text

1.2.16 AskText – Dialog für freie Eingabe

1.2.17 AskYesNo – MessageBox mit Fragecharakter

1.2.18 AssignLong/AssignDouble – Wert zuweisen

1.2.19 AssignString – String Variable Wert zuweisen

1.2.20 AssignStringLen - String erstellen und Wert zuweisen

1.2.21 BatchAdd – Zeile in Batch hinzufügen

1.2.22 BatchFileLoad – Batchdatei laden

1.2.23 BatchFileSave – Batchdatei speichern

1.2.24 BatchFind – Zeile in Autoexec.bat einfügen

1.2.25 BufAddParam – speichert zusätzliche Steuerparameter bei einem Buffer

1.2.26 BufAppendFromDouble - hängt an Buffer formatierte Double an

1.2.27 BufAppendFromLong - hängt an Buffer eine formatierte Zahl (Long) an

1.2.28 BufAppendFromString - hängt an Buffer formatierten String an

1.2.29 BufAssignStringAtPIS –Buffer ab PIS initialisieren

1.2.30 BufCopyFieldAtPIS - formatiertes Feld in Buffer schreiben

1.2.31 BufCreateBuffer – Erstellen eines Buffer

1.2.32 BufCopyField – Feld von Buffer zu Buffer

1.2.33 BufDeleteBuffer – Löschen eines Buffers

1.2.34 BufFetchNext – Lese nächste Datensatz

1.2.35 BufGetError – Abfrage des Errorcodes des letzten Befehls

1.2.36 BufInsertBuffer – Insert Buffer in Datenbank

1.2.37 BufIsLockedBuffer – Ist Buffer gelockt

1.2.38 BufIsGlobalLocked – Ist Buffer gelockt

1.2.39 BufLockBuffer – Lock Buffer

1.2.40 BufLockISNBuffer – Lock Buffer über ISN

1.2.41 BufQueryDoubleFromField – Lese Doublewert aus Buffer

1.2.42 BufQueryLongFromField – Lese Long aus Buffer

1.2.43 BufQueryStringFromField – Lese String aus Buffer

1.2.44 BufQueryStringFromPIS – String ab PIS aus Buffer lesen

1.2.45 BufRemoveBuffer – Enferne Buffer aus ASB

1.2.46 BufRestoreBuffer – Wiederherstellen des Buffers

1.2.47 BufSaveBuffer – Sichern des Buffers

1.2.48 BufSelectBuffer – Lesen eines Satzes aus der Datenbank

1.2.49 BufSelectLookupRecord – Weiteren Satz lesen

1.2.50 BufSetErrorLevel – Abbruch bei schweren Fehlern verhindern

1.2.51 BufSetFieldFromDouble – Double in Buffer schreiben

1.2.52 BufSetFieldFromLong – Long in Buffer schreiben

1.2.53 BufSetFieldFromString - String in Buffer schreiben

1.2.54 BufSetFieldFromStringPos – Einfügen Substring in Feld

1.2.55 BufSetFormatFromDoubleAtPIS - formatierte Zahl (Double) in Buffer

1.2.56 BufSetFormatFromLongAtPIS - formatierte Zahl (Long) in Buffer

1.2.57 BufSetFormatFromStringAtPIS - formatierten String in Buffer schreiben

1.2.58 BufSetKey, BufAddKey – Setzen der Schlüssel für DBZugriff

1.2.59 BufSetStringAtPIS – String in Buffer ab PIS abstellen

1.2.60 BufSyncApplBuffer – Arbeitsbereich in Buffer kopieren

1.2.61 BufUnlockBuffer – Lock wieder aufheben

1.2.62 BufUpdateBuffer – Update Datensatz in Datenbank

1.2.63 BufUseAssocBuffer – Assoziiere Buffer

1.2.64 ChangeDirectory – Verzeichnis wechseln

1.2.65 CreateDir – Verzeichnis anlegen

1.2.66 CreateSecString – Erstellt einen Zufallsstring

1.2.67 Debug – Debuggen von Teilen des Skriptes

1.2.68 DeleteFolderIcon – Löscht Symbole im Startmenü

1.2.69 DbsOpenTable – Öffnet eine infra-Datenbank

1.2.70 DbsCloseTable – Schließt eine infra-Datenbank

1.2.71 DbsConnect - Verbinden zur Datenbank

1.2.72 DbsCountUsers – Anzahl angemeldeter User

1.2.73 DbsCSCountSessions – Anzahl am DB-Server angemeldeter Sessions

1.2.74 DbsFilReadRecord – Satz über ISN (1=Vorbelegungssatz) lesen

1.2.75 DbsFilWriteRecord – Satz über ISN (1=Vorbelegungssatz) schreiben

1.2.76 DbsInitAccess – Vorbelegung Variablen für DB-Zugriff

1.2.77 DbsLockX, DbsUnLockX – Sperren/Entsperren

1.2.78 DecLong/DecDouble Decrement

1.2.79 Delay – Programmausführung verzögern

1.2.80 DeleteDir – Verzeichnis löschen

1.2.81 DivLong/DivDouble Dividieren

1.2.82 DlgSimpleInput - Einzeiliger Eingabedialog

1.2.83 DlgSchedule - Dialog zur Eingabe der Skriptweiterführung

1.2.84 DlgMessageBox( strText, strHead );

1.2.85 DlgShowDialog – Dialog für die Anzeige von Text

1.2.86 Double – Deklariere Doublevariable

1.2.87 DoubleToString - Double in String umwandeln

1.2.88 Exit – Teilskript beenden

1.2.89 ExitEndSetup – Teilskript ohne ‚ATEND’ beenden

1.2.90 ExistsDir – Verzeichnisexistenz abfragen

1.2.91 ExistsDisk – Laufwerksexistenz abfragen

1.2.92 FileOpen – Öffne eine Datei

1.2.93 FileClose- Schließen einer Datei

1.2.94 FileRead – Lesen aus einer Datei

1.2.95 FileWrite – Schreibe in eine Datei

1.2.96 FindAllFiles – Suche von Dateien

1.2.97 GetDiskSpace – Freier Speicherplatz einer Festplatte

1.2.98 GetEnvVar – Liest Umgebungsvariable

1.2.99 GetIniString - Lesen eines IniFileWertes

1.2.100 GetIniToDouble - Double aus SIBPPS.INI versorgen

1.2.101 GetIniToLong - Long aus SIBPPS.INI versorgen

1.2.102 GetIniToString - String aus SIBPPS.INI versorgen

1.2.103 GetListItem – komma-separierte Werte aus String auslesen

1.2.104 GlobCreateLong – Anlegen globaler Longs

1.2.105 GlobCreateString – Anlegen globaler Strings

1.2.106 GlobUpdateLong - Updaten globaler Longs

1.2.107 GlobUpdateString – Updaten globaler Strings

1.2.108 if else – Fallunterscheidungen im Skript

1.2.109 infraMacroString – infra-Makros ausführen, Wert zurückliefern

1.2.110 InitinfraSysMsg - Initialisierung infraMessages

1.2.111 InternalInfo – Interne Informationen ausgeben

1.2.112 IpsSetErrorOutputLevel – Setzen der Fehlerausgabe

1.2.113 IsInString – Existenz eines Substrings in einem String prüfen

1.2.114 IncLong/IncDouble Increment

1.2.115 Jump – Sprung auf Label

1.2.116 Label – Label für Sprungmarken

1.2.117 LaunchApp – Externe Anwendung asynchron starten

1.2.118 LaunchAppAndWait – Externe Anwendung synchron starten

1.2.119 Long – Deklariere Longvalue

1.2.120 LongPathFromShortPath – c:\langer~1 nach c:\langer Pfad

1.2.121 LongPathToShortPath– c:\langer Pfad nach c:\lange~1

1.2.122 LongPathToQuote– c:\langer Pfad nach „c:\langer Pfad“

1.2.123 LongToString - Long in String umwandeln

1.2.124 MergeBinaryFile – Aus zwei Dateien eine erstellen

1.2.125 MessageBox – Meldungsfenster ausgeben

1.2.126 MessageBoxNr – Meldungsfenster ausgeben

1.2.127 MessageBoxError – Meldungsfenster ausgeben

1.2.128 MLActivateChannel – Druckkanal aktivieren/deaktivieren

1.2.129 MLActivatePrint – Druckausgabe ein- oder ausschalten

1.2.130 MLClose – Dokument fertigstellen/Druckausgabe beenden

1.2.131 MLOpen – Druckkanal öffnen/Ausgabe vorbereiten

1.2.132 MLPrint – Drucktabelle ausgeben

1.2.133 MLQueryChannelState – Druckkanal-Status abfragen

1.2.134 MLQueryPrintState – Druck-Status abfragen

1.2.135 MLSaveMedia – Druckkanal-Einstellungen speichern

1.2.136 MLRestoreMedia – Druckkanal-Einstellungen wieder herstellen

1.2.137 MonitorDouble – Beobachten von Double Variablen zur Laufzeit

1.2.138 MonitorLong – Beobachten von Long Variablen zur Laufzeit

1.2.139 MonitorString – Beobachten von String Variablen zur Laufzeit

1.2.140 ModLong - Modula

1.2.141 MulLong/MulDouble - Multiplizieren

1.2.142 MoveFiles – Verschiebt Dateien und Verzeichnisse

1.2.143 OptionsButtons

1.2.144 OsiCopyFile, Kopiert eine Datei

1.2.145 OsiDeleteFile, Eine Datei löschen

1.2.146 OsiFindFirstFile, Eine Datei suchen

1.2.147 OsiFindNextFile, Eine Datei suchen

1.2.148 OsiLaunchProcess, Externe Anwendung asyncron starten

1.2.149 OsiLaunchProcessWait, Externe Anwendung syncron starten

1.2.150 OsiMakeDirectory, Verzeichnis erzeugen

1.2.151 OsiMessageBox

1.2.152 OsiQueryOSInfo, Lesen von Betriebssystemversion

1.2.153 PatchBinaryFile – Platzhalter in binärer Datei ersetzen

1.2.154 PatchDD - DataDictionnary anpassen

1.2.155 PatchINIFile – INI-Datei patchen

1.2.156 ProgDefGroupType – Vorfunktion für AddFolderIcon

1.2.157 QuerySizeInfo – Datenmenge ermitteln

1.2.158 ReadBinaryFile – Ausschnitt einer Binärdatei lesen

1.2.159 RegDBCreateKeyEx – Schlüssel in der Registry anlegen

1.2.160 RegDBDeleteKey – Schlüssel in der Registry löschen

1.2.161 RegDBGetKeyValueEx – Schlüsselwert in der Registry abfragen

1.2.162 RegDBSetDefaultRoot – RootKey für die Registryfunktionen setzen

1.2.163 RegDBSetKeyValueEx – Schlüsselwert in der Registry setzen

1.2.164 RemoveLastBackSlash – Entferne letztes ‚\’

1.2.165 RunInstallShieldFunctions – InstallEngine Direktaufruf

1.2.166 RunScript – Skriptaufruf aus Skript

1.2.167 SaveFile – Sichert Dateien

1.2.168 SCopyFiles – Dateien kopieren

1.2.169 SDeleteFiles – Dateien löschen

1.2.170 SdShowMsg – Temporäre Mitteilung zeigen

1.2.171 SetDoublePrecision – Ändern der Nachkommastellen

1.2.172 SetFolderList – Setzen der Startmenüs (im Standard nicht verwendet)

1.2.173 SetInstallComponents – Setzen der zu installierenden Komponenten

1.2.174 SetStringAt – Substring in einen String kopieren

1.2.175 SetupTypeOptions – Definiert die zu installierenden Komponenten

1.2.176 SGetFileInfo – Dateiinformationen ermitteln

1.2.177 StpGwINIRead – Auslesen der GwINI - Dateien

1.2.178 StpGwINIReadAt – Auslesen der GwINI - Dateien

1.2.179 StpGwINIUpd – Update der Schlüssel in GwINI - Dateien

1.2.180 StpGwINIDel – Löschen von Schlüsseln in GwINI - Dateien

1.2.181 StpGwINISave – Schreiben der Änderungen in die GwINI - Dateien

1.2.182 String – Deklariere String

1.2.183 StringAscToIso

1.2.184 StringFormatFromDouble - Double in String formatieren

1.2.185 StringFormatFromLong - Long in String formatieren

1.2.186 StringFormatFromString - Stringinhalt formatieren

1.2.187 StringIsoToAsc

1.2.188 StringIsSpace –String auf Leerzeichen prüfen

1.2.189 StringLen – Stringlänge ermitteln

1.2.190 StringReplace

1.2.191 StringReplaceAsc – Zeichen über dezimalen Wert tauschen

1.2.192 StringReplacePattern – Zeichen in String ersetzen

1.2.193 StringToDouble - String in Zahl (Double) umwandeln

1.2.194 StringToLong - String in Zahl (Long) umwandeln

1.2.195 StringToLower

1.2.196 StringToUpper – Kleinbuchstaben durch Großbuchstaben ersetzen

1.2.197 StringTrim

1.2.198 StringTrimLeft

1.2.199 StringTrimRight

1.2.200 SubLong/SubDouble – Subtrahiere

1.2.201 SubString – Substring aus einem Stringabschnitt bilden

1.2.202 SUpdateSysFile – Systemdatei ersetzen

1.2.203 SWriteFile – Textdatei erzeugen oder erweitern

1.2.204 SXCopyFiles – Dateien kopieren

1.2.205 Today - Systemdatum holen

1.2.206 VerCompare – Vergleichen zweier Versionstrings

1.2.207 WriteBinaryFile – Ausschnitt in Binärdatei schreiben

1.2.208 WriteIniString – Schreiben eines IniFileWertes