Skip to main content

Shopping 6.1

Editing or localizing Shopping

Summary

You can edit or localize Shopping by modifying email templates and Web console strings for language packages. The default language pack is installed in: C:\Program Files (x86)\1E\Shopping\Website\ShoppingAPI\GlobalResources

The process to localize Shopping is:

  1. Create a language subfolder under GlobalResources to contain the translated files – give it the name of the language code you localizing for.

  2. Copy the .html, .xslt and .resx files from the GlobalResources folder to the new subfolder.

  3. Rename the .html, .xslt and .resx files in the new subfolder to include the language code before the file extension.

  4. Edit the .html, .xslt and .resx files in the new subfolder and translate all the strings to be localized.

For example, for German localization:

  1. Create the subfolder structure:GlobalResources\de\de-DE

  2. Copy all the .html, .xslt and .resx files from the GlobalResources folder to the de and the de-DE folder.

  3. Rename the files in the respective folders – ShoppingWEbStrings.resx becomes ShoppingWEbStrings.de.resx in the de folder and ShoppingWEbStrings.de-DE.resx in the de-DE folder.

  4. Localize ShoppingWEbStrings.de.resx for general German usage and ShoppingWEbStrings.de-DE.resx for native German usage.

When copying and localizing the files, you must populate and create translations for all the new language folders you have created, including the general ones. If you do not populate the general language folder, this may result in blank emails being sent for systems where the specific de-DE language is not set, but the default language is de.

Modifying the email templates

Shopping relies on the use of email notifications to manage approvals and licensing. The default email content can be modified by editing the template XSLT files in: C:\Program Files\1E\Shopping\Website\ShoppingAPI\GlobalResources]

You can use @parameters in the templates to represent different elements of the Shopping process, such as users and approvers account details. See below for details of available parameters.

The subject for each email is taken from the text in the <title> tag in its .xslt template file. Changing the title will change the subject for all the emails derived from that template.

Some XSLT email templates include logic to determine what to include in emails, dependent on the values of parameters. Please refer to Editing and testing XSLT email template files below.

The following table is a complete alphabetic list of email template files.

  • Normal request workflow emails, as shown in the picture

  • other emails and supporting files

Filename

Purpose

1

Footer.htm

footer content for all the email templates

2

Header.htm

header content for all the email templates

3

Mail-ADIntegration-Failure-Admin.xslt

(12) sent to the administrator if the AD integration part of an installation fails

4

Mail-ADIntegration-Failure-Shopper.xslt

(12) sent to the user if the AD integration part of an installation fails

5

Mail-ADIntegration-Success-Shopper.xslt

(12) sent to the user if the AD integration for a non-SMS application succeeds

6

Mail-ApproveRequest.xslt

(8, 15) sent to the user to inform them about the approval for an application request

7

Mail-BranchApp-to-CentralApp.xslt

sent to a branch administrator when one of their branch applications has been modified by a Shopping administrator from branch administration to central administration.

8

Mail-Deleted-App-Approver.xslt

sent to the approver if they are in the process of approving an application that is subsequently deleted

9

Mail-Deleted-App-Shopper.xslt

sent to the user if they are awaiting approval for an application that is subsequently deleted

10

Mail-Failed-App-Admin.xslt

(12) sent to a Shopping administrator when the application requested by a user fails to install correctly

11

Mail-Failed-App-Shopper.xslt

(12) sent to a user when the requested application fails to install properly

12

Mail-Installed-App-Shopper.xslt

(12) sent to a user when the requested application has been successfully installed

13

Mail-LicenseExceeded.xslt

(16) sent to the License Manager and last approver whenever a license limit is exceeded

14

Mail-LicenseThreshold.xslt

sent to the License Manager whenever a license threshold is reached

15

Mail-OrderCompleted.xslt

(24) sent on completion of the order for non-approval applications if the option is set in the Shopping Admin Console.

16

Mail-OrderStatus-Shopper.xslt

