Erstellen einer Basisbibliothek

Das folgende Tutorial führt Sie durch die Schritte zum Erstellen einer Bibliothek in Studio, zum Veröffentlichen und zur Verwendung in anderen Automatisierungsprojekten.

Das Erstellen einer Bibliothek funktioniert ähnlich wie das Erstellen eines Basisprozesses. Der Unterschied besteht darin, dass Pakete zur Erstellung wiederverwendbarer Komponenten dienen, die im Kontext anderer Projekte verwendet werden können.

In diesem Beispiel werden Daten aus einer Excel-Tabelle abgerufen und an eine andere Excel-Datei angefügt. Anschließend werden Sie durch die Schritte zum Packen und Veröffentlichen des Projekts in einen benutzerdefinierten Feed, zum Installieren des Pakets in ein anderes Projekt und zum Verwenden der darin enthaltenen Aktivität geführt.

In diesem Beispiel werden Excel-Aktivitäten verwendet, für die die Installation von Microsoft Excel auf Ihrer Maschine nicht erforderlich ist.

Fangen wir an.

Erstellen einer Bibliothek

1. Starten Sie Studio. Klicken Sie in der Backstage-Startansicht auf Bibliothek, um ein neues Bibliotheksprojekt zu erstellen. Das Fenster Neue leere Bibliothek wird angezeigt.
   
   

   

   
   
2. Geben Sie einen Namen für das Projekt ein und verwenden Sie für dieses Beispiel QuickLibrary. Fügen Sie eine kurze Beschreibung hinzu und wählen Sie einen Speicherort aus.
   
   Hinweis: Der Projektname darf nicht länger als 128 Zeichen und die Beschreibung nicht länger als 500 Zeichen sein.
3. Klicken Sie auf Erstellen. Die neue Bibliothek wird in Studio geöffnet.

Hinzufügen von Excel-Aktivitäten

1. Suchen Sie im Panel Aktivitäten nach der Aktivität Read Range unter System > Datei > Arbeitsmappe, und legen Sie sie im Panel Designer ab.
   • Fügen Sie im Feld Arbeitsmappenpfad den Pfad zu der Excel-Datei hinzu, aus der Sie die Daten abrufen möchten.
   • Geben Sie in das Feld Blattname den Namen des Blatts ein. Für dieses Beispiel wird der Standardname Sheet1 beibehalten
   • Fügen Sie im Feld Bereich den Bereich der zu lesenden Zellen hinzu. Für dieses Beispiel lassen Sie das Feld leer, damit alle Zellen gelesen werden.
2. Klicken Sie im Panel Eigenschaften der Aktivität Read Range auf das Feld neben DataTable, und verwenden Sie dann die Tastenkombination Strg+K, um das Variablenfeld zu öffnen. Fügen Sie dann den Namen GetRange hinzu. Die Variable vom Typ DataTable speichert Daten aus den gelesenen Zellen.
   
   

   

   
   

   
   

   

   
   
3. Suchen Sie im Panel Aktivitäten nach der Aktivität Append Range unter System > Datei > Arbeitsmappe. Fügen Sie sie unter der Aktivität „Read Range“ hinzu.
   • Fügen Sie im Arbeitsmappenpfad den Pfad zu der Datei hinzu, der Sie die kopierten Daten anfügen möchten.
   • Fügen Sie in Blattname den Namen des Blatts hinzu. Behalten Sie für dieses Beispiel den Standardwert Sheet bei.
   • Fügen Sie im Feld Datentabelle die zuvor erstellte Variable GetRange hinzu, die die Informationen speichert. Ihr Projekt sollte wie in der Abbildung unten aussehen.
     
     

     

     
     
4. Klicken Sie im Menüband auf Datei ausführen oder verwenden Sie Strg + F6, um den Workflow auszuführen. Die Daten aus der ersten Excel-Tabelle werden an eine andere angehängt. Sie ersetzen keine Daten, die bereits in der zweiten Tabelle vorhanden sind.

Packen einer Bibliothek

