Roboyo - Build Your Own Robot - (BYOR)

Die Seite wird erstellt Marion-Helene Freitag
 
WEITER LESEN
Roboyo - Build Your Own Robot - (BYOR)
Roboyo – Build Your Own Robot
    (BYOR)

Version: 1.0
Status: final
Vertraulichkeit: public
Date: [Veröffentlichungsdatum]
Autor: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

Inhaltsverzeichnis
1     Über dieses Dokument ..................................................................................................................................................... 2
    1.1        Historie................................................................................................................................................................................. 2
    1.2        Zweck des Dokuments .......................................................................................................................................... 2
2     BYOR: Demo-Fälle................................................................................................................................................................ 3
    2.1        Yahoo Finance Automatisierung .................................................................................................................... 3
    2.2        Beispiel für eine Automatisierung des Rechners ...........................................................................14

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                                                                                                                                  1
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

1 Über dieses Dokument

1.1 Historie
Datum               Version       Editor               Änderungen
     Seiten

03.06.2019    0.1          Kevin Eberle         Neue Kreation             alle
24.06.2019    0.2          Kevin Eberle         Übersetzung auf Deutsch   alle

1.2 Zweck des Dokuments
Dieses Dokument enthält ein Handbuch für (potenzielle) Kunden, um eigene Demo-
Roboter zu bauen.

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                 2
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

2 BYOR: Demo-Fälle
In diesem Kapitel sind die Demo-Fälle für Kunden beschrieben. Zunächst wird das
Szenario allgemein beschrieben, um Verständnis für den zu automatisierenden Prozess
zu schaffen. Daraufhin folgt jeweils eine Click-für-Click-Anleitung, um einen Roboter für
den jeweiligen Prozess in UiPath zu erstellen.

2.1 Yahoo Finance Automatisierung
2.1.1 Szenario
Im ersten Schritt dieses Prozesses müssen aktuellen Informationen, über die auf der
Yahoo Finance-Seite aufgeführten Waren extrahiert und in einer Excel-Datei gespeichert
werden. Diese Excel-Datei sollte im Ordner ‚Data‘ innerhalb des Projektordners abgelegt
werden. Die Spalten 'Symbol' und 'Day Chart' sollten zuvor herausgefiltert werden, da
diese für die weitere Analyse nicht mehr benötigt werden. Zur besseren Übersicht sollte
die Tabelle zudem nach Waren-Namen in aufsteigender Reihenfolge sortiert werden.
(Optional) Im zweiten Schritt dieses Prozesses sollten positive und negative Waren
getrennt auf entsprechend benannten Blättern in derselben Excel-Datei gespeichert
werden.
(Optional) Als letzter Schritt sollte der Prozess nun nach 2 Minuten Verzögerung
wiederholt werden. Hierzu soll eine Nachrichtenbox als Benutzerinteraktion verwendet
werden, um zu entscheiden, ob der Prozess fortgesetzt werden soll oder nicht. Im Falle
eines Neustarts des Prozesses soll dieser die bereits erstellte Excel Datei an der
angegebenen Stelle löschen. Bei Abbruch des Prozesses, wird hingegen eine
Logmeldung                                                                   erwartet.

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                     3
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

