- 27 Mar 2025
- 3 minute read
- Print
- DarkLight
- PDF
Custom Dataset Legacy Compatibility
- Updated 27 Mar 2025
- 3 minute read
- Print
- DarkLight
- PDF
If your institution still uses local/Slate Template Library features, additional steps are required to use your custom dataset with those features. This article will walk you through the steps to ensure your dataset is compatible with any legacy tools that may depend upon legacy querying functionality (local/Slate Template Library queries).
These steps are optional, and are not recommended unless needed for a specific purpose. Completing these steps will require using database tools that are shown in gray text and marked as “(legacy tool)”.
Best Practice
Local and Slate Template Library queries/query bases are no longer in development and are not supported by Technolutions. Unless absolutely necessary, we advise against following the steps in this article and instead recommend making the transition to using only Configurable Joins queries and database tools.
Step 1. Preparation
This article assumes you have already completed all steps noted in the Creating a Custom Dataset article.
Step 2. Refresh the Slate Template Library
From the main navigation, select Database.
Under Configurations, select Slate Template Library (legacy tool).
Click the link to manually refresh the Slate Template Library.
Step 3: Add the custom dataset query base
Before Configurable Joins, it was necessary to add query bases manually before they could be used. Creating a custom query base allows you to use a new dataset in the areas of Slate that do not yet support Configurable Joins, or where Local or Slate Template Library filters are still in use. If your institution is still using the legacy Lookup tool, this step is required to add your new dataset to that tool.
To add the query base for the custom dataset:
From the main navigation, select Database.
Under Configurations, select Slate Template Library (legacy tool).
In the Search Library bar, enter the name of the new dataset.
Under Query Bases, click Add. A popup appears.
Set Status to Active.
In the Order field, enter a number. This number determines the position of the new dataset in the Lookup tool relative to other record types.
Select a Read Permission for the dataset query base. Leave all other settings unchanged.
Click Save.
Step 4: Creating the Lookup
Creating a Lookup for a custom dataset displays it in the Record Lookup tool. The Lookup also determines the columns that display for the Dataset Records in the Record Lookup tool.
To create the Lookup:
From the main navigation, select Database.
Under Configurations, select Slate Template Library (legacy tool).
Click the refresh the Slate Template Library link at the top of the page. A system dialog appears.
Click OK.
In the Search Library bar, enter the name of the new dataset.
Under Query Custom Exports, select one of the results from the list (it doesn't matter which) and click Add. A popup appears.
Configure the following settings:
Base: Select your new custom dataset.
Name: Enter Lookup
Default: Yes
Click Save.
With the Lookup record created, we'll create the partial match.
Step 5: Creating the partial match
Partial Match creates a “search box” that can be used in the Record Lookup tool to find specific Dataset Records.
To create a partial match:
From the main navigation, select Database.
Under Queries, select Query Exports/Filters.
Click Insert. A popup appears.
Configure the following settings:
Base: Select your new custom dataset
Name: Enter Partial Match
Where Clause: Enter (contains(d. [index], ))
#1 Operators: Enter CONTAINS
Click Save.
Step 6: Assign the New Record form to the Query Base
Locate the New Record form for your custom dataset. This will be needed for the following steps.
On the New Record form, right-click the New Registration link on the registration page, and then select Copy link address.
Select Database on the top navigation.
Select Query Bases (legacy tool).
Select the Query Base of the new dataset.
In the Create Record URL settings, paste the New Registration link that was previously copied.
Select Save.
When manually adding a record to the custom dataset, if an error appears that reads "Resource not available," this indicates that the query base has not been properly configured. Go to the Query Base with the Database tool and complete the Create Record URL setting.