used by the Order Tracking feature - please refer to Managing Order Tracking.

17

Mail-OsdMigration-Cancelled.xslt

sent to a user if another user who shares the machine cancels an OSD scheduled by the other user.

18

Mail-OsdMigration-CancelledDueToOsdDeletion.xslt

sent to users who have scheduled an OSD that becomes unavailable as a result of the Shopping administrator deleting the OSD item

19

Mail-OsdMigration-CancelledDueToPermissionChange.xslt

sent to users who have scheduled an OSD that becomes unavailable as a result of the Shopping administrator changing the permissions for the OSD item.

20

Mail-OsdMigration-CancelledDueToScheduleChange.xslt

sent to users who have schedule an OSD that becomes unavailable as a result of the Shopping administrator changing the schedule for the OSD item

21

Mail-OsdMigration-Confirmation.xslt

22

Mail-OsdMigration-Failure.xslt

sent to users and the Shopping administrator when the OSD fails

23

Mail-OsdMigration-Imminent.xslt

sent to users to remind them that the OSD is about to take place. The default is 24 hours.

24

Mail-OsdMigration-MachineDiscoveryTimeout.xslt

25

Mail-OsdMigration-Reminder.xslt

26

Mail-OsdMigration-Success.xslt

sent to users after the OSD migration

27

Mail-RejectRequest.xslt

(17) sent to the user when their application request is rejected

28

Mail-RejectRequestExpired.xslt

(17) sent to the user if their application request has not been approved or rejected after 10 days. This can be modified in the Shopping Admin Console with the auto reject timeout setting.

29

Mail-Rental-Expiration-Reminder.xslt

sent to the user to remind them that a rental application is due for uninstallation

30

Mail-RequestItem-Failure.xslt

31

Mail-Uninstall-Shopper.xslt

(24) sent to the user if a Shopping administrator uninstalls one of their shopped for applications

32

Mail-UserRequest(NonSMS).xslt

(4, 19) sent to the user and approver about the requested Configuration Manager application

33

Mail-UserRequest-Cancel-InformAdmin.xslt

(21) sent to the approver when a user cancer their request for an application

34

Mail-UserRequest-Cancel-InformUser.xslt

(21) sent to the user when they cancel their request for an application

35

Mail-UserRequest.xslt

(4, 19) sent to the user and approver about the requested Configuration Manager application. You can include a one-click approval or rejection for the approver by including these URLs in the template:

http://%SERVERURL%/%APPROVELINK%
http://%SERVERURL%/%DENYLINK%

36

OsdMigration-IcsBody.html

sent to the user with an ICS attachment for the OS Deployment calendar reminder - for more information please refer to Customizing ICS files.

230741932.png

The purple text shows the names of the XSLT email templates used in the normal request workflow, highlighted in yellow and numbered in the list to the left - the picture does not show OSD or Rental emails. The red numbering in the picture reflects the integration points discussed on The Shopping workflow page, which is the main purpose of the picture. The picture is not intended to be a complete design specification - it does not show OSD or rental emails.

Parameters summary

Paramters are used in the email templates listed above, and also in Order Tracking notification texts, as described in Managing Order Tracking.

Note

The existence of a parameter does not mean it can be used in all email templates, or notification texts.

Approval or rejection email parameters

APPROVERACCOUNT, APPROVERCOMMENT, APPROVEREMAIL, APPROVERFULLNAME, NEXTAPPROVERACCOUNT, NEXTAPPROVERFULLNAME, NEXTAPPROVEREMAIL, PREVIOUSAPPROVERACCOUNT, PREVIOUSAPPROVERFULLNAME, PREVIOUSAPPROVEREMAIL, PREVIOUSAPPROVERCOMMENT

License threshold email parameters

The parameters below are described in the Parameters Table

APPROVERACCOUNT, APPROVERCOMMENT, APPROVEREMAIL, APPROVERFULLNAME, LICENSECOUNT, LICENSEMANAGER, MAXLICENSES, NEXTAPPROVERACCOUNT, NEXTAPPROVEREMAIL, NEXTAPPROVERFULLNAME, REQUESTSTATUS, THRESHOLD

