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:

../_images/example_timeline.png

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:

../_images/classic_sequence_shot_preview.png

Classic, sequence and shot

This template will generate a structure containing both sequences and shots. The last clip is missing SH and so does not match the template. As a result it is excluded from further processing and displayed under a special heading in the preview tree.
../_images/classic_shot_preview.png

Classic, shot only

This template will generate a structure containing only shots and, as you can see, the same clip as before does not match this template either. You can also see that, due to the template not using the sequence name, shots from different sequences have been collated as a single shot.
../_images/full_name_shot_preview.png

Full name, shot only

This template will generate a structure containing only shots, but based on whatever name the clip has. In this case all clips match and corresponding shot names produced.

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 Editorial ‣ Rename Shots (Alt+Shift+/)

../_images/rename.png

Note

Rename works on a selection of clips. The ### will be replaced by the increment value and the number of selected clips.

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, Window ‣ Tags and navigating to the ftrack folder.

../_images/tags.png

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.

../_images/applied_ftags.png

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:

../_images/create_project_context_menu.png

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.
../_images/create_project_dialog.png

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.

../_images/create_project_settings.png

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:

../_images/select_template_preview.png

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.

../_images/create_project_done.png

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.

../_images/create_project_remote_result.png

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

../_images/create_project_remote_result_attributes.png

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