AWS S3 Get-Plugin (veraltet) für Jitterbit-Cloud- und private Agentengruppen

Einführung

Der AWS S3 Get-Plugin liest, benennt um oder löscht eine Datei von Amazon AWS S3. Eine gelesene Datei kann als Quelle in einem Vorgang verwendet werden.

Dieses Plugin ist standardmäßig in Jitterbit-Cloud-Agentengruppen verfügbar und kann auch mit privaten Agentengruppen verknüpft werden.

Diese Seite beschreibt die Schritte zur Verwendung des AWS S3 Get-Plugins:

1. Plugin herunterladen und hinzufügen
2. Plugin mit einer Agentengruppe verknüpfen
3. Plugin einer Quelle zuweisen
4. Globale Variablen für das Plugin festlegen
5. Vorgangseinrichtung abschließen

Verschlüsselung

Das AWS S3 Get-Plugin überträgt Ihre bereitgestellte AWS S3-Zugangs-ID und den geheimen Zugriffsschlüssel (unten beschrieben in Globale Variablen für das Plugin festlegen) an Amazon. Die Sicherheit wird von Amazon gemäß der Dokumentation von Amazon zu AWS-Sicherheitsanmeldeinformationen gewährleistet.

Verwendung

Das AWS S3 Get-Plugin kann verwendet werden, wann immer Sie Dateien von AWS abrufen, umbenennen oder löschen müssen.

Zusätzliche Funktionalität

Darüber hinaus bieten diese Optionen zusätzliche Funktionalität über das AWS S3 Get-Plugin hinaus:

• AWS S3 Erstellen: AWS S3 erstellen ist ein von Jitterbit bereitgestelltes Plugin, das verwendet wird, um eine Datei als Ziel innerhalb eines Vorgangs in Design Studio in Amazon AWS S3 hochzuladen.

• AWS REST API: Die AWS REST API kann über eine HTTP-Quelle oder ein HTTP-Ziel in Design Studio aufgerufen werden. Während der Konfiguration kann es erforderlich sein, das Plugin HMAC-SHA256-Generator je nach Ihrer Authentifizierungsmethode zu verwenden. Wenn Sie Unterstützung benötigen, wenden Sie sich bitte an den Support.

Download und hinzufügen des Plugins

Das AWS S3 Get-Plugin ist ein Standard-Jitterbit-Plugin, das bereits in der Management-Konsole auf der Seite Plugins verfügbar ist und nicht heruntergeladen oder zur Organisation hinzugefügt werden muss.

Das Plugin mit einer Agentengruppe verknüpfen

Beide Versionen des AWS S3 Get-Plugins sind standardmäßig mit Jitterbit-Cloud-Agentengruppen verknüpft. Wir empfehlen die Verwendung von Version 1.0.1.0.

Wenn Sie eine private Agentengruppe verwenden, müssen Sie das Plugin mit der privaten Agentengruppe verknüpfen, um das Plugin auf allen Agenten in der Gruppe verfügbar zu machen.

Die Plugins werden auf der Seite Plugins der Management-Konsole mit diesen Anzeigenamen aufgelistet:

• Jitterbit AWS S3 Get (Version 1.0.1.0)

• Jitterbit AWS S3 Get (Version 1.0.0.0)

Das Plugin einer Quelle zuweisen

In einem Design-Studio-Projekt müssen Sie das Plugin einer Quelle innerhalb einer Operation zuweisen. Eine Beispiel-Operationseinrichtung ist am Ende dieser Seite angegeben.

Innerhalb des Projekts:

1. Erstellen Sie eine Operation. Jede Operation, die eine Quelle verwendet, kann verwendet werden.
2. Erstellen Sie eine Dummy-Quelle, der das Plugin zugewiesen wird. Diese Quelle wird als Platzhalter verwendet und wird tatsächlich nicht gelesen. Wir empfehlen die Verwendung einer globalen Variablenquelle. Wenn andere Dateitypenquellen verwendet werden, wie z. B. Temporärer Speicher, lokale Datei oder FTP, wird empfohlen, während der Konfiguration der Quelle einen Get Files-Wert von [file].[ext] anzugeben.
3. Weisen Sie das Plugin der Quelle zu. Klicken Sie dazu mit der rechten Maustaste auf die Quelle und wählen Sie Plugin. Wählen Sie im Popup unter Verfügbare Plugins "Jitterbit AWS S3 Get" aus und klicken Sie auf Zuweisen. Klicken Sie dann auf OK.

Globale Variablen für das Plugin festlegen

Damit ein einem Quell-Plugin zugewiesenes Plugin funktionsfähig ist, müssen alle vom Plugin benötigten globalen Variablen festgelegt werden. Diese Variablen werden in einem Skript festgelegt, das vor der Quelle in der Operation platziert werden sollte, damit die Variablen initialisiert werden können.

Um ein Skript vor der Quelle hinzuzufügen:

1. Klicken Sie mit der rechten Maustaste auf die Quelle in der Operation und wählen Sie Vor diesem einfügen > Skript.

2. Erstellen Sie ein neues Jitterbit-Skript, das Variablen festlegt, die vom Plugin verwendet werden, um sich bei Ihrem S3-Bucket zu authentifizieren und die von Ihnen angegebene Datei zu lesen. Eine Skriptschablone für die erforderlichen Variablen ist unten angegeben, gefolgt von der Dokumentation zu allen möglichen Variablen, die im Skript enthalten sein können.

   AWS S3 Get Script

   <trans>
   $AWS.S3.BUCKET_NAME="<YOUR_BUCKET_NAME>";
   $AWS.S3.ACCESS_KEY_ID="<YOUR_ACCESS_KEY>";
   $AWS.S3.SECRET_ACCESS_KEY="<YOUR_SECRET_KEY>";
   $AWS.S3.OBJECT_KEY="<myfile.txt>";
   </trans>
   

Complete operation setup

Der Plugin-Teil der Betriebseinrichtung ist abgeschlossen, nachdem Sie (1) das Skript definiert haben, das die Variablen enthält, die mit dem Plugin verwendet werden sollen, und (2) das Plugin einer Quelle in der Operation zugewiesen wurde.

Um Ihre Betriebseinrichtung abzuschließen, definieren Sie ein target zum Archivieren Ihrer S3-Daten oder fügen Sie sowohl ein Ziel als auch eine transformation hinzu, wenn Sie Ihre Daten vor dem Erreichen des Ziels transformieren möchten.