The Marketplace Mapping Manager allows you to configure Salesforce field mappings and default values for Microsoft Marketplace workflows directly from the Labra Salesforce Canvas App.
With the Marketplace Mapping Manager, you can:
- Map Salesforce fields to Microsoft Marketplace fields
- Automate field population when creating Marketplace transactions
- Define default values for Microsoft Marketplace fields
- Configure metadata visibility and editability
- Create multiple templates for different Microsoft Marketplace workflows
Examples include:
- Standard Private Offers
- Renewal Offers
- Custom Enterprise Offers
- Resale Authorizations
Creating a Marketplace Template
-
To access Microsoft Marketplace templates, navigate to Settings β Sync Configuration β Marketplace.
Fig. 1 -
From the Cloud account dropdown in the upper-right corner, select your Microsoft cloud account.
Fig. 2 -
Click Create New Template.
Fig. 3 -
Enter a unique template name, select the appropriate template type, and click Create.
- You can choose from the following template types:
-
Offer β Creates a template for Microsoft Marketplace Private Offers.
Fig. 4
-
Reseller authorization β Creates a template for Microsoft Marketplace Resale Authorizations.
Fig. 5
-
Offer β Creates a template for Microsoft Marketplace Private Offers.
π Please note: The mapping configuration is largely the same for both template types. The template type determines whether the template is used when creating a Private Offer or a Resale Authorization.
- You can choose from the following template types:
Your new template will now be available for configuration.
Understanding the Marketplace Mapping Template
The Microsoft Marketplace template is divided into four sections:
- Fields
- Plan
- Metadata
- Recipient Source
Fig. 6
Each section contains Microsoft Marketplace fields that can be mapped to Salesforce fields or configured with default values.
Marketplace Mapping Fields
π Learn More! Click here for a full list of Labra Microsoft Marketplace Offer Fields in Salesforce.
Fields Tab
The Fields tab is where Salesforce fields are mapped to Microsoft Marketplace Private Offer fields.
Fig. 7
Field Mapping Columns
Each row contains the following columns:
| Column | Description |
|---|---|
| Fields to map | The Microsoft Marketplace Private Offer field available for mapping. |
| Field Type | The required Salesforce field type (Text, Picklist, Date, File, etc.). |
| Salesforce fields | The Salesforce object and field mapped to the Microsoft Marketplace field. |
| Default Value | A static value automatically populated when creating a Private Offer. |
Table 1
π Please note: Users can configure either:
- a Salesforce field mapping
OR
- a default value
A field cannot use both simultaneously.
Hidden and Read-Only Fields
The final columns provide additional control over how fields appear when creating Private Offers.
| Setting | Description |
|---|---|
| Hidden | Hides the field from the Private Offer creation page. |
| Read Only | Displays the field but prevents users from editing it. |
Table 2
π Please note: If a field is marked as Hidden, the Read Only option is automatically disabled.
Plan Tab
The Plan tab allows you to configure the product plans and plan-specific dimensions associated with the Microsoft Marketplace Private Offer.
Plans are organized into sections based on the corresponding Marketplace product or offer. Each section contains one or more product dimensions that can be mapped to Salesforce fields or assigned a default value.
Plan Mapping Columns
Each plan section contains the following columns:
| Column | Description |
|---|---|
| Product dimensions | The Marketplace plan dimension or value that can be configured for the Private Offer. |
| Salesforce fields | The Salesforce field mapped to the corresponding product dimension. |
| Default value | A static value that is automatically populated when creating the Private Offer. |
Table 2
Fig. 8
Configuring Plan Dimensions
The Plans section displays your products, with each product containing its associated dimensions.
Fig. 9
Fig. 10
For each dimension, you can either:
- Select a Salesforce field from the dropdown to dynamically populate the value, or
- Enter a Default value to use the same value for every Private Offer created from the template.
A dimension cannot use both a Salesforce field mapping and a default value simultaneously.
This configuration allows you to automatically populate the price or other dimension values for each Marketplace plan based on the Salesforce data associated with the Private Offer.
Fig. 11
π Please note: If a Salesforce field is selected, the mapped Salesforce value takes precedence over a manually entered default value. To use a static value, leave the Salesforce field mapping unselected and enter the desired value under Default value.
Metadata Tab
The Metadata tab allows you to configure the global metadata fields that are included when creating a Microsoft Marketplace Private Offer.
Metadata can be used to define additional information required for each Offer or Agreement. Administrators can create multiple metadata entries and configure their corresponding Salesforce object and value.
Fig. 12
Metadata Configuration Columns
Each metadata entry contains the following columns:
| Column | Description |
|---|---|
| Key | The metadata key or name used to identify the metadata field. |
| Object | The Salesforce object associated with the metadata field. |
| Value | The value assigned to the metadata field. |
| Read Only | Determines whether the metadata value can be edited when creating the Private Offer. |
Table 3
Creating Metadata
To add a metadata field:
- Enter the metadata Key.
- Select the corresponding Salesforce Object from the dropdown.
- Enter the required Value.
- Select Read Only if the value should not be editable during Private Offer creation.
- To add additional metadata fields, click + New metadata.
π Please note: All Global Metadata fields configured in the template are mandatory for each Offer or Agreement.
For picklist fields, the first value is automatically considered the default value.
You can remove an existing metadata entry by clicking the Delete icon next to the corresponding row.
Recipient Source Tab
The Recipient Source tab allows you to define where recipient information is retrieved from when creating a Microsoft Marketplace Private Offer.
The configured Salesforce source determines which records are available for selection as recipients during the Private Offer creation process.
Fig. 13
Selecting the Recipient Source
The Choose source of recipient section allows you to select the Salesforce source used to retrieve recipient information.
Select one of the following options:
| Option | Description |
|---|---|
| Contacts | Retrieves recipient information from Salesforce Contact records. |
| Contact Roles | Retrieves recipient information based on Contact Role records associated with Salesforce records. |
Table 4
To configure the recipient source:
- Under Choose source of recipient, select the Salesforce object from which recipients should be retrieved.
- Select either Contacts or Contact Roles.
The selected source determines the recipient records available when creating a Microsoft Marketplace Private Offer from the template.
π Please note: Only one recipient source can be selected for each template.
Saving and Managing Marketplace Templates
Once all desired mappings have been configured, click Save.
Fig. 14
All saved Microsoft Marketplace templates will appear under Settings β Sync Configuration β Marketplace after selecting your Microsoft cloud account.
From this page, users can:
- create new templates
- edit existing templates
- clone templates
- delete templates
π Please note: Templates can be updated at any time. Once saved, they will be available whenever users create a Microsoft Marketplace Private Offer from the Labra Control Center in Salesforce.