Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Title

...	...	@@ -1,1 +1,1 @@
1		-Integration in Dropbox
	1	+Dropbox plugin

Content

...	...	@@ -1,39 +1,35 @@
1		-With the Dropbox plugin for XIMA® FORMCYCLE you are able to to upload files to your Dropbox account during form processing. Two steps need to be taken in order to upload files to the Dropbox:
	1	+[[**Plugin download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/fc-plugin-bundle-dropbox&fileid=3054||target="_blank"]] (requires login)
2	2
3		-1. [[Providing files for the Dropbox plugin to upload>>||anchor="HProvidingfilesfortheDropboxplugintoupload"]]
4		-1. [[Configuration of the Dropbox plugin>>||anchor="HConfigurationoftheDropboxplugin"]]
	3	+{{info}}
	4	+Please use **plugin version 2.0.0** or above for FORMCYCLE V6.
	5	+{{/info}}
5	5
6		-An installation guide for plugins can be found [[here>>https://help.formcycle.eu/xwiki/bin/view/Main/Mandant-Plugins]].
	7	+{{info}}
	8	+When switching from plugin version 1 to version 2 please check the plugin configuration in the [[workflow>>Formcycle.UserInterface.MyForms.WorkflowProcessing]] of the forms.
	9	+{{/info}}
7	7
8		-= Providing files for the Dropbox plugin to upload =
9		-
10		-{{figure image="Formular.png" width="300"}}
11		-Users can attach files to forms via the form element [[Upload>>https://help.formcycle.eu/xwiki/bin/view/Main/Upload]].
	11	+{{id name="fig_plugin_dropbox_auth"/}}
	12	+{{figure image="plugin_dropbox_auth_en.png"}}
	13	+Configuration panel of the Dropbox plugin. The user has granted access to his Dropbox account.
12	12	{{/figure}}
13	13
14		-In order to upload files to your Dropbox 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]]).
	16	+With the Dropbox plugin for XIMA® FORMCYCLE you are able to to upload files to your Dropbox account during form processing. This plugin is subject to additional charge.
15	15
16		-{{figure image="Provide_upload.png" width="300"}}
17		-Providing attached files via the action [[Provide upload>>https://help.formcycle.eu/xwiki/bin/view/Main/Upload+bereitstellen]].
18		-{{/figure}}
	18	+An installation guide for plugins can be found [[here>>doc:Formcycle.UserInterface.Client.Plugins.WebHome]].
19	19
20		-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).
21		-
22		-A listing of all providing actions can be found [[here>>https://help.formcycle.eu/xwiki/bin/view/Main/Aktionen]].
23		-
24	24	= Configuration of the Dropbox plugin =
25	25
26		-After files have been provided for further processing, you can add a new action of type Dropbox plugin in order to upload these files to your Dropbox.
	22	+Add a new action of type //Dropbox (Upload)// in order to upload files to your Dropbox.
27	27
28	28	== Authentication of your Dropbox account ==
29	29
30		-{{figure image="Dropbox_authentication.png" width="300"}}
	26	+{{figure image="Dropbox_authentication.png"}}
31	31	Authorizing XIMA® FORMCYCLE to access the user's Dropbox.
32	32	{{/figure}}
33	33
34		-In order to use the Dropbox plugin to begin with it is necessary to authorize XIMA® FORMCYCLE to access your Dropbox. For this purpose you need an authentication token which can be requested via the respecting button in the plugin user interface (see [[attach:Dropbox-Plugin.png]]). This button will open a new browser window in which you have to sign in to your Dropbox account. Subsequently you need to allow XIMA® FORMCYCLE to access your Dropbox in order to receive the authentication token. This token needs to be copied into the appropriate input field of the plugin user interface. Afterwards save the action. If the authentication was successful the name of your Dropbox account will be displayed.
	30	+In order to use the Dropbox plugin to begin with it is necessary to authorize XIMA® FORMCYCLE to access your Dropbox. For this purpose you need an authentication token which can be requested via the respecting button in the plugin user interface (see [[figure>>||anchor="fig_plugin_dropbox_auth"]]). This button will open a new browser window in which you have to sign in to your Dropbox account. Subsequently you need to allow XIMA® FORMCYCLE to access your Dropbox in order to receive the authentication token. This token needs to be copied into the appropriate input field of the plugin user interface. Afterwards save the action. If the authentication was successful the name of your Dropbox account will be displayed.
35	35
36		-{{figure image="Dropbox_authentication_token.png" width="300"}}
	32	+{{figure image="Dropbox_authentication_token.png"}}
37	37	The received authentication token from Dropbox needs to be copied into the appropriate input field of the plugin user interface.
38	38	{{/figure}}
39	39
...	...	@@ -45,10 +45,16 @@
45	45
46	46	== Upload settings ==
47	47
48		-The table of the plugin user interface lets you select the providing actions, the files of which should be uploaded to your Dropbox. 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 Dropbox. This way the files only reside in your Dropbox and not in the system of XIMA® FORMCYCLE anymore.
	44	+Two types of files can be uploaded to the Dropbox with the plugin:
49	49
50		-By default files will be uploaded to the root directory of your Dropbox. The input field "Upload to folder" lets you specify a file path in your Dropbox in which the uploaded files will be placed. Separate folders with a "/". In the example [[attach:Dropbox-Plugin.png]] [[variables>>https://help.formcycle.eu/xwiki/bin/view/Main/Platzhalter]] are used to create a new folder for the project and a new folder for every form process.
	46	+* **Files of previous actions**
	47	+Here action are available that provide files to the [[workflow>>Formcycle.UserInterface.MyForms.WorkflowProcessing]]. The files of the selected actions will be uploaded to the selected Dropbox account. You can find a list of all file providing actions [[here>>Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions]]. {{info}}Only actions are availbale that are positioned before and within the same state.{{/info}}
	48	+* **Files to upload**
	49	+Here files of [[form uploads>>Formcycle.FormDesigner.FormElements.Upload]] are provided. Additionally these files can be deleted from the form attachments. This way the files only reside in your Dropbox and not in the system of XIMA® FORMCYCLE anymore.
51	51
52		-The option "Mute upload" deactivates operating system notifactions for new uploads if you are using the Dropbox client.
	51	+Configuration of the upload destination:
53	53
54		-[[image:Dropbox-Plugin_en.png]]
	53	+* **Upload to folder**
	54	+By default files will be uploaded to the root directory of the Dropbox. The input field "Upload to folder" lets you specify a file path in your Dropbox in which the uploaded files will be placed. Separate folders with a "/". In the [[example>>||anchor="fig_plugin_dropbox_auth"]] [[variables>>Formcycle.UserInterface.Variables]] are used to create a new folder for the form and a new folder for every form process.
	55	+* **Mute upload**
	56	+This option deactivates operating system notifactions for new uploads if you are using the Dropbox client.