# Aktionen und Datentypen mit 'Aktion erstellen' erstellen

Bei
'Aktion erstellen' handelt es sich um ein Werkzeug zum Erstellen

- einer Aktion, mit der eine Anwendung gestartet wird.

- eines oder mehrerer Datentypen für die Datendateien einer Anwendung.

- von Aktionen, mit denen die Datendateien einer Anwendung geöffnet und gedruckt werden.

'Aktion erstellen' kann auch dazu verwendet werden, einfache Aktionen zu erstellen, mit denen Betriebssystembefehle und Shell-Prozeduren ausgeführt werden.

SAG.dtCrA.mkr.2
SAG.dtCrA.mkr.3
SAG.dtCrA.mkr.4

Weiterführende Informationen können der Hilfeseite `dtcreate(1X)` entnommen werden.

## Funktionsweise von 'Aktion erstellen'

'Aktion erstellen' besteht aus einem Hauptfenster und einer Reihe von Dialogfenstern, über die eine Aktion und die zugehörigen Datentypen erstellt werden.

Das Werkzeug 'Aktion erstellen'

- erstellt eine Aktionsdefinition, die einen Befehl ausführt.

- erstellt eine Datei Standardverzeichnis`/.dt/types/`aktion_name`.dt.` Diese Datei speichert die Definitionen für Aktion und Datentyp, die für die Anwendung erstellt wurden.

- erstellt eine
  Aktionsdatei im Standardverzeichnis des Benutzers. Bei der Aktionsdatei handelt es sich um eine ausführbare Datei mit demselben
  Namen wie die Aktion.

  Die Darstellung der Aktionsdatei im Dateimanager wird als
  Anwendungssymbol bezeichnet, da man durch Doppelklicken auf diesem Symbol die Anwendung starten kann.

  Wahlweise kann der Benutzer das Aktionssymbol als Übergabebereich einrichten, indem er beim Erstellen der Aktion für die Übergabe geeignete Datentypen angibt.

- erstellt einen oder mehrere Datentypen für die Datendateien einer Anwendung (optional).

- erstellt eine Aktion 'Öffnen' für jeden Datentyp.

- erstellt eine Aktion 'Drucken' für jeden Datentyp (optional).

- lädt die Datenbank für Aktionen und Datentypen erneut. Auf diese Weise werden Aktionen und Datentypen sofort wirksam.

## Einschränkungen von 'Aktion erstellen'

'Aktion erstellen' dient dazu, Aktionen und Datentypen für die Ausführung von Anwendungen zu erstellen. Aber Aktionen und Datentypen sind sehr flexibel und enthalten zusätzliche Funktionen, auf die nur zugegriffen werden kann, wenn die Definitionen manuell erstellt werden.

Weitere Informationen hierzu können folgenden Kapiteln entnommen werden:

- SAG.CrAct.mkr.1

- SAG.CrDT.mkr.1

### Einschränkungen bei Aktionen

'Aktion erstellen' kann nicht verwendet werden, um die Aktion für eine Anwendung zu erstellen, wenn eine der folgenden Bedingungen zutrifft:

- Für die Befehlszeile ist ein Parameter (ein Argument, das 'Aktion erstellen' nicht der Aktionsdatei entnehmen kann)
  notwendig.

  Beispielsweise kann 'Aktion erstellen' nicht verwendet werden, um eine Aktion für folgenden Befehl zu schreiben:

`lp -d gerät dateiname`

da der Benutzer bei jeder Ausführung des Befehls einen Wert für gerät angeben muß.

- Das Anwendungssymbol muß eine andere Bezeichnung tragen als der Aktionsname.

  Beispielsweise kann 'Aktion erstellen' nicht verwendet werden, um eine Version einer bereits vorhandenen Aktion in der lokalen Sprache zu erstellen.

- Für die Aktion ist eine der erweiterten Funktionen der Aktionsdatenbank erforderlich.

  Beispiele für diese erweiterten Funktionen sind Aktionen, die

  - Befehle auf fernen Systemen, die nicht über die Aktionsdefinition verfügen, starten.

  - andere Aktionen aufrufen.

  - mit einer anderen Berechtigung ausgeführt werden müssen (zum Beispiel als Superuser).

  - mit der Zuordnungsfunktion (map) ausgeführt werden.

  - je nach Anzahl der Dateiargumente, die die Aktion zur Verfügung stellt, ein sehr unterschiedliches Verhalten zeigen.

