Connectors → Zuora

About Zuora

Zuora is a technology solutions provider that offers complete Order-to-Revenue capabilities for modern businesses. Zuora is developing products to manage quotes, orders, billing, and revenue recognition for the entire customer lifecycle on a single platform. Zuora provides a subscription management SaaS platform for businesses utilizing a subscription-service model that enables any company in any industry to successfully launch, manage, and transform into a subscription business.

The Zuora Central platform lets companies keep track of subscription payments, billing, collections, pricing, product catalogs, and accounting. In addition to Zuora Central, Zuora's four primary SaaS applications are Zuora Billing, for recurring billing operations; Zuora Revenue, for revenue recognition; Zuora CPQ, sales quoting for subscription businesses; and Zuora Collect, for payment collections. Zuora's app marketplace, Zuora Connect, allows partners to develop and list apps built on the Zuora Central platform.

About the Zuora Connector

The Zuora connector supports the following Incorta specific functionality:

FeatureSupported
Chunking
Data Agent
Encryption at Ingest
Incremental Load
Multi-Source
OAuth
Performance Optimized
Remote
Single-Source
Spark Extraction
Webhook Callbacks

Zuora connector authentication types

Incorta can connect to Zuora through four different types of authentication:

  • Header: uses the Zuora user name and password
  • Cookie: uses the Zuora user name and password
  • BasicHttp: uses the Zuora user name and password
  • OAuth: uses the Zuora user name and password, in addition to the Client ID and Client Secret for the OAuth client

For information about creating an OAuth client for a user account, refer to Manage Users - Create an OAuth Client for a User.

For information about creating an OAuth tenant login, refer to Create an OAuth Tenant Login in Zuora Connect.

Note

After successfully creating an OAuth client, Zuora displays the Client ID and Client Secret for the OAuth client. Make a note of these details when Zuora displays them. This is the only time you can see the Client Secret.

Steps to connect Zuora and Incorta

To connect Zuora and Incorta, here are the high level steps, tools, and procedures:

Create an external data source

Here are the steps to create an external data source with the Zuora connector:

  • Sign in to the Incorta Direct Data Platform™.
  • In the Navigation bar, select Data.
  • In the Action bar, select + NewAdd Data Source.
  • In the Choose a Data Source dialog, in Application, select Zuora.
  • In the New Data Source dialog, specify the applicable connector properties.
  • To test, select Test Connection.
  • Select Ok to save your changes.

Zuora connector properties

Here are the properties for the Zuora connector:

PropertyControlDescription
Data Source Nametext boxEnter the name of the data source
Authentication Typedrop down listSelect between Header, Cookie, BasicHttp, and OAuth
Usernametext boxEnter the Zuora username
Passwordtext boxEnter the Zuora password
Client IDtext boxSelect OAuth as the Authentication Type to configure this property. Enter the OAuth Client ID.
Client Secrettext boxSelect OAuth as the Authentication Type to configure this property. Enter the OAuth Client Secret.
URLdrop down listSelect the URL you want to connect to. Select Other to enter a URL other than the available ones.
Othertext boxSelect Other as URL to configure this property. Enter the URL you want to connect to.

Create a schema with the Schema Wizard

Here are the steps to create a Zuora schema with the Schema Wizard:

  • Sign in to the Incorta Direct Data Platform™.
  • In the Navigation bar, select Schema.
  • In the Action bar, select + NewSchema Wizard.
  • In (1) Choose a Source, specify the following:
    • For Enter a name, enter the schema name.
    • For Select a Datasource, select the Zuora external data source.
    • Optionally, enter a description.
  • In the Schema Wizard footer, select Next.
  • In (2) Manage Tables, in the Data Panel, first select the name of the Data Source, and then check the Select All checkbox.
  • In the Schema Wizard footer, select Next.
  • In (3) Finalize, in the Schema Wizard footer, select Create Schema.
Important

