test

CDE Handbuch für fortgeschrittene Benutzer und Systemverwalter

Eine Aktion manuell erstellen: Allgemeine Schritte

In diesem Abschnitt wird erläutert, wie eine Konfigurationsdatei für eine Aktionsdefinition erstellt wird.

Konfigurationsdateien für Aktionen

Konfigurationsdateien mit Aktionsdefinitionen müssen folgende Bedingungen erfüllen:

Informationen über das Ändern des Suchpfads für Aktionen und Datentypen finden Sie im Abschnitt "Wert eines Suchpfads setzen".

Eine Aktion manuell erstellen

  1. Öffnen Sie eine vorhandene Datenbankdatei, oder erstellen Sie eine neue Datei.

    Informationen finden Sie im vorhergehenden Abschnitt "Konfigurationsdateien für Aktionen".

  2. Erstellen Sie die Aktionsdefinition mit folgender Syntax: 

    	ACTION Aktionsname
 	{
 		TYPE		Aktionstyp
  		Aktionsfeld
 		...
 	}

    Die einzelnen Parameter können folgendermaßen belegt werden:

    Aktionsname - Der Name, mit dem die Aktion ausgeführt wird.

    Aktionstyp - COMMAND (Standardwert), MAP oder TT_MSG.

    Aktionsfeld - Eines der erforderlichen oder optionalen Felder für diesen Aktionstyp. Alle Felder bestehen aus einem Schlüsselwort und einem Wert.

    Viele dieser Aktionsfelder werden in diesem Kapitel beschrieben. Weitere Informationen finden Sie auf der Hilfeseite dtactionfile(4).

  3. Speichern Sie die Datei.

  4. Soll das Aktionssymbol eine eindeutige Grafik verwenden, erstellen Sie die Symbole für die Aktion. Die Symbole befinden sich normalerweise in folgendem Verzeichnis:

    • Persönliche Symbole: Home-Verzeichnis/.dt/icons

  5. Doppelklicken Sie auf 'Aktionen neu laden' in der Anwendungsgruppe 'Desktop-Anwendungen'.

  6. Erstellen Sie eine Aktionsdatei für die Aktion. Diese Datei erstellt für die Aktion ein Symbol im Dateimanager oder Anwendungsmanager (wird mit der Aktion eine Anwendung gestartet, heißt das Symbol Anwendungssymbol).

    To create the action file, create an executable file with the same name as action_name. Sie können die Datei in jedes Verzeichnis einfügen, für das Sie Schreiberlaubnis haben. Es können beliebig viele Aktionsdateien erstellt werden.

Beispiel für das Erstellen einer COMMAND-Aktion

In diesem Beispiel wird eine persönliche Aktion erstellt, mit der eine Fax-Anwendung auf dem entfernten System AppServerA gestartet werden kann. Der Befehl zum Starten der Fax-Anwendung lautet:

/usr/fax/bin/faxcompose [Dateiname]

  1. Erstellen Sie die Datei Home-Verzeichnis/.dt/types/Fax.dt.

  2. Fügen Sie die folgenden Aktionsdefinitionen in die Datei ein: 

    	ACTION FaxComposer
 	{
 		TYPE					COMMAND
 		ICON					fax
 		WINDOW_TYPE			NO_STDIO
 		EXEC_STRING			/usr/fax/bin/faxcompose -c %Arg_1%
 		EXEC_HOST     	 	AppServerA
 		DESCRIPTION    	Startet das Faxprogramm
    	}

    Die Felder WINDOW_TYPE und EXEC_STRING beschreiben die Funktionsweise der Aktion.

    WINDOW_TYPE - Das Schlüsselwort NO_STDIO legt fest, daß die Aktion nicht in einem Terminalemulationsfenster ausgeführt werden muß.

    Weitere Informationen finden Sie im Abschnitt "Fensterunterstützung für die Aktion festlegen".

    EXEC_STRING - Die Syntax %Arg_1% akzeptiert eine übergebene Datei. Beim Doppelklicken auf das Aktionssymbol wird ein leeres Faxfenster geöffnet.

    Weitere Informationen finden Sie im Abschnitt "Ausführungszeichenfolge für eine COMMAND-Aktion erstellen".

  3. Speichern Sie die Datei.

  4. Erstellen Sie mit dem Symboleditor die folgenden Symboldateien im Verzeichnis Home-Verzeichnis/.dt/icons:

    • fax.m.pm, Größe 32 x 32 Pixel

    • fax.t.pm, Größe 16 x 16 Pixel

  5. Doppelklicken Sie auf 'Aktionen neu laden' in der Anwendungsgruppe 'Desktop-Anwendungen'.

  6. Erstellen Sie eine ausführbare Datei mit dem Namen FaxComposer in einem Verzeichnis, für das Sie über Schreiberlaubnis verfügen (zum Beispiel in Ihrem Home-Verzeichnis).

