Customize saving

This feature works as a customized "Save As" in Word and Excel. Here, we are able to set the file name in advance when saving. If the command is used in a command chain, we can define whether the remaining commands should be executed.

Module is located here: 

...\ModuleLibrary\BaseExtensions\04_nocontext_MISC\15_W_savePromptFileName.xml

CMD

<Cmd case="BaseExtensions:customized-save" title="x" endIfCancel="x"/>

Parameter

title

Define the title for the document. Here, you can either define what the title of the document should be when it is saved, but also use environmental variables. For instance, the title can be based on a custom document property, a content control, or the current date. This is the syntax for doing so:

Document properties: %CustProp|X%

Content control: %ContentControl|Y%

Date: %CurrentDate|Z%

X refers to the name of the document property, while Y refers to the title of the content control. When using a content control that has more than one paragraph, it will always take the first paragraph. Lastly, Z refers to the format of the date. As an example, this could be dd-MM-yyyy.

The syntax is flexible, which means that we are able to reverse order or add new data. This means, if your title should be based on several variables, you can just put all of them in the title parameter.

Here is an example:

<Cmd case="BaseExtensions:customized-save" title="%CustProp|fileTitle% %ContentControl|project% %CurrentDate|dd-MM-yyyy%"/>

Here, my document will be saved with whatever is defined as the value in the document property fileTitle, as well as content in the content control project following the current date.

endIfCancel

Define whether the remaining commands should be cancelled if the opened folder dialogue is cancelled. If this parameter is set to be true, it will cancel the execution of remaining commands. If false, the command will call the remaining commands even though the user clicks "Cancel" in the dialogue.

currentDirectory

Use this parameter and define its value to true if the command should open the save as dialog in the directory where the active document is previously saved in. If this is set to false or omitted, it will open the save as dialog in the Document folder.