Configuring Specifications

Within the Configuration tab of a Specification you can select which session template you would like to use, and configure conformance modes.

Selecting the Edit icon in the Session Template field will allow you to choose a template to use and, once this has been selected, the relevant data stores will be available to configure.

The Configuration tab with the Session Template field annotated.

Navigate the file structure and choose the required template and click Confirm.

Session Template popout.

The task list will be populated by the template, where you can then configure Pass Thresholds and task options.

ClosedConformance Mode

The conformance mode can be changed by selecting one of the three options from the drop down menu:

  • All Check Rules Tasks - Only Check Rules Tasks will be used for verification.
  • All Tasks - Both Rules and Actions Maps will be used for verification.
  • Selected Tasks - Only the selected Tasks will be used for verification.

ClosedData Stores

From here, you can decide whether to allow the upload and download of input/output data, enable/disable schema mapping, and allowing user-supplied parameters.

A Project's configuration screen showing the data stores with inputs and outputs.

The Upload Mode can be set so that submissions don't require data to be uploaded before running. This will use the data that was set in the 1Integrate configuration for the submission.

Upload options for a Data Store.
  • Not Supported - Data cannot be uploaded.
  • Optional - Data isn't necessary but can be uploaded if needed.
  • Required - A file must be uploaded.

The Schema Mapping can be set to enable or disable the automatic or manual schema mapping.

Schema Mapping options for a Data Store.
  • Automatic - Editable - The schema is automatically mapped but allows Suppliers to edit the schema.
  • Automatic - Show mapping - The schema is automatically mapped.
  • Automatic - Hide mapping - The schema is automatically mapped and hidden to the supplier user.
  • Use source schema - The original uploaded schema is used without modifications.

The Download Modified Input Mode and Download Mode can be set to enable or disable the ability to download data.

Download options for Modified Input Data or Output Data.
  • Downloadable - The Modified Input/Output data can be downloaded. This also enables the Output Filename Template field.
  • Not Supported - Data cannot be downloaded.

The Output Filename Template field can be edited when the Output Data is downloadable. Clicking the Edit icon opens the Edit Output Filename popout.

The template for the filename can be constructed using the provided variables. Clicking a variable type lists the variables associated with that type eg. Project has Project Name and Project Key.

Choosing a variable will insert it into the text field at the selected location. Multiple variables can be inserted and text, including variables, can be manually typed. Once the template is ready, click Confirm to save it.

The popout for configuring a template for output filenames.

     Note: Filenames can be completely static, as variables are optional. However, for clarity and best practice, this is not advised.

Adding User-Supplied Parameters allows users to edit those Data Store Parameters at the Upload Data stage. This also allows users to connect to an external Data Store.

A Specification's configuration screen showing Username and Password parameters to connect to an external Data Store.

     Note: Information on parameters can be found for the respective Data Stores in the 1Integrate documentation.

ClosedTasks

This tab displays a breakdown of all tasks associated with your selected template.

Project Configuration showing the list of tasks that a submission would perform in the processing phase.

If Selected Tasks Only is the chosen Conformance Mode, you can choose which Tasks will be used to confirm success or failure by selecting the Record conformance results check boxes.

Example configuration containing all the tasks with task options.

Task

Task Option

Description

Validate Schema

Record conformance results

 

 

Enabling this allows the collection of conformance statistics and the setting of Pass Thresholds.

 

 

Check Rules

Apply Action Map

Pause

Require all previous tasks to pass

When this is enabled the submission will be automatically rejected if any previous tasks do not meet the pass threshold.

ClosedPass Thresholds

If you have Pause tasks defined in your 1Integrate Session, you have the option to enforce pass thresholds with the Require all previous tasks to pass option. For more information about 1Integrate Sessions, please refer to the 1Integrate documentation.

Defining a Pass Threshold (%) on a task will determine the percentage of feature conformance required in order to continue a submission. The Pass Threshold (%) defaults to 100.00% and can only be edited on Tasks with the Record conformance results option enabled.

     Note: You can set a Pass Threshold (%) for submissions that do not have pause tasks. This will not halt the submission process but will give a warning to the user and show the percentage of conformation.