Upload a model

Selecting the file

Select ‘Import a model’ from the ‘Import & Export’ menu (in Community, ‘Import a model’ is on the main menu).

Models are imported from a repository. First select the repository from the drop-down, then click ‘Authorise’. You will be asked to sign in to GitHub, and can then browse the repositories you have access to.

Note

If a repository is missing there may be an issue with resources set-up (View & manage tenant resources).

trac upload a model screen with repository selection and Authorise button

Once authorised, select the branch and commit and then click ‘Select file’, to open a pop-up showing the file structure and available models.

trac model repository file browser showing available models

Models are uploaded one at a time. Pick a file and hit ‘Save’.

trac model file picker with Save button

The pop-up should now close with your target model selected and some system generated tags displayed.

trac selected model with system-generated tags displayed

Saving the model

To complete the upload, first assign the tags.

A model can be imported as a new object or as a new version of an existing object. To upload as a new version of an existing model object check that the version match toggle is on and click ‘Upload model’.

trac upload model screen with tags and version match toggle

If any models are found that could be versioned using the selected import you will be allowed to select the object and click ‘New version of selected’.

trac model upload screen listing objects available to version

Note

To be imported as a new version of an existing model it must be the same repository and entry point but loaded from a different commit. The modal will show all existing objects which meet these criteria.

Success or failure

A pop-up should tell you that ImportModel job has started but will not disclose its outcome, so navigate to the search page to check its status (search for Jobs) or find the model.

If the job fails click into the job summary to see the error message.

trac model import job summary showing an error message

The most common issues relate to repository access. Check that you have access to the repository on GitHub, and that your organisation’s GitHub App is installed on it. In Community, check the repository’s token on the tenant resources page.