# Definieren der Bedingungen

Whether your action will eventually be displayed in Caja file manager context menus or in its toolbar depends on the conditions you will have defined for it.

Diese Bedingungen können sich auf den Ort beziehen, an dem der Dateimanager gerade geöffnet ist oder auf die aktuell ausgewählten Objekte an diesem Ort.

Each time the selection or the location change in the file manager, Caja-Actions checks all your actions, comparing the defined conditions against the new location and selection: all defined conditions must be satisfied in order your action be actually displayed.

## Auf dem Basisnamen basierende Bedingungen

Sie können festlegen, dass Ihre Aktion abhängig von den Basisnamen der aktuell im Dateimanager ausgewählten Objekte angezeigt werden soll. Dazu muss ein gewisser Teil der Basisnamen der Objekte übereinstimmen, wobei Sie außerdem gleichzeitig festlegen können, dass ein weiterer Basisnamenteil nicht in den gewählten Objekten vorkommen darf.

Click on the Basenames tab to show the page which will permit you to configure your basename-based conditions.

### Auf dem Basisnamen basierende Bedingungen

Zeigt den Reiter, in welchem Sie auf Basisnamen basierende Bedingungen konfigurieren können.

Faktisch werden auf Basisnamen basierende Bedingungen als eine Liste aus Mustern erstellt, die entweder die Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« haben. Damit Ihre Aktion auf Basisnamen basierende Bedingungen verarbeiten kann, muss jedes Element der Auswahl für eine der aufgelisteten Bedingungen gültig sein: Der Basisname jedes Elements muss auf mindestens eines der »muss mit einem von … übereinstimmen«-Muster passen und darf nicht auf eines der »darf nicht mit einem von … übereinstimmen«-Muster passen.

Falls mindestens ein Element der Auswahl nicht alle definierten Bedingungen erfüllt, dann wird Ihre Aktion nicht angezeigt.

Wenn Ihre Aktion für das Kontextmenü der Auswahl bestimmt ist, dann werden die auf Basisnamen basierenden Bedingungen auf die aktuell ausgewählten Objekte angewendet. Wenn Ihre Aktion dagegen für das Kontextmenü des Ortes oder für die Werkzeugleiste bestimmt ist, dann werden die auf Basisnamen basierenden Bedingungen auf den Basisnamen des aktuellen Ortes angewendet.

Die Definition einer neuen auf Basisnamen basierenden Bedingung umfasst zwei Schritte.

1. Definiert die neue Filterbedingung.

   - Press Insert or click on button to insert a new condition filter

   - Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie den gewünschten Basisnamen enthält.

     A basename-based condition may use « `*` » or « `?` » wildcard characters.

2. Gibt an, ob es sich um eine Bedingung der Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« handelt.

   Click on the Must match one of or Must not match any of radio button in the same row to set the corresponding condition.

Depending of your target operating system, make sure that the Match case checkbox is activated (or not).

- When activated, all filters are considered as case sensitive, which means that `/my/file` filename is considered distinct from `/My/File` one.

  Dies ist das vorgegebene Verhalten auf Unix-ähnlichen Systemen.

- When deactivated, filters are considered as case insensitive, which means that `/my/file` and `/My/File` filenames are considered the same name.

  This is most probably what you want if you target some sort of Windows system.

Removing a defined basename-based condition is as simple as selecting it, and pressing Del (or clicking on button).

By default, the basename-based condition is just one « `must match one of *` » condition. As all basenames always match the « `*` » condition, this just means that basename-based conditions are not considered as relevant for the action.

## Auf dem MIME-Typ basierende Bedingungen

Sie können festlegen, dass Ihre Aktion abhängig von den MIME-Typen der aktuell im Dateimanager ausgewählten Objekte angezeigt werden soll. Dazu muss jedes Objekt der Auswahl einem bestimmten MIME-Typ entsprechen, wobei Sie außerdem gleichzeitig festlegen können, dass keines der ausgewählten Objekte einem anderen anzugebenden MIME-Typ entsprechen darf.

Click on the Mimetypes tab to show the page which will permit you to configure your mimetype-based conditions.

### Auf dem MIME-Typ basierende Bedingungen

Zeigt den Reiter, in welchem Sie auf dem MIME-Typen basierende Bedingungen festlegen können.