Joins are not automatically created between the schema tables. You need to define them manually. In addition, there are no key columns defined for schema tables. You need to edit each table and define the key column(s), if any. Key columns affect data loading, especially incremental loads.

Create a schema with the Schema Designer

Here are the steps to create a Zuora schema using the Schema Designer:

  • Sign in to the Incorta Direct Data Platform™.
  • In the Navigation bar, select Schema.
  • In the Action bar, select + NewCreate Schema.
  • In the Create Schema dialog, in Name, specify the schema name, and then select Save.
  • In Start adding tables to your schema, select Zuora.
  • In the Data Source dialog, specify the Zuora table data source properties.
  • Select Add.
  • In the Table Editor, in the Table Summary section, enter the table name.
  • To save your changes, in the Action bar, select Done.

Zuora table data source properties

For a schema table in Incorta, you can define the following Zuora-specific data source properties as follows:

PropertyControlDescription
Typedrop down listDefault is Zuora Database
Data Sourcedrop down listSelect the Zuora external data source
IncrementaltoggleEnable the incremental load configuration for the schema table. See Supported Incremental Loads.
Querytext boxEnter the SQL query to retrieve data from the Zuora data source
Update Querytext boxEnable Incremental to configure this property. Define the SQL update query to use during an incremental load. The query and update query should be of the same structure, that is, the same selected columns.
CallbacktoggleEnable post extraction callback, that is, enable callback on the data source data set(s) by invoking a certain callback URL with parameters containing details about the load job.
Callback URLtext boxEnable Callback to configure this property. Specify the callback URL.

View the schema diagram with the Schema Diagram Viewer

Here are the steps to view the schema diagram using the Schema Diagram Viewer:

  • Sign in to the Incorta Direct Data Platform™.
  • In the Navigation bar, select Schema.
  • In the list of schemas, select the Zuora schema.
  • In the Schema Designer, in the Action bar, select Diagram.
Note

Only joins that you manually create appear on the diagram as there are no joins automatically created between the schema tables.

Load the schema

Here are the steps to perform a Full Load of the Zuora schema using the Schema Designer:

  • Sign in to the Incorta Direct Data Platform™.
  • In the Navigation bar, select Schema.
  • In the list of schemas, select the Zuora schema.
  • In the Schema Designer, in the Action bar, select LoadFull Load.
  • To review the load status, in Last Load Status, select the date.

Explore the schema

With the full load of the Zuora schema complete, you can use the Analyzer to explore the schema, create your first insight, and save the insight to a new dashboard.

To open the Analyzer from the schema, follow these steps:

  • In the Navigation bar, select Schema.
  • In the Schema Manager, in the List view, select the Zuora schema.
  • In the Schema Designer, in the Action bar, select Explore Data.

For more information about how to use the Analyzer to create insights, see Analyzer and Visualizations.

Additional Considerations

Supported Incremental Loads

You can enable Incremental Load for a Zuora table data source. Incremental load will depend on the Update Query in the table properties. Make sure you define a key column in the table before using the incremental load; otherwise, when you run an incremental load, both new and updated data will be added to the existing data resulting in duplicate rows.

In the Update Query, you can use a timestamp, date, numeric, or text field. Select the field(s) to use in the Update Query as appropriate to your needs.

Note

Changing the incremental load strategy requires a full load to ensure data integrity.

Incremental Load Example

In this example, the Account table contains a column of the type Timestamp to use to load the table incrementally. In this case, the name of the date column is UpdatedDate and its format is Timestamp.

Here are the data source property values for this example:

Incremental is enabled

Query contains SELECT * FROM Account

Update Query contains SELECT * FROM Account WHERE UpdatedDate > ?

Note

? is a variable in the update query that contains the last schema refresh date.
When running an update query for an incremental load, you are able to use the ? reference character. The ? character will be replaced with the last incremental reference to construct a valid query to the database. The ? reference character is not valid in a standard query.

Valid Query Types

When creating a query for the Zuora connector, only SELECT statements are valid.