Set up context and target folders

In the CommonClient.properties file, specify the context and target folders as follows:

• Context folder: Update the value of DefaultContextFolder with the context folder location. Example:

  DefaultContextFolder=D:\\Models\\MyModelRoot
  

• Target folder: Update the value of DefaultTargetFolder with the target folder location. Example:

  DefaultTargetFolder=D:\\Staging\\DefaultTargetFolder
  

Default context folder

The default context folder allows you to specify a common parent folder under which all models and model folders are organized. The context folder is used during the initial save, import, and add operations.

As an example, consider the following folder hierarchy:

ParentFolder
  Folder 1
    Folder 1.1
      Topmodel.mdl
    Folder 1.2
      Submodel_1.mdl
    Folder 1.3
      Submodel_2.mdl

Suppose that the context folder is set as D:\ParentFolder and you save the contents of Folder 1.1 to Teamcenter. Teamcenter picks up the context folder information and organizes the saved model file as follows:

ParentFolder-->Folder 1-->Folder 1.1-->Topmodel.mdl

If you do not specify a context folder, the files are organized based on the parent folder.

Default target folder

The default target folder defines the folder hierarchy of the models in the staging directory. The target folder is used during the save as, new save, and revise operations.

As an example, consider that your staging directory is C:/Staging and you intend to download the models inside the directory Parent Level/MidLevel/Car/PT/Engines. When you open a model, the model is downloaded to the staging directory at C:/Staging/Parent Level/MidLevel/Car/PT/Engines.

You can also specify the target folder when performing the operations mentioned above. If you do not specify the target folder, the existing behavior continues, that is, the models are saved in the Staging-directory/model-name_itemid_revisionid folder.

How is the folder where models are downloaded calculated based on context and target folders?

The location where your model files are downloaded is calculated based on the values of the default context folder and default target folder. The path where the models are downloaded is the concatenation of the target folder and the context folder.

Result folder = Target-folder + Context-folder

Example: Assume that your Simulink models are located in the directory structure D:\models\ContextExample\Level1\Level2\Level3\Level4 and that your staging directory is located at D:\staging. The following table shows the path to the folder where the models are downloaded based on how you set up the context and target folders:

Context folder	Target folder	Result folder
NA	NA	D:\staging\ModelName_ItemID_RevID
D:\models\ContextExample\Level1	NA	D:\staging\ModelName_ItemID_RevID\Level1\Level2\Level3\Level4
NA	D:\staging\MyWorkspace	D:\staging\MyWorkspace
D:\models\ContextExample\Level1	D:\staging\MyWorkspace	D:\staging\MyWorkspace\Level1\Level2\Level3\Level4

After completing this configuration, you can:

• Check if you need to perform any other client configurations for Teamcenter MBSE Integration Services.
• Refer to the MBSE Integration Services deployment checklist to see next steps.