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:
Create a language subfolder under
GlobalResourcesto contain the translated files – give it the name of the language code you localizing for.Copy the
.html,.xsltand.resxfiles from theGlobalResourcesfolder to the new subfolder.Rename the
.html,.xsltand.resxfiles in the new subfolder to include the language code before the file extension.Edit the
.html,.xsltand.resxfiles in the new subfolder and translate all the strings to be localized.
For example, for German localization:
Create the subfolder structure:
GlobalResources\de\de-DECopy all the
.html,.xsltand.resxfiles from theGlobalResourcesfolder to thedeand thede-DEfolder.Rename the files in the respective folders –
ShoppingWEbStrings.resxbecomesShoppingWEbStrings.de.resxin thedefolder andShoppingWEbStrings.de-DE.resxin thede-DEfolder.Localize
ShoppingWEbStrings.de.resxfor general German usage andShoppingWEbStrings.de-DE.resxfor 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.
|
|
|
|
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. |
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
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 |
| 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 | ||||||||||
APPROVELINK | 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 | |||||||||
DENYLINK | 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 | |||||||||
EXTENDRENTALLINK | 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
To localize the Shopping reports text, copy and edit the
.rdlcand.rdlxfiles in theReportssubfolder.To localize the Shopping help text, copy and edit the
help.htmlfile (the master file with links to other help files) in theHelpsubfolder. 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
To localize the Shopping Web strings, copy, rename and editing the
ShoppingWebString.resxfile.
Editing and testing XSLT email template files
You can test changes to XSLT files using a tool such as https://xslttest.appspot.com/
Paste your XML list of parameters into the top box
Paste your edited XSLT into the middle box
Click Run Transformation which should populate the bottom box.
Click Open Result to view what the email body looks like. This does not include header and footer substitution
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." />
