WikiSysop: Created page with "{{Article |Standalone=No |DisplayName=Manage field codes |TocName=Manage field codes |Context=Learn how to create and edit fields codes to use in standard responses. |Dimensio..."

2023-08-07T05:00:50Z

Created page with "{{Article |Standalone=No |DisplayName=Manage field codes |TocName=Manage field codes |Context=Learn how to create and edit fields codes to use in standard responses. |Dimensio..."

New page

{{Article
|Standalone=No
|DisplayName=Manage field codes
|TocName=Manage field codes
|Context=Learn how to create and edit fields codes to use in standard responses.
|Dimension=sr
|ComingSoon=No
|Role=Administrator
|Application=Designer
|Section={{Section
|alignment=Vertical
|structuredtext=Field codes are the most complex and powerful aspect of standard responses. With field codes, you can create standard responses that are automatically personalized when they are used.

For example, you can use the field code <code>Contact.FirstName</code> in a response beginning <code>Dear Contact.FirstName</code>, which you send to dozens of recipients. In each message, <code>Contact.FirstName</code> is replaced by the first name of the addressee of the message (the contact) as listed in the Universal Contact Server database.

Field Codes Management enables you to create a wide range of field codes types. The codes can range from simple - similar to a Mail Merge word processor feature - to complex field codes that include multiple objects, formulas, and constants.

Once you create a field code, you can use it in multiple standard responses.

The interface for creating field codes is simple. Creating useful field codes requires a deeper understanding of how they are constructed. {{Link-SomewhereInThisVersion|manual=Administrator|topic=FieldCodes|anchor=create|display text=Create or edit a field code}} provides step-by-step instructions, with links to detailed reference information at the relevant places.

Access Field Codes Management under the '''Responses''' menu.

[[File:Des_FC_overview.png]]
|Status=No
}}{{Section
|sectionHeading=Create or edit a field code
|anchor=create
|alignment=Horizontal
|Media=Image
|image=Des_FC_create.png
|structuredtext=When you create a new field code, the '''New Field Code''' view opens on the right side of the page. To begin, give your field code a name and brief description.

{{NoteFormat
|
The field code name can consist of no more than 64 alphanumeric characters supported in UTF-8. For additional valid characters see {{Link-SomewhereInThisVersion|manual=Administrator|topic=FieldCodes|anchor=characters|display text=Characters allowed in names}}. The following characters combinations are not allowed: "<$" or "$>".
|}}

Choose system or custom variables to insert into the '''Text''' field, and add any other necessary text. See {{Link-SomewhereInThisVersion|manual=Administrator|topic=FieldCodes|anchor=usevars|display text=Use variables in field codes}} for details about variables and how to use them. If the custom variable you need is not in the list, you can create it using {{Link-SomewhereInThisVersion|manual=Administrator|topic=CustomVars|anchor=create|display text=Custom Variables Management}}.

For detailed help with constructing the field code, see {{Link-SomewhereInThisVersion|manual=Administrator|topic=FieldCodes|anchor=useforms|display text=Use formulas in field codes}}.

See {{Link-SomewhereInThisVersion|manual=Administrator|topic=FieldCodes|anchor=examples|display text=Examples}} for more about using complex field codes.
|Status=No
}}{{Section
|sectionHeading=Use variables in field codes
|anchor=usevars
|alignment=Vertical
|structuredtext=The ability to access interaction data is perhaps the most frequent use of field codes. Although field code formulas can be complicated, many just retrieve a single piece of data, such as a contact’s name.

You access Universal Contact Server data using predefined variables, called "system variables."

These variables access three predefined objects. Each object has a name and a set of properties. Let's use <tt>Contact.FirstName</tt> as an example. <tt>Contact</tt> is an object and <tt>FirstName</tt> is one of its properties. The system variable <tt>Contact</tt>. <tt>FirstName</tt> retrieves the value of the <tt>FirstName</tt> property of the <tt>Contact</tt> object.

Similarly, there is a system variable for each <tt>object+property</tt> pair. You can use the following objects in field codes:

*{{Link-AnywhereElse|product=PEC-ROU|version=Current|manual=FldCod|topic=AgeObj}} - Information about the agent, such as name and signature.
*{{Link-AnywhereElse|product=PEC-ROU|version=Current|manual=FldCod|topic=ConObj}} - Contact details such as name, address, and phone number.
*{{Link-AnywhereElse|product=PEC-ROU|version=Current|manual=FldCod|topic=IntObj}} - Information about the interaction, such as created date, to and from address, and attached data.

====Use your own data====
It is possible to incorporate data that you keep external to Universal Contact Server into your standard responses (including automated responses). This data could include case numbers, account information, and so on. Remember that attached data always consists of key-value pairs.

Follow this two-step process to use external data:

#Retrieve the external information and add it to the interaction as attached data. One place to do this is in a Designer application.
#Now that you have attached the data to the interaction, use the <code>AttachedData</code> property of the Interaction object to access the data. The <code>AttachedData</code> property requires one argument, which is the key name. The result of the following formula is the value associated with the <code>OrderStatus</code> attached-data key: <code>Interaction.AttachedData("OrderStatus")</code>
|Status=No
}}{{Section
|sectionHeading=Use formulas in field codes
|anchor=useforms
|alignment=Vertical
|structuredtext=In addition to system variables such as <tt>Contact.FirstName,</tt> field codes contain formulas. This section provides an outline of formula usage. Find details about these topics in the {{Link-AnywhereElse|product=PEC-ROU|version=Current|manual=FldCod}}.

Field code formulas are similar to formulas in other applications, such as Microsoft Excel.

A ''formula'' is a sequence of one or more operands (such as numbers and text strings), separated by operators (such as <tt>+</tt> and <tt>-</tt>).

For example, in the following formula, <tt>2</tt> and <tt>3</tt> are operands and <tt>+</tt> is an operator: <tt>2 + 3</tt>

Operands can be values that do not change (constants), or values that vary based on the context. In the previous formula, all the operands are constants, so the formula always evaluates to <tt>5.</tt> The next formula evaluates to a different value for each agent who uses it: <tt>Agent.Signature</tt>

===Field Code Syntax===
To summarize field code syntax:

*Enclose alphabetic strings, whether constants in formulas or elsewhere in a field code, in double quotes.
*Numeric constants require no special treatment.
*Use special characters for some purposes. For example, for your field code to render with a line break, you cannot just type a carriage return. Instead, you must insert the expression <tt>\n.</tt> See the {{Link-AnywhereElse|product=PEC-ROU|version=Current|manual=FldCod|topic=DatTyp|anchor=EscapeSequences|display text=Escape Sequences table}} in the ''Field Codes Reference Guide''.

===HTML in Field Codes===
With special configuration, field codes can contain HTML markup; for example, you could have a field code that uses a custom variable with a default value of:
<pre>
Sam Agent<BR />
Acme Products<BR />
29 Exterior Blvd<BR />
Springfield, CX 09090<BR />
</pre>

To enable this, you must use the Java property <tt>-Dsrl-field-code-allow-html=true,</tt> in one of the following ways:

*Add it to the <tt>JavaArgs</tt> section of <tt>ContactServerDriver.ini</tt>
*Add it as an argument to the startup command line in <tt>contactServer.sh.</tt>

===Operator Precedence===
If you use more than one operator in a formula, the order in which they are evaluated depends on their relative ''precedence.'' Higher precedence operators are evaluated first. For example, multiplication (<tt>*</tt>) has a higher precedence than addition (<tt>+</tt> ), so that the formula below evaluates to <tt>14,</tt> not <tt>20</tt>:

<tt>2 + 3 * 4</tt>

You can use parentheses to override the default precedence. The formula below evaluates to <tt>20</tt>:

<tt>(2 + 3) * 4</tt>

For a complete list of operators and their relative precedence, see {{Link-AnywhereElse|product=PEC-ROU|version=Current|manual=FldCod|topic=OpePre}} in the ''Field Codes Reference Guide''.

====Data Types====
Operands of several different types may appear in formulas:

*Number
*String (text)
*Date/time
*Boolean (true/false)
*Object (Contact, Interaction, and Agent)

Each data type behaves differently in formulas, and the operators have different meanings when you use them with different data types. For example, the <tt>+</tt> operator means “add” when used with numbers, but “concatenate” (paste together) when used with strings. This formula evaluates to ''Uncle Sam Wants You'':

<tt>"Uncle Sam " + "Wants You"</tt>

You can't use some operators with some data types at all. For example, you cannot use the multiplication (<tt>*</tt>) operator on two strings.

Genesys converts all formulas, regardless of their final data type, to strings before merging them into your standard response. This conversion follows a set of default rules that depend on the data type. For example, the default rules for numbers round them off to integers. This formula inserts <tt>2</tt> into your standard response, even though the real result is <tt>2.25</tt>:

<tt>9 / 4</tt>

You can use the <tt>Text</tt> function or format operator (:) to override the default formatting. Either of the following formulas inserts <tt>2.25</tt> into your standard response:

<tt>Text(9 / 4, "#.##")</tt>

<tt>(9 / 4):"#.##"</tt>

For a detailed list of data types and how you can use them, see {{Link-AnywhereElse|product=PEC-ROU|version=Current|manual=FldCod|topic=DatTyp}} in the ''Field Codes Reference Guide''.

===Functions===

When composing formulas, you can use many built-in functions. ''Functions'' are predefined formulas that perform calculations using values, called ''arguments,'' which you supply. To use a function, write its name, followed by an opening parenthesis, the arguments for the function separated by commas, and a closing parenthesis.

Function arguments can be of any data type, although individual functions can place restrictions on their arguments. Function arguments can be constants or formulas. The <tt>Length</tt> function, for example, takes a single string argument and returns its length in characters. This formula evaluates to <tt>13</tt>:

<tt>Length("Hello, world!")</tt>

As another example, the <tt>Date</tt> function takes individual date components (year, month, day, and so on), and constructs a date/time value. The formula below evaluates to <tt>1965-11-23 09:03:10</tt>:

<tt>Date(1965, 11, 23, 9, 3, 10)</tt>

Functions can act as arguments to other functions. The <tt>WeekdayName</tt> function takes a single date/time argument and returns the day of the week as a string. The formula below evaluates to <tt>Tuesday</tt>:

<tt>WeekdayName(Date(1965, 11, 23, 9, 3, 10))</tt>

This formula evaluates to <tt>7</tt>:

<tt>Length(WeekdayName(Date(1965, 11, 23, 9, 3, 10)))</tt>

For detailed descriptions of all available functions, see the following topics in the ''Field Codes Reference Guide'':

*{{Link-AnywhereElse|product=PEC-ROU|version=Current|manual=FldCod|topic=StrFun}}
*{{Link-AnywhereElse|product=PEC-ROU|version=Current|manual=FldCod|topic=DatTim}}
*{{Link-AnywhereElse|product=PEC-ROU|version=Current|manual=FldCod|topic=TypCon}}
*{{Link-AnywhereElse|product=PEC-ROU|version=Current|manual=FldCod|topic=MatFun}}
*{{Link-AnywhereElse|product=PEC-ROU|version=Current|manual=FldCod|topic=MisFun}}

===Using Objects===
All object/property pairs are available in the system and custom variables menus.

Object properties can be of any data type. <tt>Agent.FullName,</tt> for example, is a string, but <tt>Interaction.DateCreated</tt> is a date/time.

The data type of an object property can even be another object. For example, <tt>Contact.EmailAddresses</tt> yields another object called a <tt>ContactEmailAddressList.</tt> You can access the properties of the resulting object by entering a period (.), followed by the property name, just as before. The formula below evaluates to the number of email addresses assigned to the contact:

<tt>Contact.EmailAddresses.Count</tt>

Some object properties require arguments just as functions do. For these properties, write the arguments, enclosed in parentheses after the property name, just as before.

For example, the ContactEmailAddressList object has a property named <tt>Exists</tt>. You can use this property test whether a contact has a particular email address. The data type of this property is Boolean (true/false), and it takes one argument, the email address to test.

<tt>Contact.EmailAddresses.Exists("samd@acme.com")</tt>

For detailed descriptions of all objects and their properties, see the following topics in the Field Codes Reference Guide:

*{{Link-AnywhereElse|product=PEC-ROU|version=Current|manual=FldCod|topic=AgeObj}}
*{{Link-AnywhereElse|product=PEC-ROU|version=Current|manual=FldCod|topic=ConObj}}
*{{Link-AnywhereElse|product=PEC-ROU|version=Current|manual=FldCod|topic=IntObj}}
|Status=No
}}{{Section
|sectionHeading=Examples
|anchor=examples
|alignment=Vertical
|structuredtext=The following is an example of a complex field code:

<tt>If (Time() - Interaction.DateCreated > 14, “Please accept our apologies for not having replied sooner. ”, “”)</tt>

This field code inserts a tardiness apology if more than 14 days have elapsed since the interaction first entered the system. It uses the function <tt>If,</tt> which has these properties:

*Its syntax is <tt>If (Boolean, TrueResult, FalseResult)</tt>
*If <tt>Boolean</tt> evaluates to <tt>True,</tt> it returns the second argument.
*If <tt>Boolean</tt> evaluates to <tt>False,</tt> it returns the third argument.

In this example, the three arguments of <tt>If</tt> are as follows:

#<tt>Time() - Interaction.DateCreated > 14</tt> A formula that returns <tt>True</tt> if the difference between the date created and the current system time is more than 14 days. (A mathematical operation on dates returns a result in days.)

#<tt>“Please accept our apologies for not having replied sooner.”</tt> A text string apologizing for tardiness, inserted if the formula evaluates to <tt>True.</tt>
#The null string: if the reply is not late (the formula evaluates to <tt>False</tt>), nothing is inserted in it.
|Status=No
}}{{Section
|sectionHeading=Copy a field code
|anchor=copy
|alignment=Vertical
|structuredtext=You can copy an existing field code with the '''Copy''' button ([[File:Des_PII_copy.png|link=]]). This opens the '''New Field Code''' view with the copied information. The name of the field includes "_''N''", where "''N''" is the number of the copy. For example: Greeting_1, Greeting_2, and so on.
|Status=No
}}{{Section
|sectionHeading=Delete a field code
|anchor=delete
|alignment=Vertical
|structuredtext=To delete a field code, just click the delete icon ([[File:Des_PII_delete.png|link=]]).
|Status=No
}}{{Section
|sectionHeading=Search for a field code
|alignment=Vertical
|structuredtext=To search for a field code, use the search box above the table. The results filter automatically based on the text you enter in the search box.

[[File:Des_FC_search.png]]
|Status=No
}}{{Section
|sectionHeading=Characters allowed in names
|anchor=characters
|alignment=Vertical
|structuredtext={{{!}}
{{!}}+Additional Characters Allowed in Object Names
!'''Name'''
!'''Character'''
!'''Name'''
!'''Character'''
{{!}}-
{{!}}Hyphen
{{!}} -
{{!}}Exclamation point
{{!}}!
{{!}}-
{{!}}Number sign, pound
{{!}}#
{{!}}Dollar sign
{{!}}$
{{!}}-
{{!}}Caret
{{!}}^
{{!}}Asterisk
{{!}}*
{{!}}-
{{!}}Underscore
{{!}}_
{{!}}Curly brackets
{{!}}{ }
{{!}}-
{{!}}Angle brackets
{{!}}<nowiki><></nowiki>
{{!}}Period, full stop
{{!}}.
{{!}}-
{{!}}Backslash
{{!}}<nowiki>\</nowiki>
{{!}}Parentheses
{{!}}()
{{!}}-
{{!}}Question mark
{{!}}?
{{!}}Space
{{!}}
{{!}}-
{{!}}At sign
{{!}}@
{{!}}
{{!}}
{{!}}}
|Status=No
}}
}}

PEC-DC/Current/Administrator/FieldCodes - Revision history

WikiSysop: Created page with "{{Article |Standalone=No |DisplayName=Manage field codes |TocName=Manage field codes |Context=Learn how to create and edit fields codes to use in standard responses. |Dimensio..."