Additionally to DFRNT hosted data products, you can connect and collaborate directly on data products hosted at TerminusCMS from DFRNT, using TerminusDB API keys.
DFRNT.com helps you manage data products that are either hosted in DFRNT through the subscription, or connected via API. Data products hosted at TerminusCMS can be reached by adding an API key found in your TerminusCMS profile at https://dashboard.terminusdb.com .
To get started, the first step is to connect your data product instance at TerminusDB, here's how:
- get an account, and setup a data product at TerminusDB/TerminusCMS
- connect the data product to DFNRT.com.
Step 1: Create your data product in TerminusCMS/TerminusDB
A suggestion is to bring up a text editor to save the values you need for later.
- Join the TerminusCMS offering at TerminusCMS
- Sign up for an account (Remember that the team name will be used later)
- Confirm your email address
- Login to https://dashboard.terminusdb.com to create your data product
- Create the data product (note that the id and name are not the same), you will need the data product id to connect to DFRNT.com
- Create an API key for connecting DFRNT.com to TerminusDB (upper right/profile in the menu)
- Add a token description, generate new token and copy it
You should now have the three things you need to connect Zebra to your data product:
- A TerminusDB Team name (See your Profile to find it)
- A Data Product ID (See about the Data Product)
- The API key (Create one in the profile, you can create as many as you need)
Step 2: Connect DFRNT.com to TerminusDB
- Sign up for DFRNT.com through the sign-up on the homepage dfrnt.com
- Once logged in to DFRNT.com, go to Settings/API Keys. Or use the guided setup at Learn More/Start Free.
- Add your Settings/API Key: Fill in the TerminusDB Team (that your captured above), “Token” and the API Token (see above)
- Complete filling in the details for your team/instance; the setup is similar for the localhost subscription
- Team/Instance: Fill in TerminusDB Team (connects using the server-side vaulted API token) as both team name and team reference
- Team/Instance: Set the id to commit as, you likely want to use your email address (like you would if you use git)
- Create a named TerminusDB connection pointer to a data product branch in your team/instance, or create a sandbox data product. In settings, this is part of the team-specific settings.
- Pointer creation: Select your TerminusDB Team
- Pointer creation: Enter your TerminusDB data product id (see above)
- Pointer creation: Set the branch you want to be working on (usually main)
If all went well, you should now be ready to add your schema and data in the Model Editor.
If you encounter any errors, feel free to submit an issue at Github/issues. Be careful to check that you share no secret information, like the API token if you copy/paste a screenshot.