Um eine Custom Action in der Ansicht CUSTOM ACTIONS im Advanced-Modus zu bearbeiten, müssen die aktuellen Einstellungen in den Detailbereich auf der rechten Seite geladen werden. Dazu wählen Benutzer die Custom Action aus der Listenansicht auf der linken Seite aus.
Wenn die kachelbasierte Detailansicht aktiv ist, können Benutzer einige der Custom-Action-Einstellungen direkt bearbeiten, indem sie auf die Kachel klicken, die die aktuelle Einstellung anzeigt. Bei allen Kacheln, die unten eine Reihe von Zustandsrechtecken anzeigen, z. B. Ausführungsmodus und Verhalten wie links dargestellt, können die verschiedenen Optionen durch einfaches Klicken auf die Kachel festgelegt werden, bis der gewünschte Wert angezeigt wird.
Um auf den vollständigen Satz von Custom-Action-Eigenschaften zur Bearbeitung zuzugreifen, müssen Benutzer auf die schwarze Titelkachel klicken. Der Dialog CUSTOM ACTION PROPERTIES wird angezeigt.
Wenn die tabellenbasierte Detailansicht aktiv ist, müssen Benutzer die Schaltfläche „Diese Custom Action bearbeiten" verwenden, um den Dialog CUSTOM ACTION PROPERTIES anzuzeigen.
Der Dialog CUSTOM ACTION PROPERTIES
Der Dialog für Custom-Action-Eigenschaften ermöglicht es Packagern, den vollständigen Bereich der Einstellungen für das Custom-Action-Objekt zu verwalten. Der Dialog ist in folgende Registerkarten unterteilt:
•General – Einstellungen für Name, Ausführungsmodus und aktivitätsbezogenes Verhalten ändern
•PROCESSING AND EXECUTION – Einstellungen für Ausführungsmodus, Patch-Optionen und ausführungsbezogenes Verhalten ändern
Der Dialog zeigt in der unteren rechten Ecke eine Reihe von Schaltflächen, mit denen Benutzer:
•Änderungen speichern und den Dialog durch Klicken auf die Schaltfläche OK schließen können
•Änderungen mit APPLY übernehmen können, während der Dialog geöffnet bleibt
•Den Dialog mit CLOSE schließen können, ohne die Änderungen zu speichern
Registerkarte: GENERAL
Name
Der Name der Custom Action darf nicht leer sein, muss innerhalb des Packaging-Projekts eindeutig sein und sollte keine Sonderzeichen enthalten. Achten Sie darauf, einen Namen zu verwenden, der die Absicht und den Zweck der Custom Action schnell erkennbar macht. Bedenken Sie, dass Abkürzungen später schwer zu erinnern sein können und dass andere Packager, die Ihr Packaging-Projekt in Zukunft möglicherweise bearbeiten müssen, diese möglicherweise nicht kennen.
Run Mode
•Immediate – Custom Actions, die Eigenschaften, Feature-Zustände, Komponentenzustände oder Zielverzeichnisse festlegen oder Systemoperationen durch Einfügen von Zeilen in Sequenztabellen planen, können in vielen Fällen sicher mit sofortiger Ausführung verwendet werden.
•Deferred – Custom Actions, die das System direkt ändern oder einen anderen Systemdienst aufrufen, müssen auf den Zeitpunkt verschoben werden, zu dem das Installationsskript ausgeführt wird.
•Rollback – Die Rollback-Prozedur wird zur Bereinigung ausgeführt, wenn eine Installation fehlschlägt. Custom Actions, die für die Ausführung während des Rollbacks markiert sind, werden während der primären Installation nicht ausgeführt.
•Commit – Die Commit-Prozedur wird ausgeführt, um erfolgreiche Installationen abzuschließen. Eine Commit-Custom-Action ist das Gegenstück zu einer Rollback-Custom-Action und kann zusammen mit Rollback-Custom-Actions verwendet werden, um Custom Actions rückgängig zu machen, die direkte Änderungen am System vornehmen.
Der Ausführungsmodus kann für Custom Actions vom Typ „Ordner festlegen", „Eigenschaft festlegen" und „Fehlermeldung" nicht geändert werden.
User Context
•Run as system – Wenn Custom Actions so konfiguriert sind, dass sie als Systembenutzer ausgeführt werden, sind die Eigenschaften einiger benutzerbezogener Eigenschaften und Pfade betroffen, z. B. die benutzerbezogenen AppData-Verzeichnisse und Registrierungsziele des aktuellen Benutzers.
•Run as current user – Diese Standardeinstellung führt die Custom Action unter dem Benutzer aus, der das Paket tatsächlich installiert.
•Terminal server aware – Nur in Terminal-Server-basierten Zielumgebungen erforderlich.
Der Benutzerkontext kann für Custom Actions vom Typ „Ordner festlegen", „Eigenschaft festlegen" und „Fehlermeldung" nicht geändert werden.
Die zusätzlich angezeigten Steuerelemente hängen vom tatsächlichen Custom-Action-Typ ab und variieren daher:
Typ: Executable
Type
Für ausführbare Custom Actions stehen folgende vier Grundtypen zur Verfügung:
•Executable from a binary source
Erfordert ein ausführbares Ressourcenobjekt in der Binary-Tabelle.
Weitere Informationen zur Verwaltung binärer Ressourcen über die Visual-Designer-Oberfläche finden Sie im Hilfeabschnitt zu Ressourcen.
•Executable deployed within this package
Erfordert ein ausführbares Dateiobjekt in der File-Tabelle.
Weitere Informationen zur Verwaltung von Dateien über die Visual-Designer-Oberfläche finden Sie im Hilfeabschnitt zu Dateien und Ordner.
•Executable pointed by a property
Erfordert eine Eigenschaft mit einem Pfad, der auf eine bestimmte Datei verweist, die entweder im aktuellen Packaging-Projekt oder auf dem Zielrechner gespeichert sein kann.
Weitere Informationen zur Verwaltung von Eigenschaften über die Visual-Designer-Oberfläche finden Sie im Hilfeabschnitt zu Eigenschaften.
•Executable on destination
Ermöglicht die Definition eines Pfads zu einer ausführbaren Datei.
Stream, File, Property, or Directory
Der oben ausgewählte Typ bestimmt, welche Einstellung tatsächlich definiert werden muss. Durch Ändern des Custom-Action-Typs werden die Steuerelemente sofort umgeschaltet, um die Auswahl von Stream-Datei oder Eigenschaft usw. zu ermöglichen.
Command or Arguments
Auch hier bestimmt der oben ausgewählte Typ, ob Argumente oder ein bestimmter Befehl erforderlich ist.
Typ: DLL
Type
Die Typauswahl bestimmt, ob die DLL als Ressourcen-Stream oder bereitgestellte Datei zur Verfügung gestellt wird. Durch Wechseln des Typs wird das Steuerelement für die Quelldefinition automatisch geändert.
Stream or File
Wählen Sie die binäre Ressource oder die mit dem Paket bereitgestellte Datei aus. Stellen Sie sicher, dass Sie eine gültige DLL-Referenz angeben.
DLL Entry Point
Die DLL muss über den Einstiegspunkt aufgerufen werden, wobei das Handle der aktuellen Installationssitzung als Argument übergeben wird. Der angegebene Einstiegspunkt muss mit dem aus der DLL exportierten übereinstimmen.
Typ: VBS oder JS Script
Type
Die vier verfügbaren Skripttypen sind:
•Binäre Stream-Ressource
•Inline-Skriptquellcode
•Eigenschaftswert
•Im Paket bereitgestellte Datei
Base for the actual script content
Je nach ausgewähltem Typ werden Benutzer aufgefordert, den tatsächlichen Skriptinhalt oder die Referenz auszuwählen bzw. zu definieren.
Durch Klicken auf den Link Edit the script wird eine zusätzliche Registerkarte SCRIPT aufgerufen, die nur bei der Bearbeitung skriptbasierter Custom Actions verfügbar ist. Diese Registerkarte bietet den vorhandenen Quellcode als bearbeitbaren Skriptcode und enthält ein zusätzliches Eingabesteuerelement für die Definition der auslösenden Funktion.
Typ: Set Property und Set Folder
Property or Folder name
Wählen Sie die Eigenschaft oder den Ordner aus, der bearbeitet werden soll.
New value
Definieren Sie den neuen Wert für die Eigenschaft oder den Ordner, der zur Laufzeit der Custom Action festgelegt werden soll.
Typ: Error Message
Der tatsächlich als Fehlerinformation angezeigte Meldungstext kann geändert werden. Beachten Sie, dass der Meldungstext nicht leer sein darf.
Registerkarte: PROCESSING AND EXECUTION
Die tatsächlich verfügbaren Steuerelemente hängen vom Typ und den Konfigurationseinstellungen der Custom Action ab. Die Registerkarte kann eine beliebige Kombination der folgenden Eigenschaftssteuerelemente enthalten:
Die folgenden optionalen Verhaltenseinstellungen können aktiviert werden:
Execution Mode
•Immer ausführen
•Nur ausführen, wenn auf dem Client nach der UI-Sequenz ausgeführt wird
•Nur einmal ausführen
•Nur einmal pro Prozess ausführen
Run During Patch Uninstall
Diese Option ist für Installer-Versionen ab 4.0 verfügbar. Sie kann verwendet werden, um Custom Actions ausschließlich bei Patch-Deinstallationsvorgängen auszuführen. Weitere Informationen zum Szenario für Patch-Deinstallations-Custom-Actions finden Sie in der MSDN-Dokumentation.
Run as 64-bit Script
Auf 64-Bit-Betriebssystemen kann Windows Installer Custom Actions aufrufen, die für 32-Bit- oder 64-Bit-Systeme kompiliert wurden. Eine 64-Bit-Custom-Action auf Basis von Skripten muss explizit als 64-Bit markiert werden.
Check Exit Code Upon Finishing
Wenn diese Option aktiviert ist, gilt die Custom Action als erfolgreich abgeschlossen, wenn der Rückgabecode 0 zurückgegeben wird. Alle anderen Rückgabewerte weisen auf eine fehlerhafte Custom-Action-Ausführung hin. Deaktivieren Sie diese Option, um den Rückgabecode zu ignorieren und stets mit der Prozedur fortzufahren, zu der die Custom Action gehört.
Run this Action Asynchronously (in the Background)
Diese Option kann für ausführbare und DLL-basierte Custom Actions festgelegt werden. Wenn sie gesetzt ist, wird die Ausführung der übergeordneten Sequenz fortgesetzt, während die Custom-Action-Logik noch ausgeführt wird.