2.1.2 Klick für Klick Handbuch
Basisprozess:
   -   Ziehen Sie eine ‚Open Browser‘ Aktivität per Drag & Drop in den Designbereich und
       verbinden Sie sie mit dem Startknoten des Prozesses.
          o Erstellen Sie im Feld ‚URL-Definition‘ eine neue Variable (STRG + K) namens
              ‚cfg_YahooCommoditiesUrl‘ und geben Sie den Wert dieser Variable mit
              der    URL     der   Yahoo       finance    commodities     Website     an:
              https://finance.yahoo.com/commodities/
          o Vergessen Sie dabei nicht die Anführungszeichen um den Link („abc“)
          o Fügen Sie in den Abschnitt ‚Do‘ eine ‚Maximize Window‘ Aktivität ein.

              Nun sollte der Prozess einen Internet Explorer mit der Yahoo Commodities
              Seite in einem maximierten Fenster öffnen. Sie können dies testen, indem
              Sie den Reiter ‚Execute‘ auswählen und auf Debuggen klicken. Dabei wird
              der Roboter ausgeführt und alle einzelnen Schritte angezeigt.

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                     4
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

   -   Klicken Sie nun im UiPath Reiter ‚Design‘ auf den Button ‚Data Scraping‘.
           o Nach Lesen des Infotextes klicken Sie auf ‚Next‘.
           o Wählen Sie als erstes Element der Tabelle das linke obere Feld der
              Tabelle mit dem Namen ‚Symbol‘ aus.
           o UiPath wird Sie fragen, ob die gesamte Tabelle ausgelesen werden soll,
              da das ausgewählte Feld ein Teil davon ist.
           o Klicken Sie auf ‚Yes‘.
           o Jetzt sollten alle Elemente der Tabelle im Vorschau-Datenfenster sichtbar
              sein.
           o Setzen Sie nun die Anzahl der Ergebnisse auf ‚0‘, um alle Elemente der
              Tabelle zu erhalten.
           o Klicken Sie nun auf ‚Finish‘.
           o UiPath wird Sie bei mehr als einer Seite nach dem Identifikator für eine
              mögliche nächste Seite fragen.
           o Klicken Sie auf ‚No‘.
           o Die neu hinzugefügte Sequenz im Designbereich namens 'Data Scraping'
              sollte nun umbenannt und dann mit dem Prozess verbunden werden.
           o Suchen Sie in der Variablen Übersicht nach der neu erstellten Variable
              ‚ExtractDataTable‘ und benennen Sie sie um in

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                   5
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

              ‚tmp_YahooCommoditiesDT‘ und ändern Sie den ‚Scope‘ auf das letzte
              Element der Dropdown-Liste.

   -   Nach dem Data-Scraping benötigen wir den Browser nicht mehr, also schließen
       wir ihn.
           o Ziehen Sie dazu eine ‚Close Activity‘ Aktivität per Drag & Drop hinter die
                Datenextraktion und verbinden Sie sie mit dem Prozess.
           o Doppelklicken Sie auf die Aktivität und wählen Sie das Browserfenster mit
                der Yahoo-Warenseite aus.

   -   Da wir die beiden Spalten ‚Symbol‘ und ‚Day Chart‘ weglassen wollen,
       implementieren wir jetzt eine ‚Filter Data Table‘ Aktivität.
          o Ziehen Sie eine ‚Filter Data Table‘ Aktivität in den Designbereich und
              verbinden Sie sie mit dem Prozess.
          o Doppelklicken Sie darauf und wählen Sie den Filter-Assistenten aus.
          o Setzen Sie 'tmp_YahooCommoditiesDT' als Input und Output
              Datentabelle, um den Inhalt zu ersetzen.
          o Gehen Sie auf den ‚Output Columns‘ Bereich.
          o Klicken Sie auf die Optionsschaltfläche ‚Remove‘.
          o Fügen Sie die Spalte „Symbol“ hinzu.

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                     6
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

          o   Klicken Sie auf das Plus am Ende der Zeile.
          o   Fügen Sie „Day Chart“ als zweite Spalte hinzu, um die Spalte
              Tagesdiagramm ebenfalls zu entfernen.
          o   Klicken Sie auf ‚OK‘, um die Filteroptionen zu speichern.

   -   Um die Daten zu sortieren, fügen wir eine 'Sort Data Table‘ Aktivität hinzu.
         o Ziehen Sie die Aktivität ‚Sort Data Table‘ in Ihren Workflow und verbinden
             Sie diese.
         o Klicken Sie auf die Aktivität, um sie auszuwählen.
         o Fügen Sie 'tmp_YahooCommoditiesDT' als Ein- und Ausgabedatentabelle
             hinzu.
         o Geben Sie als Spaltenname „Name“ im Feld ‚Name‘ im Bereich ‚Sorting
             Column‘ an.
         o Wählen Sie als Reihenfolge ‚Ascencing‘.

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                  7
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

   -   Um die Ergebnisse der Datenextraktion zu speichern, verwenden wir eine ‚Write
       Range‘ Aktivität aus dem System Tree Bereich, die im Hintergrund und ohne
       Excel-Installation auf der Maschine funktioniert.
          o Ziehen Sie die ‚Write Range‘ Aktivität aus dem Aktivitätspanel per Drag &
              Drop in den Designbereich und verbinden Sie sie mit dem Prozess.
          o Geben Sie die Variable 'cfg_ExcelLocation' als ‚workbook path‘ ein.
          o Das Blatt, in das die Daten geschrieben werden, soll ‚Commodities‘ heißen.
          o Die Daten sollen in das Feld ‚B2‘ geschrieben werden
          o Geben Sie als zu schreibende Datentabelle ‚tmp_YahooCommoditiesDT‘
              ein.
          o Wählen Sie im Eigenschaftenbereich die Option ‚Add Headers‘ aus.

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                  8
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

