Wiki-Quellcode von Amazon-S3-Plugin

Zeige letzte Bearbeiter
1 [[**Plugin-Download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/fc-plugin-bundle-aws-s3&fileid=3080||target="_blank"]] (erfordert Anmeldung)
2
3
4 {{info}}
5 Bitte verwenden Sie für FORMCYCLE V6 das Plugin ab **Version 2.0.0**.
6 {{/info}}
7
8 {{info}}
9 Überprüfen Sie beim Wechsel von Version 1 zu Version 2 des Plugins die Pluginkonfiguration im [[Workflow>>Formcycle.Designer.Workflow.WebHome]] der Formulare.
10 {{/info}}
11
12 {{figure image="Formular.png"}}
13 Nutzer können dem Formular Dateien über das Formularelement [[Upload>>Formcycle.FormDesigner.FormElements.Upload]] anhängen, welche mit dem Plugin zum [[Amazon Simple Storage Service (S3)>>https://aws.amazon.com/de/s3/]] hochgeladen werden können.
14 {{/figure}}
15
16 Mit dem kostenpflichtigen Amazon S3 Plugin für XIMA® FORMCYCLE haben Sie die Möglichkeit, bereitgestellte Dateien im Verlauf der Formularverarbeitung in den [[S3 Storage>>https://docs.aws.amazon.com/AmazonS3/latest/dev/Welcome.html]] Ihres Amazon-Kontos zu laden.
17
18 Einer Anleitung zur Installation von Plugins finden Sie [[hier>>Formcycle.UserInterface.Client.Plugins]].
19
20 = Konfiguration des Amazon S3 Plugins =
21
22 Legen Sie eine neue Aktion des Typs Amazon Storage (Upload) an, um Dateien in Ihren S3 Storage zu laden.
23
24 == Autorisierung von FORMCYCLE ==
25
26 {{id name="fig_plugin_aws_s3"/}}
27 {{figure image="plugin_aws_s3_de.png"}}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.{{/figure}}
28
29
30 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.
31
32 == Uploadeinstellungen ==
33
34 Es können zwei verschiedene Typen von Dateien zu Amazon hochgeladen werden:
35
36 * **Dateien vorheriger [[Aktionen>>Formcycle.Designer.Workflow.Actions.WebHome]]**
37 Hier stehen Aktionen zur Verfügung, die Dateien für die Aktions- und Statusverarbeitung zur Verfügung stellen. Die Dateien der gewählten Aktionen werden in das gewählte Amazaon S3 Konto geladen. Eine Auflistung aller bereitstellenden Aktionen finden Sie [[hier>>Formcycle.Designer.Workflow.Actions.WebHome]].{{info}}Es stehen nur bereitstellende Aktionen zur Verfügung, die sich im selben Status und vor der Plugin-Aktion befinden.{{/info}}
38 * **Hochzuladende Dateien**
39 Hier stehen Dateien von [[Forumlaruploads>>Formcycle.FormDesigner.FormElements.Upload]] zur Auswahl. Zusätzlich können diese Uploads nach dem Hochladen zu Amazon aus dem Formularanhang gelöscht werden. Somit befinden sich die Dateien lediglich in Ihrem S3 Storage und nicht zusätzlich im System von XIMA® FORMCYCLE.
40
41 Konfiguration des Uploadziels:
42
43 * **Upload in Bucket**
44 Ü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.
45 * **Upload in Ordner**
46 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>>||anchor="fig_plugin_aws_s3"]] wird durch die Verwendung von [[Platzhaltern>>Formcycle.UserInterface.Variables]] ein neuer Ordner für das Formular und jeden einzelnen Formularvorgang angelegt.