Close

BLOGS

Unified Service Desk - Replacement Parameter (aka Data Parameters/Run time Parameters)

Replacement Parameter provides a great way to pass parameter to the Configuration in Unified Service Desk. The Parameter can be value of any key value pair within the context. Replacement Parameter is used to replace the current value of the Key value dictionary during execution time.

Replacement Parameter is used to pull data throughout the application from data element that has been captured during execution of Unified Service Desk. The context consists of Name value parameter use change during the different steps of the application execution.

Replacement parameter can be used in various places such as scriptlets, session lines, session overview, entity search, CTI, generating querystring, hosted controls, action call, etc. Replacement parameter has a specific syntax.

  • - View the Replacement Parameters in Unified Service Desk
  • - Replacement parameter can be viewed inside the Debugger window in Unified Service Desk. Below are the steps:
  • - Open Unified Service Desk with a sample package installed.

 

As shown below, click on the Debug Menu, then system will open Debugger Hosted control in the MainPanel.

In the Debugger, click Data Parameters to view the replacement parameters.

 

System Replacement Parameters

There are few predefined Replacement Parameters available in Unified Service Desk. The names of the predefined Replacement Parameters start with $. USD has the following predefined Replacement Parameters:

  • - $Context
  • - $Debug
  • - $Global
  • - $Panel
  • - $Resources
  • - $Return
  • - $Session
  • - $Settings
  • - $Subject
  • - $User

 

Replacement Keys

One of the Key concept of Replacement Parameter is Replacement Keys. Replacement Key is normally used in conjunction with Replacement Parameter which gives extra meaning to the Replacement Parameter as below:

 

Replacement Key Description
+

This key, when present, will replace a null or non-existent key with an empty string.

For example: In the scenario where account.name is undefined, calling [[account.name]] would result in a “Not all parameters in action call are available, aborting action call.” error. This will stop processing the rule or line item being executed.

However, [[account.name]+] will return a blank, and not raise the replacement key error.

 

 

Few Replacement Parameter tips:
  • - If a value might return a null, use [[afield]+], as this will handle nulls correctly.
  • - If you are constructing a url, use the “]u]”, as this adds %20 for spaces etc.
  • - If the string might contain “special” characters such as “<“, the use “]x]” to ensure they display correctly.
  • - You can combine combinations, like “[[telephone1]+x]”, for a telephone number that might be null and might contain “special” characters.
 

Few Replacement Parameter examples:
  • - To return the start time of a session use  [[$Session.StartTime]g]
  • - Use this [[$User.fullname]g] to return the name of the current user. (Useful in agent scripts etc.)
  • This will return the number of open sessions [[$Session.Count]g], and this [[$Global.maxNumberOfSessions]] will return the maximum number of session possible.

For more details and list of Replacement Keys and Specialized handlers, please visit https://msdn.microsoft.com/en-us/library/dn864934.aspx

 


Print
Posted: Aug 27, 2018,
Comments: 0,
Author: Urish Arora
Tags:
Rate this article:
5.0

Urish AroraUrish Arora

Other posts by Urish Arora

, Contact author

Please login or register to post comments.

Name:
Email:
Subject:
Message:
x

SEARCH

Categories

Subscribe to our blog

«May 2019»
MonTueWedThuFriSatSun
293012345
6789101112
13141516171819
20212223242526
272829303112
3456789

  • Featured Posts
  • Recent Posts
  • Recent Comments
Dynamics365Authority is a community platform for Professionals and Students to contribute or share their knowledge and skills on Microsoft Dynamics 365 Technologies. Our primary goal is to invite professionals on Dynamics 365 technology across the world to contribute & share their knowledge and skills through their blogs so that we can help other developers.
Stay updated with Dynamics 365 technology. Improve skills and knowledge from our blogs, articles and code snippets. Learn it. Follow professionals and learn from them.
Unified Service Desk Book(Online Edition) 

FOLLOW US

Stay connected with us on our social media channels for latest articles, blogs posts etc.  We will keep updating regularly on our social media platform and web platform.

FACEBOOK

Follow us on Facebook

 

TWITTER

View all our tweets

 

DYNAMICS365AUTH

Join us now

 

BLOGS

View our blogs

 

 

Latest Blog

Posted: Apr 30, 2019

Find which privileges are applied to which roles in Dynamics 365 with privileges discovery

This blog is about Find which privileges are applied to which roles in Dynamics 365 with privileges discovery

Read more
Posted: Apr 30, 2019

Dynamics 365 Field Security

This blog is about Field Security in Dynamics 365

Read more
Posted: Apr 30, 2019

Access Team Templates in Dynamics 365

This blog is about Access Team Templates in Dynamics 365

Read more
RSS

ADDITIONAL RESOURCES

Dynamics 365 Authority.com - Search the library for "Dynamics 365"

  What's New in Dynamics 365

  Dynamics 365 Documentation

  

  Sign-up for 30 days trial

 

 

Recent comments

Ashish:

Nice blog. Very helpful to get all references to white papers at one place.

Previous Next

About Us

Here comes the Dynamics 365 Authority - Great technical blog posts are hidden gems. They are hard to find simply because not enough of us write them in the first place. Yet technical blogging is one of the best things we can do not only for ourselves, but also as members of the wider community of developers.

Dynamics 365 Authority leverages this platform to help developers and users to move from traditional paper-based process to modern digital business process. Dynamics365Authority.com helps your business grow, evolve and transform.

Dynamics365Authority.com is your Digital Transformation Partner

Recent Posts

Find which privileges are applied to which roles in Dynamics 365 with privileges discovery

This blog is about Find which privileges are applied to which roles in Dynamics 365 with privileges discovery

  • 3
  • Article rating: No rating

Dynamics 365 Field Security

This blog is about Field Security in Dynamics 365

  • 3
  • Article rating: No rating
RSS

Get in touch

Follow Us

 

Tag cloud: Dynamics365Authority.com with Urish Arora; Dynamics365Authority.com; Sales; Leading community site on MS Dynamics 365; Dynamics 365 Authority; Service;Top CRM Blogs; Urish Arora - Australia's leading expert on Digital Transformation;  Digital Transformation; Field Service;Top Articles on MS Dynamics CRM Relationship Insights; Office 365 Security Compliance; Project Service; Microsoft Dynamics 365 for Sales; Relevance Search; Goal Metrics; Activities and Case; Sales Literature;Knowledge Management;

Terms Of UsePrivacy StatementCopyright 2019 by Dynamics365Authority
Back To Top