Completed orders email parameters

APPROVERACCOUNT, APPROVERCOMMENT, APPROVEREMAIL, APPROVERFULLNAME, COMMENT

Software installation status email parameters

INSTALLDATEMACHINE, INSTALLDATEUTC, MESSAGEID, MESSAGE, ORDERSTATUS, REQUESTDATEMACHINE, REQUESTDATEUTC, TIMEZONE

Software uninstall email parameters

REASON, UNINSTALLDATE

User requests email parameters

APPROVELINK, APPROVERACCOUNT, APPROVEREMAIL, DENYLINK, ESCALATED, LICENSECOUNT, LICENSEMANAGER, MAXLICENSES, NEXTAPPROVERACCOUNT, NEXTAPPROVERFULLNAME, NEXTAPPROVEREMAIL, PREVIOUSAPPROVERACCOUNT, PREVIOUSAPPROVERFULLNAME, PREVIOUSAPPROVEREMAIL, PREVIOUSAPPROVERCOMMENT, REQUESTSTATUS, SERVERURL, THRESHOLD

Rental expiry reminders email parameters

APPLICATION, CANUNINSTALL, EXTENDRENTALLINK, EXTENSIONDATE, EXTENSIONSLEFT, SERVERURL

Parameters table

The table below shows which email template XSLT files can be used by each parameter. The template XSLT files highlighted in bold, include the parameter by default.

Parameter

Description

Can be used in template

ADDITIONALNOTIFICATIONTEXT

Application specific text added to an application definition in the General tab of the Application Properties dialog. This text is used provide additional information related to the installation, such as a link to a file share or an installation program for a non-Configuration Manager application.

Mail-ApproveRequest.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

APPLICATION

The name of the application.

Mail-ADIntegration-Failure-Admin.xslt

Mail-ADIntegration-Failure-Shopper.xslt

Mail-ADIntegration-Success-Shopper.xslt

Mail-ApproveRequest.xslt

Mail-BranchApp-To-CentralApp.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-Rental-Expiration-Reminder.xslt

Mail-RequestItem-Failure

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest-Cancel-InformAdmin.xslt

Mail-UserRequest-Cancel-InformUser.xslt

Mail-UserRequest.xslt

APPLICATIONINSTALL

AD

App

1

add

install

0

remove

uninstall

Mail-ADIntegration-Failure-Admin.xslt

Mail-ADIntegration-Failure-Shopper.xslt

Mail-ADIntegration-Success-Shopper.xslt

Mail-FailedApp-Admin.xslt Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-OrderStatus-Shopper.xslt

APPLICATIONLICENSEMANAGEREMAIL

Mail-LicenseExceeded.xslt

Link for one-click application approval without a comment.

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

APPROVERACCOUNT

User account for the approver.

Mail-ApproveRequest.xslt

Mail-RejectRequest.xsltMail-LicenseThreshold.xslt

Mail-LicenseExceeded.xslt

Mail-OrderCompleted.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

APPROVERCOMMENT

Comments made by the approver when approving or rejecting a request.

Mail-ApproveRequest.xslt

Mail-RejectRequest.xslt

Mail-LicenseThreshold.xslt

Mail-LicenseExceeded.xslt

Mail-OrderCompleted.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

APPROVEREMAIL

Email address of the approver.

Mail-ApproveRequest.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-RejectRequest.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

APPROVERFULLNAME

User name of the approver derived from the AD.

Mail-ApproveRequest.xslt

Mail-LicenseThreshold.xslt

Mail-LicenseExceeded.xslt

Mail-OrderCompleted.xslt

Mail-RejectRequest.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

BRANCH

Mail-BranchApp-To-CentralApp.xslt

CANUNINSTALL

Internally used flag that indicates whether the application can be uninstalled.

Rental-Expiration-Reminder.xslt

