On this page
Install Aurelia Utilities
Prepare a learning environment, install the sample, and verify that its initial task completes.
Install Aurelia Utilities to explore data quality, search, and duplicate review in Trazadera Golden. The sample represents a fictional residential energy retailer with customer records from a CRM and a billing system, plus sales leads collected through several channels.
The sample includes synthetic records and configuration. It contains no real customer data. Use a non-production environment for the exercises.
Before you begin
| Item | Requirement |
|---|---|
| Role | ADMIN. Settings is administrator-only |
| Environment | Non-production. The installation writes customer and lead records, plus lookup catalogs |
| Execution | Background task; follow its status until completion |
Set GOLDEN_URL to the assigned service URL and GOLDEN_ADMIN_TOKEN to an
administrator credential before using the API commands.
Install the sample
- Open Administration and select Settings.
- Find Aurelia Utilities under Sample projects. Its status reads Not installed.
- Select Install.
- Follow the task under Administration → Tasks until it reaches
SUCCEEDED.
Golden confirms: “The sample aurelia-utilities is being installed. Follow its
progress under Administration, Tasks.”
To start the installation through the API:
curl --fail-with-body --silent --show-error \
--request POST \
--header "Authorization: Bearer ${GOLDEN_ADMIN_TOKEN}" \
"${GOLDEN_URL}/api/samples/aurelia-utilities/install"
{
"run": {"id": "a246c036-5791-4a60-8ea4-96823077a4a1", "status": "PENDING"},
"sampleId": "aurelia-utilities",
"messages": ["The installation of the sample aurelia-utilities was scheduled"]
}
The shortened response contains the queued run, not the installation result.
Read its run.id and follow it with GET /api/jobs/runs/{id} until status is SUCCEEDED. The
installation creates both entities and their resources, uploads two customer
CSV exports and a leads JSON file, then loads, cleans, scores, indexes, and
classifies their records. It takes an initial quality measurement for each
entity.
Use GET /api/samples to list the available samples and their installation status.
An administrator can select Download files in Sample projects, before
or after installation, to inspect the source data and configuration. The API
equivalent is GET /api/samples/aurelia-utilities/download; it returns a ZIP
archive containing the manifest, resources, source files, and expected
outcomes. Compare a source file with a stored record to see what cleaning
changed. The archive does not contain subsequent edits made in your installation.
Verify the installed result
Confirm that both sample-customer-entity and sample-lead-entity are READY.
For an unmodified Aurelia Utilities 1.0.0 installation in a clean environment:
| Entity | Records | Duplicate groups | Initial average quality |
|---|---|---|---|
| Customers | 378 | 350 | 96.91 |
| Sales leads | 108 | 15 | 60.7 |
The customer measurement includes all 378 records, with 17 error findings and 149 warning findings. The leads measurement includes 108 records, with four error findings and 1,231 warning findings. Findings count occurrences, not necessarily distinct records. The leads’ lower average is expected: each capture channel supplies only some of the dataset’s fields.
Picture shown identifies the installation measurement and its actual time. It appears as On demand because it was taken during installation rather than at a daily close. The saved label follows the installation language. There is no need to wait for a scheduled snapshot.
If another measurement has been taken since installation, use Change to select the installation row and Show this picture to display it. Do this within the entity whose figures you are checking. If an initial measurement is missing, inspect the installation run’s messages before continuing.
Continue reading
Understand the sample configuration