Beispiel für die Verwendung von Aktionen im XML-package

Erstellen Sie unter Verwendung des XML-packages einen bot, der Daten aus einer XML-Datei liest und in ein Excel-Arbeitsblatt schreibt.

Das in diesem Tutorial verwendete XML-Beispiel hat die folgende Struktur:
<movies>
    <movie genre="" year="">
        <name></name>
        <description></description>
        <director></director>
        <writers>
            <writer type=""></writer>
            <writer type=""></writer>
        </writers>
        <rating>R</rating>
    </movie>
</movies>

Bevor Sie beginnen, laden Sie eine XML-Beispieldatei herunter.

Das Tutorial wird die folgenden Aktionen demonstrieren:
  • Verwenden eines XPath-Ausdrucks, um eine Knotenmenge mit einem bestimmten Wert zu erhalten, und durchlaufen der Elemente in der Knotenmenge, z. B. Filme mit einer bestimmten Bewertung in diesem Tutorial.
  • Verwenden einer XPath-Funktion, um die untergeordneten Knotengruppen zu durchlaufen.
  • Verkettung von Variablen zur Erstellung einer Zeichenkette.
  • Schreiben von Daten in ein Excel-Arbeitsblatt.

Vorbereitungen

Stellen Sie Folgendes sicher:

  • Sie wissen, wie man bots erstellt.
  • Sie sind mit der Benutzeroberfläche von Control Room vertraut.

