# Text extrahieren

Mit dem Plugin <img src="/files/GvIfXytYJVtskuTQ6zmt" alt="" data-size="line"> *Text extrahieren* können Sie mit Hilfe von regulären Ausdrücken Textpassagen extrahieren oder herausfiltern.

<figure><img src="/files/0uLHTq3uTD8qosDjQJ6X" alt="" width="290"><figcaption></figcaption></figure>

## Parameter "Variable"

In der Auswahlbox *Variable* wählen Sie die gewünschte Variable aus, deren Text Sie filtern möchten.

## Parameter "Regulärer Ausdruck"

Im Eingabefeld *Regulärer Ausdruck* geben Sie einen regulären Ausdruck ein, der **Capture Groups** enthält. Der Ausdruck muss mindestens eine Capture Group enthalten; es können auch mehrere definieren werden.

### Testen

Durch Klick auf den Button *Testen* gelangen Sie auf ein Testseite, wo sie Ihren regulären Ausdruck testen können.

<figure><img src="/files/EtJpvC6zsgAbY2c2ZsJ6" alt="" width="287"><figcaption></figcaption></figure>

Es steht ein Eingabefeld zur Verfügung, in dem Sie einen Beispieltext eingeben können. Mit einem Klick auf den Button *Regulären Ausdruck testen* erhalten Sie eine Vorschau, welcher Text in den *Capture Groups* gespeichert wird.

<figure><img src="/files/WiL1Aws32iNBAhJJIi45" alt="" width="300"><figcaption></figcaption></figure>

## Parameter "Nach erster Übereinstimmung aufhören"

Mit dem Parameter *Nach erster Übereinstimmung aufhören* legen Sie fest, ob Sie alle Vorkommen des Regulären Ausdrucks im Text speichern möchten, oder nach der ersten Übereinstimmung aufhören wollen.

### Beispiel

Mit Hilfe des Regulären Ausdrucks `(.*?): (.)` sollen die Positionen und Beträge aus folgendem Text extrahiert werden:

```
Position 1: CHF 10
Position 2: CHF 20
Position 3: CHF 30
```

Ist der Parameter *Nach erster Übereinstimmung aufhören* **aktiviert**, bekommen Sie als Ergebnis `Position1` und `CHF 10`.

Ist der Schalter **deaktiviert**, bekommen Sie die Ergebnisse `Position 1`, `CHF 10`, `Position 2`, `CHF 20`, `Position 3` und `CHF 30`.

## Parameter "Erste Gruppe extra abspeichern"

Alle gefundenen Capture Groups werden in einer Variable vom Typ `collection` abgespeichert. Es gibt die Möglichkeit, das erste Ergebnis separat abzuspeichern. Dazu muss die Option *Erste Gruppe extra abspeichern* aktiviert werden.

<figure><img src="/files/yQ97bxSFNzjUCWqHm73k" alt="" width="293"><figcaption></figcaption></figure>

Daraufhin erscheint eine zusätzliche Auswahlbox unter *Erste Capture-Gruppe*, um die Variable für das Ergebnis der ersten Gruppe auszuwählen.

## Parameter "Verbleibende Capture-Gruppe"

Die restlichen Gruppen werden dann wieder in einer Variable vom Typ `collection` gespeichert, die unter *Verbleibende Capture-Gruppe* ausgewählt werden kann.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.aiaibot.com/robot/plugins/textverarbeitung/text-extrahieren.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.