Erste optionale Prozessänderung:
   -   Um nur positive Werte zu filtern, benötigen wir eine weitere ‚Filter Data Table‘
       Aktivität.
          o Ziehen Sie erneut eine solche in den Designbereich und verbinden Sie sie
               mit dem Prozessende.
          o Doppelklicken Sie darauf und wählen Sie den Filter-Assistenten aus.
          o Setzen Sie ‚tmp_YahooCommoditiesDT‘ als Eingabe und erstellen Sie eine
               weitere Variable (STRG + K) im Ausgabefeld wie z.B.
               ‚tmp_YahooPositiveCommoditiesDT‘.
          o Wählen Sie den Reiter ‚Filter Rows‘.
          o Klicken Sie auf den Radio-Button ‚Remove‘.
          o Fügen Sie ‚Change‘ als Spalte ein.
          o Wählen Sie im Dropdown Bereich die Methode ‚Contains‘ aus.
          o Geben Sie als Wert „-“ ein.
          o Klicken Sie auf ‚OK‘, um die Filteroptionen zu speichern.
          o Durch diesen Schritt werden alle Zeilen mit negativen Werten in der
               Spalte ‚Change‘entfernt.

   -   Um unsere neuen Ergebnisse zu speichern, verwenden wir erneut eine ‚Write
       Range‘ Aktivität.
          o Ziehen Sie die ‚Write Range‘ Aktivität aus dem Aktivitätspanel per Drag &
             Drop in den Designbereich und verbinden Sie sie mit dem Prozess.
          o Weisen Sie die Variable ‚cfg_ExcelLocation‘ als Arbeitsmappen-pfad zu.
          o Das Blatt, in das die Daten geschrieben werden, sollte z.B. ‚Positive
             Commodities‘ heißen.
          o Schreiben wollen wir die Daten in das Feld ‚B2‘ und folgende.
          o Geben Sie als zu schreibende Datentabelle
             ‚tmp_YahooPositiveCommoditiesDT‘ an.
          o Wählen Sie im Eigenschaftenbereich die Option ‚Add Headers‘ aus.

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                    9
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

   -   Wiederholen Sie die letzten beiden Schritte mit negativen Werten. Zu beachtende
       Änderungen sind:
          o tmp_YahooPositiveRohstoffeDT => tmp_YahooNegativeRohstoffeDT
          o Verwenden Sie die Optionsschaltfläche ‚Keep‘ anstelle der Option
             ‚remove‘ um die Daten zu filtern.

          o   Benennen Sie das Blatt, in das die Daten geschrieben werden, z.B. ‚Negative
              Rohstoffe‘ und verwenden Sie die negativen Werte.

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                     10
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

