Template Macros

Some fields allow for macro expansion to allow the actual value to include details dynamically retrieved from the patient, assessment, or order that is being processed.

A macro is indicated by a set of curly braces, and the general form of a macro is {source,path,empty}. Source describes where to obtain the value, and path further clarifies exactly which value is desired. If the value obtained is NULL or an empty string an optional third parameter to the macro can provide an alternative value to be substituted.

The sources and paths available depend upon the context in which the format string will be utilized. Currently supported sources and paths are listed below:

Password Reset Emails

The following macros are available for the password reset emails.

Source

Description

System

Info associated with the SilhouetteCentral environment that is processing the current request

Path	Description
Date	The current date and time of the server processing the request.

User

Info associated with the user requesting the password be reset

Path	Description
Login	The login name for the current user.
Email	The email address for the user.
FirstName	The user's first name
LastName	The user's last name.
MiddleName	The user's middle name.
FullName	The user's full name.
Phone	The user's phone number.
PasswordResetUrl	The URL the user will have to visit to reset their password.
PasswordResetCancelUrl	The URL that will allow the user to cancel the password reset request. Once this is visited, then the password reset URL will no longer be usable.
ForgotPasswordUrl	The URL that the user should visit if they have forgotten their password

Assessment Email Templates

The following macros are available for the assessment email templates.

Source

Description

System

Info associated with the SilhouetteCentral environment that is processing the current request

Path	Description
Date	The current date and time of the server processing the request.

Patient

Info associated with the patient the current action is associated with

Path	Description
PatientId	Patient ID for the unit the patient is currently assigned to (could be blank). See below for including additional ID types.
FirstName	The patient’s first name.
MiddleName	The patient’s middle name.
LastName	The patient’s last name.
DateOfBirth	The patient’s date of birth.
Gender	The text “Female” or “Male” based upon the gender recorded in the patient’s demographics.
Unit	The name of the unit the patient is currently assigned to.
Street	Current address information for the patient as recorded in their demographics.
Suburb
City
State
Postcode
Country
WorkPhone	Current phone numbers as recorded in the patients demographics.
HomePhone
MobilePhone
DashboardUrl	A datalink to the wound dashboard within SilhouetteCentral for the patient

Visit

Info associated with the visit the current action is associated with

Path	Description
Date	The date (and time) the visit was originally created on

Assessment

Info associated with the assessment the current action is associated with

Path	Description
Date	The date (and time) the assessment was originally created on
AssessmentUrl	Datalink to the wound assessment dashboard within SilhouetteCentral for this assessment
ReportFilename	Internal filename of the PDF wound assessment report (useful only if SilhouetteCentral is configured to place reports on a network share etc)
ReportUrl	Datalink to the PDF wound assessment report within SilhouetteCentral.

Wound

Info associated with the wound the current action is associated with

Path	Description
Label	The wound label e.g. Wound “A” or Wound “1”. The option to set Wound Labels to numeric or alpha is found in Organization > Settings
AnatomicalSite	A description of the anatomical site the wound is associated with.

Order

Info associated with the HL7 order associated with the current action

Path	Description
Id	The placer order number obtained from the ORM^O01 message
ScheduledDate	The date/time the wound assessment was requested to be performed at.
Description	The description of the order as it will appear within the SilhouetteCentral and SilhouetteConnect user interfaces.

Notes

Provides access to all patient, visit and wound assessment level notes recorded against the assessment currently being processed.

‘Path’ should be the name of a valid variable name associated with a notes field and the current value for that notes field will be returned.

If an unknown variable name is requested an empty string will be returned.

Note: If you want to include an explicit curly brace within your text value you need to escape it e.g. {{foo}} turns into {foo}.

Note: Within a macro, if the empty parameter is not specified a blank string will be assumed. Likewise if a macro refers to an unknown source or path an empty string will be substituted.

Some example macros and the resultant text string they produce are described in the table below:

Format String	Resultant Text
Hello, World	Hello, World
Please view the report at {Assessment,ReportUrl}	Please view the report at http://server-name/SilhouetteCentral/datalink/3D916AD2-92D8-4D8E-B5FB-BC2D0D1B12B4
Please dress the wound using {Notes,DressingType}	Please dress the wound using Gauze
{Patient,PatientId} was assessed at {Assessment,Date}. Their admission status is "{Notes,Admission_Status,not recorded}"	PX1234 was assessed at 2009-10-12 19:53 Their admission status is "Lost to follow up".
Hello {{world}}	Hello {world}
Dressing Type: {Notes,DressingType,Unknown}	Dressing Type: Unknown

Data Links

A data link is a unique URL that can be used to access a specific page related to a specific patient or assessment within the SilhouetteCentral website.

Macros which generate data links such as {Patient,DashboardUrl} and {Assessment,ReportUrl} by default will generate data links that do not expire. However if you wish the links to only be active for a fixed period of time you can add optional parameters as explained below:

Example Macro	Description
{Patient,DashboardUrl}	Non expiring link - always usable
{Patient,DashboardUrl:days=20}	Link will expire after 'n' days from today
{Patient,DashboardUrl:months=1}	Link will expire after 'n' months from today
{Patient,DashboardUrl:years=1}	Link will expire after 'n' years from today

When a user attempts to view a data link that has expired instead of the webpage or PDF report being presented they will be shown an error message stating the data link has expired. This feature is useful if the URLs are being sent for consultation or review purposes and you want to control how long the user has access to the information.

Date Values

Any of the macros outlined in the previous tables that return date/time values are by default formatted using the current organizational settings. If you wish the timestamps to be formatted in a different manor you can add an optional parameter to specify the date format explicitly:

Example Macro	Description
{Assessment,Date}	Format date using current organisation settings
{Assessment,Date:format=dd-MM-yyyy}	Format date as day-month-year, e.g. 31-12-2014
{Assessment,Date:format=D}	Format date in long format, e.g. Wednesday, December 31, 2014

The format string parameter can be any valid date/time format string understood by Microsoft .NET's System.DateTime class. For further reference refer to Microsoft's documentation.

Standard Date and Time Format Strings

http://msdn.microsoft.com/en-us/library/az4se3k1(v=vs.110).aspx

Custom Date and Time Format Strings

http://msdn.microsoft.com/en-us/library/8kb3ddd4(v=vs.110).aspx

Patient Identifiers

A patient may have several different identifiers assigned. These identifiers can be obtained using overloads of the PatientId macro

Example Macro	Description
{Patient,PatientId}	Display the identifier assigned to the unit that the patient belongs to
{Patient,PatientId:name=MRN}	Display the "MRN" patient identifier for the patient. The name argument (MRN) must match exactly the name of the patient identifier you want to display as defined in SilhouetteCentral.