Faktisch werden auf dem MIME-Typ basierende Bedingungen als eine Liste aus Mustern erstellt, die entweder die Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« haben. Damit Ihre Aktion auf dem MIME-Typ basierende Bedingungen verarbeiten kann, muss jedes Element der Auswahl für eine der aufgelisteten Bedingungen gültig sein: Der MIME-Typ jedes Elements muss auf mindestens eines der »muss mit einem von … übereinstimmen«-Muster passen und darf nicht auf eines der »darf nicht mit einem von … übereinstimmen«-Muster passen.

Falls mindestens ein Element der Auswahl nicht alle definierten Bedingungen erfüllt, dann wird Ihre Aktion nicht angezeigt.

Wenn Ihre Aktion für das Kontextmenü der Auswahl bestimmt ist, dann werden die auf dem MIME-Typ basierenden Bedingungen auf die aktuell ausgewählten Objekte angewendet. Wenn Ihre Aktion dagegen für das Kontextmenü des Orts oder für die Werkzeugleiste bestimmt ist, dann werden Ihre auf dem MIME-Typ basierenden Bedingungen gegen den MIME-Typ des aktuellen Orts angewendet. Letzter ist der sehr bekannte MIME-Typ »inode/directory«.

Die Definition einer neuen auf dem MIME-Typ basierenden Bedingung umfasst zwei Schritte.

1. Definiert die neue Filterbedingung.

   - Press Insert or click on button to insert a new condition filter

   - Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie den gewünschten MIME-Typen enthält.

     A mimetype must be defined as a `group/subgroup` expression.

     The « `*` » wildcard is supported only in some situations:

     - The « `*/*` » expression matches all mimetypes. As a convenient shortcut, the « `*` » literal is also accepted for this same purpose.

     - A `group/*` string matches all subgroups of `group` mimetype.

     - The `*/subgroup` string is not accepted as a valid wildcard.

2. Gibt an, ob es sich um eine Bedingung der Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« handelt.

   Click on the Must match one of or Must not match any of radio button in the same row to set the corresponding condition.

Removing a defined mimetype-based condition is as simple as selecting it, and pressing Del (or clicking on button).

By default, the mimetype-based condition is just one « `must match one of */*` » condition. As all mimetypes always match the « `*/*` », this just means that mimetypes are not considered as relevant for the action.

### Beispiel für übliche MIME-Typen

`all/all`

- Trifft auf alle Objekte zu.

`all/allfiles`

- Bezieht alle regulären Dateien ein.

`inode/directory`

- Bezieht nur Ordner ein.

## Auf Ordnern basierende Bedingungen

Sie können festlegen, dass Ihre Aktion abhängig von dem Ordner der aktuell im Dateimanager ausgewählten Objekte angezeigt werden soll. Dazu muss sich jedes Objekt der Auswahl in einer bestimmten Hierarchie befinden, wobei Sie außerdem gleichzeitig festlegen können, dass keines der Objekte in einer anderen Hierarchie liegen darf.

Eine auf Ordnern basierende Bedingung muss als die Spezifikation einer Hierarchie angesehen werden, in welcher das aktuell untersuchte Objekt (nicht) verbleiben soll. Es ist ein Muster des Ordnernamens des Elements.

Click on the Folders tab to show the page which will permit you to configure your folder-based conditions.

### Auf Ordnern basierende Bedingungen

Zeigt den Reiter, in welchem Sie auf Ordnern basierende Bedingungen konfigurieren können.

Tatsächlich werden auf Ordnern basierende Bedingungen als eine Liste von »Muss einem entsprechen von« und »Darf keinem entsprechen von« erstellt. Damit Ihre Aktion auf Ordnern basierende Bedingungen verarbeiten kann, muss jedes Element der Auswahl für eine der aufgelisteten Bedingungen gültig sein: Jedes Element muss sich in einem der unter »muss mit einem von … übereinstimmen« aufgeführten Ordner befinden und darf nicht mit einem der unter »darf nicht mit einem von … übereinstimmen« aufgeführten Ordnernamen übereinstimmen.

Falls mindestens ein Element der Auswahl nicht alle definierten Bedingungen erfüllt, dann wird Ihre Aktion nicht angezeigt.

