125. XXE.saveAll

Parameter syntax:

[ '[ifNeeded]' ]?

Saves all the documents (which actually need to be saved) currently opened in XXE.

[ifNeeded]

Without this option, this command cannot be executed if no documents at all need to be saved.

With this option, this command does nothing but can be successfully executed even when no documents at all need to be saved.

Returns CommandResult.FAILED if no documents at all need to be saved (when [ifNeeded] is not specified) or if some of the documents which need to be saved, cannot be saved. Otherwise, returns CommandResult.DONE.

Example: converting a map to PDF requires all the topics referenced in this map to have been saved to disk.

  <command name="map.convertToPDF">
    <macro>
      <sequence>
        <command name="XXE.saveAll" parameter="[ifNeeded]" />
        <command name="selectConvertedFile" 
                 parameter="saveFileURLWithExtension=pdf" />
        <command name="map.toPDF" parameter="%_" />
      </sequence>
    </macro>
  </command>