====== Enterprise Service Bus Data Handler - QuickBooks Browse ======

===== Purpose =====

The QuickBooks Browse data handler allows the builder to create an application that reads records from QuickBooks Online.

//This feature will be available in Platform Version 10.14.1001//
===== Supporting Elements =====

For the QuickBooks Browse 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 write to.  The QuickBooks Browse Data Handler will read a variable amount of data depending on the type of QuickBooks Record.  The ID and Sync Token are used to identify and sync a record with QuickBooks and is required for [[Enterprise Service Bus Data Handler - QuickBooks Edit|QuickBooks Edit]] and [[Enterprise Service Bus Data Handler - QuickBooks Delete|QuickBooks Delete]] data handlers to work.

For an End User to connect to QuickBooks and use this ESB they will need to [[Enterprise Service Bus - Intuit Login|login to QuickBooks Online]].

===== Options =====

There are five configuration options in this data handler.

  * OAuth Consumer Key - Intuit provides this key as a way to identify an application when requesting data from QuickBooks.
  * OAuth Consumer Secret - Intuit provides this key as a way to secure the identity of the application.  This value should not be public knowledge and protected like a password.
  * OAuth Field - This query points to the record and Intuit OAuth field that is being used to identify which QuickBooks Online Account the ESB is communicating with.
  * QuickBooks Table - This is the table that the ESB will add records to.
  * Values to Browse - This setting allows the application developer to determine what data is returned from QuickBooks.

===== 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.


===== Child Actions =====

When this Data Handler is used in an Enterprise Service Bus Action it becomes possible to add child actions below the ESB Action.  Actions added to this part of the action tree will have available as run time values the values returned from QuickBooks.