###
Einschränkungen bei Datentypen

'Aktion erstellen' kann nicht verwendet werden, um den Datentyp für eine Anwendung zu erstellen, wenn eine der folgenden Bedingungen zutrifft:

- Für den Datentyp müssen neben 'Öffnen' und 'Drucken' noch weitere Aktionen definiert sein.

- Bei der Aktion 'Öffnen' für den Datentyp handelt es sich nicht um den Befehl der Aktion.

  Beispielsweise kann 'Aktion erstellen' nicht verwendet werden, um den Datentyp zu erstellen, mit dem ein eindeutiges Symbol für das Verzeichnis, das die Gruppe von Anwendungen der Anwendung darstellt, zur Verfügung gestellt wird.

## Aktionen und Datentypen für eine Anwendung mit 'Aktion erstellen' erstellen

Bevor 'Aktion erstellen' ausgeführt wird, muß der Benutzer einige Informationen über die Anwendung zur Verfügung haben.

- Die Befehlszeile, mit der die Anwendung gestartet wird.

  Der Benutzer muß wissen, ob die Befehlszeile ein erforderliches Dateiargument, ein wahlfreies Dateiargument oder kein Dateiargument enthält.

  Ist für die Anwendung ein Parameter erforderlich, kann die Aktion nicht mit 'Aktion erstellen' erstellt werden.

- Die Typen von Datendateien, die die Anwendung akzeptieren kann.

  Einige Anwendungen können nur einen Datentyp akzeptieren. Andere (zum Beispiel ein ASCII-Editor oder ein Grafikeditor) können verschiedene Datentypen akzeptieren.

- Wie die Anwendung ihre Datendateien identifiziert.

  Hierbei kann es sich um eine Benennungskonvention (beispielsweise Dateinamen mit der Erweiterung `.doc`) handeln und/oder vom Inhalt der Datei abhängig sein. Verwendet die Anwendung keine Dateinamenskonvention, kann für das Aktionssymbol dennoch eine Konvention eingerichtet werden.

- Wahlweise: Die Befehlszeile für den Druck der Dateien.

### Eine Aktion für eine Anwendung erstellen

1. Auf
   'Aktion erstellen' in der Gruppe Desktop-Anwendungen doppelt klicken.

   #### Das Symbol 'Aktion erstellen' im Anwendungsmanager

   Hierdurch wird das Hauptfenster 'Aktion erstellen' angezeigt.

   #### Hauptfenster 'Aktion erstellen'

2. Den Namen für das Aktionssymbol in das Textfeld
   'Aktionsname' eingeben.

3. Die Bedienelemente für
   'Aktionssymbole' verwenden, um das Symbol für die Anwendung anzugeben. Zu Beginn wird das Standardsymbol angezeigt.

   - Soll ein anderes, bereits vorhandenes Symbol ausgewählt werden, muß der Benutzer 'Gruppe suchen' anklicken, damit das Dialogfenster 'Gruppe suchen' angezeigt wird. Weitere Informationen hierzu können dem Abschnitt sag.dtcra.mkr.7 entnommen werden.

   - Sollen neue Symbole erstellt werden, 'Symbol bearbeiten' auswählen, um den Symboleditor auszuführen.

4. In dem Textfeld 'Befehl beim Öffnen der Aktion (durch Doppelklicken)' den Befehl zum Starten der Anwendung eingeben.

   Für ein Dateiargument die Syntax `$n` verwenden. Beispiel:

       emacs
       bitmap $1
       diff $1 $2
       lp -oraw $1

   Enthält die Befehlszeile ein Dateiargument (`$n`), ist das Aktionssymbol ein Übergabebereich für Dateien.

   Die Befehlszeilen werden nicht an eine Shell übergeben, es sei denn, die Verwendung einer Shell wird explizit angegeben. Zum Beispiel verwenden folgende Zeilen Shell-Verarbeitung:

       /bin/sh -c "ps | lp"
       /bin/sh -c "spell $1 | more"

