Zum Inhalt springen

Amazon S3 Get Object-Aktivität in Jitterbit Studio

Einführung

Eine Amazon S3 Get Object-Aktivität ruft mit ihrer Amazon S3-Verbindung ein Objekt aus einem Amazon S3-Bucket ab und dient als Quelle zur Bereitstellung von Daten in einem Vorgang.

Voraussetzungen

Die Get Object-Aktivität erfordert die folgenden Amazon S3-Berechtigungen:

Erforderliche Berechtigung Funktionalität
s3:ListAllMyBuckets Testen der Verbindung und Abrufen von Aktivitätsmetadaten während der Aktivitätskonfiguration
s3:GetObject und s3:ListBucket Ausführung der Get Object-Aktivität
s3:GetObjectTagging (optional) Ausführung der Get Object-Aktivität, wenn Tagging-Metadaten in Antwort einschließen aktiviert ist

Amazon S3 Get Object-Aktivität erstellen

Eine Instanz einer Amazon S3 Get Object-Aktivität wird aus einer Amazon S3-Verbindung mit ihrem Aktivitätstyp Get Object erstellt.

Um eine Aktivitätsinstanz zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Weitere Informationen finden Sie unter Aktivitäts- oder Tool-Instanz erstellen in Komponentenwiederverwendung.

Eine vorhandene Amazon S3 Get Object-Aktivität kann von diesen Orten aus bearbeitet werden:

Amazon S3 Get Object-Aktivität konfigurieren

Führen Sie diese Schritte aus, um eine Amazon S3 Get Object-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben und Bucket auswählen

Geben Sie in diesem Schritt einen Namen für die Aktivität an und wählen Sie einen zu verwendenden Bucket aus.

Die in diesem Konfigurationsschritt einer Amazon S3 Get Object-Aktivität verwendete Benutzeroberfläche hängt von den ausgewählten Bucket-Optionen ab:

Bucket aus Liste auswählen

Wenn Bucket aus Liste auswählen für Bucket-Optionen ausgewählt ist, wird die unten beschriebene Benutzeroberfläche angezeigt.

Tipp

Felder mit einem -Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das -Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen.

  • Endpoint-Menü: Wenn mehrere Endpoints desselben Connector-Typs konfiguriert sind, zeigt ein Menü oben auf dem Bildschirm den Namen des aktuellen Endpoints an. Klicken Sie auf das Menü, um zu einem anderen Endpoint zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpoint ändern in Konfigurationsbildschirme.

    • Endpoint bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den Namen des aktuellen Endpoints bewegen. Klicken Sie, um die Verbindungskonfiguration des aktuell ausgewählten Endpoints zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Amazon S3 Get Object-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Bucket auswählen: Wählen Sie aus der aufgefüllten Liste den Bucket aus, der das Objekt enthält.

  • Key: Geben Sie den Key des Objekts ein, das Sie aus dem Bucket abrufen möchten. Dies wird ignoriert, wenn entweder bucketName oder objectId im Datenschema GetObjectRequest angegeben ist.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern.

    • AWS-Region (überschreibt die Region des Buckets): Wählen Sie eine Amazon S3-Region aus.

    • Tagging-Metadaten in Antwort einschließen: (Standardmäßig deaktiviert.) Wenn aktiviert, gibt die Get Object-Aktivität das Tag-Set eines Objekts in der Antwort zurück. Um diese Einstellung zu verwenden, muss die Amazon S3-Instanz die Berechtigung s3:GetObjectTagging haben.

  • Speichern und beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

S3-Bucket manuell bereitstellen

Wenn S3-Bucket manuell bereitstellen für Bucket-Optionen ausgewählt ist, wird die unten beschriebene Benutzeroberfläche angezeigt.

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Amazon S3 Get Object-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Bucket-Name: Geben Sie den Namen des Amazon S3-Buckets ein, der das Objekt enthält.

  • Key: Geben Sie den Key des Objekts ein, das Sie aus dem Bucket abrufen möchten. Dies wird ignoriert, wenn entweder bucketName oder objectId im Datenschema GetObjectRequest angegeben ist.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern.

    • AWS-Region (überschreibt die Region des Buckets): Wählen Sie eine Amazon S3-Region aus.

    • Tagging-Metadaten in Antwort einschließen: (Standardmäßig deaktiviert.) Wenn aktiviert, gibt die Get Object-Aktivität das Tag-Set eines Objekts in der Antwort zurück. Um diese Einstellung zu verwenden, muss die Amazon S3-Instanz die Berechtigung s3:GetObjectTagging haben.

  • Speichern und beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Datenschemas überprüfen

Alle aus dem Endpoint generierten Request- oder Response-Schemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Datenschemas: Die Request- und Response-Schemas für diese Aktivität werden angezeigt. Diese Datenschemas werden von benachbarten Transformationen geerbt und werden erneut während der Transformationszuordnung angezeigt.

Hinweis

Daten, die in einer Transformation bereitgestellt werden, haben Vorrang vor der Aktivitätskonfiguration.

Der Amazon S3-Connector verwendet die Amazon Simple Storage Service API. Weitere Informationen zu den Schemaknoten und Feldern finden Sie in der Dokumentation zur GetObject-Aktion.

Die Request- und Response-Datenschemas bestehen aus diesen Knoten und Feldern:

  • Request:

    Request-Schemafeld Beschreibung
    GetObjectRequest Request zum Abrufen von Inhalten aus einem Bucket
    request Knoten, der den Request darstellt
    bucketName String mit dem Namen des Buckets, das das gewünschte Objekt enthält
    objectId String mit dem Schlüssel im angegebenen Bucket, unter dem das Objekt gespeichert ist

  • Response:

    Response-Schemafeld/-Knoten Beschreibung
    GetObjectResponse Response vom Abrufen von Inhalten aus einem Bucket
    LastModified Datetime-Wert des Last-Modified-Headers, der das Datum und die Uhrzeit angibt, zu der Amazon S3 zuletzt eine Änderung am zugehörigen Objekt aufgezeichnet hat
    Metadata Die von Amazon S3 für dieses Objekt gespeicherten Metadaten
    Name String auf die Konstante ContentType gesetzt
    Value String auf den Content-Type HTTP-Header gesetzt, der den Standard-MIME-Typ des im zugehörigen Objekt gespeicherten Inhalts angibt
    SystemMetadata Systemmetadaten, die mit dem Objekt im Bucket gespeichert sind
    UserMetadata Metadaten, die vom Benutzer beim Hochladen eines Objekts in den Bucket zugewiesen werden
    Data Base64binary mit dem Inhalt dieses Objekts

    Tipp

    Sie können eine Kombination aus Jitterbit's Base64Decode, BinaryToHex und HexToString Funktionen verwenden, um base64binary in Text zu konvertieren:
    $amazonData = Base64Decode(BinaryToHex(HexToString($myData)));

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Schemas vom Amazon S3-Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer Amazon S3-Aktivität Get Object schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Designoberfläche zugänglich. Weitere Informationen finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

Amazon S3-Aktivitäten vom Typ Get Object können als Quelle mit diesen Vorgangsmustern verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Skriptfunktion.

Wenn Sie bereit sind, stellen Sie den Vorgang bereit und führen ihn aus, und überprüfen Sie das Verhalten, indem Sie die Vorgangsprotokolle prüfen.