{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"ddba3fbc-b701-412c-a888-bbe3a71448b4"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"42d122b8-ebab-4edf-b777-94430daf47a1"}},{"type":"rule"},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"ATTENTION","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Please note the following restrictions before using this document function:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Due to Word's own various save dialogs, it cannot be guaranteed that the defined file names and paths will take effect. Example: In the case of Microsoft 365 this works with the save dialog via key ","type":"text"},{"text":"F12","type":"text","marks":[{"type":"em"}]},{"text":", but not with the new one at the new save menu under ","type":"text"},{"text":"Datei","type":"text","marks":[{"type":"em"}]},{"text":" → ","type":"text"},{"text":"Speichern unter","type":"text","marks":[{"type":"em"}]},{"text":" jedoch nicht.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"This document function is used to suggest a name and a file location when saving the document in the standard save dialog. It is possible to compose the file name using profile data or document parameters. This is done in the configuration by accessing elements from the CustomXMLPart via XSLT and XPath.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Basic configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Here is a simple example configuration:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n false\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n SavePathDefinition\n \n \n \n false\n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Resulta:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"This causes the XSLT stylesheet to generate the following XML document:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n C:\\temp\\Test_FileName.docx\n false\n","type":"text"}]},{"type":"paragraph","content":[{"text":"This in turn is interpreted by OneOffixx to suggest the path \"C:\\temp\" and the file name \"Test_FileName.docx\" in the save dialog. If the folder \"C:\\temp\" does not exist, the folder should ","type":"text"},{"text":"not","type":"text","marks":[{"type":"em"}]},{"text":" be created in this example, because ","type":"text"},{"text":"CreateFolder","type":"text","marks":[{"type":"code"}]},{"text":" is set to ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Save as-dialog:","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":946,"id":"b860a90a-49b8-43b0-b7ee-3cb110a4cab5","collection":"contentId-61408693","type":"file","height":649}}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"SaveNewDocumentOnOpen","type":"text","marks":[{"type":"code"}]},{"text":" option can be used to define whether the user should be prompted to save after generating a document by displaying the save dialog.","type":"text"}]},{"type":"paragraph","content":[{"text":"Existing save paths and file names","type":"text","marks":[{"type":"strong"}]}]},{"type":"panel","attrs":{"panelIconId":"atlassian-warning","panelIcon":":warning:","panelColor":"#FFEBE6","panelType":"custom"},"content":[{"type":"paragraph","content":[{"text":"CAUTION","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"In this configuration: If the save dialog is called for documents that have already been saved (e.g. TestDok.docx on the desktop), \"Test_FileName\" is suggested again under C:_temp\\ and not the existing name at the existing location (\"TestDok\" on the desktop) as usual.","type":"text"}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Extended configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Here is an example of a configuration with much more functionality:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n false\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \\\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\t\n\t \n \n \n \n \n SavePathDefinition\n \n \n \n \n \n \n \n \n false\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"The function ","type":"text"},{"text":"translate(...)","type":"text","marks":[{"type":"code"}]},{"text":" replaces all spaces with underscores (\"_\") in this example.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Inclusion in other document functions","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Inclusion of scripts","type":"text"}]},{"type":"paragraph","content":[{"text":"The following scripts are accessed here:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n Consent form \n \n \n\n\n\n S:\\Personnel-dossier\\\n\n\n\n false\n","type":"text"}]},{"type":"paragraph","content":[{"text":"The function of the individual scripts should be self-explanatory based on the name. These scripts must be available on any template that has the \"Saving path definition\" with this configuration attached.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Access to \"Toolboxes in editor mode","type":"text"}]},{"type":"paragraph","content":[{"text":"In addition, these OneOffixx contents are accessed:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DocumentProperties.SavePath","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DocumentProperties.DocumentName","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"For these contents to be available, the document function ","type":"text"},{"text":"Toolboxes in editor mode","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDTEN/pages/61408780"}}]},{"text":" must be attached (it is already attached in the layout template if there is a logo in the document).","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Existing save paths and file names","type":"text"}]},{"type":"paragraph","content":[{"text":"The above inclusion of the existing save path and document name causes the existing save path and file name to be used for documents that have already been saved (see \"Existing save paths and file names\" at ","type":"text"},{"text":"Basic Configuration","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":" above).","type":"text"}]},{"type":"paragraph","content":[{"text":"One problem that remains here, however: When a Word file is moved or renamed, the ","type":"text"},{"text":"DocumentProperties.SavePath","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"DocumentProperties.DocumentName","type":"text","marks":[{"type":"code"}]},{"text":" fields are not updated. In this case the old save path and file name is suggested, which was still current when the file was last saved.","type":"text"}]}],"version":1}

Browser not supported