5. Den Kontexthilfetext für das Aktionssymbol im Textfeld 'Hilfetext für Aktionssymbol' eingeben.

   Der Text wird im Textfeld automatisch umgebrochen. Diese Zeilenumbrüche werden jedoch online nicht beibehalten. Soll ein fester Zeilenumbruch angegeben werden, muß `\n` verwendet werden.

6. Die für die Aktion erforderliche Fensterunterstützung im Menü 'Optionen' 'Fensterart' auswählen.

   Grafisch (X-Window) | Die Anwendung erstellt ihr eigenes Fenster.
   Terminal (automatisches Schließen) | Die Anwendung wird in einem Terminal-Emulator-Fenster ausgeführt, das automatisch geschlossen wird, wenn der Benutzer die Anwendung verläßt.
   Terminal (manuelles Schließen) | Die Anwendung wird in einem Terminal-Emulator-Fenster ausgeführt, das geöffnet bleibt, bis der Benutzer es explizit schließt.
   Keine Ausgabe | Die Anwendung zeigt keine Ausgabe am Bildschirm an.

7. Folgendermaßen vorgehen:

   - Verfügt die Anwendung über Datendateien, und möchte der Benutzer einen oder mehrere Datentypen für diese erstellen, kann er weitere Informationen hierzu dem Abschnitt sag.dtcra.mkr.6 entnehmen.

   - Soll kein Datentyp erstellt werden, die Aktion sichern, indem 'Speichern' im Menü 'Datei' ausgewählt wird. Anschließend die neue Aktion durch Doppelklicken auf ihrem Symbol im Standardverzeichnis des Benutzers testen.

### Einen oder mehrere Datentypen für eine Anwendung erstellen

1. Die Aktion für die Anwendung unter Verwendung der Prozedur im vorherigen Abschnitt, sag.dtcra.mkr.5, definieren.

2. Die Taste 'Erweitert' im Fenster 'Aktion erstellen' anklicken, um das Fenster zu erweitern.

   #### Erweiterte Funktionen im Hauptfenster 'Aktion erstellen'

