Artifacts are versioned instances of Intermediate Data Schemas (IDS), protocols, or task scripts. To search for specific artifacts and get detailed information about them, you can use the Artifacts option in the TDP navigation pane to do any of the following:

• View IDSs and Their Details
• View Protocols and Their Details
• View Task Scripts and Their Details

For more information about each type of pipeline element, see Tetra Data Pipeline Overview.

📘

NOTE

When reviewing artifacts in the default view, the latest version of each artifact is listed. Prior artifact versions are not automatically listed in the default view. To see all of the versions of a specific artifact, you must run a search for the artifact by using the search field. Searches return all of the versions associated with specific artifacts.

View IDSs and Their Details

A TetraScience IDS is applied to raw instrument data or report files to map vendor-specific information (such as a field name) to vendor-agnostic information. The IDS standardizes naming, data type, data range, and data hierarchy.

📘

NOTE

You can view high-level information about different IDSs in Gallery View or List View, and then select individual IDSs to see more details. Each schema entry includes the following information:

• Thumbnail image (shows either a graphic or the first and last letter of the schema's slug)
• IDS name
• IDS namespace
• IDS version

To view available IDSs and to get more information about a specific IDS, do the following:

1. In the left navigation pane, choose the hamburger icon. A drop-down list appears.
2. From the drop-down list, choose Artifacts. Then, choose IDS. The list of schemas appears in Gallery View by default. For a list view, choose the upper right List View icon.
3. To search for specific schemas, do one of the following:
   • Enter your search keywords into the upper right search field. The search returns any schema that includes the string you entered in either the IDS slug, name, description, or its associated labels.
     -or-
   • (For List View only) In one or more of the filter fields at the top of each column, enter the values that you want to filter by. You can filter by slug, type (private, common, or client), namespace, version, and last updated date.
4. To see more information about a specific schema, select the schema. The IDS Details page opens for that schema. This page provides additional information about each schema, such as the available versions, README files, and the last update date and time.
5. (Optional) Choose one of the tabs at the top of the page to get more information about the following:
   • The Details tab shows the IDS name, description, namespace, slug, related protocols and task scripts, and the last date and time the schema was updated.
   • The ReadMe tab shows the README file for the selected IDS version as well as the README files for any of the schema’s associated protocols and task scripts.
   • The Labels tab shows the schema’s associated labels that are outlined in the artifact’s manifest.json file, if there are any.
6. (Optional) In the ACTIONS section, choose one of the action buttons to run its associated task. For a list of available actions, see the following table. Action buttons are grayed out and unable to be selected if the linked file for that action doesn’t exist.

Actions Available on the IDS Details Page

View Protocols and Their Details

Protocols contain steps and configurations that are used to process data in a pipeline. Protocols have two main files: protocol.json, which contains the steps and configuration information, and a script.js file, which orchestrates the workflow.

📘

NOTE

You can view high-level information about different protocols in List View, and then select individual protocols to see more details about each one. Protocol entries include the following information:

• Slug
• Type (private, common, or client)
• Protocol namespace
• Protocol version
• Last updated date

To view available protocols and get more information about a specific protocol, do the following:

1. In the left navigation menu, choose the hamburger icon. A drop-down list appears.
2. From the drop-down list, choose Artifacts. Then, choose Protocols. The list of protocols appears in a list view.
3. To search for specific protocols, do one of the following:
   • Enter your search keywords into the upper right search field. The search returns any protocol that includes the string you entered in either the protocol slug, name, description, or its associated labels.
     -or-
   • In one or more of the filter fields at the top of each column, enter the values that you want to filter by. You can filter by slug, type (private, common, or client), namespace, version, and last updated date.
4. To see more information about a specific protocol, select the protocol’s row. The Protocol Details page opens. This page provides additional information about each protocol, such as the available versions, README files, related task scripts, and the last update date and time.
5. (Optional) Choose one of the tabs at the top of the page to get more information about the following:
   • The Details tab shows the protocol name, description, namespace, slug, related task scripts, and the last date and time the protocol was updated.
   • The ReadMe tab shows the README file for the selected protocol version.
   • The Labels tab shows the protocol’s associated labels that are outlined in the artifact’s manifest.json file, if there are any.
6. (Optional) In the ACTIONS section, choose one of the action buttons to run its associated task. For a list of available actions, see the following table. Action buttons are grayed out and unable to be selected if the linked file for that action doesn’t exist.

Actions Available on the Protocol Details Page

View Task Scripts and Their Details

Task scripts contain the code for the business logic needed to process the data in a pipeline. When processing is finished, output files are indexed according to a predefined IDS and stored in the data lake or another specific data target.

📘

NOTE

You can view high-level information about different task scripts in List View, and then select individual scripts to see more details about each one. Task script entries include the following information:

• Slug
• Type (private, common, or client)
• Task script namespace
• Task script version
• Last updated date

To view available task scripts and to get more information about a specific script, do the following:

1. In the left navigation pane, choose the hamburger icon. A drop-down list appears.
2. From the drop-down list, choose Artifacts. Then, choose Task Scripts. The list of task scripts appears in a list view.
3. To search for specific task scripts, do one of the following:
   • Enter your search keywords into the upper right search field. The search returns any script that includes the string you entered in either the protocol slug, name, description, or its associated labels.
     -or-
   • In one or more of the filter fields at the top of each column, enter the values that you want to filter by. You can filter by slug, type (private, common, or client), namespace, version, and last updated date.
4. To see more information about a specific task script, select the script's row. The Task Script Details page opens. This page provides additional information about each task script, such as the available versions, README files, related protocols, and the last update date and time.
5. (Optional) Choose one of the tabs at the top of the page to get more information about the following:
   • The Details tab shows the task script’s name, description, namespace, slug, related protocols and IDSs, and the last date and time the script was updated.
   • The ReadMe tab shows the README file for the selected task script version.
   • The Build Logs tab shows the build logs for the selected task script version.
   • The Labels tab shows the task script ’s associated labels that are outlined in the artifact’s manifest.json file, if there are any.
6. (Optional) In the ACTIONS section, choose one of the action buttons to run its associated task. For a list of available actions, see the following table. Action buttons are grayed out and unable to be selected if the linked file for that action doesn’t exist.

Actions Available on the Task Script Details Page