Special character translation in field names

You may have noticed, in the Command Center Translated Name values or when browsing indexed items in your Coveo organization, that Coveo for Sitecore replaces special characters in your Sitecore field names. The replacement strings follow the "z" + num + "x" format, where num is the decimal code for the replaced ASCII character.

Command Center showing Translated Names with the "z95x" sequence | Coveo for Sitecore 5

Coveo for Sitecore must perform this conversion to respect Coveo Platform field name character restrictions, and to create a Sitecore field name to Coveo field name mapping within Sitecore.

The following table lists the special ASCII characters Coveo for Sitecore converts, the decimal value for each character, and the replacement strings Coveo for Sitecore uses.

Special ASCII character Decimal value Replacement string

(space)

32

z32x

!

33

z33x

34

z34x

#

35

z35x

$

36

z36x

%

37

z37x

&

38

z38x

'

39

z39x

(

40

z40x

)

41

z41x

*

42

z42x

+

43

z43x

,

44

z44x

-

45

z45x

.

46

z46x

/

47

z47x

:

58

z58x

;

59

z59x

<

60

z60x

=

61

z61x

>

62

z62x

?

63

z63x

@

64

z64x

[

91

z91x

\

92

z92x

]

93

z93x

^

94

z94x

_

95

z95x

`

96

z96x

{

123

z123x

|

124

z124x

}

125

z125x

~

126

z126x

Additional translations occur if you’re using index-specific field naming. To make field usage as easy as possible, Coveo for Sitecore result templates provide Underscore template methods that evaluate Coveo field names dynamically based on the Sitecore field name.