3. Soll das Anwendungssymbol nach einem Dateiargument fragen, nachdem das Symbol doppelgeklickt wurde, den Text der Eingabeaufforderung in dem Textfeld `Beim Öffnen einer Aktion Benutzer nach folgendem fragen:' eingeben.

   Folgende Richtlinien gelten für dieses Textfeld:

   - Dieses Feld muß verwendet werden, falls die Befehlszeile der Anwendung ein erforderliches Dateiargument enthält.

   - Enthält die Befehlszeile kein Dateiargument, bleibt das Feld leer.

   - Ist das Dateiargument in der Befehlszeile der Anwendung optional, wird, falls ein Text für die Eingabeaufforderung eingegeben wurde, beim Doppeltklicken auf dem Symbol nach dem Dateiargument gefragt. Wurde kein Text für die Eingabeaufforderung eingegeben, wird die Aktion ausgeführt und eine leere Zeichenfolge als Dateiargument verwendet.

4. Die Dateitypen angeben, die die Aktion als Argumente akzeptiert:

   - Akzeptiert die Aktion jeden Datentyp, 'Alle Datentypen' auswählen.

   - Akzeptiert die Aktion nur den/die Datentyp(en), der/die für die Anwendung erstellt wurde(n), 'Nur obige Liste' auswählen.

     Zu Beginn ist die Liste
     'Datentypen, die diese Aktion verwenden' leer. Erstellt der Benutzer Datentypen für die Anwendung, werden sie zu der Liste hinzugefügt.

5. Die Taste 'Hinzufügen' neben dem Fenster mit der Liste 'Datentypen, die diese Aktion verwenden' anklicken, um das Dialogfenster 'Datentyp hinzufügen' anzuzeigen.

   #### Dialogfenster 'Datentyp Hinzufügen' in 'Aktion erstellen'

6. Wahlfeil: Soll der Standarddatentypname nicht verwendet werden, einen neuen Namen für den Datentyp im Textfeld
   'Name der Datentypfamilie' eingeben.

   In dem Namen dürfen keine Leerzeichen vorkommen. Der Datentypname ist für Benutzer der Anwendung nicht sichtbar. Er wird in der Datenbank für Aktionen und Datentypen verwendet, um die Definition für den Datentyp zu identifizieren.

7. Die Taste 'Bearbeiten' neben dem Fenster
   'Identifizierende Merkmale' anklicken, um das Dialogfenster 'Identifizierende Merkmale' anzuzeigen.

   #### Dialogfenster 'Identifizierende Merkmale' in 'Aktion erstellen'

   Datentypen werden anhand ihrer Merkmale voneinander unterschieden. Der Benutzer kann eines oder mehrere der folgenden Kriterien auswählen:

   Dateien oder Ordner | Der Datentyp gilt nur für Dateien oder nur für Ordner.
   Namensmuster | Datentypzuordnung auf der Grundlage des Dateinamens
   Berechtigungsmuster | Lese-, Schreib- und Ausführungsberechtigungen
   Inhalt | Inhalt eines angegebenen Teils einer Datei

8. Auswählen, ob der Datentyp eine Datei oder einen Ordner darstellt.

   #### Das Merkmal für Datei oder Verzeichnis für einen Datentyp angeben.

9. Ist die Zuordnung eines Datentyps vom Namen abhängig, das Markierungsfeld 'Namensmuster' auswählen und den Namen im Textfeld eingeben.

   #### Das Merkmal Dateiname für einen Datentyp angeben.

   Hierbei können * und ? als Platzhalterzeichen verwendet werden:

   * | Entspricht einer beliebigen Folge von Zeichen.
   ? | Entspricht einem beliebigen einzelnen Zeichen.

10. Ist die Zuordnung eines Datentyps von den Berechtigungen abhängig, das Markierungsfeld 'Berechtigungsmuster' auswählen und die Berechtigungen für den Datentyp auswählen.

    #### Das Merkmal Zugriffsrechte für einen Datentyp angeben

    Ein | Für die Datei muß die angegebene Berechtigung vorliegen.
    Aus | Für die Datei muß die angegebene Berechtigung fehlen.
    Egal | Die angegebene Berechtigung ist unwichtig.

11. Ist die Zuordnung eines Datentyps vom Inhalt abhängig, das Markierungsfeld 'Inhalt' auswählen und die erforderlichen Informationen, Suchmuster und Typ des Inhalts eingeben. Wahlweise kann der Benutzer die Byteposition angeben, an der die Suche starten soll.

    #### Das Merkmal Inhalt für einen Datentyp angeben

    Die Datentypzuordnung auf der Grundlage des Inhalts beeinträchtigt möglicherweise die Leistung des Systems.

12. 'OK' anklicken, um das Dialogfenster 'Merkmale identifizieren' zu schließen.

    Die Merkmale werden im Feld 'Merkmale identifizieren' mit folgender Codierung angezeigt:

    d | Verzeichnis
    r | Für die Datei liegt Lesezugriff vor.
    w | Für die Datei liegt Schreibzugriff vor.
    x | Für die Datei liegt Ausführungszugriff vor.
    ! | Logischer Operator NICHT
    & | Logischer Operator UND

13. Den Hilfetext für die Datendateien in das Textfeld 'Hilfetext' eingeben.

14. Die Bedienelemente für 'Aktionssymbole' verwenden, um das Symbol für die Anwendung anzugeben. Zu Beginn wird das Standardsymbol angezeigt.

    - Soll ein anderes, bereits vorhandenes Symbol ausgewählt werden, muß der Benutzer 'Gruppe suchen' anklicken, damit das Dialogfenster 'Gruppe suchen' angezeigt wird. Weitere Informationen hierzu können dem Abschnitt sag.dtcra.mkr.7 entnommen werden.

    - Sollen neue Symbole erstellt werden, 'Symbol bearbeiten' auswählen, um den Symboleditor auszuführen.

15. Den Befehl im Textfeld 'Befehl zum Öffnen dieses Datentyps' überprüfen. Dieser Befehl wird ausgeführt, wenn der Benutzer eine Datendatei doppelt anklickt.

16. Optional: Stellt der Anwendung einen Druckbefehl für das Drucken von Datendateien über die Befehlszeile zur Verfügung; den Befehl in das Textfeld 'Befehl zum Drucken dieses Datentyps' unter Verwendung der Syntax `$n` für ein Dateiargument eingeben.

17. Die Datentypdefinition auf eine der folgenden Weisen sichern:

    - 'OK' anklicken, um den Datentyp zu sichern und das Dialogfenster 'Datentyp hinzufügen' zu schließen.

    - 'Anwenden' anklicken, um den Datentyp ohne Schließen des Dialogfensters 'Datentyp hinzufügen' zu sichern. Der Benutzer kann sofort mit der Definition eines weiteren Datentyps für die Aktion fortfahren.

### Symbol über das Dialogfenster 'Gruppe suchen' angeben

Das Dialogfenster 'Gruppe suchen' wird angezeigt, wenn der Benutzer 'Gruppe suchen' im Hauptfenster 'Aktion erstellen' oder im Fenster 'Datentyp hinzufügen' anklickt. Dieses Dialogfenster wird verwendet, um das Symbol anzugeben, das für die Aktion oder den Datentyp verwendet wird.

#### Dialogfenster
'Gruppe suchen'

Das Dialogfenster 'Gruppe suchen' ermöglicht dem Benutzer, eine Gruppe von Symbolabbilddateien in folgenden Positionen zu erstellen:

- In einem Verzeichnis im Symbolsuchpfad. Die Liste 'Symbolordner' enthält alle Verzeichnisse im Symbolsuchpfad.

- In einem Registrierungspaket, das mit dem Desktop mit `dtappintegrate` integriert wird. Diese Symbole befinden sich noch nicht in einem Verzeichnis im Symbolsuchpfad, werden aber von `dtappintegrate` dorthin gestellt.

Die Definitionen für Aktionen und Datentyp, die mit 'Aktion erstellen' erstellt wurden, verwenden den Dateinamen ohne Pfad für die Symboldateien (den Dateinamen ohne die Erweiterungen für Größe und Typ). Symbole für Aktionen und Datentypen, die mit 'Aktion erstellen' erstellt wurden, werden letztendlich in Verzeichnisse im Symbolsuchpfad gestellt.

#### Gruppen von Symbolen im Symbolsuchpfad angeben

1. In der Liste 'Symbolordner' des Dialogfensters 'Gruppe suchen' auf dem Verzeichnispfad, der das Symbol enthält, doppeltklicken.

   Die Liste 'Symboldateien' zeigt alle Symboldateien in diesem Ordner an.

2. In der Liste 'Symboldateien' das Symbol anklicken, das verwendet werden soll.

   Dadurch wird der Dateiname ohne Pfad der Symboldatei in das Textfeld 'Den Namen der Symboldatei eingeben' gestellt.

3. 'OK' anklicken.

#### Symbole in einem Registrierungspaket angeben

Handelt es sich bei dem Benutzer um einen Systemadministrator oder um einen Programmierer, der ein Registrierungspaket erstellt, werden die Symbolabbilddateien zunächst in ein Verzeichnis im Registrierungspaket gestellt:

`app_root/dt/appconfig/icons/sprache`

Nach der Registrierung mit `dtappintegrate` werden die Symboldateien in das Verzeichnis `/etc/dt/appconfig/icons/`sprache, das sich im Symbolsuchpfad befindet, kopiert.

Diese Prozedur verwenden, um Symbole anzugeben, die Bestandteil eines Registrierungspakets sind:

1. Im Textfeld 'Den Namen der Symboldatei eingeben' des Dialogfensters 'Gruppe suchen' den Dateinamen ohne Pfad der Symboldatei eingeben.

2. 'OK' anklicken.

   'Aktion erstellen' zeigt ein Dialogfenster an, in dem der Benutzer darüber informiert wird, daß die Symbole in Verzeichnissen im Symbolpfad nicht gefunden wurden.

3. In dem Dialogfenster 'Information', das angezeigt wird, 'Keine Änderung' auswählen.