Um diese Bibliothek als wiederverwendbare Komponente zu anderen Automatisierungsprojekten hinzuzufügen, müssen Sie sie als .nupkg-Datei verpacken, indem Sie das Projekt veröffentlichen.

1. Öffnen Sie das Bibliotheksprojekt in Studio.
2. Klicken Sie im Menüband auf die Schaltfläche Veröffentlichen. Das Fenster Bibliothek veröffentlichen wird geöffnet.
   • Geben Sie auf der Registerkarte Paketeigenschaften einen Paketnamen ein. Fügen Sie im Feld Versionshinweise ein paar Details zur Bibliothek hinzu. Dies ist nützlich, um die Änderungen nachzuverfolgen, die an der Bibliothek in jeder neuen veröffentlichten Version vorgenommen wurden.
   • Wählen Sie auf der Registerkarte Veröffentlichungsoptionen die Option Veröffentlichen in > Benutzerdefiniert aus, und fügen Sie dann im Feld Benutzerdefinierte URL den Pfad zu einem lokalen Ordner hinzu. Sie können z. B. einen myfeed-Ordner auf Ihrem Desktop erstellen.
3. Klicken Sie auf Veröffentlichen. Das Paket ist jetzt im lokalen Ordner als .nupkg-Datei verfügbar.

Installieren von wiederverwendbaren Komponenten

Um das Paket in einem anderen Projekt zu verwenden, müssen Sie es zunächst als Projektabhängigkeit hinzufügen. Erstellen Sie zunächst einen neuen Prozess in Studio, wie auf der Seite Erstellen eines Basisprozesses erklärt.

Weitere Informationen zu Projektabhängigkeiten finden Sie auf der Seite Über Abhängigkeiten.

Hinzufügen eines benutzerdefinierten Feeds

1. Klicken Sie im Studio-Menüband auf Pakete verwalten > Einstellungen. Die standardmäßigen und benutzerdefinierten Feeds werden angezeigt.
2. Fügen Sie im Container Benutzerdefinierte Paketquellen einen Namen für Ihren Feed im Feld Name hinzu. Fügen Sie im Feld Quelle den Pfad zu dem Ordner hinzu, in dem Sie Ihre Bibliothek veröffentlicht haben.
3. Klicken Sie auf Hinzufügen. Ihr neuer Feed wird dem Abschnitt hinzugefügt.
   
   

   

   
   

Sie müssen die obigen Schritte ausführen, wenn Sie einen benutzerdefinierten Feed in Studio hinzufügen oder entfernen möchten. Weitere Informationen zu Aktivitätenfeeds finden Sie unter Über Aktivitätenpakete.

Installieren des Pakets

1. Wechseln Sie im Fenster Pakete verwalten unter der Registerkarte Alle Pakete auf der linken Seite zum zuvor hinzugefügten Feed. Die Liste der im Feed verfügbaren Pakete wird angezeigt.
2. Suchen Sie nach dem Paket, und wählen Sie es aus. In unserem Beispiel lautet der Paketname Quick Library
3. Klicken Sie auf Installieren und dann auf Speichern. Das Paket ist nun in Ihrem Projekt installiert und im Panel Projekt unter unter Abhängigkeiten sichtbar.
   
   

   

   
   

Hinzufügen von Aktivitäten aus der Bibliothek

1. Suchen Sie im Panel Aktivitäten nach dem Namen des Pakers, in unserem Fall Quick Library.
2. Legen Sie die Aktivität im Panel Designer ab.
3. Klicken Sie im Studio-Menüband auf Datei ausführen oder verwenden Sie Strg + F6, um die Aktivität auszuführen.
   
   

   

   
   

Sie können weitere Aktivitäten wie Copy Sheet oder Auto Fill Range hinzufügen, aber dafür muss Microsoft Excel auf Ihrer Maschine installiert sein.

Der Vorteil von wiederverwendbaren Komponenten ist, dass sie Wiederholungen reduzieren. Sie erstellen sie einmal und verwenden sie in anderen Projekten wieder.

Zum Herunterladen der Bibliothek, die wir oben erstellt haben, klicken Sie auf die Schaltfläche unten:

Beispiel herunterladen