Search & view objects

Object search

The search page is split into two sections. The top portion allows you to specify search criteria and the bottom portion lists the objects which meet that criteria.

In the top portion you must select an object type to search for (A).

You also have various optional criteria which can be applied to narrow the pool of search results

• B = date filters

• C = objects which are flagged to automatically appear in search results (‘indexed items’)

• D = optional business segment tags

• E = created by a specific user (not relevant for COMMUNITY TRAC)

• F = object specific filters, for Models this is repo and model path, for Jobs this is type and status and for File this is size and type. Other object types do not have specific filter options

As well as searching via filtration, you can also find a single object if you know it’s unique ID (G).

In the bottom portion you see the list of objects which meet the search criteria. You must click ‘Update search’ to refresh the results every time you change the criteria.

Selecting one row brings up the objects general attributes and the option to ‘View’ the object, which takes you to the relevant (Object summary pages).

Note

Data that was generated via a RunModel or RunFlow job will not show up in the search results, which by default show you primary (imported or uploaded) data only. You can find generated data by entering the object ID (see G) or by searching for the job and accessing the outputs via the job summary page.

Object summaries

All of the information TRAC holds for a given object can be viewed on that object’s summary page, which is navigated to from the Search results page.

Layout

Object summary pages differ slightly per object type but follow a similar pattern.

At the top of the page are 3-4 action icons. Below, the object’s metadata is displayed. The ‘Version control’ information is the same for all objects. The ‘Attributes’ vary by object type and contains user-defined attributes.

Further down you will see information relating to any Files that have been appended. If none have, you just see the option to upload a File or link to an existing one.

Files can be appended for a variety of reasons. You could attach the model development documentation to a model, or a data quality report to a data object.

The final section describes the object and varies by object type. For Data and Models, this will describe their schemas. For a Flow this will include a visual representation of the graph. For a Job it will contain a combination of the components found on the Flow, Job and Model summaries.

Export

The JSON and PDF action icons allow you to download the object summary information. The PDF downloads are formatted to be used in formal governance processes.

For a data object, the CSV action icon allows you to download a copy of the data.

Note

In TRAC PROFESSIONAL you can also export data using an ExportData job.

Append

Files can be added to objects. To upload a new File, simply find and select it, then click ‘Import’ and ‘Upload’.

As usual you must define the general attributes, except Name which is fixed.

Instead of uploading, you can also link to an existing File object, using the standard filter and select process.

Once a link to a File has been added you will see it on the object summary.

Clicking ‘Remove link’ does not remove the File object from TRAC, it just breaks the association with this object.

Clicking ‘More info’ allows you to explore the lineage of the linked File.

Model Code

For a Model, the PY icon is link which allows you to click through to the underlying code in the repository.

Because the model object corresponds to a specific commit in the repository, the code associated with this object will never change. For more information on models and model versioning see Import model.

Note

This link only works for individual’s who have access to the repository, irrespective of their tenant role.

Find a Job

Find a Job is simply filtered version of the general search page (object type = job).

By default all your jobs will be shown in chronological order. Once the list gets too long, you can filter and search as necessary.