All Collections
Technical Documentation
Formatting salutation and addresses
Formatting salutation and addresses
Updated over a week ago

When putting together salutations and addresses in templates there are several attributes available. These attributes are available for candidates (toEmployee), contacts (toContact) and users (toUser).

The available attributes are:

Attribute

name

opening

openingWithPrefix

closing

Salutation

The 'Salutation' in the file determines if a formal or informal salutation is used.
Use the following attributes for a formal/informal salutation:

Attribute

formalName

formalTitleName

informalName

formalAndlnformalName

Attribute

formalOpening

formalTitleOpening

informalOpening

formalAndlnformalOpening

Attribute

formalClosing

formalTitleClosing

informalClosing

formalAndlnformalClosing

Remarks

  • If no salutation is set in the file, the default from the table item is used.

  • If there is no default set in the table item, then the Formal (informal) is used.

Variants (EU, US, ES)

When putting together salutations and addresses, 1 of the following 3 variants is used:

  • EU - Europese format: Mr. A. van der Akker

  • US - International format: Mr. Michael J. Fox

  • ES - Spanish format: Sr. Juan Gomez Antonio

Remarks

  • The default variant of a Carerix system is determined by one of the following interface parameters: isInternational(US), isBelgian(EU), isSpanish(ES).

  • It is always possible to choose a variant yourself by adding an attribute to one of the codes. For example: formalNameEU or informalNameUS.

  • The default language of a Carerix system is determined by the language parameters. The language determines the salutations and addresses (mister / de heer / senor). If no language parameter is set, the language is dutch.

UnknownGenderSalutation

The setting 'UnknownGenderSalutation' determines, if the gender is unknown, what the salutation will be. 

EU-variant

Field

Value

Contact

Employee

First name

Arie

firstName

firstName

Prefix

van der

lastNamePrefix

lastNamePrefix

Initials

A.

initials

initials

Last name

Akker

lastName

lastName

Title

drs.

title

title

Suffix

RA

suffix

suffix

Gender

Man (MaleTag)

toGenderNode.value

toGenderNode.value

Attributes based on salutation

The 'salutation type' is the field that is available at every candidate and contact. The value in the field determines the salutation in the templates. 

Salutation

Formal

Formal
(Title)

Informal

Formal (Informal)

name

De heer A. van der Akker

De heer drs. A. van der Akker RA

Arie van der Akker

De heer A. (Arie) van der

opening

heer Van der Akker

heer Van der Akker

Arie

heer Van der Akker (Beste Arie)

openingWithPrefix

Geachte heer Van der Akker

Geachte heer Van der Akker

Beste Arie

Geachte heer Van der Akker (Beste Arie)

closing

De heer A. Van der Akker

De heer drs. A. van der Akker RA

Arie van der Akker

De A. (Arie) van der Akker

Fixed fields

formalName

De heer A. van der Akker

formalTitleName

De heer drs. A. van der Akker RA

informalName

Arie van der Akker

formalAndlnformalName

De heer A. (Arie) van der Akker

formalOpening

heer Van der Akker

formalTltleOpening

heer Van der Akker

informalOpening

Arie

formalAndlnformalOpening

heer Van der Akker (Beste Arie)

formalClosing

De heer A. van der Akker

formalTitleClosing

De heer drs. A. van der Akker RA

informalClosing

Arie van der Akker

formalAndlnformalClosing

De heer A. (Arie) van der Akker

ES-variant

Field

Value

Contact

Employee

first name

Juan

firstName

firstName

initials

(n.a.)

initials

initials

last name

Gomez

lastName

lastName

second last name

Antonio

IastNamePrefix

IastNamePrefix

title

(n.a.)

title

title

suffix

(n.a.)

SUfflX

suffix

gender

Sr. (MaleTag)

toGenderNode.value

toGenderNode.value

Most important differences in comparison to the dutch version:

  • Initials and titles: These fields aren't used.

  • Suffix: This field doesn't exist in the Spanish version.

  • Second last name: This field is added in the Spanish version. 