Zweite optionale Prozessänderung:
   -   Hinzufügen einer ‚Delay‘-Aktivität
          o Ziehen Sie eine ‚Delay‘ Aktivität aus dem Aktivitätenbereich in den
              Designbereich und verbinden Sie sie mit dem Ende Ihres Workflows.
          o Klicken Sie auf die Aktivität.
          o Ändern Sie die Dauer auf 2 Minuten im Format 00:02:00.

   -   Verwenden Sie eine ‚Message Box‘ für die Benutzerinteraktion.
          o Fügen Sie eine Aktivität ‚Message Box‘ hinzu und verbinden Sie sie mit
            Ihrem Workflow.
          o Ändern Sie die Eigenschaft ‚Buttons‘ auf ‚YesNo‘.
          o Fügen Sie einen Text ein, der den Benutzer fragt, ob er den Prozess
            fortsetzen möchte oder nicht.
          o Speichern Sie das Ergebnis ‚ChosenButton‘ in einer neu erstellten Variable
            (STRG+K) ab.

   -   Um abhängig von der Wahl des Benutzers handeln zu können, fügen wir eine
       ‚Flow Decision‘ Aktivität hinzu.
           o Ziehen Sie die Aktivität ‚Flow Decision‘ hinter Ihre Nachrichtenbox und
              verbinden Sie diese.
           o Klicken Sie auf die Aktivität.
           o Setzen Sie im Eigenschaftsfenster die Bedingung auf die erstellte Variable
              der Nachrichtenbox, die Sie im letzten Schritt für das Ergebnis erstellt
              haben. Fügen Sie einen „.“ (Punkt) ein und schreiben Sie ‚Equals‘ dahinter
              (Sie können auch die automatische Vervollständigung mit STRG+Tab
              versuchen). In den Klammern der ‚Equals‘ Methode schreiben Sie ‚Yes‘.
           o Ändern Sie das ‚TrueLabel‘ auf Yes.
           o Ändern Sie das ‚FalseLabel‘ auf No.

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                    11
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

   -   Erstellen Sie eine Lognachricht für das Prozessende.
           o Ziehen Sie eine ‚Log message‘ Aktivität auf die rechte Seite Ihrer ‚Flow
               Decision‘ Aktivität und verbinden Sie sie mit deren rechten Seite. Auf dem
               Verbindungsetikett sollte nun ‚No‘ stehen.
           o Doppelklicken Sie auf die ‚Log Message‘ Aktivität.
           o Fügen Sie einen informativen Text in Anführungszeichen ein, wie z.B.
               „Prozessende“.

   -   Erstellen einer Sequenz mit Prozesslogik, um alte Dateien zu löschen, falls der
       Prozess fortgesetzt wird.
           o Ziehen Sie eine ‚Sequence‘ Aktivität in Ihren Designbereich und verbinden
               Sie sie mit der linken Seite Ihrer ‚Flow Decision‘ Aktivität.
           o Verbinden Sie nun die andere Seite der Sequenz mit der ersten Aktivität,
               die mit dem Startknoten Ihres Prozesses verbunden ist.
           o Doppelklicken Sie auf die ‚Sequence‘.
           o Verwenden Sie eine ‚Path exists‘ Aktivität und ziehen Sie sie als erstes
               Element in Ihre Sequenz.
                   ▪ Wählen Sie ‚File‘ als Typ aus.
                   ▪ Geben Sie Ihre Variable ‚cfg_ExelLocation‘ an, die wir beim
                       Schreiben des Excel-Scopes in die Arbeitsmappe erstellt haben.
                   ▪ Klicken Sie auf die Aktivität und erstellen Sie eine neue Output-
                       Variable in den Eigenschaften.
           o Fügen Sie unten in der Sequenz eine ‚If‘-Aktivität hinzu.
                   ▪ Geben Sie die neu erstellte Variable aus der ‚Path exists‘ Aktivität in
                       das Bedingungsfeld ein.
                   ▪ Fügen Sie im Abschnitt ‚Then‘ eine ‚Delete‘ Aktivität hinzu und
                       setzen Sie den Pfad erneut auf ‚cfg_ExcelLocation‘.
                   ▪ Im Abschnitt ‚Else‘ können Sie eine Logmeldung hinzufügen oder
                       das Feld leer lassen.
           o Das war der letzte Schritt für diese Sequenz.

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                        12
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

   -   Der Workflow sollte nun bereit sein und kann getestet werden.
          o Gehen Sie zum ‚Execute‘ Reiter neben ‚Design‘ und klicken Sie auf
             ‚Debuggen‘, um Ihren Workflow zu testen.

   -   Das sollte es sein. Wir wünschen frohes Automatisieren!

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                13
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

