{"type":"doc","content":[{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"details","parameters":{"macroParams":{"hidden":{"value":"true"}},"macroMetadata":{"macroId":{"value":"7da7401a-fb83-48ca-85d3-e35f08cdb27e"},"schemaVersion":{"value":"1"},"title":"Page Properties"}},"localId":"6ef58a0c-52b5-457a-8a50-c76c36a7f2fd"},"content":[{"type":"paragraph","content":[{"text":"deep links","type":"text"},{"type":"hardBreak"},{"text":"deeplinks","type":"text"},{"type":"hardBreak"},{"text":"email templates variables","type":"text"},{"type":"hardBreak"},{"text":"email templates links","type":"text"}]}]},{"type":"paragraph","content":[{"text":"In this section you will find different template types designated for:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Different document workflow states","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"General cases and messaging functionality in Unity UI","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The templates are organized by document/situation type and they contain styling (HTML code) with placeholders referring to:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Texts – e.g. ","type":"text"},{"text":"$email_approveSuccess$","type":"text","marks":[{"type":"code"}]},{"text":" which translates to \"You have approved the following $object$\"","type":"text"},{"type":"hardBreak"},{"text":"For details see ","type":"text"},{"text":"Template Texts and Localization","type":"text","marks":[{"type":"link","attrs":{"href":"#TemplateTextsandLocalization"}}]},{"text":" below.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Repeating parts of styling – ","type":"text"},{"text":"$header()$","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"$body()$","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"$footer()$","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Each of these placeholders has a corresponding file in the build. These files contain company logo and formatting which is shared across all of the various template types. There are no texts and so these files are not editable in the UI.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":55.0},"content":[{"type":"media","attrs":{"width":1920,"id":"7a17501c-8953-4919-80d2-67c5d27d71d4","collection":"contentId-5481890318","type":"file","height":754},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"paragraph","content":[{"text":"In this section:","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"maxLevel":{"value":"1"}},"macroMetadata":{"macroId":{"value":"351160f2-6890-47eb-a278-89cb504736c5"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"d6ea2229-1179-420c-93d2-20d82c36788e"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Template Types","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Workflow","type":"text"}]},{"type":"paragraph","content":[{"text":"There are several ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"link","attrs":{"href":"https://pricefx.atlassian.net/wiki/spaces/UNITY/pages/5481988587"}}]},{"text":" email templates which inform users (approvers, watchers, owners) about various workflow states. The templates are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For email body:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"approvalRequired – Request for an approval to the approver.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"approve_success – Confirmation to the approver.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"deny_success – Confirmation to the approver.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"stepApproved – Notification to others.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"stepDenied – Notification to others.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"watcherNotification – Triggered by having a watcher step in the workflow. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"workflowApproved – Triggered when the whole workflow is approved.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"delegationFooter/Header – Delegation of approval authority to other user.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For email subject:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"workflowSubjectSuffix – Adds document's details to the email subject. (The subject is hardcoded and contains one of the following: Pricefx - Approval Required, Pricefx - Watcher notification, Pricefx - Approved, Pricefx - Workflow Approved, Pricefx - Denied.)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"delegationSubjectSuffix – Adds source and target users' names to the subject when workflow delegation is used.","type":"text"},{"type":"hardBreak"},{"type":"emoji","attrs":{"id":"atlassian-warning","text":":warning:","shortName":":warning:"}},{"text":" When editing these templates, you must put everything in one row (text line), even if you use a more complex template code. (If multiple rows were used, the subject suffix would be generated empty and the code you wrote would appear in the email body.)","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Some of these notifications can be switched off. You can disable:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All notifications for specified events – for details see ","type":"text"},{"text":"My Workflows (Configuration)","type":"text","marks":[{"type":"link","attrs":{"href":"https://pricefx.atlassian.net/wiki/spaces/UNITY/pages/5482218052"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Individual message types. Use the ","type":"text"},{"text":"Allow Sending","type":"text","marks":[{"type":"strong"}]},{"text":" option (next to the template name; see below) to control which message types will be sent.","type":"text"},{"type":"hardBreak"},{"text":"Note:","type":"text","marks":[{"type":"strong"}]},{"text":" Some messages are split into several items (e.g., email subject and body) – in this case only the main part (e.g., the email body) can be enabled/disabled. Disabling the main part disables the whole message.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"All of these templates are available for all the approvable documents:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data Change Request","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Price Grid Item","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Quote","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rebate Agreement","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Agreement/Promotion","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Price List","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rebate Record","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rebate Record Group","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Compensation Plan","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Compensation Record","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Custom Form","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Claim","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Export and Send by Email","type":"text"}]},{"type":"paragraph","content":[{"text":"There are templates for emails which users can send manually from Quotes, Agreements/Promotions and Rebate Agreements with the related document as an attachment (available only in the Unity interface):","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"quote_externalEmailSubject","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"quote_externalEmailBody","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"contract_externalEmailSubject","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"contract_externalEmailBody","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"rebateagreement_externalEmailSubject","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"rebateagreement_externalEmailBody","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Templates for Messaging in Documents","type":"text"}]},{"type":"paragraph","content":[{"text":"The following templates relate to the messaging functionality in Quotes, Agreements/Promotions, Rebate Agreements, Deal Plans and Custom Forms:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"emailBody_requestInfo","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"emailSubject_requestInfo","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"In these templates you can work with the following variables:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$requester","type":"text","marks":[{"type":"code"}]},{"text":" – Sender of the message. It is the ","type":"text"},{"text":"user","type":"text","marks":[{"type":"code"}]},{"text":" object for which which you can access fields such as firstname, lastname etc.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$recipient","type":"text","marks":[{"type":"code"}]},{"text":" – Recipient of the message. It is the ","type":"text"},{"text":"user","type":"text","marks":[{"type":"code"}]},{"text":" object for which which you can access fields such as firstname, lastname etc.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$baseURL","type":"text","marks":[{"type":"code"}]},{"text":" – URL of the Pricefx application. You can append to it a specific string pointing to e.g., Agreements/Promotions and create a link to this part of the application.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$type","type":"text","marks":[{"type":"code"}]},{"text":" – Allows you to find out in which context you are: it is either Quote, Agreement/Promotion, Rebate Agreement, Deal Plan or Custom Form. ","type":"text"},{"type":"hardBreak"},{"text":"Instead of this variable you can also use one of the following five variables (","type":"text"},{"text":"isQuote","type":"text","marks":[{"type":"code"}]},{"text":", etc.) – their usage is similar.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$isQuote","type":"text","marks":[{"type":"code"}]},{"text":" – Allows you to customize the template for Quotes only. It returns true if ","type":"text"},{"text":"$entity","type":"text","marks":[{"type":"code"}]},{"text":" is a Quote.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$isContract","type":"text","marks":[{"type":"code"}]},{"text":" – Allows you to customize the template for Agreements/Promotions only. It returns true if ","type":"text"},{"text":"$entity","type":"text","marks":[{"type":"code"}]},{"text":" is a Agreement/Promotion.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$isRebateAgreement","type":"text","marks":[{"type":"code"}]},{"text":" – Allows you to customize the template for Rebate Agreements only. It returns true if ","type":"text"},{"text":"$entity","type":"text","marks":[{"type":"code"}]},{"text":" is a Rebate Agreement.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$isDealPlan","type":"text","marks":[{"type":"code"}]},{"text":" – Allows you to customize the template for Deal Plans only. It returns true if ","type":"text"},{"text":"$entity","type":"text","marks":[{"type":"code"}]},{"text":" is a Deal Plan.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$isCustomForm","type":"text","marks":[{"type":"code"}]},{"text":" – Allows you to customize the template for Custom Forms only. It returns true if ","type":"text"},{"text":"$entity","type":"text","marks":[{"type":"code"}]},{"text":" is a Custom Form.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$entity","type":"text","marks":[{"type":"code"}]},{"text":" – Contains the whole object of a Quote, Agreement/Promotion or Rebate Agreement (based on the context). See this ","type":"text"},{"text":"Knowledge Base article","type":"text","marks":[{"type":"link","attrs":{"href":"https://pricefx.atlassian.net/wiki/spaces/KB/pages/2199453954"}}]},{"text":" to learn how to find out which fields are available for use for a specific object.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$message","type":"text","marks":[{"type":"code"}]},{"text":" – Body of the message which you type in the Messages tab of e.g., a Quote.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$msgEntity","type":"text","marks":[{"type":"code"}]},{"text":" – Object of the message. In a thread, there is ","type":"text"},{"text":"msgEntity","type":"text","marks":[{"type":"code"}]},{"text":" created for each message sent within the conversation. You can work with its fields such as sender, recipient, date of sending, message body etc.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$workflow.externalActionToken","type":"text","marks":[{"type":"code"}]},{"text":" – A token allowing any user (workflow notification email recipient) to perform an action in the particular workflow step.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$directActionEmail","type":"text","marks":[{"type":"code"}]},{"text":" – The user identity used for approval. The value is derived from user email on behalf of which the action will be done.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Other","type":"text"}]},{"type":"paragraph","content":[{"text":"There are also message templates for:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"General failure","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Workflow failure","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"E-signature","type":"text","marks":[{"type":"link","attrs":{"href":"https://pricefx.atlassian.net/wiki/spaces/UNITY/pages/5482250839"}}]},{"text":" system notifications","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Password expiry notifications","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notifications about ","type":"text"},{"text":"Action","type":"text","marks":[{"type":"link","attrs":{"href":"https://pricefx.atlassian.net/wiki/spaces/UNITY/pages/5482348564"}}]},{"text":" items.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Links in Templates","type":"text"}]},{"type":"paragraph","content":[{"text":"The email body will typically contain a link to the document for which the message has been sent.","type":"text"}]},{"type":"paragraph","content":[{"text":"To configure a working link, make sure that they follow the correct pattern and use the correct variables. As page token, you can use typed ID for all document types.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"5793a298-03b1-4c3e-b7b7-2353e01cc901"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[503.0]},"content":[{"type":"paragraph","content":[{"text":"Document Type","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[895.0]},"content":[{"type":"paragraph","content":[{"text":"Link Pattern","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[503.0]},"content":[{"type":"paragraph","content":[{"text":"Quote","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[895.0]},"content":[{"type":"paragraph","content":[{"text":"$baseURL$/app/modules/#/qc/go-to-quotes/$entity.typedId$/messages/$msgEntity.typedId$","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[503.0]},"content":[{"type":"paragraph","content":[{"text":"Agreement/Promotion","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[895.0]},"content":[{"type":"paragraph","content":[{"text":"$baseURL$/app/modules/#/pm/go-to-contracts/$entity.typedId$/messages/$msgEntity.typedId$","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[503.0]},"content":[{"type":"paragraph","content":[{"text":"Price List","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[895.0]},"content":[{"type":"paragraph","content":[{"text":"$baseURL$/app/modules/?partition=partitionName#/pb/pricelists/$pricelist.typedId$/detail","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[503.0]},"content":[{"type":"paragraph","content":[{"text":"Live Price Grid","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[895.0]},"content":[{"type":"paragraph","content":[{"text":"$baseURL$/app/modules/?partition=partitionName#/pb/lpgs/$pricegriditem.priceGrid.typedId$/detail","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[503.0]},"content":[{"type":"paragraph","content":[{"text":"Rebate Agreement","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[895.0]},"content":[{"type":"paragraph","content":[{"text":"$baseURL$/app/modules/#/rm/go-to-rebate-agreements/$entity.typedId$/messages/$msgEntity.typedId$","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[503.0]},"content":[{"type":"paragraph","content":[{"text":"Rebate Calculation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[895.0]},"content":[{"type":"paragraph","content":[{"text":"$baseURL$/app/modules/?partition=partitionName#/rm/calculations/$rebatecalculation.typedId$/detail","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[503.0]},"content":[{"type":"paragraph","content":[{"text":"Rebate Record","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[895.0]},"content":[{"type":"paragraph","content":[{"text":"$baseURL$/app/modules/?partition=partitionName#/rm/rebate-records/$rebaterecord.typedId$/detail","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[503.0]},"content":[{"type":"paragraph","content":[{"text":"Data Change Request","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[895.0]},"content":[{"type":"paragraph","content":[{"text":"$baseURL$/app/modules/?partition=partitionName#/md/dcr/$dcr.typedId$/detail","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[503.0]},"content":[{"type":"paragraph","content":[{"text":"Ship and Debit Claim","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[895.0]},"content":[{"type":"paragraph","content":[{"text":"$baseURL$/app/modules/?partition=partitionName#/cm/claims/$claim.typedId$/detail","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[503.0]},"content":[{"type":"paragraph","content":[{"text":"Deal Plan","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[895.0]},"content":[{"type":"paragraph","content":[{"text":"$baseURL$/app/modules/?partition=partitionName#/lo/deal-plans/$dealplan.typedId$/detail","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[503.0]},"content":[{"type":"paragraph","content":[{"text":"Action","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[895.0]},"content":[{"type":"paragraph","content":[{"text":"$baseURL$/app/modules/#/user/actions/$actionItem.typedId$/detail","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Note:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For Quotes, Agreements/Promotions and Rebate Agreements, use the above links that work both for the Ember and React UI versions.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"With limitations, you can use other parameters as page tokens:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Document ID – You must, however, ","type":"text"},{"text":"format","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/antlr/stringtemplate4/blob/master/doc/expr-options.md"}}]},{"text":" it as integer for the link to work.","type":"text"},{"type":"hardBreak"},{"text":"For example: ","type":"text"},{"text":"$baseURL$/app/modules/?partition=partitionName#/pb/pricelists/$pricelist.id;format=\"#\"$/detail","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"uniqueName – This parameter will not work for revisions as the revision number is appended to the unique name.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Advanced Links in Templates","type":"text"}]},{"type":"paragraph","content":[{"text":"From the version Rampur 13.0, message templates can benefit from combination of deep links and ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://pricefx.atlassian.net/wiki/spaces/KB/pages/4336648258"}},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"You can combine parameters to open directly a specific tab on any CLIC object , for example:","type":"text"},{"type":"hardBreak"},{"text":"Item tabs on a specific Quote: ","type":"text"},{"text":"$baseURL$/app/modules/#/?targetPage=quotes&targetPageState=$quote.typedId$&targetPageTab=items","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Theoretically, other context-linking parameters can be used this way as well, but not all of them were tested for this usage.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Template Texts and Localization ","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"TemplateTextsandLocalization"},"legacyAnchorId":{"value":"MessageTemplates-TemplateTextsandLocalization"}},"macroMetadata":{"macroId":{"value":"7df1630e92a9a4e55ebc046b1fad8f06"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"cf1f8fdb-014d-455e-8ad2-3f04ef7b087c"}}]},{"type":"paragraph","content":[{"text":"To support easier text customizations and localization of the templates, their content and formatting are separated (since Bijou 7.0).","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All textual elements in the templates are represented by placeholders. These placeholders and their values (texts) are shipped and maintained as part of the product. In your custom templates you can use them or replace them with \"real\" text. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The default templates contain only HTML and styling information and text placeholders.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"To ensure that the previous system (templates containing both formatting and content) keeps working, the following rules apply:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Template names stay as they are.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"First the server loads ","type":"text"},{"text":"customized","type":"text","marks":[{"type":"strong"}]},{"text":" language specific templates (e.g., quote_approvalRequired_fr). ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If no customized template is found, the server will load the ","type":"text"},{"text":"default","type":"text","marks":[{"type":"em"}]},{"text":" template in a 3-step hierarchy:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Full template name as specified (e.g., quote_approvalRequired_fr)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Full template name without language suffix (e.g., quote_approvalRequired)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Template name without language suffix and without type prefix (e.g., approvalRequired)","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"It will then add the language-specific translations into the templating engine (plus the usual placeholders) and render it.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"By default, the templates are available in ","type":"text"},{"text":"the same languages as the application UI","type":"text","marks":[{"type":"link","attrs":{"href":"https://pricefx.atlassian.net/wiki/spaces/UNITY/pages/5482086474"}}]},{"text":". You can also add other languages in the Add Language dialog (if you have provided the Email.properties file for that language) and then simply switch between the template's language versions in the Language drop-down list. To determine, which language version will be used for a particular user, go to the ","type":"text"},{"text":"User Admin","type":"text","marks":[{"type":"link","attrs":{"href":"https://pricefx.atlassian.net/wiki/spaces/UNITY/pages/5482086852"}}]},{"text":" section and select the appropriate language in 'Email Language'.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Customize Template","type":"text"}]},{"type":"paragraph","content":[{"text":"A default template is provided and can be changed by writing standard HTML code and using Pricefx fields. Make sure you keep the correct syntax. ","type":"text"}]},{"type":"paragraph","content":[{"text":"In the message you can access data from the object which triggered sending the email message. For example, the method ","type":"text"},{"text":"withDataMap(Map dataMap)","type":"text","marks":[{"type":"code"}]},{"text":" of the ","type":"text"},{"text":"WorkflowDTO","type":"text","marks":[{"type":"code"}]},{"text":" object allows you to access any workflow related data at the time of submitting. (If data from later phases of the workflow are needed, use ","type":"text"},{"text":"Workflow Post Step Logic","type":"text","marks":[{"type":"link","attrs":{"href":"https://pricefx.atlassian.net/wiki/spaces/UNITY/pages/5482545647"}}]},{"text":".) To access data stored with the method ","type":"text"},{"text":"withDataMap(Map dataMap)","type":"text","marks":[{"type":"code"}]},{"text":" in the message templates, you need to access the context variable ","type":"text"},{"text":"workflowHistory.dataMap","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Workflow code","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"def map = [test: \"This is a test\"]\nworkflow.withDataMap(map)","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Message template code","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"$workflowHistory.dataMap.test$","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The template engine used here by the Pricefx application is StringTemplate, version 3.","type":"text"}]},{"type":"paragraph","content":[{"text":"To learn more about this engine see: ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"https://theantlrguy.atlassian.net/wiki/display/ST/StringTemplate+3+Documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://theantlrguy.atlassian.net/wiki/display/ST/StringTemplate+3+Documentation"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"https://theantlrguy.atlassian.net/wiki/display/ST/StringTemplate+cheat+sheet","type":"text","marks":[{"type":"link","attrs":{"href":"https://theantlrguy.atlassian.net/wiki/display/ST/StringTemplate+cheat+sheet"}}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"This will be replaced by the label of the Quote:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"$quote.label$","type":"text"}]},{"type":"paragraph","content":[{"text":"This block will be rendered conditionally:","type":"text"}]},{"type":"paragraph","content":[{"text":"(It works only with true values; it is not possible to use if( a == 'a'). This true/null element has to be visible in the line item logic on the Quotes.)","type":"text"}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"$if(quote.additionalInfo3)$\n

\n Additional info about the Quote: $quote.additionalInfo3$\n

\n$endif$","type":"text"}]},{"type":"paragraph","content":[{"text":"Adding \"&approve\" or \"&deny\" to the document link approves/rejects the document immediately after clicking on the link, skipping the dialog where users can add a comment.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"\"$baseURL$/pricefx/$partition$/directaction/approve/$workflow.externalActionToken$?output=html&approve\"\n\"$baseURL$/pricefx/$partition$/directaction/deny/$workflow.externalActionToken$?output=html&deny\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Replacing \"approve\" or \"deny\" in the document link with \"form\" displays a dialog with both ","type":"text"},{"text":"Approve","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"Deny","type":"text","marks":[{"type":"strong"}]},{"text":" buttons.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"\"$baseURL$/pricefx/$partition$/directaction/form/$workflow.externalActionToken$?output=html\"","type":"text"}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-info","text":":info:","shortName":":info:"}},{"text":" If the ","type":"text"},{"text":"$partition$","type":"text","marks":[{"type":"code"}]},{"text":" variable is not present, you can use ","type":"text"},{"text":"$entity.partition$","type":"text","marks":[{"type":"code"}]},{"text":" where \"entity\" is to be replaced with the current object, e.g., ","type":"text"},{"text":"$pricelist.partition$","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-check_mark","text":":check_mark:","shortName":":check_mark:"}},{"text":" When you check the JSON structure of the underlying item (using Chrome Developer tools), all attributes should be accessible through the ","type":"text"},{"text":"$entity","type":"text","marks":[{"type":"code"}]},{"text":" reference. In addition, there are variables like ","type":"text"},{"text":"$entity.partition","type":"text","marks":[{"type":"code"}]},{"text":" which are not visible in this JSON representation, but they are part of the object in the backend.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":40.0},"content":[{"type":"media","attrs":{"width":795,"id":"05574e6b-f32b-4ce4-83fc-9e14b495305b","collection":"contentId-5481890318","type":"file","height":749},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"paragraph","content":[{"text":"More advanced example: it iterates through line items and conditionally shows the line items with workflow with colors. ","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Enhanced email template","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\nQuote $quote.uniqueName$ - $quote.label$ created by $quote.createdByName$ requires your approval.

\nQuote details: \n

\n Customer: $quote.customerId$ $quote.CustomerName$
\n
\nTarget date: $quote.targetDate; format = \"MM/dd/yyyy\"$
\nExpiry date: $quote.expiryDate; format = \"MM/dd/yyyy\"$
\n Margin: $quote.outputsMap.Margin.result;format = \"##.##%\"$
\n Total Price: $quote.outputsMap.TotalPrice.result;format = \"#,###.####\"$USD
\n\n

\n\n\n\n \n \n \n \n \n \n \n \n \n\n \n$quote.lineItems:{ item |\n $if(item.outputsMap.hasWorkflow.result )$\n \n \t\n\t\n \n \n \n \n \n \n \n\n \n $else$\n \n \t\n\t\n \n \n \n \n \n \n \n\n \n $endif$\n}$\n

Product	Quantity	Total Cost	Total Price	Margin	Δ List	Δ Target	Δ Floor	Is Index Product
$item.sku$ - $item.label$	$item.outputsMap.Quantity.result;format = \"#,###.####\"$ $item.outputsMap.UoM.result$	$item.outputsMap.TotalCost.result;format = \"#,###.####\"$ $item.outputsMap.CustomerCurrency.result$	$item.outputsMap.TotalPrice.result;format = \"#,###.####\"$ $item.outputsMap.CustomerCurrency.result$	$item.outputsMap.Margin.result;format = \"#,###.####\"$ $item.outputsMap.CustomerCurrency.result$	$item.outputsMap.DeltaList.result;format = \"##.##%\"$	$item.outputsMap.DeltaTarget.result;format = \"##.##%\"$	$item.outputsMap.DeltaFloor.result;format = \"##.##%\"$	$item.outputsMap.IsIndexProduct.result$
$item.sku$ - $item.label$	$item.outputsMap.Quantity.result;format = \"#,###.####\"$ $item.outputsMap.UoM.result$	$item.outputsMap.TotalCost.result;format = \"#,###.####\"$ $item.outputsMap.CustomerCurrency.result$	$item.outputsMap.TotalPrice.result;format = \"#,###.####\"$ $item.outputsMap.CustomerCurrency.result$	$item.outputsMap.Margin.result;format = \"#,###.####\"$ $item.outputsMap.CustomerCurrency.result$	$item.outputsMap.DeltaList.result;format = \"##.##%\"$	$item.outputsMap.DeltaTarget.result;format = \"##.##%\"$	$item.outputsMap.DeltaFloor.result;format = \"##.##%\"$	$item.outputsMap.IsIndexProduct.result$

Browser not supported