Prozedur

  1. Erstellen Sie einen bot und nennen Sie ihn XMLDataReader.
  2. Fügen Sie einen Schritt hinzu, um alle Aufgaben zum Öffnen eines Excel-Arbeitsblattes zu gruppieren.
    1. Fügen Sie die Schritt > Schritt action nach dem Ablauf von Start in den Bot editor ein.
      Anmerkung: Um eine action hinzuzufügen, suchen Sie die action im Bereich Aktionen und ziehen Sie sie in den Ablauf des bots im Bot editor.
    2. Geben Sie in Titel den Eintrag Open an Excel Sheet ein und speichern Sie die action.
  3. Um ein Excel-Arbeitsblatt zu erstellen und zu öffnen, verwenden Sie Excel Advanced > Arbeitsmappe erstellen.
    1. Fügen Sie die Excel Advance > Arbeitsmappe erstellen action innerhalb der Schritt action- hinzu.
    2. Geben Sie für Dateipfad C:\Filme\Filme.xlsx ein, und speichern Sie die Datei action. Wenn der Ordner Filme im angegebenen Pfad nicht vorhanden ist, erstellen Sie einen Ordner Filme im Pfad.
  4. Um die erste Zelle auf dem Excel-Arbeitsblatt auszuwählen, verwenden Sie die Excel Advanced > Zu Zelle wechseln action.
    1. Fügen Sie die Aktion Excel Advanced > Zu Zelle wechseln nach der Aktion Excel Advanced: Arbeitsmappe erstellen hinzu.
    2. Klicken Sie auf Spezifische Zelle, wenn sie nicht bereits ausgewählt ist, und geben Sie A1 ein.
    3. Speichern Sie die Aktion.
  5. Erstellen Sie einen weiteren Schritt, um alle Aufgaben zum Abrufen von XML-Daten zu gruppieren.
    1. Fügen Sie die Aktion Schritt > Schritt nach der ersten Schritt-action hinzu.
    2. Für Titel geben Sie XML-Daten abrufen ein und speichern dann die action.
  6. Starten Sie eine XML-Sitzung.
    1. Fügen Sie die XML > Sitzung starten action innerhalb des Schritts XML-Daten abrufen hinzu.
    2. Wählen Sie unter Datei die Option Desktop und suchen Sie die heruntergeladene XML-Beispieldatei und wählen Sie sie aus.
    3. Speichern Sie die Änderungen.
  7. Um alle Filmknoten mit dem Rating R zu erhalten, verwenden Sie die Mehrere Knoten abrufen action.
    1. Fügen Sie die Aktion XML > Mehrere Knoten abrufen nach der Sitzung starten action hinzu.
    2. Geben Sie in XPath-Ausdruck den Eintrag //movie[rating/text()=\'R\'] ein und speichern Sie die action.
      Der ausgewählte Knotensatz wird in einer Systemvariablen gespeichert und steht nun dem Iterator Für jeden Knoten in einem XML-Dataset zur Verfügung.
    3. Um sicherzustellen, dass die Aktion den gesamten Knotensatz und nicht nur die Textknoten abruft, klicken Sie auf XPath-Ausdruck.
  8. Verwenden Sie die Aktion Schleife, um durch die ausgewählte Knotenmenge zu iterieren, die die Mehrere Knoten abrufen action abruft.
    1. Fügen Sie Schleife > Schleife nach der XML: Mehrere Knoten abrufen-action hinzu.
    2. Unter Iterator wählen Sie XML > Für jeden Knoten in einem XML-Dataset als Iterator.
    3. Klicken Sie unter Aktuelle Zeile dieser Variablen zuweisen auf (x) und erstellen Sie eine Variable mit dem Standardnamen, z. B. XMLNode. Jedes Element des Knotensatzes ist nun über die Variable verfügbar.
    4. Speichern Sie den action.
  9. Um den Filmnamen aus dem iterierten Knoten zu erhalten, verwenden Sie die Einzelnen Knoten abrufen action.
    1. Fügen Sie die Aktion XML > Einzelnen Knoten abrufen innerhalb der Schleife: Schleife-action hinzu.
    2. Geben Sie in XPath-Ausdruck den Eintrag $XMLNode$/name ein.
    3. Erstellen Sie unter Die Ausgabe einer Variablen zuweisen eine Variable und nennen sie diese sMovieName.
    4. Speichern Sie den action.
  10. Um den Filmnamen aus der XMLNode-Variable zu schreiben, verwenden Sie die Zelle festlegen action.
    1. Fügen Sie die Excel Advanced > Zelle festlegen action nach der Einzelnen Knoten abrufen action ein.
    2. Klicken Sie auf Aktive Zelle, geben Sie $sMovieName$ in Zellenwert ein, und speichern Sie die action.
  11. Um eine neue Zelle im Excel-Arbeitsblatt auszuwählen, verwenden Sie die Zu Zelle wechseln action.
    1. Fügen Sie die Zu Zelle wechseln action nach der Zelle festlegen action nach der Excel Advanced: Zelle festlegen-action hinzu.
    2. Klicken Sie auf Aktive Zelle, wählen Sie Eine Zelle nach rechts und speichern Sie dann die action.
  12. Um den Namen des Regisseurs aus dem iterierten Knoten zu erhalten, verwenden Sie die Einzelnen Knoten abrufen action.
    1. Fügen Sie die XML > Einzelnen Knoten abrufen action nach der Excel Advanced: Zu Zelle wechseln-action hinzu.
    2. Für XPath-Ausdruck geben Sie $XMLNode$/director an.
    3. Erstellen Sie unter Die Ausgabe einer Variablen zuweisen eine Variable mit dem folgenden Namen: sDirector
    4. Speichern Sie den action.
  13. Um den Namen des Regisseurs in die XMLNode-Variable zu schreiben, verwenden Sie die Zelle festlegen action.
    1. Fügen Sie die Aktion Excel Advanced > Zelle festlegen nach der XML: Einzelnen Knoten abrufen-action hinzu.
    2. Klicken Sie auf Aktive Zelle, geben Sie $sDirector$ für Zellwert ein, und speichern Sie die action.
  14. Um eine neue Zelle im Excel-Arbeitsblatt auszuwählen, verwenden Sie die Zu Zelle wechseln action.
    1. Fügen Sie die Zu Zelle wechseln action nach der Excel Advanced: Zelle festlegen-action hinzu.
    2. Klicken Sie auf Aktive Zelle, wählen Sie Eine Zelle nach rechts und speichern Sie die action.
  15. Da der<Verfasser->Knoten mehrere<Verfasser->Knoten enthalten kann, ermitteln Sie jeden Namen der Verfasser, verketten Sie die Namen und schreiben Sie sie in eine einzige Zelle, anstatt Werte in mehrere Zellen zu schreiben. Dazu fügen Sie die Schleife-action innerhalb der aktuellen Schleife-action ein.
    1. Um die Nummer des<Verfasser->Knotens innerhalb der<Verfasser->Knoten abzurufen, fügen Sie XML > Xpath-Funktion ausführen nach der Excel Advanced: Zelle festlegen-action hinzu. Geben Sie in XPath-Ausdruck den Eintrag count($XMLNode$/writers/writer) ein. Erstellen Sie unter Die Ausgabe einer Variablen zuweisen eine Variable namens sWriterCount.
      Verwenden Sie<Verfasser->Knoten, um eine Schleife durch alle<Verfasser->Knoten auszuführen.
    2. Fügen Sie die Aktion Schleife > Schleife nach der XML: XPath-Funktion ausführen-action hinzu.
      Wichtig: Die zweite Schleife-action muss innerhalb der Haupt- Schleife-action eingefügt werden.
    3. Unter Iterator wählen Sie Für n-mal als Iterator.
    4. In Mal geben Sie Folgendes ein: $sWriterCount.String:toNumber$
      Anmerkung: sWriterCount enthält einen Zeichenfolge-Wert. Um eine Zeichenfolge in eine Nummer umzuwandeln, können Sie das Format
      lt;variable name>.String:toNumber$ verwenden, zum Beispiel $sWriterCount.String:toNumber$.
    5. Erstellen Sie unter Aktuellen Wert einer Variablen zuweisen (Optional) eine Variable mit dem Namen Counter.
    6. Speichern Sie den action.
  16. Um die Werte aus allen Verfasser-Knoten zu verketten, erstellen Sie eine Zeichenfolgevariable.
    1. Klicken Sie im Bereich Variablen auf das Plus-Symbol.
      Das Fenster Variable erstellen... öffnet sich.
    2. Wählen Sie unter Typ die Option Zeichenfolge.
    3. In Name geben Sie sWriters ein.
    4. Klicken Sie auf Erstellen.
  17. Um den Wert aus dem iterierten<Verfasser->Knoten abzurufen, verwenden Sie die Einzelnen Knoten abrufen. action.
    1. Fügen Sie die XML > Einzelnen Knoten abrufen action innerhalb der zweiten Schleife action- ein.
    2. Geben Sie für XPath-Ausdruck $XMLNode$/writers/writer[$Counter.Number:toString$] an.
      Mit der Variablen Counter können Sie auf einen Knoten mit einem bestimmten Index zugreifen. Da die Variable Counter einen numerischen Wert enthält, wird der Ausdruck .Number:toString$ zur Variable Counter hinzugefügt, um sie in eine Zeichenfolge umzuwandeln.
    3. Erstellen Sie unter Die Ausgabe einer Variablen zuweisen eine Variable und nennen sie diese sWriter.
    4. Speichern Sie den action.
  18. Um Werte aus den Verfasser-Knoten zuzuweisen, verwenden Sie die Zeichenfolge > Zuweisen action.
    1. Fügen Sie die Zeichenfolge > Zuweisen action nach XML: Einzelnen Knoten abrufen innerhalb der zweiten Schleife hinzu.
    2. Lassen Sie Quell-Zeichenfolgenvariable(n)/Wert auswählen (Optional) leer und geben Sie $sWriters$, $sWriter$ ein.
    3. Wählen Sie unter Ziel-Zeichenfolgenvariable auswählen sWriters.
    4. Speichern Sie den action.
    Nach Abschluss der inneren Schleife enthält die Variable sWriters alle Namen der Verfasser.
  19. Um die Namen der Verfasser in eine neue Zelle zu schreiben, verwenden Sie die Aktion Excel Advanced > Zelle festlegen innerhalb der Hauptschleife.
    1. Fügen Sie die Excel Advanced > Zelle festlegen action nach der inneren Schleife-Aktion innerhalb der ersten Schleife- action hinzu.
    2. Klicken Sie auf Aktive Zelle.
    3. Geben Sie $sWriters$ für Zellenwert ein.
    4. Speichern Sie den action.
    Die Daten, die von einem<Film->Knoten, empfangen wurden, werden in eine Zeile geschrieben. Zum Schreiben der Daten des nächsten<Film->müssen Sie die nächste Zeile des Excel-Arbeitsblatts auswählen.
  20. Um den Cursor in die nächste Zeile zu bewegen, verwenden Sie die Excel Advanced > Zu Zelle wechselnaction.
    1. Fügen Sie die Zu Zelle wechseln action nach der Zelle festlegen action ein.
    2. Klicken Sie auf Aktive Zelle, wählen Sie Zeilenanfang, und speichern Sie dann die action.
    3. Fügen Sie die Zu Zelle wechseln action erneut hinzu. Klicken Sie auf Aktive Zelle, wählen Sie Eine Zelle darunter, und speichern Sie dann die action.
  21. Bevor der nächste Knoten im abgerufenen<Film->Knotensatz iteriert wird, müssen Sie die Variable sWriters zurücksetzen. Um die Variable sWriters zurückzusetzen, führen Sie die folgenden Schritte durch:
    1. Fügen Sie die Aktion Zeichenfolge > Zuweisen nach der Aktion Excel Advanced: Zu Zelle wechseln innerhalb der Hauptschleife hinzu.
    2. Lassen Sie Quell-Zeichenfolgenvariable(n)/Wert auswählen (Optional) leer.
    3. Wählen Sie unter Die Zeichenfolgenvariable für das Ziel auswählen die Option sWriters aus.
    4. Speichern Sie den action.
  22. Erstellen Sie einen Schritt.
    1. Fügen Sie die Aktion Schritt > Schritt nach der zweiten Aktion Schritt ein.
    2. Für Titel geben Sie Datei schließen ein.
  23. Um das Excel-Arbeitsblatt zu schließen, verwenden Sie die Excel Advanced Schließen action.
    1. Fügen Sie Excel Advanced > Schließen im Schritt Datei schließen hinzu.
    2. Speichern Sie die Änderungen.
  24. Führen Sie den bot aus.