# Text extrahieren

Mit dem Plugin <img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FkK592C2dYVR6gJ7PooYl%2Fplugin-extract-text-01.png?alt=media&#x26;token=bb16fc9f-d085-4c8a-bb03-16385af24af0" alt="" data-size="line"> *Text extrahieren* können Sie mit Hilfe von regulären Ausdrücken Textpassagen extrahieren oder herausfiltern.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FmAhv8RaCbtq6ktqWz2IA%2Fplugin-extract-text-03.png?alt=media&#x26;token=7b58c3b3-c625-4072-8d36-3df478fc1285" 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FoaD3Huu9EUVlaGDowPID%2Fplugin-extract-text-04.png?alt=media&#x26;token=e4868337-bfdc-429f-9710-9cd82ffd7ccd" 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FQ0vW9oiuxfvKvaBMuZPp%2Fplugin-extract-text-05.png?alt=media&#x26;token=f10e329e-79d6-4379-b7af-d06dd744b20d" 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FJHSRv2DJG9LZAU9HMIxt%2Fplugin-extract-text-06.png?alt=media&#x26;token=d3039d82-c026-4de2-90e4-e207bd4ae02c" 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.