Wenn Ihre Aktion für das Kontextmenü der Auswahl bestimmt ist, dann werden Ihre auf Ordnern basierenden Bedingungen auf den Ordnernamen jedes aktuell ausgewählten Objekts angewendet. Wenn Ihre Aktion dagegen für das Kontextmenü des Orts oder für die Werkzeugleiste bestimmt ist, dann werden Ihre auf Ordnern basierenden Bedingungen auf den aktuellen Ort angewendet.

Die Definition einer neuen auf Ordnern basierenden Bedingung umfasst zwei Schritte.

1. Definiert die neue Filterbedingung.

   - Press Insert or click on button to insert a new condition filter

   - Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie den gewünschten Ordner enthält.

     The « `*` » and « `?` » characters are accepted as wildcards at any level of the defined folder filter.

   - Or click on Browse to select a folder on the file system.

2. Gibt an, ob es sich um eine Bedingung der Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« handelt.

   Click on the Must match one of or Must not match any of radio button in the same row to set the corresponding condition.

Removing a defined folder-based condition is as simple as selecting it, and pressing Del (or clicking on button).

By default, the folder-based condition is just one « `must match one of /` » condition. As `/` is always the top of an Unix-like file system, then all selected items always match this condition.

If you target a Windows system, then this default value may not be what you actually want.

## Auf Schemata basierende Bedingungen

Sie können festlegen, dass Ihre Aktion abhängig von den Schemata der Adressen der aktuell im Dateimanager ausgewählten Objekte angezeigt werden soll. Dazu muss jedes Objekt ein bestimmtes Schema haben, wobei Sie außerdem gleichzeitig festlegen können, dass keines der Objekte ein anderes Schema haben darf.

Click on the Schemes tab to show the page which will permit you to configure your scheme-based conditions.

### Schemata basierte Bedingungen

Zeigt den Reiter, in welchem Sie auf Schemata basierende Bedingungen konfigurieren können.

Faktisch werden auf Schemata basierte Bedingungen als eine Liste aus Mustern erstellt, die entweder die Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« haben. Damit Ihre Aktion auf Basisnamen basierende Bedingungen verarbeiten kann, muss jedes Element der Auswahl für eine der aufgelisteten Bedingungen gültig sein: Der Basisname jedes Elements muss auf mindestens eines der »muss mit einem von … übereinstimmen«-Muster passen und darf nicht auf eines der »darf nicht mit einem von … übereinstimmen«-Muster passen.

Falls mindestens ein Element der Auswahl nicht alle definierten Bedingungen erfüllt, dann wird Ihre Aktion nicht angezeigt.

Wenn Ihre Aktion für das Kontextmenü der Auswahl bestimmt ist, dann werden die auf Schemata basierende Bedingungen auf die aktuell ausgewählten Objekte angewendet. Wenn Ihre Aktion dagegen für das Kontextmenü des Orts oder für die Werkzeugleiste bestimmt ist, dann werden die auf Schemata basierenden Bedingungen auf das Schema des aktuellen Orts angewendet.

Die Definition einer neuen auf Schemata basierenden Bedingung umfasst zwei Schritte.

1. Definiert die neue Filterbedingung.

   - Press Insert or click on button to insert a new condition filter

   - Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie das gewünschte Schema enthält.

     Scheme-based conditions only accept « `*` » wildcard, which stands for « any scheme ».

   - Or click on Common to select a scheme among those predefined in Edit Preferences.

     ### Auswahl eines Schemas aus vordefinierten Schemata

     Die Liste der vordefinierten Schemata anzeigen.

     Ein neues Schema darf hier nur ausgewählt werden, wenn es nicht bereits als Schema-Filter definiert wurde.

     To select a new scheme, click OK, or double-click on the desired row.

2. Gibt an, ob es sich um eine Bedingung der Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« handelt.

   Click on the Must match one of or Must not match any of radio button in the same row to set the corresponding condition.

Removing a defined scheme-based condition is as simple as selecting it, and pressing Del (or clicking on button).

By default, the scheme-based condition is just one « `must match one of *` » condition, which means that schemes are not relevant for this action.

## Auf Fähigkeiten basierende Bedingungen

Als Fähigkeiten werden hier Eigenschaften bezeichnet, die eine Datei dem Benutzer anbietet.

But except for the `Local` capability, all others depend on the user who executes the command.

You may so decide that your action will appear, or not, depending on the capabilities of the selected item(s) vs. the current user.

