Updated CSV Logger documentation for new object tree

CETONI_Elements_Manual_DE/datalogger_DE/datalogger_DE.rst

@@ -39,91 +39,144 @@ zusätzliche Schaltflächen für die Konfiguration der Datenprotokollierung
 Sobald die Konfiguration der Datenaufzeichnung aktiviert wurde, wird der 
 folgende Konfigurationsdialog angezeigt:
 
-.. image:: Pictures/100002010000038700000200BEF606624A304EEC.png
-   :alt: Konfigurationsdialog Datenprotokollierung
+.. image:: ../../img/datalogger/configuration_dialog_overview.png
 
 Der
 Konfigurationsdialog zur Datenprotokollierung besteht im Wesentlichen
 aus den folgenden Bereichen:
 
 .. rst-class:: guinums
 
-1. **Geräteliste (Device List)** – die Geräteliste enthält alle Geräte
-   von denen Prozessdaten aufgezeichnet werden können. Mit der
-   Filterauswahl über der Geräteliste, können Sie diese nach einem
-   bestimmten Gerätetyp (z.B. Ventile) filtern.
-2. **Logger Channels** – hier sehen Sie in tabellarischer Form alle
+1. **Objektbaum (Object Tree)** - Der Objektbaum enthält einen Baum aller
+   Objekte und deren Eigenschaften, die in der Applikation vorhanden sind.
+   Mit verschiedenen Filtern können Sie den Objektbaum nach bestimmten Objekten
+   filtern. Standardmäßig werden nur Geräte und Geräteeigenschaften angezeigt.
+
+2. **Logger Channels** - hier sehen Sie in tabellarischer Form alle
    Kanäle die vom Logger aufgezeichnet werden.
-3. **CSV File Configuration** – in diesem Bereich können Sie verschiedene
+
+3. **CSV File Configuration** - in diesem Bereich können Sie verschiedene
    Einstellungen zur Aufzeichnung der CSV-Datei konfigurieren.
 
+
+Der Objektbaum
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Im Objektbaum finden Sie eine hierarchische Auflistung aller Objekte (z.B. Geräte) 
+und deren Kindobjekte (wie z.B. untergeordnete Geräte):
+
+.. image:: ../../img/datalogger/object_tree.png
+
+.. rst-class:: guinums
+
+1. **Objekt** - Ein Objekt kann z.B. ein Gerät (hier **Nemesys_M_1**) oder
+   ein anderes Anwendungsobjekt sein. In jedem Objekt finden Sie nach dem
+   Aufklappen in der nächsten Ebene die beiden Elemente **Children** und
+   **Properties**.
+
+2. **Children** - Das Children Element gruppiert alle Kindobjekte des 
+   übergeordneten Objektes. In unserem Beispiel sind dies alle Objekte,
+   bzw. Geräte, die dem Gerät **Nemesys_M_1** untergeordnet sind bzw. zu
+   diesem Gerät gehören.
+
+3. **Properties** - Das Properties Element gruppiert alle Eigenschaften des 
+   übergeordneten Objektes. In unserem Beispiel sind dies alle Eigenschaften
+   des Gerätes **Nemesys_M_1**, welche im Logger aufgezeichnet werden können.
+
+4. **Untergeordnetes Objekt** - In der **Children** Gruppe sind alle untergeordneten
+   Objekte zu finden. Beim Beispiel **Nemesys_M_1** sind dies z.B. die
+   digitalen und analogen Ein- und Ausgänge des Gerätes, wie z.B.
+   **Nemesys_M_1_DigOUT1**. Diese Objekte können wiederum aufgeklappt werden,
+   um deren Kindobjekte und Eigenschaften anzuzeigen.
+
+5. **Eigenschaft** - In der **Properties** Gruppe finden sie alle Eigenschaften 
+   des übergeordneten Objektes. Beim Beispiel **Nemesys_M_1** sind dies z.B.
+   die Eigenschaften **SyringeFillLevel** oder **ActualFlow**. Diese
+   Eigenschaften können Sie einfach per Drag & Drop in die Kanalliste ziehen,
+   um deren Werte aufzuzeichnen.
+
+
+Objektbaum filtern
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Über dem Objektbaum finden Sie verschiedene Filter, mit denen Sie den Objektbaum
+nach bestimmten Kriterien filtern können. Standardmäßig ist die Checkbox 
+:guilabel:`Devices Only` :guinum:`❶` aktiviert. D.h. im Objektbaum werden nur
+Geräte, die vom internen Gerätemanager (:guilabel:`Core.DeviceManager`) verwaltet
+werden angezeigt. Wenn Sie diese Checkbox deaktivieren, werden Ihnen im
+Objektbaum weitere Anwendungsobjekte angezeigt.
+
+Ist die Checkbox :guilabel:`Devices Only`:guinum:`❶` aktiviert, wird Ihnen
+eine Auswahlbox :guinum:`❷` angezeigt, mit der Sie den Gerätebaum nach einem
+bestimmten Gerätetyp filtern können. In der Abbildung unten wurde z.B. nach
+Spritzenpumpen gefiltert:
+
+.. image:: ../../img/datalogger/object_tree_filter.png
+
+Zusätzlich finden Sie direkt über dem Objektbaum ein Eingabefeld :guinum:`❸`,
+mit dem Sie den Objektbaum nach einem bestimmten Begriff, z.B. einem
+Gerätenamen oder eine Geräteeigenschaft, filtern können. In der Abbildung unten
+wurde z.B. nach der Geräteeigenschaft **ActualFlow** gefiltert. D.h.,
+es werden nur Objekte oder Geräte mit dieser Eigenschaft im Objektbaum
+angezeigt:
+
+.. image:: ../../img/datalogger/object_tree_filter_text.png
+
+
 Übersicht Tabelle Logger-Channels
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. image:: Pictures/100002010000028A00000098C8649B9656E2A140.png
+.. image:: ../../img/datalogger/logger_channels_view.png
 
 Die Tabelle :guilabel:`Logger Channels` zeigt in tabellarischer Form die
