Summary

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

Details

Page properties

Content

...	...	@@ -1,29 +1,96 @@
1	1	{{content/}}
2	2
3		-{{figure image="FCSnapshot4.png" height="300"}}Uploading form specific files{{/figure}}
	3	+{{figure image="files_list_en.png" width="600"}}
	4	+A list of all uploaded files. These may be form-specific files or files available to all forms.
	5	+{{/figure}}
4	4
5		-{{figure image="FCSnapshot5.png" width="300"}}Uploading client specific files{{/figure}}
	7	+There are two different types of files in {{formcycle/}}:
6	6
7		-There are two different types of files.
	9	+; Client-specific files
	10	+: Files that are available to all forms. For example, they could be used as template files for actions of type //[[PDF (Fill)>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.PDFFill.WebHome]]// or [[//Word (Fill)//>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.WordFill.WebHome]]: The same template may be required by multiple forms. Client-specific files with the extension //.css// ([[{{smallcaps}}Css{{/smallcaps}}>>doc:Formcycle.FormDesigner.CodingPanel.CSSTab.WebHome]]) or //.js// ([[JavaScript>>doc:Formcycle.FormDesigner.CodingPanel.ScriptTab.WebHome]]) are included automatically in all forms. You can upload these files in the menu //Files & templates //{{rarrow/}} //Files//.
	11	+; Form-specific files
	12	+: Files that are only available to the form for which they have been uploaded. Form-specific files with the extension //.css// ([[{{smallcaps}}Css{{/smallcaps}}>>doc:Formcycle.FormDesigner.CodingPanel.CSSTab.WebHome]]) or //.js //([[JavaScript>>doc:Formcycle.FormDesigner.CodingPanel.ScriptTab.WebHome]]) are included automatically in the form. You can upload these files in the form overview menu //My forms// if you open the side menu of the form and click on //Files//. Or you can upload files directly from within the designer by clicking on //More// {{rarrow/}} //Files//.
8	8
9		-* Client specific files are available to all forms. For example, they could be used as template files for actions of type //[[PDF (Fill)>>doc:PDF - Fill]]// or [[//Word (Fill)//>>doc:Word (Fill)]], as the same template may be required by multiple forms.
10		-* Form-specific files are only available to the form for which they have been uploaded. Form specific files with the extensions //.css// ([[Stylesheet>>doc:CSS]]) or //.js //([[Javascript>>doc:TAB - Script]]) will be included in the form automatically.
	14	+=== Create a new file ===
11	11
12		-== Uploading files ==
	16	+{{figure image="files_new.png"}}
	17	+Creating a new file. You can upload a file either with the browser's upload dialog or directly via drag&drop.
	18	+{{/figure}}
13	13
14		-=== Client specific files
	20	+1. Click on the {{ficon name="plus-circle-outline"/}} button to the top left.
	21	+1. The browser's file upload dialog opens. Select the file or files you would like to upload. After you choose a file, it will be uploaded automatically.
	22	+1. Optionally, you can give the uploaded files a different name and description in the panel to the right. To save the changes you have made, click the //Save// button at the bottom.
15	15
16		-Files that should be available for all forms of a certain client can be uploaded via //Files & Templates// -> //Files//.
	24	+If a file with the same name exists already, the file is renamed and created as a separate file.
17	17
18		-=== Form specific files
	26	+=== Update a file ===
19	19
20		-You can upload files that should be available to a certain form via //Forms// -> //FormName// -> //Files//.
	28	+{{figure image="files_update_en.png"}}
	29	+You can change the content of a file later. Either use the update button or the drag&drop support. When you make use of a file elsewhere in the system (such as in a workflow action), you should not change the name of the file anymore. Otherwise, references to the file may be lost.
	30	+{{/figure}}
21	21
22		-== Creating new files ==
	32	+1. Select the file you would like to update, by clicking on the file name.
	33	+1. Click on the button //Update file// to the bottom right
	34	+1. This opens the browser's upload dialog. Choose a new file and press {{smallcaps}}Ok{{/smallcaps}}.
	35	+1. To apply the changes, press the //Save// button to the bottom right
