*NEW*

- 04/18/13

You can now use the new tool provided here to build your custom StoreStructure.xml

- 03/10/13

Finally, note that you can use the Windows 8 Company Store with its Windows desktop client software. This will allow you to install modernUI application as well as launching them directly if they are already installed. More information here.

How to customize the content:

To customize the content you will need to edit the XML file named StoreStructure.xml

The global structure of the file should be the following:

<xml companyName=" ">

<Settings>

<DisplayPrivacyPolicy>Yes</DisplayPrivacyPolicy>

<ErrorMessage>

<Error name="URIFormatException">Url {0} is not valid, is protocol missing?</Error>

</ErrorMessages>

<StoryBoardLayout_GridMargin>0,0,0,0</StoryBoardLayout_GridMargin>

</Settings>

      <feed name=" " uri=" "/>

      <feed name=" " uri=" "/>

      <ApplicationGroup name=" " description=" " image=" ">

               <Application>

                        <Name></Name>

                        <ShortDescription></ShortDescription>

                        <MSStoreID></MSStoreID>

                        <Logo></Logo>

                        <HyperLink></HyperLink>

               </Application>

      </ApplicationGroup>

</xml>

The main xml tag will contain the name of the company. This name will be the one displayed on the main page of the application.

The Settings tag will allow you to control some of the settings of the application

• The DisplayPrivacyPolicy tag will allow you to hide or display the Privacy Policy menu in the Settings charm.
• The ErrorMessage tag will allow you to define localized error messages. The only error message available yet is the URIFormetException message that will be used if you are using a hyperlink not well formatted (for example www.bing.com instead of http://www.bing.com). 
• The StoryBoardLayout_GridMargin tag will allow you to define new margins around the application panel (add space between the application title and the application list).

You can add up to two RSS/Atom feeds to display some content to users on the main page. If don’t have feeds tag, no feeds will be displayed.

Then you can add as many ApplicationGroup as you want. Each group can contain as many application as you want.

An application is composed of:

• ·     a Name = a String,
• ·     a Description = a String,
• a Microsoft Store ID for a Windows Store application, this will be used to select an application in the store. You can find application ID in the folder %USERPROFILE%\AppData\Packages,
• ·     a Logo = an URI to a picture,
• ·     This one could be:
  • o  a website Internal or External
  • o  a link to a Windows Store page: ms-windows-store:PDP?PFN=[MSStoreID]
  • o  a protocol that will launch the application you want: example lync15MLX:// to launch the Lync ModernUI application

The image attribute of the ApplicationGroup tag as well as the Logo tag can be formatted like this:

• A path to a logo (ex: <Logo>http://mywebsite.com/mylogo.png</Logo>)
• The name of the logo file contained in the application package in the assets folder (ex: <Logo>WindowsStore.png<Logo>)
• The name of the logo file contained in the application user’s settings folder (the same folder as the StoreStructure.xml file). Before the name of the file you should add “local\” (ex: <Logo>local\myapp.jpg</Logo>) 

 

To use this store to provide Internal ModernUI application you will need to have a webpage for each application you have because it's not possible to install ModernUI application from another ModernUI application. So your internal ModernUI application will be declare like this :

               <Application>

                        <Name>My first internal ModernUI app</Name>

                        <ShortDescription>Internal ModernUI app 1</ShortDescription>

                        <MSStoreID></MSStoreID>

                        <Logo></Logo>

                        <HyperLink>http://Server/ApplicationInternal1.htm</HyperLink>

               </Application>

The Hyperlink will link to an internal website that will be used to install an application by launching an install script stored on a share. Like this:

powershell \\myShare\EnterpriseStore$\MyInternalApp\Add-AppPackage.ps1

and the powershell script is one like the one you can find when you download my application. Note that you can find more information on how to configure your web server and an example of web page here.