-Konfiguration des Prozessdatenloggers. Jede Zeile in der Tabelle
+Konfiguration des Loggers. Jede Zeile in der Tabelle
 entspricht genau einer Spalte in der CSV-Dateien die aufgezeichnet wird.
 Folgende Spalten sind vorhanden:
 
--  **Channel** – zeigt die Kanalnummer des entsprechenden Kanals
--  **Device** – enthält den Gerätenamen des Gerätes, von dem ein
-   bestimmter Gerätewert aufgezeichnet werden soll und das Geräteicon
--  **Property** – dies ist der Name der Geräteeigenschaft / des
+-  **Object** - enthält den Namen des Objektes, von dem der Wert einer
+   bestimmten Eigenschaft (Property) aufgezeichnet werden soll und das Icon des
+   Objekts.
+-  **Property** - dies ist der Name der Objekteigenschaft / des
    Prozessdatenwertes, der aufgezeichnet wird. Den Typ der
-   Geräteeigenschaft (numerischer oder boolescher Wert) können Sie an
+   Eigenschaft (numerischer oder boolescher Wert) können Sie an
    dem Typ-Icon einfach erkennen.
 
-   ======== ================
-   |image5| Numerischer Wert
-   |image6| Boolescher Wert
-   |image7| Text
-   ======== ================
+   ============ =================
+   |icon-num|   Numerischer Wert
+   |icon-bool|  Boolescher Wert
+   |icon-text|  Text
+   ============ =================
 
--  **Label** – hier können Sie eine eigene Bezeichnung des Kanals
+-  **Label** - hier können Sie eine eigene Bezeichnung des Kanals
    festlegen. Diese Bezeichnung erscheint dann in der CSV-Datei in der
    Kopfzeile über der Spalte mit den Prozessdaten.
 
-Zum Hinzufügen eines Prozessdatenkanals zum Logger, führen Sie einfach
-folgende Schritte durch.
+Zum Hinzufügen eines Kanals zum Logger, führen Sie einfach
+folgende Schritte durch:
 
 
 Datenprotokollierung konfigurieren
 -----------------------------------
 
+Kanäle hinzufügen
+~~~~~~~~~~~~~~~~~~~~
+
 :step:`Schritt 1 - Kanäle hinzufügen`
 
-Ziehen Sie aus
-der Geräteliste :guilabel:`Device List` das Gerät, von dem Sie Prozessdaten aufzeichnen möchten,
-via Drag & Drop (Ziehen und Ablegen) in die Kanalliste :guilabel:`Logger Channels`. Der neue Kanal
-wird in der Zeile eingefügt, an der sie die Maustaste loslassen (siehe
-Abbildung unten).
+Ziehen Sie aus dem Objektbaum :guilabel:`Object Tree` die Objekteigenschaft,
+welche Sie aufzeichnen möchten, per Drag & Drop in die Kanalliste 
+:guilabel:`Logger Channels`. Der neue Kanal wird in der Zeile eingefügt, an 
+der sie die Maustaste loslassen (siehe Abbildung unten).
 
