Configuration Settings

Configuration settings for Tentaculo consist in creating a configuration file in the json-format and then uploading it to Cerebro.

In order to upload a configuration file to Cerebro:

After the upload is completed, Tentaculo configuration will be available to all users in your universe.

Note:

In order to make sure that the configuration is correct, it is recommended to use the debug mode first.

Configuring the Tentaculo configuration consists of the following parts:

Example of Configuration

Section protocol

The protocol variable allows you to configure file access protocols; note that different values ​​are possible depending on the application in which the plugin is launched.

Element structure:

The key is the internal name of one of the supported applications ("cerebro", "maya", "nuke", "houdini" и т.д.), and the value is a string containing a protocol name or a list of protocol names. All key allows you to set the protocols for all possible programs at once, including Cerebro. If you need to specify an individual file access mode for any of the applications used, then you need to set your own protocol, different from the all one.

Note:

A value must be specified for the "cerebro" variable so that Cerebro application could independently determine which protocol it will use to access files. Otherwise, access to the file storage from Cerebro application will be denied. This is done to control access to your main file structure.

Possible protocol variable values for different applications:

You can set one or more protocols for each application, including Cerebro. For example, you might have a network drive that is accessible both on the local network and via FTP. In this case, you can set two protocols:

"cerebro": ["network", "ftp:ftp://mycompany.com"]

Additionally, when trying to access files, the user will be able to choose the protocol that suits him best – depending on where the user is at the moment, whether it's the office or a remote location.

Section project_path

The project_path variable contains a list of elements that describe the root paths to project files:

Each of the elements describes possible file paths to the project's root directory and contains the following fields:

The variables project_name and task_activity are, in fact, the key for task mapping in Cerebro, when files are either shared or downloaded. As for the paths variable, it determines where the files for this specific task should be located.

Note:

For cloud storages connected via S3 API, project_path, it is not required, since there are no folders in these storages, there are only tags imitating folders.

For Cargador storage, project_path is not required since the root access is determined by the storage itself.

Section file_path

The file_path variable contains a list of elements describing how tasks in different branches and projects match your file structure:

Each of the structures describes a set of subfolders and a file name template which are used to store file versions, and it contains the following fields:

The folder_path and task_activity variables are, in fact, the key for task mapping in Cerebro, when files are either shared or downloaded. The rest of the variables determine where the files for this task should be located.

If the value of the publish or version field is not specified, then when the file is sent to the storage, the main or the numbered version of the file respectively will not be created.

Any components of the file_path variable can contain the following substitutable variables:

For substituted variables, there is the possibility of partial definition and support for regular expressions.

To highlight a part of a variable, use the syntax $ (variable_name [i: j]), where i and j are the starting and ending index in the string.

For example:

To highlight a part of a variable, you can also use regular expressions, while the first group from the regular expression is selected by searching for the first match in the string.

Syntax:

$(variable_name{/regexp/}), where regexp - regular expression.

For example:

In formatted strings, you can also use the operating system's environment variables if their names do not match the variables listed above. Their application format is the same: $(VARIABLE_NAME).

The value of the soft_folder variable is set depending on the application in which the files are created.

Element structure:

The key in a set of paths is the internal name of one of the supported applications («maya», «nuke», «houdini» и т.д.), while the value is a string containing the variable value. It is used in the file_path section to specify file paths or file names, depending on the application in which the files are created.

Note:

Please, note that the keys do not list cerebro, since Cerebro application does not create files. When you share files using Cerebro application, the soft_folder value will be determined by the file extension corresponding to any of the supported applications.

Section version_save

The version_save variable defines what to do with the work file when saving the version — save, move, or always ask the user. The parameter can be defined for each app in which versions are saved.

Element structure:

Possible values:

The default value is 'status_question'.

The trans_mode variable allows you to enable transliteration of file paths corresponding to tasks in Cerebro – depending on the application in which the files are created or shared.

Element structure:

Possible values: true, false. Transliteration is enabled by default.

When transliteration mode is enabled, all non-Latin characters in the file path are automatically converted to Latin characters, while spaces are converted into underscores («_»). For instance, instead of the /Project 01/Моделирование path, there will be used the /Project_01/Modelirovanie path.

Section casa_mode

The case_mode variable allows you to determine the case of letters of file paths corresponding to tasks in Cerebro, depending on the application in which files are created or uploaded.

Element structure:

Possible value: "", "lowercase", "uppercase", "capitalize". The default value is empty. An empty value means that the case of letters in file paths will repeat the case of the corresponding tasks in Cerebro.

Section filters

he optional variable allows you to set task filtering parameters for each app.

You can set the following filters for each app:

Element structure:

status_filter – the variable allows you to set a list of statuses in order to filter tasks in Todo List. Standard filtering displays tasks in all statuses, except the stopped ones (work stopped). The variable type is an array of strings. In this filter, you can specify the filtering of tasks with no status by selecting the No Status option.

Example:

activity_filter – the variable allows you to set a list of activities to filter tasks in Todo List. The variable type is an array of strings. In this filter, you can specify the filtering by tasks with no activity type by selecting the No Activity option.

Example:

tree_hide_list – the variable allows you to set a list of tasks hidden from the plugin users in Todo List and Browser tabs.

The variable type is an array of strings. Supported expressions:

Example:

An example of setting up task filtering for the Maya app:

Section mirada_path

The optional variable allows you to specify the full path to the Mirada app for each operating system, providing the ability to add thumbnails for attached files of supported formats. By default, Tentaculo searches for Mirada in the directory of the installed Cerebro app.

Element structure:

Example:

Section processor

The optional processors variable defines a set of python scripts that are additionally executed when performing actions in the plugin, such as opening a file, creating a new file in a task, saving a version, publishing a report (see the Processors section), and so on.