Overview
The Lyftron Provider for Harvest offers the most natural way to access Harvest data from Lyftron with ease and also enables to connect with BI, MDM & ML tools, Data warehouses, Databases and other SAAS based applications with zero code and zero infrastructure requirements. The provider wraps the complexity of accessing Harvest data into easy-to-integrate relational fully managed ANSI Sql format. Make faster and better business decisions with Lyftron’s Harvest data provider and automatically build your data migration pipelines in minutes, not months
The provider hides the complexity of accessing data and provides additional powerful security features, smart caching, batching, socket management, and more.
Key Features
- Comprehensive Delta load mechanism.
- Real-time access to Harvest.
- Comprehensive full support of ANSI Sql to query data with ease.
- Collaborative query processing.
Prerequisites
The user must have credentials for Harvest, Lyftron and your destination data warehouse, lake or database to perform the data pipeline operation with Lyftron
Establishing a Connection with Lyftron's Quickstart Steps
Create your Harvest connection with Lyftron by following the 5 easy steps show below:
Step1. Add your connection
Click on Connect section on the left panel → Click on Add Connection button
Step2. Select your connector
In the connector selection panel, search and click Harvest for your connection
Step3. Enter your connection details
In the Connection String section enter the values of the below parameters. The following connection string is required to establish Harvest connection with Lyftron.
Profile=C:\profiles\Harvest.apip;ProfileSettings='Api-Key=my_api_key';Key | Value | Field |
Connection Name | Enter your connection details | Required |
Profile | C:\profiles\Harvest.apip | Required |
Api-Key | your Harvest api_key | Required |
Profile | C:\profiles\Harvest.apip | Required |
InitiateOAuth | your Harvest GETANDREFRESH | Required |
OAuthClientId | your Harvest client_id | Required |
OAuthClientSecret | your Harvest client_secret | Required |
CallbackUrl | your Harvest callback_url | Required |
Logfile** | Use the logfile option to debug your job and provide your connection name to generate the log file. [ConnectionConfigurationPath]\Connection_name_log.tx | Optional |
Verbosity** | Choose verbosity 1-5 based on the severity of debugging | Optional |
** For more information, check the Lyftron logging and debugging section.
If you want more detailed information about how to establish a connection with Lyftron, click on Lyftron Connection Quick Start guide.
Step4. Test your connection
Once you are done entering your connection details, simply click on the Test Connection button to test the connectivity. In case your connection fails, add Logfile and Verbosity parameters and check the Lyftron logging and debugging section, to debug the error.
Step5. Save your connection
Hurray! Now you have successfully connected with the Lyftron Harvest connector and can utilize the connector to Extract, Warehouse, Analyze, Visualize and Share your data.
Data Model
The provider models the data in APIs into a list of tables that can be queried using standard SQL statements.
Generally, querying APIs tables is the same as querying a table in a relational database. Sometimes there are special cases, for example, including a certain column in the WHERE clause might be required to get data for certain columns in the table. This is typically needed for situations where a separate request must be made for each row to get certain columns.
Name |
Type | Description |
AuthenticatedUser | Tables | Returns a list of your users. |
Clients | Tables | Returns a list of your clients. |
Company | Tables | Retrieves the company for the currently authenticated user. |
Contacts | Tables | Returns a list of your contacts |
EstimateItemCategories | Tables | Returns a list of your estimate item categories. |
EstimateMessages | Tables | Returns a list of messages associated with a given estimate |
Estimates | Tables | Returns a list of your estimates |
ExpenseCategories | Tables | Returns a list of your expense categories. |
Expenses | Tables | Returns a list of your expenses |
InvoiceItemCategories | Tables | Returns a list of your invoice item categories. |
InvoiceMessages | Tables | Returns a list of messages associated with a given invoice |
InvoicePayments | Tables | Returns a list of payments associate with a given invoice |
Invoices | Tables | Returns a list of your invoices |
Projects | Tables | Returns a list of your projects |
ProjectTaskAssignments | Tables | Returns a list of your task assignments. |
ProjectUserAssignments | Tables | Returns a list of your user assignments. |
Roles | Tables | Returns a list of roles in the account |
Tasks | Tables | Returns a list of your tasks. |
TimeEntries | Tables | Returns a list of your expenses |
UserCostRates | Tables | Returns a list of cost rates for the specified user. |
ProjectUserAssignments | Tables | Returns a list of your project assignments for the specified user. |
Users | Tables | Returns a list of your users. |
Advanced Settings
To view a detailed advanced settings options, go to Harvest Advanced Settings. Complete list of the parameters you can configure in the connection string can be found by clicking Connection String Parameters.