Click on the Capabilities tab to show the page which will permit you to configure your capability-based conditions.

### Auf Fähigkeiten basierende Bedingungen

Zeigt den Reiter, in welchem Sie auf Fähigkeiten basierende Bedingungen konfigurieren können.

Faktisch werden auf Fähigkeiten basierende Bedingungen als eine Liste aus Mustern erstellt, die entweder die Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« haben. Damit Ihre Aktion auf Fähigkeiten basierende Bedingungen verarbeiten kann, muss jedes Element der Auswahl für eine der aufgelisteten Bedingungen gültig sein: Die Fähigkeit jedes Elements muss auf mindestens eines der »muss mit einem von … übereinstimmen«-Muster passen und darf nicht auf eines der »darf nicht mit einem von … übereinstimmen«-Muster passen.

Falls mindestens ein Element der Auswahl nicht alle definierten Bedingungen erfüllt, dann wird Ihre Aktion nicht angezeigt.

Wenn Ihre Aktion für das Kontextmenü der Auswahl bestimmt ist, dann werden die auf Fähigkeiten basierende Bedingungen auf die aktuell ausgewählten Objekte angewendet. Wenn Ihre Aktion dagegen für das Kontextmenü des Orts oder für die Werkzeugleiste bestimmt ist, dann werden die auf Fähigkeiten basierenden Bedingungen auf jene des aktuellen Orts angewendet.

Die Definition einer neuen auf Fähigkeiten basierenden Bedingung umfasst zwei Schritte.

1. Definiert die neue Filterbedingung.

   - Press Insert to insert a new condition filter.

   - Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie die gewünschte Fähigkeit enthält.

   - Or click on to open the Adding a new capability dialog box.

     ### Verwaltete Fähigkeiten

     Zeigt eine Liste der verwalteten Fähigkeiten.

     Eine neue Fähigkeit darf hier nur ausgewählt werden, wenn es nicht bereits als Fähigkeiten-Filter definiert wurde.

     To select a new capability, click OK, or double-click on the desired row.

2. Gibt an, ob es sich um eine Bedingung der Form »muss mit allen von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« handelt.

   Click on the Must match all of or Must not match any of radio button in the same row to set the corresponding condition.

Removing a defined capability-based condition is as simple as selecting it, and pressing Del (or clicking on button).

Per Voreinstellung ist die Liste der auf Fähigkeiten basierenden Filter leer. Somit sind auf Fähigkeiten basierende Bedingungen für diese Aktion nicht relevant.

## Bedingung zur Anzahl der Auswahl

Sie können festlegen, dass Ihre Auswahl nur dann erscheint, wenn die gegenwärtige Auswahl im Dateimanager einer genauen Anzahl der Objekte entspricht oder eine genaues Verhältnis zu einer gegebenen Anzahl hat.

### Ein Anwendungsfall der Anzahl der Auswahl

If your action consists in displaying the differences between two files, you may define here « `Count = (equal to) 2` ».

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions.

### Auf der Umgebung basierende Bedingungen

Zeigt den Reiter, in welchem Sie auf der Umgebung basierende Bedingungen konfigurieren können. Hier sind die Konfiguration der Anzahl der Auswahl, die Auswahl der Arbeitsumgebung sowie Laufzeitfilter enthalten.

The selection count condition is defined in the 'Appears if selection contains' frame.

### Bereich für den Auswahlzähler

Focus on the Appears if selection contains frame.

Wenn Ihre Aktion für das Kontextmenü der Auswahl bestimmt ist, dann wird die hier definierte Zählbedingung mit der aktuellen Zahl ausgewählter Objekte verglichen. Wenn Ihre Aktion dagegen für das Kontextmenü des Orts oder für die Werkzeugleiste bestimmt ist, dann wird die Zählbedingung mit Null verglichen, weil es in diesem Fall kein ausgewähltes Objekt gibt.

So definieren Sie eine Bedingung für eine Auswahlanzahl:

- Select in the Count drop-down list the operator you want apply to the selection count:

  - `<` (definitiv kleiner als)
  - `=` (entspricht)
  - `>` (definitiv größer als)

- Geben Sie die gewünschte Auswahlanzahl ein.

The selection count defaults to « `Count > (strictly greater than) 0` », which means that the action will be a candidate to be displayed as soon as at least one item is selected in the file manager.

## Auswahl der Arbeitsumgebung