2.2 Beispiel für eine Automatisierung des Rechners
2.2.1 Szenario
Das zweite Szenario automatisiert die Windows Rechner Anwendung als Demo-
Anwendung und verwendet eine Excel-Datei für die Ein- und Ausgabe. Die Datei enthält
drei Spalten, wobei die ersten beiden die Eingabewerte darstellen. Für jede Zeile werden
die beiden Werte in den Taschenrechner eingegeben, um die Summe zu erhalten. Das
Ergebnis wird in die dritte Spalte der gleichen Zeile innerhalb der Datei
zurückgeschrieben.

 Wert 1     Wert 2     Summe
 4          5          9
 12         30         43
 ...

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                    14
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

2.2.2 Klick für Klick Handbuch
Unser Prozess besteht aus drei Teilen. Der Erste wird die Initialisierung sein und der Start
aller erforderlichen Anwendungen. Der zweite Teil führt die eigentliche Verarbeitung
durch. Am Ende wird es eine Bereinigung geben, um alle zuvor gestarteten Anwendungen
zu schließen, so dass sich die Maschine in einem sauberen Zustand befindet und den
Prozess erneut ausführen kann.
   -   Ziehen Sie die Aktivität ‚Open Application‘ per Drag & Drop in den Designer und
       verbinden Sie sie mit dem Startknoten.
   -   Starten Sie den Windows-Rechner manuell. (calc.exe)
   -   Klicken Sie in der Aktivität auf ‚Indicate window on screen‘ und dann auf das
       Taschenrechnerfenster.
   -   Die Aktivität sollte nun so aussehen:

   -   Versuchen Sie, den Prozess zu starten. Dies sollte eine neue Instanz des Rechners
       öffnen.
Obwohl der Prozess eine Excel-Datei verwendet, müssen wir Excel nicht manuell starten,
da die Aktivität, die wir in diesem Szenario verwenden möchten, Excel automatisch öffnet
und auch schließt.
Der nächste Teil ist für die gesamte Verarbeitung verantwortlich, vom Lesen der
Eingabewerte bis zum Schreiben der Ergebnisse in die Datei. Die Aktivität, die wir in
diesem Szenario verwenden möchten, ist der ‚Excel Application Scope‘, ein Container für
Excel und die Datei, mit der wir arbeiten möchten. Alle Excel-Aktivitäten im Inneren
beziehen sich auf die gleiche Datei, die zu Beginn der Aktivität geöffnet und am Ende der
Aktivität geschlossen wird.

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                       15
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

   -   Ziehen Sie einen ‚Excel Application Scope‘ per Drag & Drop in den Designer und
       verbinden Sie ihn mit der Aktivität ‚Open Application‘.
   -   Geben Sie den Dateipfad ein: ‚Values.xlsx‘

   -   Um das gesamte Arbeitsblatt zu lesen, verwenden wir die Aktivität ‚Read Range‘
       (wichtig: aus der Excel-Kategorie, nicht aus der Workbook-Kategorie wie im
       vorherigen Szenario).
   -   Ziehen Sie diese Aktivität per Drag & Drop in die Do-Sequenz des ‚Excel Application
       Scope‘.

   -   Die Standardeinstellungen der Aktivität sind in Ordnung, aber wir müssen die
       Ausgabe der Aktivität in einer ‚DataTable‘ speichern. Erstellen Sie in der Output-
       Eigenschaft DataTable eine neue Variable (Strg+K) und benennen Sie sie
       ‚tmp_InputValues‘.

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                      16
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

   -   Als nächstes müssen wir über alle Zeilen in dieser ‚DataTable‘ iterieren. Fügen Sie
       eine ‚For Each Row‘ Aktivität direkt nach der ‚Read Range‘ Aktivität ein und
       verwenden Sie die Variable, die Sie zuvor angelegt haben.

   -   Dies ist eine Schleife über alle Zeilen, die aus der Excel-Datei gelesen werden. In
       jeder Iteration repräsentiert die Variable "row" eine Zeile aus der Datei, mit der wir
       arbeiten können.
