September 14, 2009

Correct Gender on your XpressDox templates

Suppose you have a document which you want to personalise as far as pronouns are concerned. In other words, instead of having “he/she” in many places, you want to have only “he” or “she” depending on the sex of the party concerned. This could be done by determining the sex up front at the beginning of the template like this:

«ChooseUsingCheckBox(PartyIsMale)»

 

Using «When()» for singular values

And then in the body of the template, whenever the document would previously have had “he/she”, put:

«When(PartyIsMale = “true”,he,she)»

While this is nice, it is a bit tedious to type «When(PartyIsMale = “true”,he,she)» wherever it is required. If there are many places where “he/she” is to be replaced, then one way to create a shortcut is to use a variable, like this:

«ChooseUsingCheckBox (PartyIsMale)»
«If(PartyIsMale = “true”)»
«SetVr(“he”,”he”)»
«Else()»
«SetVr(“he”,”she”)»
«End()»

Then, in all the places where “he/she” is to be replaced, instead of using the “When” above, just type:

«GetV(“he”)»

 

Now set variables for other pronouns:

Even nicer is that you can handle “him/her” and “his/her” in the same way:

«ChooseUsingCheckBox (PartyIsMale)»
«If(PartyIsMale = “true”)»
«SetVr(“he”,”he”)»
«SetVr(“him”,”him”)»
«SetVr(“his”,”his”)»
«SetVr(“Mr.”,”Mr.”)»
«Else()»
«SetVr(“he”,”she”)»
«SetVr(“him”,”her”)»
«SetVr(“his”,”her”)»
«SetVr(“Mr.”,”Ms.”)»
«End()»

Then the following becomes possible:

If «GetV(“he”)» makes a written request, then «GetV(“his”)» copy will be sent directly to «GetV(“him”)».

 

Using the XpressDox Gender function

Particularly when there might be more than one party being referred to, then the document in its original form might have had “he/she/they” or “his/her/their” scattered throughout the document.

Probably there will have been some place in the document where the parties were enumerated, and hence a snippet of the document might have been:

The parties to the agreement are:

«ForEach(Party)»
«If(position() > 1)»

and
«End()»
«PartyName» «ChooseFromRDBList(PartyGender,Male,Female,Entity)»(«PartyGender»)
«End(ForEach)»

Then at some point later on in the document, outside the scope of the ForEach the document has wording like:

… ensure that his/her/its/their contact details are provided.

The Gender function can be used as follows:

… ensure that «Gender(PartyGender,count(Party),'his,her,its,their')» contact details are provided.

Please see the article The Gender Function for additional interesting information on how to use Gender.

 

Gender neutral

To give the option of a gender neutral contract, something like this could be done:


«ChooseFromRDBList(PartyGender,Male,Female,Entity,Rather not say)»
«if(PartyGender != ‘Rather not say’)»«Gender(PartyGender,1,'his,her,its')»«Else()»their«End()» documents...