Reckon Accounts Hosted ETL Source
In this article
See the Connector Marketplace topic. Please request your administrator to start a trial or subscribe to the Premium Reckon Accounts Hosted connector.
In Gathr, it can be added as a channel to help in fetching customers’ and prospects’ data and transform it as needed before storing it in a desired data warehouse to run further analytics.
Schema Type
See the topic Provide Schema for ETL Source → to know how schema details can be provided for data sources.
After providing schema type details, the next step is to configure the data source.
Data Source Configuration
Configure the data source parameters as explained below.
Connection Name
Connections are the service identifiers. A connection name can be selected from the list if you have created and saved connection details for Reckon Accounts Hosted earlier. Or create one as explained in the topic - Reckon Accounts Hosted Connection →
Use the Test Connection option to ensure that the connection with the Reckon Accounts Hosted channel is established successfully.
A success message states that the connection is available. In case of any error in test connection, edit the connection to resolve the issue before proceeding further.
Entity
Tables in Reckon Accounts Hosted are statically defined to model Reckon Accounts Hosted entities.
If you selected the Fetch From Source method to design the application, the Entities will list as per the configured connection. Select the entity to be read from Reckon Accounts Hosted.
If you selected the Upload Data File method to design the application, the exact name of the entity should be provided to read the data from Reckon Accounts Hosted.
If you selected the Fetch From Source method to design the application, the Fields would list as per the Entity chosen in the previous configuration parameter. Select the fields or provide a custom query to read the desired records from Reckon Accounts Hosted.
Fields
The conditions to fetch source data from a Reckon Accounts Hosted table can be specified using this option.
Select Fields: Select the column(s) of the entity that should be read.
Custom Query: Provide an SQL query specifying the read conditions for the source data.
Example: SELECT "Id" FROM Companies
If you selected the Upload Data File method to design the application, provide a custom query to fetch records from the Reckon Accounts Hosted entity specified in the previous configuration.
Query
The conditions to fetch source data from a Reckon Accounts Hosted table can be specified using this option.
Provide an SQL query specifying the read conditions for the source data.
Example: SELECT "Id" FROM Companies
Read Options
This section contains additional read options that can be configured on need basis.
Polling Interval
This determines the polling interval in milliseconds to check whether the result is ready to be retrieved.
This property determines how long to wait between checking whether or not the query’s results are ready.
Very large result sets or complex queries may take longer to process, and a low polling interval may result in many unnecessary requests being made to check the query status.
Async Timeout
The value in seconds until the timeout error is thrown, canceling the operation.
The operations run until they complete successfully or until they encounter an error condition.
If Async Timeout expires and the operation is not yet complete, an exception will be thrown.
Custom Field Mode
Which nested data format (XML,JSON) custom fields should be displayed in.
XML is the traditional way of displaying custom fields and will be compatible with older implementations.
However, JSON is more compact and may be more appropriate if the values are being saved to a database or other tool that cannot easily traverse the XML structure.
Include Line Items
Whether or not to request Line Item responses from Reckon Accounts Hosted when retrieving a base transaction, such as Invoices.
This will not affect Line Item tables, only base transaction tables. Setting this value to false will typically result in better performance.
Include Linked Txns
Whether or not to request Linked Transactions from Reckon Accounts Hosted when retrieving a base transaction, such as Invoices.
This will not affect Linked Transaction tables, only base transaction tables. Setting this value to false will typically result in better performance.
Page size
The maximum number of results to return per page from Reckon Accounts Hosted.
The Page size property affects the maximum number of results to return per page from Reckon Accounts Hosted. Setting a higher value may result in better performance at the cost of additional memory allocated per page consumed.
Partitioning
This section contains partitioning-related configuration parameters.
Enable Partitioning
This enables parallel reading of the data from the entity.
Partitioning is disabled by default.
If enabled, an additional option will appear to configure the partitioning conditions.
Column
The selected column will be used to partition the data.
Max Rows per Partition: Enter the maximum number of rows to be read in a single request.
Example: 10,000
It implies that a maximum number of 10,000 rows can be read in one partition.
Advanced Configuration
This section contains additional configuration parameters.
Use Jobs
Specifies whether to use the jobs endpoint instead of the export endpoint. If set to true, the maximum number of returned rows is configured.
Max Threads
Specifies the number of concurrent requests.
Fetch Size
The number of rows to be fetched per round trip. The default value is 1000.
Add Configuration: Additional properties can be added using this option as key-value pairs.
Detect Schema
Check the populated schema details. For more details, see Schema Preview →
Pre Action
To understand how to provide SQL queries or Stored Procedures that will be executed during pipeline run, see Pre-Actions →.
Notes
Optionally, enter notes in the Notes → tab and save the configuration.
If you have any feedback on Gathr documentation, please email us!