{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"79bf6c1a-1261-43c5-8260-62f1cdd4f41b"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"6ea22ea2-20a9-409b-bf21-9a4d7e7a5135"}},{"type":"rule"},{"type":"paragraph","content":[{"text":"This document function can be used to distribute various objects, such as PDF documents, images or macro-based add-ins for Excel or PowerPoint. The document function is also needed for mail themes with the required styles in mail templates and signatures. In the following table some elements are explained:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"36284028-4688-4772-b2f7-28b8922376ef"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Tag","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"paragraph","content":[{"text":"Explanation","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Path","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"paragraph","content":[{"text":"The storage location of the affected file can be selected here.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Lockfile","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"paragraph","content":[{"text":"This can be used to prevent an open file from being modified. For this purpose, the affected file including extension can be specified.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Merge","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"paragraph","content":[{"text":"It can be determined whether the file(s) should be replaced, removed or merged during an update.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The document function is available exclusively for the following template types: \"External file for distribution\" and \"Mail Theme\".","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"\"Scriptable\"","type":"text"}]},{"type":"paragraph","content":[{"text":"The template distribution is able to read certain system variables and thus – depending on the environment – roll out other files. This is necessary to support different Office versions with an Office Add-In package for example. The system of \"","type":"text"},{"text":"Scriptable Configs","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"/wiki/spaces/PDTEN/pages/61410884"}}]},{"text":"\" can be used for this.","type":"text"}]},{"type":"paragraph","content":[{"text":"The API object has the following properties for Word, Excel, PowerPoint and Outlook respectively:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"328a2a99-b1bb-4ce2-9266-7b467cb83c73"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[112.0]},"content":[{"type":"paragraph","content":[{"text":"Feld","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[185.0]},"content":[{"type":"paragraph","content":[{"text":"Werte","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[459.0]},"content":[{"type":"paragraph","content":[{"text":"Beschreibung","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[112.0]},"content":[{"type":"paragraph","content":[{"text":"IsDetected","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[185.0]},"content":[{"type":"paragraph","content":[{"text":"Boolean","type":"text","marks":[{"type":"code"}]},{"text":" true / false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[459.0]},"content":[{"type":"paragraph","content":[{"text":"Returns whether the Office product is installed.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[112.0]},"content":[{"type":"paragraph","content":[{"text":"Version","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[185.0]},"content":[{"type":"paragraph","content":[{"text":"Integer","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[459.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the installed Office version.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[112.0]},"content":[{"type":"paragraph","content":[{"text":"Is32Bit","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[185.0]},"content":[{"type":"paragraph","content":[{"text":"Boolean","type":"text","marks":[{"type":"code"}]},{"text":" true / false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[459.0]},"content":[{"type":"paragraph","content":[{"text":"Returns whether the Office product is installed in the 32-bit version.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[112.0]},"content":[{"type":"paragraph","content":[{"text":"Is64Bit","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[185.0]},"content":[{"type":"paragraph","content":[{"text":"Boolean","type":"text","marks":[{"type":"code"}]},{"text":" true / false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[459.0]},"content":[{"type":"paragraph","content":[{"text":"Returns whether the Office product is installed in the 64-bit version.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"For example, ","type":"text"},{"text":"oo.Word.Version","type":"text","marks":[{"type":"code"}]},{"text":" returns the installed Word version if ","type":"text"},{"text":"oo.Word.IsDetected","type":"text","marks":[{"type":"code"}]},{"text":" returns ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Office versions","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","localId":"593abef6-c461-4cb1-849b-3b3f92355aea"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"Office version","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[629.0]},"content":[{"type":"paragraph","content":[{"text":"Office 'Year'","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"14","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[629.0]},"content":[{"type":"paragraph","content":[{"text":"2010","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"15","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[629.0]},"content":[{"type":"paragraph","content":[{"text":"2013","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"16","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[629.0]},"content":[{"type":"paragraph","content":[{"text":"2016/2019","type":"text"}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Cleanup","type":"text"}]},{"type":"paragraph","content":[{"text":"Using ","type":"text"},{"text":"Cleanup","type":"text","marks":[{"type":"code"}]},{"text":" created registry values and files/folders can be deleted again. Three commands are available:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"This deletes the file or folder (including subfolders). Wildcards are also supported: i.e. using ","type":"text"},{"text":"Path To Folder/*.txt","type":"text","marks":[{"type":"code"}]},{"text":" it is possible to filter for text files in a specific folder.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"This deletes the specified registry key. ","type":"text"},{"text":"View","type":"text","marks":[{"type":"code"}]},{"text":" can be omitted (default registry view).","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"This deletes the specified value in the registry. ","type":"text"},{"text":"View","type":"text","marks":[{"type":"code"}]},{"text":" can be omitted (Default Registry View).","type":"text"}]},{"type":"paragraph","content":[{"text":"Execution time:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The cleanup process is executed:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"when OneOffixx is uninstalled.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"when OneOffixx is started with ","type":"text"},{"text":"/clean","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"by starting it manually in the template editor.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"or when changing or resetting the data source.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"CAUTION","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For cleanup ","type":"text"},{"text":"OneOffixx must have the template in cache","type":"text","marks":[{"type":"strong"}]},{"text":" – manually clearing the cache may prevent distributed templates from being removed automatically.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For changes, make sure that older versions you rolled out earlier are also cleaned up properly.","type":"text"}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"The following configuration verifies that it registers the correct 32-bit or 64-bit version of a PowerPoint add-in:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n %APPDATA%\\SomePowerpointAddin\n \n \n \n %APPDATA%\\SomePowerpointAddin\\SomePowerpointAddin.ppam\n 00000001\n \n \n \n \n \n \n \n \n \n \n %APPDATA%\\SomePowerpointAddin\\SomePowerpointAddin.ppam\n 00000001\n \n \n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"with API Object: ","type":"text"},{"text":"oo.PowerPoint.Version = 15","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"oo.PowerPoint.Is32Bit = true","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"oo.PowerPoint.Is64Bit = false","type":"text","marks":[{"type":"code"}]},{"text":" results in the following:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n %APPDATA%\\SomePowerpointAddin\n \n \n %APPDATA%\\SomePowerpointAddin\\SomePowerpointAddin.ppam\n 00000001\n \n \n \n \n \n \n","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Mail Theme for Outlook","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"CAUTION","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"The style name and the .dotx file name must match.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"To roll out a Mail Theme via the document function, the following configuration is necessary:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n ViaFiles\n \n \n CompanyStyle\n \n \n mailsettings.reg\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"The mail theme is always dependent on the installed Outlook version. If you want to support two different Outlook versions, you have to duplicate the Mail Theme and customize it in the corresponding Outlook version.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"PowerPoint","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"NOTE","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"The .ppam file must be imported zipped as \"External template”.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"To roll out the OneOffixx PowerPoint Add-in, the following configuration is necessary:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n %APPDATA%\\OneOffixx\\PowerPoint\n %APPDATA%\\OneOffixx\\PowerPoint\\OneOffixx.ppam\n \n \n = 16\">\n \n \n \n %APPDATA%\\OneOffixx\\PowerPoint\\OneOffixx.ppam\n 00000001\n \n \n \n \n \n \n \n \n \n \n %APPDATA%\\OneOffixx\\PowerPoint\\OneOffixx.ppam\n 00000001\n \n \n \n \n \n \n \n \n \n \n \n \n \n %APPDATA%\\OneOffixx\\PowerPoint\\OneOffixx.ppam\n 00000001\n \n \n \n \n \n \n \n \n \n \n %APPDATA%\\OneOffixx\\PowerPoint\\OneOffixx.ppam\n 00000001\n \n \n \n \n \n \n \n \n \n \n \n \n \n %APPDATA%\\OneOffixx\\PowerPoint\\OneOffixx_O2010.ppam\n 00000001\n \n \n \n \n \n \n \n \n \n \n %APPDATA%\\OneOffixx\\PowerPoint\\OneOffixx_O2010.ppam\n 00000001\n \n \n \n \n \n \n \n \n","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Excel","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"NOTE","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"The .xlam file must be imported zipped as \"External template”.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"To roll out the OneOffixx Excel add-in, the following configuration is necessary:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n %APPDATA%\\OneOffixx\\Excel\n %APPDATA%\\OneOffixx\\Excel\\OneOffixx.xlam\n %APPDATA%\\Microsoft\\Excel\\XLSTART\\\n \n \n \n \n","type":"text"}]},{"type":"paragraph"}],"version":1}

Browser not supported