... |
... |
@@ -1,29
+1,94 @@ |
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// |