Configuring the Microsoft 365 Subdomain Form for Billing

Important: Do not perform the instructions of this section if CloudBlue Commerce 21.0 or later is installed.

The Microsoft 365 subdomain form is a form in which customers must specify their initial subdomains (for instance, customer.onmicrosoft.com) on purchasing Microsoft 365 services.

This form is displayed in the following places in Billing:

the 'Add New Order' wizards of the Provider, Reseller, and Customer Control Panels;
the online store;

To configure the Microsoft 365 subdomain form, perform these actions:

Prepare the Billing customization files that belong to your application version:
1. Upload Microsoft365-x.xx.app.zip to your workstation.
2. Extract the contents of the application package.
3. Go to the Microsoft365-x.xx.app directory.
4. Extract the contents of Customization.zip and go to the Customization directory, which contains two sub-directories: ControlPanelCustomization and OnlineStoreCustomization. Use the contents of these sub-directories to install the Billing control panel customizations and the Billing online store customizations, as described below.
Install the Billing control panel customizations:
1. Log on to the Billing Application Server (OABLINFE) as root.
2. Create the /usr/local/bm/customization.o365 directory and copy the following files to this directory:
  - BM_ProvisioningParams.xml
  - SubscrParam_CDB_UpgradeResourceList.xml
  - SubscrParam_UpgradeList.xml
3. Go to the /usr/local/bm/conf/wnd/BM/ directory and create the customization.O365 symbolic link pointing to the /usr/local/bm/customization.o365 directory. To create the link, use the ln -s /usr/local/bm/customization.o365 customization.O365 command.
4. Create the /usr/local/bm/conf/html/o365 directory and copy the following files to the directory:
  - script.js
  - cowi_script.js
5. Copy the English localization file and the localization files of any other languages you need to the /usr/local/bm/conf/locale directory:
  - locale.en.o365 (English)
  - locale.de.o365 (German)
  - locale.es.o365 (Spanish)
  - locale.fr.o365 (French)
  - locale.it.o365 (Italian)
  - locale.ja.o365 (Japanese)
  - locale.nl.o365 (Dutch)
  - locale.pt.o365 (Portuguese)
  - locale.ru.o365 (Russian)
6. Restart the pba service by using the service pba restart command.
Install the Billing online store customizations:
1. Go to Products > Online Store and select your online store for editing.
2. Create the custom layout template o365_provision:
  1. Go to Products > Online Store and select the Layout Templates tab.
  2. Click Add New Layout Template.
  3. Specify the following:
    - Layout ID: The o365_provision value must be specified.
    - Template: Use the contents of the o365_provision.tpl.txt file.
  4. Click Save.
3. Prepare the standard layout template resourcegate:
  1. Go to Products > Online Store and select the Layout Templates tab.
  2. If the resourcegate layout template is not in the list of layout templates, add it by clicking Add Standard Layout.
  3. In the list of layout templates, click the resourcegate layout template.
  4. Click Edit.
  5. In the Template field, replace the existing contents with the contents of the o365_resourcegate.tpl.txt file.
  6. Click Save.
4. Add the custom Microsoft 365 styles to your online store:
  1. Go to Products > Online Store and select the Design tab.
  2. Click Edit.
  3. In the Customized CSS field, add the Microsoft 365 styles of the o365.css.txt file to the existing styles.
    
    Important: Do not remove or change styles not related to the Microsoft 365 application.
  4. Click Save.
5. Add the English translations and the translations of any other languages you need to your online store:
  1. Go to Products > Online Store and select the More tab.
  2. Click Languages.
  3. Select the required language by clicking the respective link in the Language ID / Language Name column.
  4. Click Import Dictionary and select the required dictionary file:
    - locale-bmstore.en (English)
    - locale-bmstore.de (German)
    - locale-bmstore.es (Spanish)
    - locale-bmstore.fr (French)
    - locale-bmstore.it (Italian)
    - locale-bmstore.ja (Japanese)
    - locale-bmstore.nl (Dutch)
    - locale-bmstore.pt (Portuguese)
    - locale-bmstore.ru (Russian)
  5. Select the Overwrite Translations checkbox.
  6. Click Save.
6. Go to Products > Online Store and click Synchronize Now.

Important: Before configuring the Microsoft 365 subdomain form, ensure the aps_defaults_o365 service parameter is added to all Microsoft 365 service templates. See Creating Microsoft 365 Service Templates to learn more about this service parameter.