23	23
24		-{{figure image="FCSnapshot6.png" width="500"/}}
	37	+=== Download a file ===
25	25
26		-1. Click on the new button to the top left.
27		-1. Select the file to be uploaded by clicking on //Browse//.
28		-1. Optionally, you may enter a description and a different name.
29		-1. Finally, save the file by click on the //save// button to the top right.
	39	+{{figure image="files_download.png"}}
	40	+You can download either individual files or a set of files as a {{smallcaps}}Zip{{/smallcaps}} archive.
	41	+{{/figure}}
	42	+
	43	+1. Use the checkboxes to the left of the filename to select the files you would like to download.
	44	+1. Click on the download {{icon name="download"/}} to download the selected files
	45	+
	46	+This starts a file download. If you selected only one files, you can download the file directly. Otherwise, when you selected more than one files, you will get a {{smallcaps}}Zip{{/smallcaps}} archive with the files.
	47	+
	48	+=== Deleting a file ===
	49	+
	50	+{{figure image="files_delete.png"}}
	51	+When you do not need a file anymore, you can delete it. Once deleted, a files cannot be restored anymore.
	52	+{{/figure}}
	53	+
	54	+1. Use the checkboxes to the left of the filename to select the files you would like to delete.
	55	+1. Click on the button {{icon name="trash"/}} to delete the files
	56	+
	57	+This will prompt you to confirm whether you would really like to delete the files. A file that has been deleted cannot be restored.
	58	+
	59	+== Additional information ==
	60	+
	61	+The panel to the right offers some more information and several more settings. You can view or edit the following settings:
	62	+
	63	+; Alias
	64	+: The name of the file, as it is used in other parts of the system.
	65	+; Description
	66	+: An internal description for the file. This description is never visible to the end user.
	67	+
	68	+Next, you can also review the following information:
	69	+
	70	+; Name
	71	+: The original file name of the uploaded file. This is useful, for instance, when you have updated a file and would like to check whether you uploaded the right file.
	72	+ Kann etwa genutzt werden, um beim Aktualisieren einer Datei zu prüfen, ob die richtige Datei hochgeladen wurde.
	73	+; Size
	74	+: The file size of the file.
	75	+; Created
	76	+: The date and time when the file was originally created.
	77	+; Create by
	78	+: The name of the user who originally created the file.
	79	+; Changed
	80	+: The date and time when the file was most recently updated.
	81	+; Changed by
	82	+: The name of the user who made the most recent update to the file
	83	+
	84	+{{figure image="files_url_en.png"}}
	85	+You can also access a file via an {{smallcaps}}Url{{/smallcaps}}. This can be used, for example, to load a file dynamically via JavaScript or to include a font file in a form.
	86	+{{/figure}}
	87	+
	88	+Finally you can get check out the {{smallcaps}}Url{{/smallcaps}} to the file. Use this {{smallcaps}}Url{{/smallcaps}} to access the contents of the file. Please note that the {{smallcaps}}Url{{/smallcaps}} may need to be modified in case you are making use of [[frontend servers>>doc:Formcycle.SystemSettings.UserInterface.FrontendServer]].
	89	+
	90	+{{smallcaps}}Urls{{/smallcaps}} are shown for files with the following file extensions only:
	91	+//.html, .htm, .shtm, .xhtm, .css, .js, .json, .xml, .jpg, .jpeg, .png, .gif, .svg, .ttf, .pdf//
	92	+
	93	+{{version major="6" minor="3"/}} Starting with version 6.3.0 the {{smallcaps}}Url{{/smallcaps}} is shown for files with the following file extensions, too:
	94	+//.otf, .woff, .woff2, .svg, .ttf, .eot, .sfnt, .jpe//
	95	+
	96	+For files with other extensions, {{formcycle/}} does not show {{smallcaps}}urls{{/smallcaps}} and these files are not accessible from outside via {{smallcaps}}url{{/smallcaps}}.