Attributes based on salutation

The 'salutation type' is the field that is available at every candidate and contact. The value in the field determines the salutation in the templates. 

Salutation

Formeel

Formeel (Titel)

Informeel

Formeel
(Informeel)

name

Sr. Juan Gomez Antonio

Sr. Juan Gomez Antonio

Juan Gomez

Juan Gomez

opening

Seôor Juan Gomez Antonio

Sefior Juan Gomez Antonio

Juan

Juan

openingWith Prefix

Estimado Sr. Gomez

Estimado Sr. Gomez

Estimado Juan

Estimado Juan

closing

Sr. Juan Gomez Antonio

Sr. Juan Gomez Antonio

Juan Gomez

Juan Gomez

Remark

  • openingWithPrefix uses 'estimado' or 'estinada' based on the gender.

Fixed fields

formalName

Sr. Juan Gomez Antonio

formalTltleName

Sr. Juan Gomez Antonio

informalName

Juan Gomez

formalAndlnformalName

Juan Gomez

formalOpening

Sefior Juan Gomez Antonio

formalTitleOpening

Sefior Juan Gomez Antonio

informalOpening

Juan

formalAndlnformalOpening

Juan

formalClosing

Sr. Juan Gomez Antonio

formalTltleClosing

Sr. Juan Gomez Antonio

informalClosing

Juan Gomez

formalAndlnformalClosing

Juan Gomez

US-variant

firstName

Michael

middleName

J.

initials

M.J.

lastName

Fox

title

dr.

suffix

Phd

gender

Man (MaleTag)

Attributes bases on salutation

The 'salutation type' is the field that is available at every candidate and contact. The value in the field determines the salutation in the templates. 

Salutation

Formeel

Formeel (Titel)

Informeel

Formeel (Informeel)

name

Mr. Michael J. Fox

Mr. dr. Michael J. Fox Phd

Michael J. Fox

Mr. Michael J. Fox

opening

mister Fox

mister dr. Michael J. Fox Phd

Michael

mister Fox (Dear Michael)

openingWithPrefix

Dear mister Fox

Dear mister dr. Michael J. Fox Phd

Dear Michael

Dear mister Fox (Dear Michael)

closing

Mr. Michael J. Fox

Mr. dr. Michael J. Fox Phd

Michael J. Fox

Mr. Michael J. Fox

Fixed fields

formalName

Mr. Michael J. Fox

formalTitleName

Mr. dr. Michael J. Fox Phd

informalName

Michael J. Fox

formalAndlnformalName

Mr. Michael J. Fox

formalOpening

mister Fox

formalTitleOpening

mister dr. Michael J. Fox Phd

informalOpening

Michael

formalAndlnformalOpening

mister Fox (Dear Michael)

formalClosing

Mr. Michael J. Fox

formalTitleClosing

Mr. dr. Michael J. Fox Phd

informalClosing

Michael J. Fox

formalAndlnformalClosing

Mr. Michael J. Fox

Translated salutation

Let's say that you use a Dutch system, and you want to use a English salutation in a template. Use the following CxScript code:

<cx:language value="English">
<cx:write value="$activity.toEmployee.openingEU"/>
</cx:language>

Lets say that you want to use a salutation based on the language that is set to the person. Use the following CxScript code:

<cx:let name="myLang" condition="$activity.toUser.toLanguageNode.dataNodeID=1465" ifTrue="English" ifFalse="Dutch">
<cx:write value="$myLang"/>
...
<cx:write value="$activity.toContact.openingWithPrefixEU"/>,
...
</cx:language>
</cx:let>

Be aware:
The 1465 is a fixed value in above example, see in your application the table item "Language" to find ID in your system for the desired language.

Alternative: Is the whole template in English. Select the system language 'English' in the template file.
Then the cx:language construction doesn't need to be used. 

____
Keywords : UD-1734

Did this answer your question?