COMMENT

User comments when requesting the application.

Mail-ADIntegration-Failure-Admin.xslt

Mail-ADIntegration-Failure-Shopper.xslt

Mail-ApproveRequest.xslt

Mail-RejectRequest.xslt

Mail-LicenseThreshold.xslt

Mail-LicenseExceeded.xslt

Mail-OrderCompleted.xslt

Mail-InstalledApp-Shopper.xslt

Mail-FailedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-OsdMigration-MachineDiscoveryTimeout

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest-Cancel-InformAdmin.xslt

Mail-UserRequest-Cancel-InformUser.xslt

Mail-UserRequest.xslt

Rental-Expiration-Reminder.xslt

Link for one-click application rejection without a comment.

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

DESCRIPTION

Description of the application.

Mail-ADIntegration-Failure-Admin.xslt

Mail-ADIntegration-Failure-Shopper.xslt

Mail-ADIntegration-Success-Shopper.xslt

Mail-ApproveRequest.xslt

Mail-BranchApp-To-CentralApp.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-Rental-Expiration-Reminder.xslt

Mail-RequestItem-Failure

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest-Cancel-InformAdmin.xslt

Mail-UserRequest-Cancel-InformUser.xslt

Mail-UserRequest.xslt

ESCALATED

Internally used flag that indicates whether an approval email is forwarded to the deputy approver.

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

One-click rental application extend period link.

Rental-Expiration-Reminder.xslt

EXTENSIONDATE

New uninstall date if the rental period is extended.

Rental-Expiration-Reminder.xslt

EXTENSIONSLEFT

Number of extensions left for a rental application.

Rental-Expiration-Reminder.xslt

FULLNAME

Full user name retrieved from AD.

Mail-ADIntegration-Failure-Admin.xslt

Mail-ADIntegration-Failure-Shopper.xslt

Mail-ADIntegration-Success-Shopper.xslt

Mail-ApproveRequest.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest-Cancel-InformAdmin.xslt

Mail-UserRequest-Cancel-InformUser.xslt

Mail-UserRequest.xslt

GLOBALLICENSEMANAGEREMAIL

Mail-LicenseExceeded.xslt

GUID

GUID of the target machine retrieved from Configuration Manager.

Mail-ApproveRequest.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-OsdMigration-MachineDiscoveryTimeout.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

INSTALLDATEMACHINE

Application install date local to the target machine.

Mail-FailedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-InstalledApp-Shopper.xslt

INSTALLDATEUTC

Application UTC install date for the application on the target machine.

Mail-FailedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-InstalledApp-Shopper.xslt

LICENSECOUNT

Count of application licenses.

Mail-LicenseThreshold.xslt

Mail-LicenseExceeded.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

LICENSEMANAGER

Shopping-defined manager of the licenses for this application.

Mail-LicenseThreshold.xslt

Mail-LicenseExceeded.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

MACHINENAME

Name of the target machine.

Mail-ADIntegration-Failure-Admin.xslt

Mail-ADIntegration-Failure-Shopper.xslt

Mail-ADIntegration-Success-Shopper.xslt

Mail-ApproveRequest.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-OrderStatus-Shopper.xslt

Mail-OsdMigration-Cancelled.xslt

Mail-OsdMigration-CancelledDueToOsdDeletion.xslt

Mail-OsdMigration-CancelledDueToPermissionChange.xslt

Mail-OsdMigration-CancelledDueToScheduleChange.xslt

Mail-OsdMigration-Confirmation.xslt

Mail-OsdMigration-Failure.xslt

Mail-OsdMigration-Imminent.xslt

Mail-OsdMigration-MachineDiscoveryTimeout.xslt

Mail-OsdMigration-Reminder.xslt

Mail-OsdMigration-Success.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest-Cancel-InformAdmin.xslt

Mail-UserRequest-Cancel-InformUser.xslt

Mail-UserRequest.xslt

MAXLICENSES

Maximum allowed licenses for an application.

