Exporting a project¶
Setup the project structure¶
As part of the project export process Context templates are used to define the hierarchy to create in ftrack.
The template is applied to each clip and will use the name of the clip to determine what entities to create.
The plugin comes with a couple of default templates which will create some different structures. Lets look at some of those now:
Template | Description |
---|---|
Classic, sequence and shot | Match SQ or SH and any subsequent numbers. Example: SQ001_SH010 will be matched as Sequence with name 001 and a shot named 010. |
Classic, shot only | Match SH and any subsequent digits. Example: vfx_SH001 will match 001. |
Full name, shot only | Match entire clip name. Example: vfx_SH001 will match vfx_SH001. |
By applying different templates to the same selection in the timeline we’ll get different results. For example if we have a selection of clips in the timeline:

All clips, except for the last one, have been renamed to a format of vfx_SQ###_SH### where ### is replaced with a sequential number. The last clip is named vfx_SQ002_003 without SH and we’ll see how that affects the result.
If we apply the different templates to all the clips in the timeline we’ll get these different results:

Classic, sequence and shot

Classic, shot only

Full name, shot only
See also
Rename clips¶
To quickly rename a bunch of clips to match the Context template you can use the standard Rename Shots dialog. It is located in the context menu under

Note
Rename works on a selection of clips. The ### will be replaced by the increment value and the number of selected clips.
See also
Apply task tags¶
When the clips are correctly named to match the Context template you can apply tags to specify which tasks you want to generate. If you don’t want to create any tasks you can jump straight to exporting
To see available tags open the tag window,
and navigating to the ftrack folder.
See also
Select the tasks you want to create and drop them on the clips. To review which tags have been applied just click on the tag icon on the clip.

When done tagging your’re ready to export you project.
Exporting¶
With the project structure setup, it is time to export the project to ftrack.
Open the Export project dialog to get started:

Preview¶
When the dialog opens it will check against the server to see what’s already been created.
As soon as the check is done, the interface will display the preview of the project. The items are color coded:
- green - an existing object.
- white - a new object.
- red - an error occurred regarding this object.

Configure project settings¶
From this interface you’ll be able to set the attributes for all the mapped shots, such as resolution, fps, and handles. You will also be able to pick the workflow schema for the project creation and define other attributes such as handles and the start frame offset.
All the project settings will be added as attributes to each mapped shot.

Note
Some attributes, such as timecode related ones, are stored as metadata. This might change in the future.
Select template¶
Select the template you want to use when exporting the project. When selecting a template the preview window will update with the new hierarchy:

Any clips not matching the selected template are displayed in the group called Clips not matching template.
Note
The selected template will be stored in the Nuke Studio project file and will be preselected if running export again.
Export¶
Once you are happy with the configuration, all you have to do is press the Export button. As soon as the export finishes, a message will be displayed.

At this point the project has been created on your ftrack server and from the Project spreadsheet it is possible to see the project and the structure that was defined in Nuke Studio.

As well as the attributes and metadata, which have been added to the mapped shots.

See also
Besides creating and updating the project structure in ftrack several versions are published. To learn more about this please refer to this article