Wiki-Quellcode von NLO_DE_EN_Einbindung in Amazon S3
Zeige letzte Bearbeiter
author | version | line-number | content |
---|---|---|---|
1 | {{info}} | ||
2 | Bitte verwenden Sie für FORMCYCLE V6 das Plugin ab **Version 2.0.0**. | ||
3 | {{/info}} | ||
4 | |||
5 | {{info}} | ||
6 | Überprüfen Sie beim Wechsel von Version 1 zu Version 2 des Plugins die Pluginkonfiguration in der [[Status- und Aktionsverarbeitung>>Formcycle.UserInterface.MyForms.WorkflowProcessing]] der Formulare. | ||
7 | {{/info}} | ||
8 | |||
9 | Mit dem Amazon S3 Plugin für XIMA® FORMCYCLE haben Sie die Möglichkeit, bereitgestellte Dateien im Verlauf der Fourmularverarbeitung in den [[S3 Storage>>https://docs.aws.amazon.com/AmazonS3/latest/dev/Welcome.html]] Ihres Amazon-Kontos zu laden. Für den S3-Upload müssen zwei Schritte getätigt werden: | ||
10 | |||
11 | 1. [[Dateien für den Upload in den Amazon S3 Storage bereitstellen>>||anchor="HDateienfFCrdenUploadindenAmazonS3Storagebereitstellen"]] | ||
12 | 1. [[Konfiguration des Amazon S3 Plugins>>||anchor="HKonfigurationdesAmazonS3Plugins"]] | ||
13 | |||
14 | Einer Anleitung zur Installation von Plugins finden Sie [[hier>>https://help.formcycle.eu/xwiki/bin/view/Main/Mandant-Plugins]]. | ||
15 | |||
16 | = Dateien für den Upload in den Amazon S3 Storage bereitstellen = | ||
17 | |||
18 | {{figure image="Formular.png" width="300"}} | ||
19 | Nutzer können dem Formular Dateien über das Formularelement [[Upload>>https://help.formcycle.eu/xwiki/bin/view/Main/Upload]] anhängen. | ||
20 | {{/figure}} | ||
21 | |||
22 | Um Dateien in den S3 Storage Ihres Amazon-Kontos laden zu können, müssen diese vorerst in der [[Verarbeitung>>https://help.formcycle.eu/xwiki/bin/view/Main/Status+und+Aktionsverarbeitung+]] bereitgestellt werden. Dateien können beispielsweise über das Formularelement [[Upload>>https://help.formcycle.eu/xwiki/bin/view/Main/Upload]] (siehe [[attach:Formular.png]]) an den Formularvorgang angehängt werden. | ||
23 | |||
24 | {{figure image="Upload_bereitstellen.png" width="300"}} | ||
25 | Bereitstellen der angehängeten Dateien durch die Aktion [[Upload bereitstellen>>https://help.formcycle.eu/xwiki/bin/view/Main/Upload+bereitstellen]]. | ||
26 | {{/figure}} | ||
27 | |||
28 | Die Aktion [[Upload bereitstellen>>https://help.formcycle.eu/xwiki/bin/view/Main/Upload+bereitstellen]] sorgt dafür, dass diese Dateien in der weiteren Verarbeitung zur Verfügung gestellt werden. Im Beispiel [[attach:Upload_bereitstellen.png]] werden Dateien über das Formularelement mit dem Namen "file_upload" für die weitere Verarbeitung in einem [[Status>>https://help.formcycle.eu/xwiki/bin/view/Main/Statusliste]] bereitgestellt (Hinweis: Dateien können nur innerhalb eines Status für weitere Aktionen bereitgestellt werden). | ||
29 | |||
30 | Eine Auflistung aller bereitstellenden Aktionen finden Sie [[hier>>https://help.formcycle.eu/xwiki/bin/view/Main/Aktionen]]. | ||
31 | |||
32 | = Konfiguration des Amazon S3 Plugins = | ||
33 | |||
34 | Nachdem Sie Dateien für die weitere Statusverarbeitung bereitgestellt haben, können Sie eine neue Aktion des Typs Amazon S3 Plugin erstellen, um diese in Ihren S3 Storage zu laden. | ||
35 | |||
36 | == Autorisierung von FORMCYCLE == | ||
37 | |||
38 | {{figure image="plugin_aws_s3_de.png"}} | ||
39 | Nach erfolgreicher Autorisierung wird die ID oder der Name des Amazon S3 Kontos in der Pluginoberfläche dargestellt. Zudem ist die Auswahl eines [[Buckets>>https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html]] des autorisierten [[IAM Benutzers>>https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users.html]] möglich. | ||
40 | {{/figure}} | ||
41 | |||
42 | Zunächst müssen Sie XIMA® FORMCYCLE dazu autorisieren, auf Ihr S3-Konto zugreifen zu können. Hierzu ist es notwendig, dass sie in Ihrer [[IAM (Identity and Access Management) Console>>https://console.aws.amazon.com/iam]] von Amazon einen neuen [[IAM Benutzer>>https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users.html]] erstellen. Wichtig ist, dass sie dem IAM Benutzer einen programmgesteuerten Zugriff erlauben, so dass FORMCYCLE auf Ihr S3-Konto zugreifen kann. Desweiteren können Sie dem IAM Benutzer verschiedene Rechte zuweisen und somit den Zugriff auf Ihr S3-Konto kontrollieren (weitere Informationen zum AWS Identity and Access Management finden Sie [[hier>>https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html]]). Nachdem die Benutzererstellung abgeschlossen wurde, erhalten Sie einen [[Zugriffsschlüssel>>https://docs.aws.amazon.com/general/latest/gr/managing-aws-access-keys.html]], bestehend aus einer //Zugriffsschlüssel-ID// und einem //geheimen Zugriffsschlüssel//. Diesen Zugriffsschlüssel müssen Sie zur Autorisierung von FORMCYCLE in die entsprechenden Felder der Pluginoberfläche eingeben und die Aktion speichern. Bei einer erfolgreichen Autorisierung wird der Name oder die ID Ihres S3-Kontos angezeigt. Ein Speichern der Aktion ist nicht möglich, solange Sie keinen gültigen Zugriffsschlüssel eingegeben haben. | ||
43 | |||
44 | == Uploadeinstellungen == | ||
45 | |||
46 | In der Tabelle der Pluginoberfläche wählen Sie die bereitstellenden Aktionen aus, deren Dateien Sie in Ihr Amazon-S3-Konto laden möchten. Bei Aktionen des Typs [[Upload bereitstellen>>https://help.formcycle.eu/xwiki/bin/view/Main/Upload+bereitstellen]] ist es zudem möglich, die Dateien nach dem Upload aus dem Formularanhang zu löschen. Somit befinden sich die Dateien lediglich in Ihrem S3 Storage und nicht zusätzlich im System von XIMA® FORMCYCLE. | ||
47 | |||
48 | Über das Eingabefeld "Upload in Bucket" wählen Sie den [[S3 Bucket>>https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html]] Ihres Amazon Kontos aus, in welchen die gewählten Dateien hochgeladen werden sollen. | ||
49 | |||
50 | Standardmäßig werden die Dateien in das Root-Verzeichnis des gewählten Buckets geladen. Über das Eingabefeld "Upload in Ordner" können Sie jedoch einen Dateipfad in diesem Bucket angeben, in welchen die Dateien geladen werden sollen. Grenzen Sie dabei Ordner mit einem "/" ab. Im Beispiel [[attach:Amazon_S3_Plugin.png]] wird durch die Verwendung von [[Platzhaltern>>https://help.formcycle.eu/xwiki/bin/view/Main/Platzhalter]] ein neuer Ordner für das Projekt und jeden einzelnen Formularvorgang angelegt. |