Mail-LicenseThreshold.xslt

Mail-LicenseExceeded.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

MESSAGE

Only used in the Mail-FailedApp-Admin.xslt template. This parameter provides the error message when there is a problem with the Shopping Receiver as the MESSAGEID parameter in that case will be blank.

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

MESSAGEID

The return code for the attempt to install the application. When used in the Mail-InstalledApp-Shopper.xslt messages, it returns the success code. When used in the Mail-FailedApp-Shopper.xslt and Mail-FailedApp-Admin.xslt templates, it returns the error code associated with the failure.

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

NEXTAPPROVERACCOUNT

User account for the next approver in the chain.This text is displayed if applicable, i.e. the application has chained approval and the current approver is not the last in the chain.

Mail-ApproveRequest.xslt

Mail-RejectRequest.xslt

Mail-LicenseThreshold.xslt

Mail-LicenseExceeded.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

NEXTAPPROVEREMAIL

Email account for the next approver in the chain retrieved from AD. This text is displayed if applicable, i.e. the application has chained approval and the current approver is not the last in the chain.

Mail-ApproveRequest.xslt

Mail-RejectRequest.xslt

Mail-LicenseThreshold.xslt

Mail-LicenseExceeded.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

NEXTAPPROVERFULLNAME

Full name of the next approver in the chain retrieved from AD. This text is displayed if applicable, i.e. the application has chained approval and the current approver is not the last in the chain.

Mail-ApproveRequest.xslt

Mail-RejectRequest.xslt

Mail-LicenseThreshold.xslt

Mail-LicenseExceeded.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

ORDERPROCESSINGSYSTEM

Mail-ApproveRequest.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt Mail-FailedApp-Shopper.xslt Mail-InstalledApp-Shopper.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-OrderStatus-Shopper.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-UserRequest.xslt

ORDERSTATUS

Notification Text Displayed string received from Order Tracking. Please refer to Managing Order Tracking.

Mail-OrderStatus-Shopper.xslt

PREVIOUSAPPROVERACCOUNT

User account for the previous approver.

Mail-ApproveRequest.xslt

Mail-RejectRequest.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

PREVIOUSAPPROVERCOMMENT

Comment entered by the previous approver when approving or rejecting a request.

Mail-ApproveRequest.xslt

Mail-RejectRequest.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

PREVIOUSAPPROVEREMAIL

Email address for the previous approver retrieved from AD.

Mail-ApproveRequest.xslt

Mail-RejectRequest.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

PREVIOUSAPPROVERFULLNAME

Full user name for the previous approver retrieved from AD.

Mail-ApproveRequest.xslt

Mail-RejectRequest.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

REASON

Reason text entered when creating an uninstall.

Mail-Uninstall-Shopper.xslt

REQUESTDATEMACHINE

Date the application was requested local to the target machine.

Mail-FailedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-InstalledApp-Shopper.xslt

REQUESTDATEUTC

UTC date the application was requested on the target machine.

Mail-FailedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-InstalledApp-Shopper.xslt

REQUESTSTATUS

Internally used flag to indicate the action taken when the license maximum has been reached for an application

Mail-LicenseThreshold.xslt

Mail-LicenseExceeded.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

SERVERURL

URL for the Shopping web site. Used for adding links to emails

Mail-Rental-Expiration-Reminder.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

SHOWASSOCIATEDEMAILS

Mail-LicenseExceeded.xslt

SITE

Configuration Manager site code.

Mail-ApproveRequest.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

SMSPACKAGEID

Configuration Manager package ID.

Mail-ApproveRequest.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

SMSPACKAGENAME

Configuration Manager package name.

Mail-ApproveRequest.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

SMSPROGRAMNAME

Configuration Manager program name.

Mail-ApproveRequest.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

SMSUNINSTALLPACKAGEID

Configuration Manager package ID for the uninstall package.

Mail-ApproveRequest.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

SMSUNINSTALLPACKAGENAME

