Enterprise Service Bus Data Source - Google Contacts

Purpose

The Google Contacts data source allows the builder to create an application that reads contacts from Google Contacts.

This feature will be available in Platform Version 13.11.851.

Supporting Elements

For the Google Contacts data source to work properly there needs to be several elements added to the application. A table will need to be created by the builder that the ESB will write to when new or modified contacts are available to sync with. The Google Contacts Data Source will provide up to 8 single pieces of data that can be saved; First Name, Last Name, Middle Name, Name Prefix, Name Suffix, Contact Description, Contact ID, and ETag. The Contact ID is required to maintain an incoming sync with Google Contacts and is used to locate and update a the record when new changes are provided by Google. The ETag is a special version id and is required to maintain the conflict detection and resolution in the outgoing google contacts data handler.In addition to several single pieces of data there are multi-value pieces of data. For each multi-value piece of data a related table will need to be created for the data to save in. The multi-values pieces of data are email addresses, phone numbers, and street addresses.

For an End User to connect to Google and use this ESB they will need to login to Google. In addition to logging into Google the “Google Contacts Last Updated Time” field on the user record is involved with the contacts sync. It is a date field that is used to maintain when the last time a sync was performed. If a full resync is needed then this fields should be cleared and all contacts for that user will be retrieved on the next update.

Options

There are no configuration options for this data source.

Triggering

This Data Source is triggered automatically, on a schedule. Every 5 minutes your WorkXpress application will communicate with Google and look for added, modified, and deleted Google Contacts on Google's end and read them into WorkXpress. To see the next time it's scheduled for use the “Scheduled Queue” tab on the Enterprise Service Bus page.

Data Handlers

There is currently only one data handler available for this data source.

  • WorkXpress Helper: Contact Management - This data handler will create, update, and delete records from the table chosen with a simple configuration system to write the data from the data source.
enterprise service bus data source - google contacts.txt · Last modified: 2016/09/14 18:19 (external edit)
Copyright WorkXpress, 2024