Manage shared models in the Management Console for Tekla Model Sharing

Tekla Structures
Not version-specific
Tekla Structures

Manage shared models in the Management Console for Tekla Model Sharing

The Management Console for Tekla Model Sharing provides web-based access for administrators to manage all of their organization's shared models. With Management Console, administrators can list and delete models, add users and modify the roles of users, lock and unlock shared models, and delete versions from the model.

In Tekla Model Sharing, an organization owns all the models shared by the users in the organization. A shared model is always owned by only one organization. The organization gets the ownership when a user in the organization starts the sharing of the model. The user who starts sharing the model gets the Owner role in that model, but the Owner role is not the same as the administrator of an organization. Only administrators can manage shared models in the Management Console.

How to use the Management Console for Tekla Model Sharing

To use the Management Console for Tekla Model Sharing, you must have a valid Trimble Identity with administrator rights.

Managing models in the Management Console for Tekla Model Sharing does not require using a Tekla Model Sharing license. You can use the Management Console without opening Tekla Structures. You do not need to be a user in any of your organization's shared models.

  1. In the Management Console for Tekla Model Sharing, click the Models button to list all of your organization's shared models.
  2. Manage the shared models.
     
    To Do this
    View the basic information of a model

    Select a model from the list.

    The Management Console shows the model name, creation date, Tekla Structures version, model ID, environment, number of users, and number of versions.

    List the model versions

    Select a model, then click the Versions button.

    The Management Console shows the version type (baseline or incremental), who created the version and when, and comments about the changes.

    Download the latest baseline of a model

    Select a model, then click the Download button.

    The Management Console downloads the last model baseline (full model) as a .zip file. Change packets that were created after the baseline are not included in the download because Tekla Structures cannot read them locally.

    List the users in a model

    Select a model, then click the Users button.

    The Management Console lists the users and shows which model version each user is currently using.

    Modify the role of a user
    1. Select a model, then click the Users button.
    2. Select a user, then select another role from the role list.

    The available roles are Owner, Editor, Viewer, Project viewer, and None.

    Note: The model can have multiple users with Owner rights. Selecting the None role removes a user's access right to the selected model.
    Add new users to shared models
    1. Select a model, then click the Users button.
    2. Click the Add users button.

    The users can now join the model. The users do not receive an invitation email.

    Delete models from the sharing service
    1. Select a model.
    2. To send an email to the users about why you are deleting the model, write a comment.
    3. Click the Save button.

    It a best practice to keep the list of your organization's shared models up to date in the Management Console. For example, you can remove obsolete projects and completed projects. Keeping the list in good shape is useful for the users in your organization as the models that are not used are not available for the users anymore.

    Lock a model for investigation

    If a shared model has changes that might cause problems, you can lock the model to prevent any further changes in the model. While the model is locked, a user can investigate the model to identify the problem. Other users of the model cannot write out changes.

    Note: The lock automatically expires in 24 hours if you do not unlock the model before that.
    1. Select a model, then click the Lock button.
    2. To send an email to the users about why you are locking the model, write a comment.

      Example: "The model is locked to investigate which packet contains the missing columns."

    3. Select one user to investigate the model.

      This user becomes the lock owner.

    4. Click the Save button.

    Locking the model changes the availability of the sharing commands from Tekla Structures 2017i onwards:

    • The Read in and Write out icons have yellow arrows . Only the lock owner can use the commands.

      Placing the mouse pointer on the Write out icon shows the message that the administrator has added in the Management Console when locking the model. The message also shows who the lock owner is.

    • On the File menu, the Read in, Write out, Create baseline and Users commands are available for the lock owner.
    • In the Shared models dialog box, the Edit model, Manage users, and Remove model from cloud commands , and joining a particular model are available for the lock owner.

    For other users, the sharing commands are not available.

    Delete a model version and unlock a model

    Before deleting a model version, a user can investigate the model to identify which version to delete. When you have deleted the model version, unlock the model.

    1. Select the model, then click the Delete versions button.
    2. Select the version to delete.

      If there are newer versions, the Management Console also selects them to be deleted.

    3. To send an email to the users about why you are deleting the version, write a comment.
    4. Click OK.
    5. Click the Unlock button.
    6. To send an email to the users about why you are unlocking the model, write a comment.
    7. Click the Save button.

    From Tekla Structures 2017i onwards, if a user of the shared model has already read in or written out any of the deleted versions, the Write out and Read in icons have red arrows for the user, and the user must rejoin the model.

    If a user is not using any of the deleted versions, the user does not need to rejoin.

    When model versions are deleted, the changes that have been made in those versions are lost from the model. You must make the changes that should be included in the model again and read them in.

    It is also possible to revert to an earlier version of the model without further investigating it. You can lock the model, delete the versions that are not needed or that contain problems, then unlock the model.

    In Tekla Structures 2018, a user can reserve the next write out in the model. Other users cannot write out while the next write out is reserved. If needed, you can release the write out reservation in the Management Console at any time by unlocking the model.

Archive completed Tekla Model Sharing projects

When you have completed a Tekla Model Sharing project, we recommend that you archive your project.

For more information, see Archiving old Tekla model sharing projects.

Example: Locking a shared model and reverting to a previous model version

In this example, the administrator locks a model for investigation to identify a model version that causes problems, and to find the last valid version.

For example, a user might have accidentally deleted too many objects. When locking the model, the administrator can name one user as the lock owner who can investigate the model, and write out and read in normally. Other users of the model cannot write out while the model is locked.

When the lock owner finds the model version that causes problems, the administrator can delete the model version in the Management Console for Tekla Model Sharing and restore an earlier version of the model. If the model has newer versions, the Management Console also deletes these versions. After the versions have been deleted, the administrator unlocks the model.

In this example, the administrator does steps 1 and 3 in the Management Console. The lock owner does step 2 in Tekla Structures.

  1. As the administrator, sign in to the Management Console for Tekla Model Sharing using a valid Trimble Identity.
    1. Click the Models button to list all of your organization's shared models.
    2. Select the model that you want to lock.

      The Management Console shows the basic information of the model.

    3. Click the Lock button to the lock the model.
    4. To send an email to the users about why you are locking the model, write a comment.
    5. Select one user to investigate the model.

      The user you select becomes the lock owner, and is the only user who can read in and write out while the model is locked.

    6. Click the Save button.
    7. Inform the lock owner that the model can now be investigated.
  2. As the named lock owner, investigate the model.
    1. Open the locked model in Tekla Structures.
    2. Read in and write out packets to find the problem.

      From Tekla Structures 2017i onwards, while the model is locked, the Read in and Write out icons have yellow arrows. You are the only user who can use these commands.

    3. Inform the administrator when you have identified the problem.
  3. As the administrator, delete the model version that contains problems and unlock the model.
    1. In the Management Console, click the Models button to list the models.
    2. Select the model.
    3. Click the Delete versions button.
    4. Select the version to be deleted.

      If there are newer versions, the Management Console also selects them to be deleted.

    5. To send an email to the users about why you are deleting the version, write a comment.
    6. Click OK to delete.
    7. Click the Unlock button.
    8. To send an email to the users about why you are unlocking the model, write a comment.
    9. Click the Save button.

When versions have been deleted from the model in the Management Console, the Write out and Read in icons are shown with red arrows for any users who have already read in or written out any of the deleted versions. The users must rejoin the model.

When model versions are deleted, the changes that have been made in those versions are lost from the model. You must make the changes that should be included in the model again and read them in.

Was this helpful?