office-addin-manifest-converter

Office-Addin-Manifest-Converter

This package provides the ability to convert an XML manifest to JSON manifest for Office add-ins.

Command-Line Interface

convert

Convert the Office add-in manifest from XML format to JSON format.

Syntax:

office-addin-manifest-converter convert <xml-manifest-file> [options]

Parameter:

xml-manifest-file: path to the XML manifest file.

Options:

-o <string> or --output <string>

Specify the path to an output directory that will contain the generated JSON manifest and related files. If there is no output directory specified, the default directory will have the same name as the input file's base name and be located at the same place of the input file. For example, if the input XML file is C:\xmlManifests\myAddin.xml, the default output directory will be C:\xmlManifests\myAddin.

-i or --image-download

Specify that the conversion should download the images into the output directory.

-u or --image-urls

Specify that the conversion should insert urls instead of package relative references for images that come from inside of the extension element.

-v or --verbose

Specify that extra log messages should be written to console.

Example:

After the package has been installed globally, the following command converts the an XML manifest file, C:\xmlManifests\myAddin.xml, to json manifest and puts the converted files into C:\jsonManifests\myAddin directory.

office-addin-manifest-converter convert C:\xmlManifests\myAddin.xml -o C:\jsonManifests\myAddin -iv

In the command, both verbose and image-download flags are turned on.

API Usage

This package provides an API called convert. The API takes two required parameters and two optional ones:

convert(inputXmlManifestFile: string, outputJsonManifestFolder: string, imageDownload: boolean = false, imageUrls: boolean = false, verbose: boolean = false);

inputXmlManifestFile: path of the input XML manifest file.

outputJsonManifestFolder: path of the output folder that will contain all generated files, including one JSON manifest file and a few icon files.

imageDownload: whether the conversion should download the images into the output directory.

imageUrls: whether the conversion should insert urls instead of package relative references for images that come from inside of the extension element.

verbose: whether extra log messages should be written to console.

The following example converts an XML manifest file, C:\xmlManifests\myAddin.xml, to json manifest and puts the converted files into C:\jsonManifests\myAddin folder.

var converter = require("office-addin-manifest-converter");

converter.convert("C:/xmlManifests/myAddin.xml", "C:/jsonManifests/myAddin", true, false, false);