CustomFields have a :org field - what is that?

When recieving data from ex contact ( /api/v1/Contact/3) and looking at CustomFields all fields seems to exist two times - see below.

I can not find documentation of the [FieldName]:org proberty. What is the purpose and which one ist the correct one to use? 

"CustomFields": {
"x_mlekstra": "Dog",
"x_mlekstra:org": "Dog",
"SuperOffice:1": "[F:1234]",
"SuperOffice:1:org": "[F:1234]"
}

RE: CustomFields have a :org field - what is that?

Hi Morten,

There can be additional metadata about the CustomField, like link_hint in archive providers. 

The purpose of the :org value is to help us resolve conflicts when both ExtraFields and CustomFields have values. In this case, org means "original value". When we see that internaly, we only update the actual value if it is different from the org value.

Other values you might see are :DisplayText and :DisplayTooltip, and inherit the same behavior from the EntityUdefHelper.

 

Best regards. 

Af: Tony Yates 23. okt 2020

RE: CustomFields have a :org field - what is that?

Ok thanks! :)
I have recommend the customer to use the propety/value without ':org'. If I understand correct both will always have the same value when recieved trough the API (even though the one without ':org' might have had another - wrong - value internally).

Could be helpfull with a note on that in the documentation. 
https://community.superoffice.com/documentation/sdk/SO.NetServer.Web.Services/html/v1ContactEntity_GetCustomFieldInfoList.htm

 

Af: Morten Larsen 29. okt 2020

RE: CustomFields have a :org field - what is that?

Feel free to create an issue on the repo in Github.

We'd like to be transparent with the docs so that you and everyone else in the community can track its progress. 

 

Af: Tony Yates 29. okt 2020