Zum Inhalt springen

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

Einführung

Das AWS S3 Get Plugin liest, benennt um oder löscht eine Datei aus Amazon AWS S3. Eine gelesene Datei kann als Quelle in einem Operation verwendet werden.

Dieses Plugin ist standardmäßig in Jitterbit-Cloud-Agent-Gruppen verfügbar und können auch mit privaten Agentengruppen verknüpft werden.

Auf dieser Seite werden die Schritte zur Verwendung des AWS S3 Get Plugin detailliert beschrieben:

  1. Laden Sie das Plugin herunter und fügen Sie es hinzu
  2. Verknüpfen Sie das Plugin mit einer Agentengruppe
  3. Das Plugin einer Quelle zuordnen
  4. Globale Variablen für das Plugin festlegen
  5. Operation abschließen

Wichtig

Von Jitterbit bereitgestellte Plugins sind veraltet.

Verschlüsselung

Das AWS S3 Get Plugin übergibt die von Ihnen bereitgestellte AWS S3-Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel (siehe unten Globale Variablen für das Plugin festlegen) an Amazon. Die Sicherheit wird von Amazon gemäß der Amazon-Dokumentation zu AWS-Sicherheitsanmeldeinformationen gehandhabt.

Verwendung

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

Zusätzliche Funktionalität

Darüber hinaus bieten diese Optionen zusätzliche Funktionen, die über das AWS S3 Get Plugin hinausgehen:

Laden Sie das Plugin herunter und fügen Sie es hinzu

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

Vorsicht

Version 1.0.0.0 des Jitterbit AWS S3 Get Plugin ist nicht kompatibel mit Transport Layer Security (TLS) Version 1.3. So beheben Sie den Fehler Invalid SSL master secret Verwenden Sie während der Plugin-Ausführung Version 1.0.1.0 des Jitterbit AWS S3 Get Plugin.

Verknüpfen Sie das Plugin mit einer Agentengruppe

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

Wenn Sie eine private Agentengruppe verwenden, müssen Sie das Plugin-In vor der Verwendung mit der privaten Agentengruppe verknüpfen, um das Plugin-In für alle Agenten in der Gruppe verfügbar zu machen.

Die Plugins sind in der Management Console Plugins aufgelistet Seite mit diesen Anzeigenamen:

  • Jitterbit AWS S3 Get (Version 1.0.1.0)

  • Jitterbit AWS S3 Get (Version 1.0.0.0)

Weisen Sie das Plugin einer Quelle zu

In einem Design Studio Projekt müssen Sie das Plugin einer Quelle zuweisen innerhalb einer Operation. Ein Beispiel für einen Operation finden Sie am Ende dieser Seite.

Im Rahmen des Projekts:

  1. Operation erstellen. Es kann jede Operation verwendet werden, die eine Quelle verwendet.
  2. Erstellen Sie eine Dummy-Quelle, der das Plugin zugewiesen wird. Diese Quelle wird als Platzhalter verwendet und wird nicht tatsächlich gelesen. Wir empfehlen die Verwendung einer globalen Variablenquelle. Wenn andere Dateitypquellen verwendet werden, wie z. B. Temporärer Speicher, lokale Datei oder FTP, wird während der Konfiguration der Quelle empfohlen, einen Get Files-Wert von [file].[ext].
  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 anschließend auf OK.

Tipp

Eine detaillierte Dokumentation zum Zuweisen von Plugins finden Sie unter Pipeline-Plugins anwenden.

Festlegen globaler Variablen für das Plugin

Damit ein einer Quelle zugewiesenes Plugin funktioniert, müssen alle globalen Variablen müssen vom Plugin benötigt werden. Diese Variablen werden in einem Script gesetzt, welches in der Operation vor der Quelle platziert werden sollte, damit die Variablen initialisiert werden können.

So fügen Sie vor der Quelle ein Script hinzu:

  1. Klicken Sie im Operation mit der rechten Maustaste auf die Quelle und wählen Sie Davor einfügen > Script.

  2. Erstellen Sie ein neues Jitterbit Script, das Variablen festlegt, die das Plugin zur Authentifizierung bei Ihrem S3-Bucket und zum Lesen der von Ihnen angegebenen Datei verwendet. Unten finden Sie eine Script für erforderliche Variablen, gefolgt von einer Dokumentation aller möglichen Variablen, die im Script 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>
    