Configuration Manager package name for the uninstall package.

Mail-ApproveRequest.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

SMSUNINSTALLPROGRAMNAME

Configuration Manager program name for the uninstall package.

Mail-ApproveRequest.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

THIRDPARTYAPPREF

Application reference ID used with the Shopping API.

Mail-ApproveRequest.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

THIRDPARTYREQUESTREF

Third-party request reference ID used with the Shopping API.

Mail-ApproveRequest.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

THRESHOLD

Current license threshold for an application.

Mail-LicenseThreshold.xslt

Mail-LicenseExceeded.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

TIMEZONE

Time zone of the target machine.

Mail-FailedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-InstalledApp-Shopper.xslt

UNINSTALLDATE

Current uninstallation date for an application

Mail-Rental-Expiration-Reminder.xslt

Mail-Uninstall-Shopper.xslt

USERACCOUNT

User account details.

Mail-ADIntegration-Failure-Admin.xslt

Mail-ADIntegration-Failure-Shopper.xslt

Mail-ADIntegration-Success-Shopper.xslt

Mail-ApproveRequest.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-OsdMigration-Failure.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

USEREMAIL

User email details.

Mail-ApproveRequest.xslt

Mail-DeletedApp-Approver.xslt

Mail-DeletedApp-Shopper.xslt

Mail-FailedApp-Admin.xslt

Mail-FailedApp-Shopper.xslt

Mail-InstalledApp-Shopper.xslt

Mail-LicenseExceeded.xslt

Mail-LicenseThreshold.xslt

Mail-OrderCompleted.xslt

Mail-RejectRequest.xslt

Mail-RejectRequestExpired.xslt

Mail-Uninstall-Shopper.xslt

Mail-UserRequest(NonSMS).xslt

Mail-UserRequest.xslt

Localizing Shopping reports, help and web strings

  1. To localize the Shopping reports text, copy and edit the .rdlc and .rdlx files in the Reports subfolder.

  2. To localize the Shopping help text, copy and edit the help.html file (the master file with links to other help files) in the Help subfolder. The following are default pages but you can add your own using these a templates:

    • Confirmation.html – notification for received order

    • Customizing.html – configure Shopping pages to suit your preferences

    • DeliveryOptions.html – changing delivery options

    • PlaceOrder.html – placing an order

    • Searching.html – search for an item

    • TrackOrder.html – track an order

  3. To localize the Shopping Web strings, copy, rename and editing the ShoppingWebString.resx file.

Editing and testing XSLT email template files

You can test changes to XSLT files using a tool such as https://xslttest.appspot.com/

  1. Paste your XML list of parameters into the top box

  2. Paste your edited XSLT into the middle box

  3. Click Run Transformation which should populate the bottom box.

  4. Click Open Result to view what the email body looks like. This does not include header and footer substitution

  5. Click Close.

The following example is for Mail-InstalledApp-Shopper.xslt

<ShoppingParameters 
APPLICATIONINSTALL="1" 
APPLICATION="AppName" 
COMMENT="Comment" 
MACHINENAME="machineName"
TARGETUSERACCOUNT="Shopper1@acme.com"
INSTALLDATEMACHINE="11-SEP-2021 20:21"
INSTALLDATEUTC="11-SEP-2021 19:21"
REQUESTDATEMACHINE="11-SEP-2021 20:20"
REQUESTDATEUTC="11-SEP-2021 19:20"
SITE="CM1"
MESSAGEID="10008"
TIMEZONE="-60"
/>

The following example is for Mail-OrderStatus-Shopper.xslt (Action 2)

<ShoppingParameters 
APPLICATIONINSTALL="1"
ORDERPROCESSINGSYSTEM="TACHYON"
APPLICATION="AppName"
MACHINENAME="machineName"
TARGETUSERACCOUNT="Shopper1@acme.com"
ORDERSTATUS="Approver1@acme.com has approved your request for AppName. 1 more approval(s) pending."
/>
230741922.png
230741921.png