Erstellen einer Basisbibliothek

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

Das Erstellen einer Bibliothek ähnelt dem Erstellen eines Basisprozesses. Der Unterschied besteht darin, dass eine Bibliothek ein Paket mit wiederverwendbaren Komponenten ist, 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.

Dieses Beispiel verwendet Excel-Aktivitäten, für die Microsoft Excel nicht auf Ihrem Computer installiert sein muss.

Fangen wir an.

Erstellen einer Bibliothek

1. Starten Sie Studio. Wählen Sie in der Backstage-Startansicht die Option Bibliothek aus, um ein neues Bibliotheksprojekt zu erstellen. Das Fenster Neue leere Bibliothek wird angezeigt.

   

2. Im Fenster „Neue leere Bibliothek“:

   • Geben Sie einen Namen für das neue Projekt und eine Beschreibung ein, die zusammenfasst, was Sie mit dieser Automatisierung erreichen möchten. Bei diesem Beispiel können Sie den Namen QuickLibrary verwenden.
     Hinweis:

     Der Projektname darf 128 Zeichen und die Beschreibung darf 500 Zeichen nicht überschreiten.

   • Wählen Sie Erweiterte Optionen anzeigen und dann den Speicherort aus, an dem das Projekt erstellt werden soll.
   • Wählen Sie Windows für die Option Kompatibilität und VB für Sprache aus.

3. Wählen Sie Erstellen. Die neue Bibliothek wird in Studio geöffnet.

Ergebnis

Das Bibliotheksprojekt wird erstellt und in Studio geöffnet, bereit zum Hinzufügen von Aktivitäten.

Hinzufügen von Excel-Aktivitäten

1. Suchen Sie im Aktivitätenbereich nach der Excel-Prozess-Scope-Aktivität und legen Sie sie im Designer-Bereich ab.

2. Fügen Sie der Sequenz eine Aktivität „Excel-Datei verwenden“ hinzu.Diese Aktivität ist für die meisten Excel-bezogenen Aktivitäten erforderlich.

3. Navigieren Sie im Feld Excel-Datei zu der Excel-Datei, aus der Sie die Daten abrufen möchten. Optional können Sie das Feld Verweis als verwenden, um die Art und Weise zu ändern, wie auf diese Datei im Workflow verwiesen wird (Excel1 in diesem Fall).

4. Fügen Sie eine zweite Aktivität innerhalb der ersten Aktivität hinzu und navigieren Sie zu der Excel-Datei, in der Sie die Daten kopieren möchten.Fügen Sie einen optionalen Verweis zu dieser zweiten Datei hinzu (Excel2 in diesem Fall).

5. Fügen Sie eine Aktivität zum Kopieren/Einfügen des Bereichs hinzu.

6. Wählen Sie im Feld Quelle die Schaltfläche Plus aus, um den Namen des Blatts in der ersten Arbeitsmappe anzugeben. Bei diesem Beispiel sollte Excel1.Sheet("Sheet1") im Feld stehen.

7. Wählen Sie im Feld „Ziel“ die Option Plus aus, um den Namen des Blatts in der zweiten Arbeitsmappe anzugeben (Excel2.Sheet("Sheet1") in unserem Fall). Ihr Projekt sollte wie in der folgenden Abbildung aussehen.

   

8. Wählen Sie im Menüband die Option Datei ausführen aus oder verwenden Sie Strg + F6, um den Workflow auszuführen. Die Daten, die aus der ersten Excel-Tabelle erfasst wurden, werden in eine andere kopiert.

Ergebnis

Die Daten aus der ersten Excel-Tabelle werden in die zweite kopiert. Der Workflow wird erfolgreich ausgeführt.

Packen einer Bibliothek

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

1. Öffnen Sie das Bibliotheksprojekt in Studio.

2. Wählen Sie im Menüband die Taste 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. Wählen Sie Veröffentlichen aus. Das Paket ist jetzt im lokalen Ordner als .nupkg -Datei verfügbar.

   

Ergebnis

Die Bibliothek wird als .nupkg -Datei in Ihrem benutzerdefinierten Feedordner veröffentlicht und kann in anderen Projekten installiert werden.

Installieren von wiederverwendbaren Komponenten

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

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

Hinzufügen eines benutzerdefinierten Feeds

1. Wählen Sie im Studio Pakete verwalten > Einstellungen aus. 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. Wählen Sie Hinzufügen aus. Ihr neuer Feed wird dem Abschnitt hinzugefügt.

   

Ergebnis

Der benutzerdefinierte Feed wird Studio hinzugefügt. Sie ist jetzt unter Alle Pakete beim Verwalten von Paketabhängigkeiten verfügbar.

Sie müssen die oben genannten Schritte ausführen, wenn Sie einen benutzerdefinierten Feed in Studio hinzufügen oder entfernen möchten. Aktivieren Sie die Seite Über Aktivitäten-Pakete, um weitere Informationen zu Aktivitäten-Feeds zu lesen.

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. Wählen Sie Installieren und dann Speichern aus. Das Paket ist jetzt in Ihrem Projekt installiert und im Explorer- Panel unter Abhängigkeiten sichtbar.

   

Ergebnis

Das Paket wird als Abhängigkeit in Ihrem Projekt installiert. Die Aktivitäten sind im Aktivitätenbereich verfügbar.

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. Wählen Sie im Studio-Menüband die Option Datei ausführen aus oder verwenden Sie Strg + F6, um die Aktivität auszuführen.

   

Ergebnis

Die Bibliotheksaktivität wird erfolgreich im Projekt ausgeführt. Die wiederverwendbare Komponente kann in jedem Projekt verwendet werden, in dem das Paket installiert ist.

Sie können andere Aktivitäten wie Blatt kopieren oder den Bereich zum automatischen Ausfüllen hinzufügen, aber diese erfordern, dass Microsoft Excel auf Ihrer Maschine installiert ist.

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