Zum Inhalt springen

Amazon S3 Put Object-Aktivität in Jitterbit Studio

Einführung

Eine Amazon S3 Put Object-Aktivität verwendet ihre Amazon S3-Verbindung, um Objektdaten in Amazon S3 zu speichern. Sie ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

Voraussetzungen

Die Put 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:PutObject und s3:GetBucketLocation Ausführung der Put Object-Aktivität

Erstellen einer Amazon S3 Put Object-Aktivität

Eine Instanz einer Amazon S3 Put Object-Aktivität wird aus einer Amazon S3-Verbindung mit ihrem Aktivitätstyp Put 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 Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

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

Konfigurieren einer Amazon S3 Put Object-Aktivität

Führen Sie diese Schritte aus, um eine Amazon S3 Put 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 Put 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.

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

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

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Amazon S3 Put 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.

  • Schlüssel: Geben Sie den Schlüssel des Objekts ein, das Sie aus dem Bucket abrufen möchten. Dies wird ignoriert, wenn bucketName oder objectId im Datenschema PutObjectRequest 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.

    • Systemmetadaten: Verwenden Sie diese Tabelle, um Systemmetadaten beim Hochladen von Dateien mit dem Amazon S3-Connector anzuhängen. Klicken Sie auf das Plussymbol , um der Tabelle eine neue Zeile hinzuzufügen. Wählen Sie einen Schlüssel aus und geben Sie einen Wert ein.

    • Benutzermetadaten: Verwenden Sie diese Tabelle, um Benutzermetadaten beim Hochladen von Dateien mit dem Amazon S3-Connector anzuhängen. Klicken Sie auf das Plussymbol , um der Tabelle eine neue Zeile hinzuzufügen, und geben Sie einen Schlüssel und einen Wert ein.

      Klicken Sie in beiden Tabellen Systemmetadaten und Benutzermetadaten auf das Bestätigungssymbol in der rechten Spalte, um eine Zeile zu speichern, oder verwenden Sie das Symbol zum Verwerfen von Änderungen , um die gerade vorgenommenen Änderungen zu verwerfen. Um eine vorhandene einzelne Zeile zu bearbeiten oder zu löschen, bewegen Sie den Mauszeiger über die rechte Spalte und verwenden Sie das Symbol zum Bearbeiten oder das Löschsymbol .

      Wichtig

      Felder in den Tabellen zeigen das Variablensymbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit aufgefüllt werden, muss die Agent-Version mindestens 10.75 / 11.13 sein.

      Um alle Zeilen zu löschen, klicken Sie auf Alle löschen.

  • 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 Änderungen verwerfen möchten.

S3-Bucket manuell bereitstellen

Wenn S3-Bucket manuell bereitstellen für Bucket-Optionen ausgewählt ist, werden diese Felder angezeigt:

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Amazon S3 Put 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.

  • Schlüssel: Geben Sie den Schlüssel des Objekts ein, das Sie aus dem Bucket abrufen möchten. Dies wird ignoriert, wenn bucketName oder objectId im Datenschema PutObjectRequest 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.

    • Systemmetadaten: Verwenden Sie diese Tabelle, um Systemmetadaten beim Hochladen von Dateien mit dem Amazon S3-Connector anzuhängen. Klicken Sie auf das Plussymbol , um der Tabelle eine neue Zeile hinzuzufügen. Wählen Sie einen Schlüssel aus und geben Sie einen Wert ein.

  • Benutzermetadaten: Verwenden Sie diese Tabelle, um Benutzermetadaten beim Hochladen von Dateien mit dem Amazon S3-Connector anzuhängen. Klicken Sie auf das Hinzufügungssymbol , um der Tabelle eine neue Zeile hinzuzufügen, und geben Sie einen Schlüssel und einen Wert ein.

    In beiden Tabellen Systemmetadaten und Benutzermetadaten klicken Sie auf das Sendesymbol in der rechten Spalte, um eine Zeile zu speichern, oder verwenden Sie das Symbol zum Verwerfen von Änderungen , um die gerade vorgenommenen Änderungen zu verwerfen. Um eine vorhandene einzelne Zeile zu bearbeiten oder zu löschen, bewegen Sie den Mauszeiger über die rechte Spalte und verwenden Sie das Bearbeitungssymbol oder das Löschsymbol .

    Wichtig

    Felder in den Tabellen zeigen das Variablensymbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit gefüllt werden, muss die Agent-Version mindestens 10.75 / 11.13 sein.

    Um alle Zeilen zu löschen, klicken Sie auf Alle löschen.

  • 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 die in einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Überprüfen Sie die Datenschemas

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

  • Datenschemas: Diese Datenschemas werden von angrenzenden 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. Informationen zu den Schemaknoten und Feldern finden Sie in der Dokumentation zur PutObject-Aktion.

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

    • Request:

      Request-Schemafeld/-knoten Beschreibung
      PutObjectRequest Request zum Platzieren von Inhalten in einem Bucket als mehrteiliger Upload
      Bucket String mit dem Namen des Buckets, der den vorhandenen, initiierten mehrteiligen Upload enthält, dem dieser neue Teil zugeordnet wird
      Key String mit dem Schlüssel des initiierten mehrteiligen Uploads
      Data Base64binary mit dem Inhalt des Objekts, das als mehrteiliger Upload hochgeladen werden soll

      Tipp

      Sie können eine Kombination aus Jitterbit's Base64Encode, HexToBinary und StringToHex Funktionen verwenden, um Daten in base64binary zu konvertieren:
      $amazonData = Base64Encode(HexToBinary(StringToHex($myData)));

  • Antwort:

    | Antwortschema-Feld/Knoten | Beschreibung                                                                                                                                    |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **`PutObjectResponse`**   | Antwort vom Platzieren von Inhalten in einem Bucket als Multipart-Upload                                                                       |
| `ETag`                    | Das [Entity Tag](https://docs.aws.amazon.com/AmazonS3/latest/API/API_Object.html#AmazonS3-Type-Object-ETag) (ETag), das das neue Objekt identifiziert |
| `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 |
| `Result`                  | String des Ergebnisses                                                                                                                         |

  • 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 Put 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 Design-Canvas zugänglich. Weitere Informationen finden Sie unter Aktivitätsaktionsmenü in Connector-Grundlagen.

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

Um die Aktivität mit Scripting-Funktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Scripting-Funktion.

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