Beispiel für das Erstellen einer MAP-Aktion

Das Beispiel setzt voraus, daß die meisten zu faxenden Dateien mit dem Texteditor erstellt werden und den Datentyp TEXTFILE (Dateien mit dem Namen *.txt) aufweisen.

Mit den folgenden Arbeitsschritten wird der Menüpunkt 'Fax' dem Menü 'Ausgewählt' des Datentyps hinzugefügt.

  1. Öffnen Sie die im letzten Beispiel erstellte Datei Home-Verzeichnis/.dt/types/Fax.dt.

  2. Fügen Sie folgende Zuordnungsdefinition hinzu:

    	ACTION Fax
 	{
 		ARG_TYPE			TEXTFILE
 		TYPE				MAP
 		MAP_ACTION		FaxComposer
 	}

  3. Speichern Sie die Datei.

  4. Kopieren Sie die Datenattributdefintion für TEXTFILE aus dem Verzeichnis /usr/dt/appconfig/types/Sprache/dtpad.dt in eine neue Datei Home-Verzeichnis/.dt/types/textfile.dt. Fügen Sie die Aktion 'Fax' dem Feld ACTIONS hinzu.

    	DATA_ATTRIBUTES TEXTFILE
 	{
 		ACTIONS			Open,Print,Fax
 		ICON				Dtpenpd
 		...
 	}

  5. Speichern Sie die Datei.

  6. Den Anwendungsmanager öffnen und auf 'Aktionen erneut starten' in der Anwendungsgruppe `Desktop-Anwendungen' doppelklicken.

Datenbank für Aktionen und Datentypen neu laden

Damit neue oder bearbeitete Aktionsdefinitionen wirksam werden, muß die Datenbank erneut gelesen werden.

    Öffnen Sie die Anwendungsgruppe 'Desktop-Anwendungen', und doppelklicken Sie auf 'Aktionen neu laden'.

    Oder führen Sie den folgenden Befehl aus:

    	dtaction ReloadActions

    'ReloadActions' ist der Name der Aktion mit dem Symbol 'Aktionen neu laden'.

    Die Datenbank wird auch erneut gelesen, wenn der Benutzer folgende Vorgänge durchführt:

    • Anmelden

    • Neustarten des Workspace Manager

    • Speichern einer Aktion mit dem Befehl 'Speichern' im Menü 'Datei' des Fensters 'Aktion erstellen'.

Aktionsdatei (Symbol) für eine Aktion erstellen

Eine Aktionsdatei ist eine sichtbare Repräsentation der Aktion im Dateimanager oder Anwendungsmanager.

Abbildung 12-1 Aktionsdateien (Aktionssymbole) im Anwendungsmanager

Graphic

Da das Symbol einer Aktionsdatei eine Aktion repräsentiert, wird es manchmal als Aktionssymbol bezeichnet. Wird durch die Aktion eine Anwendung gestartet, nennt man das Symbol Anwendungssymbol.

Durch Doppelklicken auf das Aktionssymbol wird die Aktion ausgeführt. Das Aktionssymbol kann auch eine Ablegezone sein.

Eine Aktionsdatei (Aktionssymbol) erstellen

    Erstellen Sie eine ausführbare Datei mit dem Namen der Aktion. Der Inhalt der Datei ist nicht von Bedeutung.

Ein Beispiel: Die Aktion ist folgendermaßen definiert:

ACTIONMeineAnwendung
 {
 	EXEC_STRING				Mfa -file %Arg_1%
 	DESCRIPTION				Startet MeineAnwendung
 	ICON						Mfapp
 }

Die Aktionsdatei ist dann eine ausführbare Datei mit dem Namen MeineAnwendung. Im Dateimanager und im Anwendungsmanager wird dann für die Datei MeineAnwendung das Symbol MfappGröße.Typ verwendet. Durch Doppelklicken auf das Symbol MeineAnwendung wird die Ausführungszeichenfolge ausgeführt. Als Online-Hilfe des Symbols wird der Inhalt des Feldes DESCRIPTION angezeigt (,,Startet MeineAnwendung").

Aktionsbeschriftungen

Enthält die Aktionsdefinition das Feld LABEL, erhält die Aktionsdatei im Dateimanager und im Anwendungsmanager den Inhalt dieses Feldes als Beschriftung und nicht den Dateinamen (Aktionsname). Enthält die Aktionsdefinition beispielsweise die Zeile

ACTIONMeineAnwendung
 {
 	LABEL      Bevorzugte Anwendung
...
 }

hat das Aktionssymbol die Beschriftung ,,Bevorzugte Anwendung".

Das Symbol für eine Aktion festlegen

Über das Feld ICON können Sie das Symbol angeben, das im Dateimanager und im Anwendungsmanager für die Aktion verwendet wird.

Geben Sie kein Symbol an, werden die Standardsymboldateien für Aktionssymbole verwendet (/usr/dt/appconfig/icons/Sprache/Dtactn.*).

Abbildung 12-2 Standardaktionssymbol

Graphic

Das Standardsymbol einer Aktion kann mit folgender Ressource geändert werden: 

*actionIcon:    Symbol_Dateiname

Der Parameter Symbol-Dateiname kann als Basisdateiname oder als absoluter Pfad angegeben werden.

Das Feld ICON kann folgende Werte annehmen:

Tabelle 12-1 Symbolnamen und -größen für Aktionssymbole

Größe in Pixel 

Bitmap-Name 

Pixmap-Name 

48 x 48 

Name.l.bm

Name.l.pm

32 x 32 

Name.m.bm

Name.m.pm

16 x 16 

Name.t.bm

Name.t.pm

Eine vorhandene Aktionsdefinition ändern

Sie können alle im System verfügbaren Aktionen einschließlich der integrierten Aktionen ändern.

Hinweis -

Gehen Sie beim Ändern der integrierten Aktionen vorsichtig vor. Sie sind genau auf die Zusammenarbeit mit den Desktop-Anwendungen abgestimmt.

  1. Suchen Sie die Definition der zu ändernden Aktion.

    Die Aktionsdefinitionen befinden sich in folgenden Standardverzeichnissen:

    • Integrierte Aktionen: /usr/dt/appconfig/types/Sprache

    • Systemweite Aktionen: /etc/dt/appconfig/types/Sprache

    • Persönliche Aktionen: Home-Verzeichnis/.dt/types

      Es können auch weitere Verzeichnisse im System definiert sein. Eine Liste der für Aktionen verwendeten Verzeichnisse erhalten Sie mit dem Befehl: 

      	dtsearchpath -v

      Das System verwendet die unter DTDATABASESEARCHPATH aufgeführten Verzeichnisse.

  2. Kopieren Sie gegebenenfalls den Text der Aktionsdefinition in eine neue oder bereits vorhandene Datei in einem der folgenden Verzeichnisse:

    • Systemweite Aktionen: /etc/dt/appconfig/types/Sprache

    • Persönliche Aktionen: Home-Verzeichnis/.dt/types

      Integrierte Aktionen müssen zunächst kopiert werden, da Dateien im Verzeichnis /usr/dt/appconfig/types/Sprache nicht bearbeitet werden sollten.

  3. Bearbeiten Sie die Aktionsdefinition.

  4. Speichern Sie anschließend die Datei.

  5. Doppelklicken Sie auf 'Aktionen neu laden' in der Anwendungsgruppe 'Desktop-Anwendungen'.

Reihenfolge der Aktionsdefinitionen

Ruft der Benutzer eine Aktion auf, durchsucht das System die Datenbank nach dem betreffenden Aktionsnamen. Ist mehr als eine Aktion mit diesem Namen vorhanden, beachtet das System bestimmte Regeln, um die zu verwendende Aktion zu bestimmen.