Lock models and delete model versions in the Management Console

Tekla Structures
Modificado: 4 Mar 2025
Not version-specific
Tekla Structures

Lock models and delete model versions in the Management Console

In the Management Console, you can lock models for investigation and delete versions from models to resolve issues with changes in the model.

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.

After locking the model, you can select a lock owner to investigate the model. While the model is locked, only the lock owner can read in and write out packets.

After investigating the problem, you can delete or unlock the model.

By default, models are locked automatically if malware is detected. For more information, see Manage a model where malware was detected.

  1. In the navigation pane of the Management Console for Tekla Model Sharing, click Models to list all your organization's shared models.
  2. Click the icon on the model's row.

    The Lock/Unlock model dialog opens.

  3. In the Lock Comment box, add a comment about why you are locking the model.
  4. To inform users that the model has been locked, select Send email to users.
  5. Select one user as the lock owner.

    The lock owner is responsible for investigating the model to find the problem. This user is the only user who can read in and write out packets while the model is locked.

  6. Click Lock.

    Locking the model changes the availability of the sharing commands in Tekla Model Sharing:

    • 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 lock comment 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, 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.

  7. To close the dialog, click Close.

Next, the lock owner investigates the model.

Delete a model version

Only an administrator can delete a model version. Before an administrator deletes a model version, the lock owner usually investigates the model to identify which version caused the problem.

When you delete a model version, the shared model reverts to the version before the one that you deleted. If there are newer versions than the one that you deleted, the newer versions are also deleted.

Warning:

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.

  1. In the navigation pane of the Management Console for Tekla Model Sharing, click Models to list all of your organization's shared models.
  2. In the Versions column for the model, click the icon.
  3. Select one or more versions to delete.
  4. In the Add Comment box, add a comment about why you are deleting the versions.
  5. To inform users that the versions have been deleted, select Send email to users.
  6. Click Delete versions.
  7. To close the dialog, click Close.

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 no users are using any of the deleted versions, the users do not need to rejoin.

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 by unlocking the model.

After you have deleted the model versions, unlock the model.

Unlock a model

To allow users to read in and write out changes in the shared model again, unlock the model.

  1. In the navigation pane of the Management Console for Tekla Model Sharing, click Models to list all of your organization's shared models.
  2. Click the icon on the model's row.

    The Lock/Unlock model dialog opens.

  3. In the Lock Comment box, add a comment about why you are unlocking the model.
  4. To inform users that the model has been unlocked, select Send email to users.
  5. Click Unlock.
  6. To close the dialog, click Close.

Users can now read in and write out changes in the shared model.

Manage a model where malware was detected

All new data that has been uploaded for baselines and update packets written out using Tekla Structures is scanned for malware in the Management Console for Tekla Model Sharing. If possible malware is detected, a notification is shown on the Malware scanning tab of the Notifications page. By default, the model is automatically locked, unless you have turned off the Lock model when malware is detected setting.

Both read-ins and write-outs are prevented for the model until you, as the administrator, unlock the model.
Note:

There can be a delay in scanning a new model for malware. Some users might have already downloaded the content before the scanning was done.

  1. If the model in which possible malware was found has not been automatically locked, lock it by following the steps in Lock a model for investigation.
  2. Investigate the finding:
    1. Go to the Malware scanning tab on the Notifications page.

      The model in which possible malware was found has the status Infected.

    2. Click the link to the model to view it.
  3. Take action:
    • If the model does not contain malware, unlock the model by following the steps in Unlock a model.
    • If the model contains malware, delete the infected version of the model by following the steps in Delete a model version.
      Note: Make sure that the local copies of the model on the users' workstations and the malware itself are also removed.

      The users of the shared model must rejoin the model.

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 revert to the last valid version.

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

When the lock owner finds the model version that causes problems, the administrator deletes the model version in the Management Console for Tekla Model Sharing to restore an earlier version of the model. After the versions have been deleted, the administrator unlocks the model.

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

  1. As the administrator, lock the model and select a user as the lock owner.
    1. Sign in to the Management Console for Tekla Model Sharing using a Trimble Identity with administrator rights.
    2. In the navigation pane, click Models to list all of your organization's shared models.
    3. Click the icon on the model's row.

      The Lock/Unlock model dialog opens.

    4. In the Lock Comment box, add a comment about why you are locking the model.

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

    5. Select one user as the lock owner.

      The lock owner is responsible for investigating the model to find the problem. This user is the only user who can read in and write out packets while the model is locked.

    6. Click Lock.
    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.
    3. When you have identified the problem, inform the administrator which model version to delete.
  3. As the administrator, delete the model version that caused the problems.
    1. In the navigation pane of the Management Console for Tekla Model Sharing, click Models to list all of your organization's shared models.
    2. In the Versions column for the model, click the icon.
    3. Select one or more versions to delete.
    4. In the Add Comment box, add a comment about why you are deleting the versions.
    5. Click Delete versions.
  4. As the administrator, unlock the model.
    1. Click the icon on the model's row.

      The Lock/Unlock model dialog opens.

    2. In the Lock Comment box, add a comment about why you are unlocking the model.
    3. Click Unlock.
  5. As a user of the shared model, rejoin the model if you have already read in or written out any of the deleted versions.

    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.

Esta informação foi útil?
Anterior
Seguinte