Der Einfachheit halber wollen wir in dieser Demo nicht Ziffer für Ziffer per Mausklick
eingeben, sondern die Werte über die Tastatur in den Rechner eingeben. Mit diesem
Ansatz können wir auch die Addition einbeziehen und die Berechnung des Ergebnisses
mit zwei weiteren Tastendrücken auslösen: Die Plus-Taste auf dem Ziffernblock zwischen
den beiden Werten und eine Enter-Taste am Ende.
Einige Programme unterscheiden wohin Tasteneingaben gesendet werden. Der
Taschenrechner funktioniert zum Beispiel am besten, wenn Tasteneingaben in den
Bereich geschickt werden, der auch das Ergebnis anzeigt, was gut ist, da wir später das
Ergebnis aus dem gleichen Element lesen müssen.

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                        17
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

   -   Um ein einzelnes Element mehrfach zu verwenden, können wir eine
       Containeraktivität namens ‚Element Scope‘ verwenden. Ziehen Sie diese Aktivität
       per Drag & Drop in den ‚Body‘ der Schleife.

   -   Klicken Sie auf ‚Indicate on screen‘ und wählen Sie die Ergebnisanzeige des
       Taschenrechners aus.
Wir müssen eine kleine Änderung am Selektor des Elements vornehmen. Der Selektor ist
so etwas wie ein Pfad, der UiPath sagt, wie man das Element findet und eindeutig
identifiziert.
   -   Öffnen Sie den Selektor, indem Sie auf die drei Balken in der rechten oberen Ecke
       klicken und dann auf ‚Edit Selector‘.

   -   Sie müssen nicht den gesamten Selektor verstehen, sondern nur die 0 durch einen
       Stern ‚*‘ im markierten Teil des Screenshots (Attributname) ersetzen.

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                    18
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

Das Ergebnis der Berechnung ist Teil des Elementnamens (hier: 0). Daher hat das Element
für jede Berechnung einen anderen Namen. Um dies zu umgehen, können wir Wildcards
([?,*] wie in der Windows-Suche) verwenden, um jeden beliebigen Wert zu finden.
   -   Klicken Sie auf OK, um die Änderungen im Selektor zu speichern.
   -   Fügen Sie in die Do-Sequenz des Elementumfangs zwei ‚Type Into‘ Aktivitäten ein.

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                   19
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

   -   In dem ersten ‚Type Into‘ wollen wir die erste Zelle der aktuellen Zeile schreiben.
       Darauf kann über: row.Item(0).ToString zugegriffen werden.
   -   Klicken Sie dann auf das + Zeichen rechts (Menü für Sonderzeichen) und wählen
       Sie ‚add‘ für das Nummernblock-Zusatzzeichen.

   -   Die Aktivität sollte dann so aussehen

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                     20
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

   -   Schreiben Sie in den zweiten ‚Type Into‘: row.item(1). ToString
   -   Klicken Sie auf das + Zeichen der zweiten Aktivität und wählen Sie die Taste "Enter".

   -   Nun können wir das Ergebnis ablesen. Dazu verwenden wir die Aktivität ‚Get Full
       Text‘, also ziehen Sie sie per Drag & Drop unter den letzten ‚Type Into‘. Erstellen In
       der Eigenschaft Text (Kategorie Output) erstellen Sie eine neue Variable (Strg+K)
       mit dem Namen ‚tmp_Result‘.

