Appearance
Versioning
Data Hubs and Data Providers use a versioning system to manage configuration changes safely. There are three configuration version statuses:
| Status | Definition |
|---|---|
| Draft | The Data Hub/Provider is a work-in-progress -- currently in the design, build, and/or testing phase. Both a Live and Draft status can be held simultaneously. When modifications are made to a Live Data Hub, a draft copy is created to design, build, and test the connections prior to publishing. Once published, the draft/modified version will supersede the current live version. You can view the version history by selecting Deploy > Data Hubs, then selecting the applicable Data Hub in the left column. |
| Live | The Data Hub/Provider is live in the Production environment today. Live versions are read-only; a draft version must be created to modify (see note in Draft status definition). |
| Previous Deploy | The Data Hub/Provider was in the Production environment, but has been superseded by a newer deployed version. |
View All Versions of a Data Hub
- Select Deploy from the main menu and ensure the Data Hubs tab is selected.
- Select the appropriate Data Hub from the left column.
- As needed, use the table below to determine next steps.
| To | Do this |
|---|---|
| View Data Hub Status | The status is shown in the left column of the Data Hub table. |
| Add Comments | Select Actions > Comments. Enter text in the Comments field, then select Save. |
| Deploy a Data Hub | Select Actions > Deploy. |
| Compare with Live | Select Actions > Compare with Live. In the Compare Configurations window, view the side-by-side code for any changes and to ensure accuracy. When finished, select Close. |
| Compare with Previous | Select Actions > Compare with Previous. In the Compare Configurations window, view the side-by-side code for any changes and to ensure accuracy. When finished, select Close. |
| View Code | Select Actions > View Code. View the code to ensure accuracy; when finished, select Close. |
TIP
When comparing versions within the Compare Configurations window, you can toggle the following icons to assist in comparing the versions: View Inline, Previous Change, Next Change, and Ignore Trailing/Leading Whitespace.
Create a New Draft Version of a Live Data Hub
Once a Data Hub has been deployed, it is Live. If you need to make changes, you need to create a new Draft version of the Data Hub, edit that version, and deploy it to supersede the current Live version. This ensures the current version of the Data Hub is still running and enables you to make changes and run testing prior to deploying an updated version. You can have several Draft versions of the same Data Hub.
Note
You could also revert to a Previously Deployed version of the Data Hub while making edits to the most recent Live version; however, it is advised to modify a Draft copy of the latest version.
- Select Build > Data Hubs from the main menu.
- Select the appropriate Data Hub.
- Select Actions > + New Draft.
Note
You can have only one (1) Draft and one (1) Live version of the same Data Hub; therefore, you will only see this option when there is only a Live and Previously Deployed version of this Data Hub. See the Versioning section for more information.
- A new Draft version will appear, where you can modify and save any changes.
Delete a Data Hub
Users are able to delete a Data Hub in any status (e.g. Draft, Live). This will remove all components of the Data Hub; however, your Data Models will still be valid, so you are able to use those to build a new Data Hub as needed.
WARNING
Once a hub has been deleted, all integrations inside that Hub will immediately be turned off in production.
- Select Build > Data Hubs from the main menu.
- Select the appropriate Data Hub.
- Select Actions > Delete Data Hub.
- Select OK to confirm the deletion.
Related Pages
- Deployments — Deploy Data Hub configurations
- Building Data Hubs — Create and configure Data Hubs
- Code View — View and edit the underlying Data Hub configuration
- Monitor Dashboard — Track deployment health after going live