Symphony users may want to share information about contacts, generally professionals who are affiliated with one or more organizations. A structured contact object could be useful in this situation.
Goals
- Include common Customer Relationship Management (CRM) information
- Allow for structured / parsable fields
- Reference simple objects for standardized reference data, such as org.symphonyoss.obj.contact.prefix and org.symphonyoss.obj.contact.suffix
- Reference other entity objects such as org.symphonyoss.fin.organization and org.symphonyoss.obj.contact.info (to be defined)
- Allow for extensible identifiers
Example Entity JSON
Contact Entity JSON
{
"user-12345":
{
"type": "org.symphonyoss.obj.contact",
"version": "0.1",
"id":
[
{
"type": "com.symphony.user.userId",
"value": 123456789
},
{
"type": "org.symphonyoss.obj.contact.id",
"value": "user-12345"
},
{
"type": "com.ipreo.contact.id",
"value": "iid-contact-65832"
}
],
"contactInfoId":
{
"type": "org.symphonyoss.obj.contact.info.id",
"value": 100203
},
"fullName":
{
"type": "org.symphonyoss.string",
"value": "John Smith"
},
"formalName":
{
"type": "org.symphonyoss.string",
"value": "Mr. Jonathan A. Smith, III"
},
"informalName":
{
"type": "org.symphonyoss.string",
"value": "John Smith"
},
"indexName":
{
"type": "org.symphonyoss.string",
"value": "Smith, John"
},
"summary":
{
"type": "org.symphonyoss.string",
"value": "A short summary of the contact"
},
"biography":
{
"type": "org.symphonyoss.string",
"value": "An in-depth profile of the contact in paragraph / prose form."
},
"organizations":
[
{
"id":
[
{
"type": "org.symphonyoss.fin.organization.id",
"value": "organization-12345"
},
{
"type": "org.symphonyoss.fin.organization.id.ipreo",
"value": "iid-organization-65833"
}
],
"name":
{
"type": "org.symphonyoss.string",
"value": "Apple Inc."
},
"start":
{
"type": "org.symphonyoss.time.rfc3339",
"value": "2012-01-01"
},
"end":
{
"type": "org.symphonyoss.time.rfc3339",
"value": "2016-11-12"
},
"title":
{
"type": "org.symphonyoss.string",
"value": "Director of North America Macintosh Sales, Education"
},
"role":
{
"type": "org.symphonyoss.obj.contact.role.id",
"value": 24
},
"contactInfoId":
{
"type": "org.symphonyoss.obj.contact.info.id",
"value": 100203
}
}
]
}
}
Contact Role Entity JSON
{
"role-24":
{
"type": "org.symphonyoss.obj.contact.role",
"version": "0.1",
"id": 24,
"name": "Director"
}
}