BeyondERP.Newsletter
Menu

Setup page · Retail and Commerce

Employee images

A setup page where you define the media template (URL path and file extension) that Store Commerce uses to fetch externally hosted images of workers.

Used by
Retail catalog manager, Retail merchandising manager, Retail store manager
Business process
Create and manage shifts in Dynamics 365 Commerce
Menu item
RetailWorkerImage
Main table
RetailImageResource
Show what matters for
PAGE GUIDEWhat the page does and how to use it7 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page where you define the media template (URL path and file extension) that Store Commerce uses to fetch externally hosted images of workers.
What you do hereUse this page to open Define media template for the Worker entity so that employee photos stored on your media server or CDN appear in Store Commerce.
ExampleFor example, a retailer stores employee photos on an external media server and defines the employee image template so Store Commerce can retrieve them.
Employee images page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Steps from Microsoft

  1. Go to Retail and Commerce > Employees > Employee images.
  2. On the Action Pane, select Define media template.
  3. On the Media path FastTab, enter the remaining path of the image location under the media base URL.
  4. In the File Extension field, select the expected file name extension.
  5. Select OK.
  6. Run Catalog job 1150 from Retail and Commerce IT > Distribution schedule.

Source: Microsoft Learn

Fields on the page

FieldWhat it means
EntityThe entity the media template applies to; Worker for this page.Microsoft Learn
Media pathThe folder path appended to the channel profile's media base URL to locate the images.Microsoft Learn
File ExtensionThe file name extension (for example .jpg) the images use.Microsoft Learn
Generate Image URLs for ExcelPreviews the image URLs derived from the template and prepares them for Edit in Excel overrides.Microsoft Learn

Test checklist

  1. Set Media base URL on the store's channel profile.
  2. On Employee images, open Define media template, enter the media path and file extension, and use Generate Image URLs for Excel to check the URLs.
  3. Run the Catalog job (1150) from Distribution schedule.
  4. Sign in to Store Commerce and check that the worker's photo appears.

Source: Microsoft Learn

Solution architect

4Design impact

Can it be undoneReversible: The media template can be edited any time, but Store Commerce sees the change only after the Catalog job (1150) runs. The LanguageID token isn't supported for the Worker entity. Microsoft Learn
If you change it laterAny change to the employee media template only reaches the stores after the Catalog job (1150) is run; the LanguageID token is not supported for the Worker entity. Microsoft Learn
Technical architect

5Technical

Menu itemRetailWorkerImage Checked in Dynamics 365
FormRetailMediaGallery Checked in Dynamics 365
TableRetailImageResourceShown as “RETAILIMAGERESOURCE” in Record infoChecked in Dynamics 365
Who can open itPrivilegesMaintain media management security. RetailMediaMaintainDutiesMaintain media management security. RetailMediaMaintain
3 security rolesRetail catalog manager RetailCatalogManagerRetail merchandising manager RetailMerchandisingManagerRetail store manager RetailStoreManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itRetail store manager RetailStoreManagerRetail merchandising manager RetailMerchandisingManagerRetail catalog manager RetailCatalogManagerGive people one of these roles. On this system, 3 roles can open this page.Checked in Dynamics 365
Actions on the page(Action Pane without tabs): Define media template, View referencesChecked in Dynamics 365
Developer

6Developer

Open it by URLhttps://<your-environment>/?mi=RetailWorkerImage
Table definitionRetailImageResource columns and relations Microsoft data model
Everyone

7Sources