Textpanel

Das Textpanel erlaubt es verschiedene sowie strukturierte Arten von Text zu bearbeiten und darzustellen. Dazu gibt es verschiedene Ansichten, die sich je nach Struktur des Textes unterscheiden können. Ganz klassisch kann der allgemeine Texteditor alle möglichen Texte und sogar binäre Daten anzeigen.

Um das Textpanel zu öffnen muss das Vergrößerungs-Symbol, auf welches der Pfeil zeigt, angeklickt werden. Danach kann anhand des Auswählens des umrandeten Zahnräder-Symbols der Editor geöffnet werden

textpanel

Das Textpanel kann in allen Prozessoren geöffnet werden, solange der Feldtyp dafür geeignet ist. Jedes Feld, welches das Vergrößerungs-Symbol besitzt, unterstützt die Textpanel-Funktion.

Texteditor

Navigation

textpanel-navigation
  1. Burgermenü

  2. Auswahl Texttyp

  3. Formatierungszeichen ein-/ausblenden

Burgermenü

Durch das Anklicken des Burgermenüs werden weitere Optionen angeboten, wie zum Beispiel das Hochladen einer Datei. Es ist ebenfalls möglich die Daten, welche im Texteditor hinterlegt wurden, zu speichern. Sollten Sie mehr Fragen zum Textpanel während der Bearbeitung haben, werden Sie beim Anklicken des Advanced features Element auf diese Dokumentationsseite weitergeleitet.

textpanel burgermenu

Auswahl Textstruktur

Das Textpanel ist in der Lage automatisch abhängig vom Skripttyp farbliche Makierungen zu setzen.

textpanel texteditor

Code-Vervollständigung

Bei der Verwendung von mehrzeiligen Texteditoren in IGUASU können Sie die Tastenkombination "Strg + Leertaste" verwenden, um Vorschläge zur Codevervollständigung zu erhalten. Bei einzeiligen Textfeldern, die erweiterbar sind, wird bei Verwendung des Tastaturkürzels automatisch zum mehrzeiligen Texteditor gewechselt, bevor die Vorschläge angezeigt werden.

Welche Vorschläge angezeigt werden, hängt von der aktiven Sprache des Texteditors ab. Um die aktive Sprache zu ändern, vergewissern Sie sich, dass das "Settings Panel” maximiert ist und wählen Sie dann eine unterstützte Sprache aus dem Dropdown-Menü.

NiFi Expression Language Unterstützung

In den meisten Fällen ist die aktive Standardsprache von Texteditoren "text", was die Verwendung der Nifi Expression Language (NiFi EL) erleichtert.

NiFi EL-Ausdrücke müssen innerhalb eines "${}" geschrieben werden, d.h. der Cursor muss sich an einer gültigen Position befinden, damit Vorschläge zur Code-Vervollständigung angezeigt werden.

Nur Texteditoren für Properties, die NiFi EL unterstützen, werden NiFi El-Ausdrücke vorschlagen und einen $-Button haben.

Die Prozessoren TransformXML und JSONataTransformJSON unterstützen NiFi EL, erfordern aber, dass die Ausdrücke gewrapped werden. Lesen Sie die Dokumentation der Prozessoren, um zu erfahren wie.

Beim Schreiben eines NiFi EL-Ausdrucks schlägt der Texteditor die Verwendung von subjektlosen Funktionen, Funktionsverkettungen, Subjektfunktionen, Umgebungsvariablen und Attributen auf der Grundlage des Kontexts vor, der von den Syntaxregeln von NiFi EL und den aktuell in IGUASU geladenen Daten bestimmt wird. Außerdem kann man im Auswertungsfeld darunter, eine Vorschau vom Ausdrucksauswertung sehen. Der Kontext, der für jede Art von Vorschlägen erforderlich ist, wird im Folgenden erläutert.

Es ist möglich, NiFi EL-Ausdrücke zu verschachteln, z.B. um Attribute als Argumente für eine Funktion zu verwenden.

