Differences

This shows you the differences between two versions of the page.

Link to this comparison view

enterprise service bus data handler - google contacts [2016/09/14 18:19]
enterprise service bus data handler - google contacts [2016/09/14 18:19] (current)
Line 1: Line 1:
 +====== Enterprise Service Bus Data Handler - Google Contacts ======
  
 +===== Purpose =====
 +
 +The Google Contacts data handler allows the builder to create an application that creates, updates, and deletes contacts in Google Contacts.
 +
 +//This feature will be available in Platform Version 13.11.851.//​
 +===== Supporting Elements =====
 +
 +For the Google Contacts data handler to work properly there needs to be several elements added to the application. ​ A [[Table|table]] will need to be created by the builder that the ESB will read from.  The Google Contacts Data Handler will read up to 7 single pieces of data that can be saved; First Name, Last Name, Middle Name, Name Prefix, Name Suffix, Contact Description,​ Contact ID.  The ETag is a special version id and is required to maintain the conflict detection if it is empty then the WorkXpress data will be pushed to Google without checking for any changes made in Google. ​ 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 read from.  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 [[Enterprise Service Bus - Google Login|login to Google]].
 +
 +===== Options =====
 +
 +There is one configuration option in this data handler.
 +
 +  * When WorkXpress and Google Contact Data Conflicts which data should be used? - If a change has occurred in both the WorkXpress application and Google then the version is one system has to take precedence. ​ If Google is selected then the values passed in by Google will be used and a the changes in WorkXpress will be overwritten. ​ If WorkXpress is selected then the data from Google will be ignored and the values from WorkXpress will be pushed up to Google.
 +
 +===== Triggering =====
 +
 +This Data Handler is triggered via an [[Action Type - Enterprise Service Bus|Enterprise Service Bus Action]]. ​ To see which actions will trigger this Data Handler use the "​Outgoing"​ tab on the [[Enterprise Service Bus|Enterprise Service Bus]] page.
 +
 +
 +===== Field Mapping =====
 +
 +The field mapping interface will allow the builder to choose a field on the table selected in the options above or to use a [[Query Builder|query]] to find a field on related records to the record created by the data handler.
 +
 +{{::​esb_contacts_outgoing.png?​nolink|}}
enterprise service bus data handler - google contacts.txt ยท Last modified: 2016/09/14 18:19 (external edit)
Copyright WorkXpress, 2024