Sie können festlegen, dass Ihre Aktion:

- immer erscheint,

- oder nur in bestimmten angegebenen Arbeitsumgebungen erscheint,

- oder in bestimmten angegebenen Arbeitsumgebungen nicht erscheint.

Innerhalb dieser drei Möglichkeiten ist nur eine Auswahl möglich.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions.

The desktop selection is defined in the Desktop environment frame.

### Feld zur Auswahl der Arbeitsumgebung

Focus on the Desktop environment frame.

So definieren Sie die Arbeitsumgebung:

1. Wählen Sie zunächst den Typ des zu verwendenden Filters:

   - Soll Ihre Aktion immer erscheinen, unabhängig von der Arbeitsumgebung?
   - Soll Ihre Aktion nur in bestimmten Arbeitsumgebungen erscheinen?
   - Soll Ihre Aktion nie in bestimmten Arbeitsumgebungen erscheinen?

2. Sollte Ihre Aktion nicht immer erscheinen, so wählen Sie die entsprechende(n) Arbeitsumgebung(en) in der Auswahlliste auf der rechten Seite.

The targeted desktop environment condition defaults to « `Always appear` », which means that the action will be a candidate to be displayed regardless of the current desktop environment.

## Bedingung für ausführbare Datei

Sie können festlegen, dass Ihre Aktion nur dann erscheinen wird, wenn einige notwendige Pakete auf dem System installiert sind. Für diese Prüfung geben Sie hier eine bestimmte Datei an, die von einem Paket installiert wird. Die Datei muss im Dateisystem vorhanden und ausführbar sein.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions.

The executable found condition is defined in the Execution environment frame.

### Feld Ausführungsumgebung

Focus on the Execution environment frame.

To define the relevant file, enter its full filename in the Appears if the file is executable entry box, or click on Browse to select a file on the file system.

Lassen Sie das Feld leer, wenn die Bedingung für Ihre Aktion irrelevant ist.

Sie können einige Parameter in den gesuchten Dateinamen einbetten. Diese Parameter werden dynamisch zur Ausführungszeit mit Werten ersetzt, die von den ausgewählten Objekt(en) abhängen.

## Bedingung für eine D-Bus-Registrierung

Sie können festlegen, dass Ihre Aktion nur dann erscheinen soll, wenn ein bestimmter Name zur Ausführungszeit am D-Bus-System registriert ist.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions, and focus on Execution environment frame.

To define the relevant name, enter it in the Appears if the name is registered on D-Bus entry box.

Lassen Sie das Feld leer, wenn die Bedingung für Ihre Aktion irrelevant ist.

Sie können einige Parameter in den gesuchten Namen einbetten. Diese Parameter werden dynamisch zur Ausführungszeit mit Werten ersetzt, die von den ausgewählten Objekt(en) abhängen.

## Angepasste Bedingung

You may define that your action will only appear if some given command outputs a `true` string on its standard output.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions, and focus on Execution environment frame.

This lets you define your own customized condition filter, by writing a small script which outputs, or not, the `true` string on stdout when it is ran.

To define the command, enter it in the Appears if the command outputs "true" entry box.

Lassen Sie das Feld leer, wenn die Bedingung für Ihre Aktion irrelevant ist.

Sie können einige Parameter in den Dateinamen einbetten, der ausgeführt wird, oder in dessen Optionen. Diese Parameter werden zur Laufzeit dynamisch mit Werten ersetzt, die von den gewählte(n) Objekt(en) abhängen.

## Bedingung für laufende Prozesse

Sie können bestimmten, dass Ihre Aktion nur dann erscheinen wird, wenn ein bestimmter Prozess aktuell ausgeführt wird.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions, and focus on Execution environment frame.

To define the binary, enter its name in the Appears if the binary is running entry box, or click on Browse to select a file on the file system.

Selbst wenn Sie den vollen Dateinamen der Binärdatei angeben, so wird zur Laufzeit nur nach dem Basisnamen in der Prozessliste gesucht.

Lassen Sie das Feld leer, wenn die Bedingung für Ihre Aktion irrelevant ist.

Sie können einige Parameter in den gesuchten Namen einbetten. Diese Parameter werden dynamisch zur Ausführungszeit mit Werten ersetzt, die von den ausgewählten Objekt(en) abhängen.