Um das Ergebnis in die gleiche Zeile zurückzuschreiben, müssen wir den Index der Zeile
kennen, in der wir uns gerade befinden. Dafür können wir eine Variable erstellen, die von
der Aktivität selbst für jede Iteration aktualisiert wird.
   -   Wählen Sie die ‚For Each‘ Aktivität und erstellen Sie eine neue Variable (Strg+K) für
       die Index-Eigenschaft (Kategorie Output) und benennen Sie sie ‚tmp_RowIndex‘.
UiPath und viele Programmiersprachen beginnen bei 0 zu zählen, während die erste Zeile
von Excel den Index 1 hat. Außerdem enthält die erste Zeile nur die Header der Datei, so
dass sich die erste Datenzeile bei 2 befindet.
   -   Öffnen Sie das Fenster Variablen und erstellen Sie eine neue Variable mit dem
       Namen ‚tmp_ExcelRow‘ und setzen Sie deren Datentyp auf Int32 (wie
       tmp_RowIndex).
   -   Fügen Sie eine ‚Assign‘ Aktivität unter der ‚Get Full Text‘ Aktivität ein.
   -   Die rechte Seite des ‚Assign‘ wird in der Variablen auf der linken Seite gespeichert.
   -   Da wir den Zeilenindex des Excel berechnen wollen, schreiben Sie links:
       tmp_ExcelRow
   -   Da Excel seine Datenzeilen mit einem Offset von 2 beginnt, schreiben Sie rechts:
       tmp_RowIndex + 2

Jetzt haben wir den Zeilenindex der aktuellen Zeile und können diese Informationen
nutzen, um das zuvor abgerufene Ergebnis zu schreiben. Um einen Einzelwert in eine

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                        21
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Roboyo – Build Your Own Robot (BYOR)

Excel-Datei an einem bestimmten Ort zu schreiben, können wir die Aktivität ‚Write Cell‘
verwenden (Kategorie Excel, nicht Workbook!).
   -   Fügen Sie eine ‚Write Cell‘ Aktivität ein.
   -   Ersetzen Sie den Bereich, der zunächst als "A1" definiert ist, durch: "C" +
       tmp_ExcelRow.ToString
   -   Auf diese Weise verwenden wir jederzeit die Excel-Spalte "C", jedoch wird sich die
       Zeile bei jeder Iteration ändern.
   -   Der Text, den wir schreiben wollen, ist das Ergebnis, das in der Variable tmp_Result
       gespeichert ist.

Das Letzte, was nun getan werden muss, ist das Aufräumen. Da unser Prozess den
Windows-Rechner startet, sollte dieser am Ende des Prozesses auch wieder geschlossen
werden.
   -   Ziehen Sie eine ‚Close Application‘ Aktivität auf der obersten Ebene direkt hinter
       den ‚Excel Application Scope‘ per Drag & Drop und verbinden Sie diesen damit.
   -   Klicken Sie auf ‚Indicate on screen‘ und wählen Sie das Taschenrechnerfenster aus.

Jetzt können Sie die Excel-Datei mit Daten füllen, die berechnet werden sollen, speichern,
schließen und daraufhin den Prozess starten. Der Prozess sollte die Datei sichtbar öffnen
und die Werte in den Rechner eingeben und die Ergebnisse - eine Zeile nach der anderen
- zurückschreiben.

Version: 1.0 Status: FINAL Vertraulichkeit: PUBLIC;
                                                                                      22
Date: [Veröffentlichungsdatum]; Author: Kevin Eberle
Sie können auch lesen