Das MSI-Plug-in bietet die erforderliche Funktionalität zum Lesen von Informationen aus MSI-Paketen, ermöglicht die Validierung von MSI-Paketen anhand von ICE-Regelwerken und kann die in MSI-Paketen enthaltenen Dateien extrahieren.
Funktionsübersicht
Funktionsdetails
ExtractFiles
Extrahiert die Dateiressourcen aus einem MSI in einen temporären Ordner und gibt den Ordnernamen zurück.
Verwendbar in Kombination mit Elementen vom Typ Data Field.
Eingabeparameter |
||
Name |
Typ |
Beschreibung & Beispiele |
MSIFile |
Formatierter String |
Der Name und Pfad der MSI-Datei.
Beispiel: C:\Temp\Sample.msi |
ReUse Data |
Boolean-Zeichenfolge optional Standardwert: true |
Der Pfad zum Ordner, der die extrahierten Dateien enthält, wird durch den SHA-1-Hashwert der MSI-Datei bestimmt.
Optionen: •enabled: Wenn der temporäre Extraktionsordner bereits vorhanden ist, wird er wiederverwendet. •disabled: Der temporäre Extraktionsordner wird geleert, wenn er bereits vorhanden ist, und mit der aktuellen Menge extrahierter Dateien befüllt. |
MST File |
Formatierter String optional Standardwert: kein |
•Der Name und Pfad einer optionalen MST-Datei, die das MSI-Paket erweitern kann. •Mehrere Transformationsdateien können durch Kommas getrennt angegeben werden.
Beispiel: C:\Temp\German.mst |
GetProperty
Sucht den Wert einer Eigenschaft in einem MSI-Paket. Das bedeutet, dass gemäß dem angegebenen Eigenschaftsnamen der Inhalt der Wertspalte aus der Property-Tabelle der Installer-Datenbank abgefragt wird.
Verwendbar in Kombination mit Elementen vom Typ Data Field und Multi-Option.
Eingabeparameter |
||
Name |
Typ |
Beschreibung & Beispiele |
MSIFile |
Formatierter String |
Der Name und Pfad der MSI-Datei.
Beispiel: C:\Temp\RayEval.msi |
MSTFile |
Formatierter String optional Standardwert: kein |
•Der Name und Pfad einer optionalen MST-Datei, die das MSI-Paket erweitern kann. •Mehrere Transformationsdateien können durch Kommas getrennt angegeben werden.
Beispiel: C:\Temp\German.mst |
Property |
Zeichenfolge |
Name der Eigenschaft, deren Wert abgerufen werden soll.
Beispiel: Manufacturer |
GetSummaryInfo
Ruft ein Attribut aus dem Summary-Information-Stream eines MSI-Pakets ab.
Verwendbar in Kombination mit Elementen vom Typ Data Field und Multi-Option.
Eingabeparameter |
||
Name |
Typ |
Beschreibung & Beispiele |
MSIFile |
Formatierter String |
Der Name und Pfad der MSI-Datei.
Beispiel: C:\Temp\RayEval.msi |
MSTFile |
Formatierter String optional Standardwert: kein |
•Der Name und Pfad einer optionalen MST-Datei, die das MSI-Paket erweitern kann. •Mehrere Transformationsdateien können durch Kommas getrennt angegeben werden.
Beispiel: C:\Temp\German.mst |
Attribute |
Zeichenfolge |
Name des Attributs, dessen Wert abgerufen werden soll. Dieser Parameter muss aus dem standardmäßigen Pool von Attributen ausgewählt werden:
Optionen: •Author •Comments •CreatingApp •Keywords •LastSavedBy •RevisionNumber •Subject •Template •Title •CharacterCount •CodePage •CreateTime •LastPrintTime •LastSaveTime •PageCount •Security •WordCount |
Date/Time Format |
Formatierter String optional Standardwert: dd.MM.yyyy HH:mm:ss |
Wenn das angeforderte Attribut ein Datum oder eine Datum-Uhrzeit-Kombination ist, wird das ausgewählte Formatschema angewendet.
Optionen: •d.MM.yyyy HH:mm:ss •dd.MM.yyyy •MM/dd/yyyy HH:mm:ss •MM/dd/yyyy |
IceValidation
Validiert ein MSI-Paket durch Ausführung der Prüfungen, die durch die Regeln der parametrisierten CUB-Datei definiert werden.
Verwendbar in Kombination mit Elementen vom Typ Checkpoint.
Eingabeparameter |
||
Name |
Typ |
Beschreibung & Beispiele |
MSI File |
Formatierter String |
Der Name und Pfad der MSI-Datei.
Beispiel: C:\Temp\RayEval.msi |
MST File |
Formatierter String optional Standardwert: kein |
•Der Name und Pfad einer optionalen MST-Datei, die das MSI-Paket erweitern kann. •Mehrere Transformationsdateien können durch Kommas getrennt angegeben werden.
Beispiel: C:\Temp\German.mst |
Cub Filename |
Formatierter String |
Der Name und Pfad der CUB-Datei, die die Regeln zur Validierung der MSI enthält.
Beispiel: C:\Temp\Darice.cub |
Suppressed Checks |
Formatierter String optional Standardwert: kein |
Kommagetrennte Liste von ICE-Regelnamen, die in der CUB-Datei vorhanden sind, aber nicht während der Validierung angewendet werden sollen.
Beispiel: ICE01,ICE33,ICE64 |
MaxWarnings |
Ganzzahl optional Standardwert: -1 |
Maximale Anzahl von Warnungen, die während der ICE-Validierung auftreten dürfen, ohne dass das Plug-in-Ergebnis auf „falsch" gesetzt wird.
Optionen: •-1: Die Anzahl der während der ICE-Validierung auftretenden Warnungen hat keinen Einfluss auf das Checkpoint-Ergebnis. •0: Jede CUB-Regelauswertung, die eine Warnung ergibt, führt dazu, dass das Plug-in-Ergebnis auf „falsch" gesetzt wird. •Any other integer > 0: Solange die Anzahl der während der ICE-Validierung auftretenden Warnungen unter dem eingegebenen Wert liegt, wertet das Checkpoint-Ergebnis als „wahr" aus. |
MaxErrors |
Ganzzahl optional Standardwert: 0 |
Maximale Anzahl von Fehlern, die während der ICE-Validierung auftreten dürfen, ohne dass das Plug-in-Ergebnis auf „falsch" gesetzt wird.
Optionen: •-1: Die Anzahl der während der ICE-Validierung auftretenden Fehler hat keinen Einfluss auf das Checkpoint-Ergebnis. •0: Jede CUB-Regelauswertung, die einen Fehler ergibt, führt dazu, dass das Plug-in-Ergebnis auf „falsch" gesetzt wird. •Any other integer > 0: Solange die Anzahl der während der ICE-Validierung auftretenden Fehler unter dem eingegebenen Wert liegt, wertet das Checkpoint-Ergebnis als „wahr" aus. |
Query
Führt eine Leseabfrage auf der Installer-Datenbank aus. Das Standard-Abfrageschema ist wie folgt definiert:
SELECT item FROM table WHERE key = value
Bitte beachten Sie, dass der unterstützte Satz von SQL-Operatoren und Sprachkonstrukten für Installer-Datenbankabfragen eingeschränkt ist, weshalb die Abfragefunktion auf eine einfache SELECT-Anweisung beschränkt ist.
Die Ergebnismenge der Abfrageausführung kann 0, 1 oder mehrere Datenobjekte enthalten.
Verwendbar in Kombination mit Elementen vom Typ Data Field und Multi-Option.
Eingabeparameter |
||
Name |
Typ |
Beschreibung & Beispiele |
MSIFile |
Formatierter String |
Der Name und Pfad der MSI-Datei.
Beispiel: C:\Temp\RayEval.msi |
MSTFile |
Formatierter String optional Standardwert: kein |
•Der Name und Pfad einer optionalen MST-Datei, die das MSI-Paket erweitern kann. •Mehrere Transformationsdateien können durch Kommas getrennt angegeben werden.
Beispiel: C:\Temp\German.mst |
Select |
Zeichenfolge |
SQL-Ausdruck, der die Datenspalte bestimmt, die aus der Installer-Datenbank abgerufen werden soll.
Beispiel: Action |
From |
Zeichenfolge |
SQL-Ausdruck, der die Tabelle bestimmt, die die abzurufenden Informationen enthält.
Beispiel: CustomAction |
Where |
Zeichenfolge optional Standardwert: kein |
SQL-Ausdruck, der eine Datenspalte bestimmt, die als Grundlage für die gleichheitsbasierte Ergebnismengenfilterung verwendet wird. Wenn der Equals-Parameter nicht leer ist, muss auch Where angegeben werden.
Beispiel: Type |
Equals |
Zeichenfolge optional Standardwert: kein |
Wert, der zur Filterung der Abfrageergebnismenge verwendet wird. Er muss in der durch den Where-Parameter angegebenen Spalte vorhanden sein. Wenn der Where-Parameter nicht leer ist, muss auch Equals angegeben werden.
Beispiel: 19 |