... |
... |
@@ -6,29
+6,14 @@ |
6 |
6 |
When switching from plugin version 1 to version 2 please check the plugin configuration in the [[workflow>>Formcycle.UserInterface.MyForms.WorkflowProcessing]] of the forms. |
7 |
7 |
{{/info}} |
8 |
8 |
|
9 |
|
-With the Amazon S3 plugin for XIMA® FORMCYCLE you are able to to upload files to your [[Amazon S3>>https://docs.aws.amazon.com/AmazonS3/latest/dev/Welcome.html]] account during form processing. Two steps need to be taken in order to upload files to your S3 storage: |
10 |
|
- |
11 |
|
-1. [[Providing files for the upload into Amazon S3 storage>>||anchor="HProvidingfilesfortheuploadintoAmazonS3storage"]] |
12 |
|
-1. [[Configuration of the Amazon S3 plugin>>||anchor="HConfigurationoftheAmazonS3plugin"]] |
13 |
|
- |
14 |
|
-An installation guide for plugins can be found [[here>>https://help.formcycle.eu/xwiki/bin/view/Main/Mandant-Plugins]]. |
15 |
|
- |
16 |
|
-= Providing files for the upload into Amazon S3 storage = |
17 |
|
- |
18 |
18 |
{{figure image="Formular.png" width="300"}} |
19 |
|
-Users can attach files to forms via the form element [[Upload>>https://help.formcycle.eu/xwiki/bin/view/Main/Upload]]. |
|
10 |
+Users can attach files to forms via the form element [[Upload>>Formcycle.FormDesigner.FormElements.Upload]] which may be uploaded to the [[Amazon Simple Storage Server (S3)>>https://aws.amazon.com/de/s3/]]. |
20 |
20 |
{{/figure}} |
21 |
21 |
|
22 |
|
-In order to upload files to your Amazon S3 account, the files have to be provided to the [[workflow processing>>https://help.formcycle.eu/xwiki/bin/view/Main/Status+und+Aktionsverarbeitung+]] beforehand. As an example, files may be attached to to a form process via the form element [[Upload>>https://help.formcycle.eu/xwiki/bin/view/Main/Upload]] (see [[attach:Formular.png]]). |
|
13 |
+With the Amazon S3 plugin for XIMA® FORMCYCLE you are able to to upload files to your [[Amazon S3>>https://docs.aws.amazon.com/AmazonS3/latest/dev/Welcome.html]] account during form processing. |
23 |
23 |
|
24 |
|
-{{figure image="Provide_upload.png" width="300"}} |
25 |
|
-Providing attached files via the action [[Provide upload>>https://help.formcycle.eu/xwiki/bin/view/Main/Upload+bereitstellen]]. |
26 |
|
-{{/figure}} |
|
15 |
+An installation guide for plugins can be found [[here>>Formcycle.UserInterface.Client.Plugins]]. |
27 |
27 |
|
28 |
|
-The action [[Provide upload>>https://help.formcycle.eu/xwiki/bin/view/Main/Upload+bereitstellen]] takes care of making these files available for further processing steps. In the example [[attach:Provide_upload.png]] files are provided for further processing in the same [[state>>https://help.formcycle.eu/xwiki/bin/view/Main/Statusliste]] via the form element with the name "file_upload" (Note: files can only be provided for the same state). |
29 |
|
- |
30 |
|
-A listing of all providing actions can be found [[here>>https://help.formcycle.eu/xwiki/bin/view/Main/Aktionen]]. |
31 |
|
- |
32 |
32 |
= Configuration of the Amazon S3 plugin = |
33 |
33 |
|
34 |
34 |
After files have been provided for further processing, you can add a new action of type Amazon S3 plugin in order to upload these files to your S3 storage. |
... |
... |
@@ -35,13
+35,13 @@ |
35 |
35 |
|
36 |
36 |
== Authorization of FORMCYCLE == |
37 |
37 |
|
38 |
|
-{{figure image="Amazon_S3_Plugin_en.png" width="300"}} |
|
23 |
+{{figure image="plugin_aws_s3_en.png"}} |
39 |
39 |
After a successful authorization the ID or name of the Amazon S3 account will be displayed in the user interface of the plugin. Furthermore the selection of an [[S3 bucket>>https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html]] of the authorized [[IAM user>>https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users.html]] is possible. |
40 |
40 |
{{/figure}} |
41 |
41 |
|
42 |
42 |
First XIMA® FORMCYCLE has to be authorized in order to access your Amazon S3 account. To this end you need to create a new [[IAM user>>https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users.html]] in your [[IAM (Identity and Access Management) Console>>https://console.aws.amazon.com/iam]]. It is important that you grant this user programmatic access for FORMCYCLE to be able to access your S3 account. Additionally you can manage the IAM user's permission in various way for complete control of what FORMCYCLE is allowed to access within your Amazon S3 account. For furhter information about the S3 access permissions please consult Amazon's [[Identity and Access Management>>https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html]]. After completing the IAM user creation you will be presented with an [[access key>>https://docs.aws.amazon.com/general/latest/gr/managing-aws-access-keys.html]] consisting of an //access key ID// and a //secret access key//. This access key needs to be input into the appropriate fields in the plugin user interface. After a successfull authorization the name or ID of your S3 account will be displayed. Saving the action is not possible as long as you have not input a valid access key. |
43 |
43 |
|
44 |
|
-== Uploadeinstellungen == |
|
29 |
+== Upload settings == |
45 |
45 |
|
46 |
46 |
The table of the plugin user interface lets you select the providing actions, the files of which should be uploaded to your S3 storage. With actions of type [[Provide upload>>https://help.formcycle.eu/xwiki/bin/view/Main/Upload+bereitstellen]] it is possible to delete their files from the form attachements after the upload to the S3 storage. This way the files only reside in your S3 storage and not in the system of XIMA® FORMCYCLE anymore. |
47 |
47 |
|