Subjektlose Funktion

Subjektlosen Funktionen darf innerhalb eines NiFi EL-Ausdrucks kein Text vorangestellt werden.

Funktionsverkettung

Innerhalb eines NiFi-Ausdrucks werden vorangestellte Textabschnitte (einschließlich Funktionen) als potenzielle Subjekte interpretiert, von denen aus Subjektfunktionen verkettet werden können. Der Texteditor bietet dementsprechend einen "Chain Function"-Vorschlag, der ein ":" einfügt (markiert das Ende eines Subjekts und den Beginn einer Subjektfunktion), und dann die Verwendung einer Subjektfunktion vorschlägt.

Subjektfunktion

Subjektfunktionen müssen mit einem Subjekt, gefolgt von einem ":", eingeleitet werden.

Umgebungsvariablen

Die Umgebungsvariablen, die relevante Verzeichnispfade für IGUASU enthalten: "IGUASU_DRIVER_PATH", "IGUASU_KEYSTORES_PATH", "IGUASU_PERSISTENCE_PATH" und "IGUASU_PATH", werden ebenfalls vorgeschlagen. Sie können nur für sich selbst oder als Subjekt verwendet werden. Eine Erläuterung für die verschiedenen Umgebungsvariablen finden Sie hier.

Attribute

Attribute, die im Daten-Panel vorhanden sind (entweder aus einem Provenance-Event geladen oder manuell im Daten-Panel hinzugefügt), werden vorgeschlagen. Sie können nur für sich selbst oder als Subjekt verwendet werden.

Nur Properties, mit der passende "Expression Language Scope" können Attribute auswerten. Welchen Scope eine Property hat, kann man am Icon erkennen, das ganz recht im Auswertungsfeld gezeigt wird.
Texteditoren für Properties ohne den passenden Scope werden Attribute aus dem Daten-Panel auch nicht vorschlagen.

Tastaturkürzel

Action PC Mac

Code completion

Ctrl-Space

Ctrl-Space

Select all

Ctrl-A

Cmd-A

Find

Ctrl-F

Cmd-F

Replace

Ctrl-H

Cmd-Alt-F

Remove line

Ctrl-D

Cmd-D

Undo

Ctrl-Z

Cmd-Z

Redo

Ctrl-Y

Cmd-Y

Hierarchische Strukturen (XML, JSON)

Wenn der Inhalt in dem Panel in XML oder JSON vorliegt, gibt es neben der Textansicht auch die Möglichkeit, eine Baumansicht zu verwenden.

An den Elementen des Baumes gibt es dann Menüs, über die Elemente hinzugefügt, gelöscht oder editiert werden können. In den Menüs sehen Sie auch die Tastenkombinationen, mit denen die Aktionen direkt erreicht werden können.

textpanel xml baum

Einzelne Elemente oder auch ganze Teilbäume können über Drag-and-Drop verschoben werden.

xml drag and drop

Navigation

  1. Alle Aktionen können über ein integriertes "Undo/Redo" zurückgenommen werden.

  2. Im Bereich der Suche kann nach Texten gesucht werden, sowie ein XPath Suchfeld eingeblendet werden. Gefundene Einträge werden dann blau hinterlegt.

  3. Ein weiteres Feld kann eingeblendet werden, dass den Pfad (in XPath/JSONata) des aktuell ausgewählten Feldes oder Fehlermeldungen zu Operationen anzeigt.

  4. Startet die Suche ab dem ausgewählten XML-Node.

textpanel xml uebersicht

Wenn Sie im Texteditor Ihre Datei erstellen und eine übersichtlichere Ansicht benötigen, können Sie anhand des "Pretty Print" Knopfs, die Anordnung ihrer Datei neu strukturieren.

textpanel xml 3

JSON-Ansicht

Im Falle der JSON-Ansicht wird in der Suche statt eines XPath ein JSONata-Feld verwendet.

textpannel jsonata