-.. image:: Pictures/1000020100000361000001BF5E60484B572C01AB.png
-   :alt: Logger-Kanäle via Drag & Drop hinzufügen
+.. image:: ../../img/datalogger/csv_logger_drag_and_drop.png
 
 .. admonition:: Tipp
    :class: tip
 
-   Um die Geräteauswahl zu erleichtern, können    
-   Sie die Geräteliste nach Gerätetyp filtern. 
-
-
-:step:`Schritt 2 - Geräteeigenschaft auswählen`
-
-Wählen Sie nun im Bereich der Logger-Kanäle :guilabel:`Logger Channels` die
-Geräteeigenschaft aus (*Property*), die Sie aufzeichnen möchten. Klicken
-Sie dafür doppelt in die :guilabel:`Property`-Spalte des Gerätes, welches Sie
-konfigurieren möchten. Nach dem Doppelklick wird Ihnen ein Auswahlfeld
-angezeigt, aus dem Sie die Geräteeigenschaft auswählen können (siehe
-Abbildung unten).
-
-.. image:: Pictures/1000020100000361000001A38444A253627EAD70.png
-   :alt: Geräteeigenschaft zum Aufzeichnen auswählen
+   Um die Auswahl einer Objekteigenschaft (Property) zu erleichtern, können Sie den 
+   Objektbaum nach verschiedenen Kriterien filtern.
 
-
-:step:`Schritt 3 - Kanalbeschreibung`
+:step:`Schritt 2 - Kanalbeschreibung`
 
 In der Spalte :guilabel:`Label` können Sie für jeden Kanal eine eigene
 Beschriftung vergeben. Diese Beschriftung wird später dann in der
@@ -137,14 +190,6 @@ Klicken Sie zum Ändern der
 Beschriftung doppelt in die Tabellenzelle (siehe Abbildung oben) und
 geben Sie dann die neue Bezeichnung ein.
 
-.. admonition:: Wichtig
-   :class: note
-
-   Bei der Auswahl einer anderen              
-   Geräteeigenschaft wird automatisch eine neue            
-   Kanalbezeichnung vergeben. D.h. Sie sollten die         
-   Kanalbezeichnung erst nach der Auswahl der              
-   Geräteeigenschaft festlegen.   
 
 Kanäle löschen
 ~~~~~~~~~~~~~~
@@ -159,8 +204,8 @@ aufrufen und den Menüpunkt :menuselection:`Delecte Selection` auswählen.
 Sie können alle Kanäle des Loggers gleichzeitig löschen, indem Sie im
 Kontextmenü den Punkt :menuselection:`Clear Logger` auswählen.
 
-
-:step:`Schritt 4 – CSV Eigenschaften konfigurieren`
+CSV Eigenschaften konfigurieren
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Im Bereich :guilabel:`CSV File Configuration` können Sie globale Eigenschaften 
 des CSV Loggers und zum
@@ -311,13 +356,12 @@ Funktion Stop CSV Logger
 Diese Funktion stoppt das aktuelle Logging und schließt die
 geöffnete Log-Datei.
 
+.. |image14| image:: Pictures/100000000000012100000091D7BFE42C03BA6ECE.png
+.. |image15| image:: Pictures/10000000000001220000008F424E5926A933056B.png  
 
-.. |image5| image:: Pictures/100004EA000035050000350581CFD983D12D425F.svg
-   :width: 40
-.. |image6| image:: Pictures/1000034B000035050000350585C9BEED447C4FB8.svg
+.. |icon-num| image:: ../../img/datalogger/property_number.svg
    :width: 40
-.. |image7| image:: Pictures/10000B740000350500003505221106A05ED7DC85.svg
+.. |icon-bool| image:: ../../img/datalogger/property_bool.svg
    :width: 40
-
-.. |image14| image:: Pictures/100000000000012100000091D7BFE42C03BA6ECE.png
-.. |image15| image:: Pictures/10000000000001220000008F424E5926A933056B.png   
+.. |icon-text| image:: ../../img/datalogger/property_text.svg
+   :width: 40