Änderungen von Dokument Export als Persistence-Datei


Von Version 11.1
bearbeitet von jdr
am 26.07.2021, 17:32
Änderungskommentar: Löschung des Anhangs Local import and export.zip
Auf Version 11.4
bearbeitet von jdr
am 29.07.2021, 14:55
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Titel
... ... @@ -1,1 +1,1 @@
1 -Export als Persistence-Datei
1 +Export to persistence file
Inhalt
... ... @@ -1,47 +1,47 @@
1 -{{figure image="export_persistence_de.png"}}
2 -Nutzeroberfche für Aktionen des Typs //Export als Persistence-Datei//
1 +{{figure image="export_persistence_en.png"}}
2 +User interface for actions of type //Export to persistence file//.
3 3  {{/figure}}
4 4  
5 -Aktion des Typs //Export als Persistence-Datei// ermöglicht es, die Daten eines Vorgangs als persistierte Struktur bereitzustellen. Diese kann später erneut geladen werden, um das Formular wiederherzustellen. Mit dieser Aktion und Javascript-Code für das Laden der gespeicherten Werte kann damit das Speichern von Formulardaten umgesetzt werden.
5 +Action of type //Export to persistence file// allows to provide the data of an operation as a persisted structure. This can be reloaded later to restore the form. This action and javascript code for loading the persisted values can thus be used to implement saving form data.
6 6  
7 -== Parameter ==
7 +== Parameters ==
8 8  
9 -=== Ablage der erzeugten Dateien ===
9 +=== Storage of the generated files ===
10 10  
11 -; Name der Ausgabedatei
12 -: Dateiname, unter dem der exportierte Vorgang gespeichert werden soll.
11 +; Name of the output file
12 +: File name under which the exported process should be saved.
13 13  
14 -; An den Vorgang anhängen
15 -: Legt fest, ob die erzeugte Ausgabedatei an den Vorgang angehangen werden soll.
14 +; Append to operation
15 +: Specifies whether the generated output file should be attached to the operation.
16 16  
17 -== Aktionsplatzhalter ==
17 +== Action variables ==
18 18  
19 -Aktionen vom Typ //Export als Persistence-Datei// stellen [[Aktionsplatzhalter>>Formcycle.UserInterface.Variables||anchor="HAktionsplatzhalter"]] bereit, welche in darauf folgenden Aktionen verwendet werden können.
19 +Actions of type //Export to persistence file// provide [[Action variables>>Formcycle.UserInterface.Variables||anchor="HActionvariables"]] which can be used in subsequent actions.
20 20  
21 -=== Standardplatzhalter ===
21 +=== Standard action variables ===
22 22  
23 -; [%$<Aktionsname>.SUCCESS%]
24 -: Rückgabe ob Aktion erfolgreich ausgeführt wurde. Liefert Boolean (true/false) zurück.
25 -; [%$<Aktionsname>.RESULT%]
26 -: Rückgabe aller von der Aktion bereitgestellten Ergebnisse in strukturierter Form.
23 +; [%$<action name>.SUCCESS%]
24 +: Return whether action was successfully executed. Returns Boolean (true/false).
25 +; [%$<action name>.RESULT%]
26 +: Return all results provided by the action in structured form.
27 27  
28 -; [%$<Aktionsname>.ERROR_CODE%]
29 -: Der geworfene Fehler-Code im Fehlerfall der Aktion. Leer wenn kein Fehler aufgetreten ist.
30 -; [%$<Aktionsname>.ERROR_MESSAGE%]
31 -: Die geworfene Fehler-Nachricht im Fehlerfall der Aktion. Leer wenn kein Fehler aufgetreten ist.
28 +; [%$<action name>.ERROR_CODE%]
29 +: The error code thrown in case of an error in the action. Empty if no error occurred.
30 +; [%$<action name>.ERROR_MESSAGE%]
31 +: The thrown error message in the action's error case. Empty if no error occurred.
32 32  
33 -=== Aktionsspezifische Platzhalter ===
33 +=== Action specific action variables ===
34 34  
35 -; [%$<Aktionsname>.RESULT.fileSize%]
36 -: Größe der erstellten Persistence-Datei, in Bytes.
37 -; [%$<Aktionsname>.ERROR.message%]
38 -: Fehlercode, der zurückgeliefert wird, wenn die Persistence-Datei nicht in das Dateisystem geschrieben werden konnte.
35 +; [%$<action name>.RESULT.fileSize%]
36 +: Size of the created persistence file, in bytes.
37 +; [%$<action name>.ERROR.message%]
38 +: Error code returned if the persistence file could not be written to the file system.
39 39  
40 -== Formulardaten aus Exportdatei importieren ==
40 +== Import form data from export file ==
41 41  
42 -Wird ein Formular aufgerufen und befindet sich ein nicht-leeres Uploadfeld mit dem Namen {{code language="none"}}fcp_persistence{{/code}} im Formular bzw. gibt es eine Datei mit dem Namen {{code language="none"}}fcp-persistence{{/code}} in einem anderen Uploadfeld, so werden beim Ausliefern des Formulars die Werte aus der Persistence-Datei in Formular geschrieben und so Felder vorbellt.
42 +If a form is called and there is a non-empty upload field named {{code language="none"}}fcp_persistence{{/code}} in the form or there is a file named {{code language="none"}}fcp-persistence{{/code}} in another upload field, the values from the persistence file will be written to form when the form is delivered, thus pre-populating fields.
43 43  
44 -Der folgende Beispielcode ermöglicht es, diesen Vorgang mit einem Button zu realisieren. Dabei wird das Ziel des Formulars beim Absenden auf seine eigene URL gesetzt und alle Eingabefelder außer der Uploadfeld deaktiviert. Anschließend wird ein Submit der Form ausgeführt, durch welchen die Inhalte der Datei geladen werden.
44 +The following example code allows to realize this process with a button. Here, the form's target is set to its own URL on submit and all input fields except the upload field are disabled. Then a submit of the form is executed, through which the contents of the file are loaded.
45 45  
46 46  {{code language="javascript"}}
47 47  $('BUTTON[name="btnLoad"]').on('click', function(){
... ... @@ -54,21 +54,21 @@
54 54  $('[xn="fcp_persistence"] .img-uploaded-preview').visible(false);
55 55  {{/code}}
56 56  
57 -Alternativ kann folgender Code verwendet werden:
57 +Alternatively, the following code can be used:
58 58  
59 59  {{code language="javascript"}}
60 60  $('document').ready(function(){
61 - var nameOfTriggerButton= "btnLoad";
61 + var nameOfTriggerButton="btnLoad";
62 62  
63 63   var form = $("<form>", {
64 64   action:"?",
65 - method:"post",
66 - enctype:"multipart/form-data"
65 + method: "post",
66 + enctype: "multipart/form-data"
67 67   }).appendTo('body');
68 68  
69 69   var upload = $("<input>", {
70 - type:"file",
71 - name:"fcp_persistence"
70 + type: "file",
71 + name: "fcp_persistence"
72 72   }).appendTo(form);
73 73  
74 74   upload.change(function(){form.submit()});