Name Typ Erforderlich. Beschreibung
AWS.S3.ENDPOINT Zeichenfolge Optional Die URL des Amazon AWS S3- Endpoint. Standardmäßig "s3.amazonaws.com" wenn nicht festgelegt. Gültige Endpoint nach Region finden Sie in der Amazon-Dokumentation AWS-Regionen und Endpoints.
AWS.S3.BUCKET_NAME Zeichenfolge Erforderlich Der Name des S3-Quell-Buckets (z. B. "my_bucket").
AWS.S3.ACCESS_KEY_ID Zeichenfolge Erforderlich Der S3-Zugriffsschlüssel (z. B. "ABCDEFGHI1JK2LM3NOPQ").
AWS.S3.SECRET_ACCESS_KEY Zeichenfolge Erforderlich Der geheime S3-Zugriffsschlüssel (z. B. "1aBCd2e/F34gH56IJ7Kl/Mno8pqRsTUvw9x0yzzz").
AWS.S3.REGION Zeichenfolge Optional Die S3-Region. Standardmäßig "DEFAULT_REGION" wenn nicht festgelegt (nicht empfohlen). Aktuelle Regionsnamen finden Sie in der Amazon-Dokumentation AWS-Regionen und Endpoints.
AWS.S3.OBJECT_KEY Zeichenfolge Erforderlich Der zu lesende S3-Objektschlüssel. Dies ist der Name der spezifischen Datei, die zurückgegeben werden soll, z. B. "myfile.txt". Um aus einem Ordner im Bucket zu lesen, fügen Sie den Ordnernamen nach einem Schrägstrich hinzu (z. B. "my_folder/myfile.txt"). Die Datei muss bereits vorhanden sein. Beim Objektschlüssel wird die Groß- und Kleinschreibung beachtet. Die Angabe mehrerer Dateien oder die Verwendung von Platzhaltern wird nicht unterstützt.
AWS.S3.DELETE Boolesch Optional Wenn gesetzt auf "true", löscht das Objekt nach dem Lesen aus dem S3-Bucket. Der Standardwert ist "false". Nicht verwenden mit dem AWS.S3.NEWNAME variabel.

Warnung

Diese Variable löscht das angegebene Objekt im S3-Bucket selbst.

AWS.S3.NEWNAME Zeichenfolge Optional Der Name, der zum Umbenennen des Objekts im S3-Bucket nach dem Lesen verwendet wird. Die Verwendung dieser Variable ändert den S3-Objektschlüssel. Verwenden Sie nicht mit dem AWS.S3.DELETE variabel.

Warnung

Diese Variable löscht das angegebene Objekt im S3-Bucket selbst.

Warnung

Obwohl im Plugin Manifest enthalten, ist die Variable AWS.S3.OBJECT_KEY_PREFIX ist nicht funktionsfähig. Derzeit ist es nicht möglich, mehrere Dateien gleichzeitig zu lesen; es kann immer nur eine Datei gleichzeitig gelesen werden.

Vorsicht

Einige der oben genannten Variablen sollten nicht in Kombination mit anderen verwendet werden. Die gemeinsame Verwendung führt zu Fehlern bei Ihrem Operation.

Vollständige Operation

Der Plugin-Teil der Einrichtung der Operation ist abgeschlossen, wenn Sie (1) das Script haben, das die mit dem Plugin zu verwendenden Variablen definiert, und (2) das Plugin einer Quelle in der Operation zugewiesen haben.

Um die Einrichtung Ihres Operation abzuschließen, definieren Sie ein Ziel zum Archivieren Ihrer S3-Daten oder fügen Sie sowohl ein Ziel als auch eine Transformation hinzu, wenn Sie Ihre Daten vor Erreichen des Ziels transformieren möchten.

Setup-Operation

Achtung

Bei Verwendung eines Temporären Speichers, lokale Datei oder FTP Site Ziel, damit der S3-Dateiname und die Erweiterung in das Ziel geschrieben werden, wird empfohlen, [AWS.S3.OBJECT_KEY] im Feld Dateiname(n), um im Ziel den gleichen Dateinamen zu verwenden, der vom Plugin gelesen wird. Mit einem Wert von [file].[ext] gibt die S3-ID der Datei zurück, statt des S3-Dateinamens.