SmartPlant Markup Plus with Other Applications - SmartPlant Markup Plus - Version 2019 SP 2 (10.00.02.0022) - Help

SmartPlant Markup Plus Help

Language
English
Product
SmartPlant Markup Plus
Search by Category
Help
SmartPlant Foundation / SDx Version
10
SmartPlant Markup Plus Version
10.0 (2019)
Smart Review Version
2020 (15.0)

SmartPlant Markup Plus's unique capabilities make it a useful addition to other application packages. In fact, it is used as the viewing tool with a number of other software applications, including SmartPlant Foundation.

SmartPlant Markup Plus can be opened from directly within SmartPlant Foundation, allowing you to view items from SmartPlant Foundation. In those cases, when you right click on a SmartPlant Foundation item, you will see a slightly different version of the SmartPlant Markup Plus shortcut menu than is typically available. Some features of the SmartPlant Foundation shortcut menu have been added to the Markup menu. These commands are available in SmartPlant Markup Plus only when it is used as a viewing tool from SmartPlant Foundation.

When used in conjunction with other products, a number of features in SmartPlant Markup Plus can or will work differently than when it is used as a stand-alone application. For example, the Lock and Unlock commands available in SmartPlant Markup Plus are used only in conjunction with an external application, as access is determined by user rights provided by that application.

This documentation provides specific notes for commands that are available only when SmartPlant Markup Plus is used with other applications.

Additionally, when SmartPlant Markup Plus is used with another product, security rights defined in that application can determine which fields and dialog boxes in SmartPlant Markup Plus are available to you for viewing and modification. For more information, see Command Variations within SmartPlant Foundation.

Access to SmartPlant Markup Plus within SmartPlant Foundation

Access to certain SmartPlant Markup Plus functionality within SmartPlant Foundation is controlled through SmartPlant Foundation methods and access group definitions. The following client methods are provided for markup security:

  • CreateMarkup

  • UpdateMarkup

  • DeleteMarkup

  • LimitViewMarkup (optional)

  • LockFileMarkups

  • UnlockFileMarkups

  • LockMarkupFile

  • UnlockMarkupFile

  • LockMarkups

  • UnlockMarkups

  • Methods for deleting, locking, and unlocking apply only to supported SmartPlant file formats.

  • The markup methods UpdateMarkup and DeleteMarkup that are delivered with the core document model have the condition IsMarkupUnlockedAndUserInOwningGroup set on them. The method CreateMarkup has no conditions set (that is, it is open for all).

  • When you launch SmartPlant Markup Plus, each markup is tested for access using the UpdateMarkup and DeleteMarkup methods.

CreateMarkup

The CreateMarkup method allows you to specify whether an owning group is required for a markup. You can also specify an initial owning group, if needed.

SHARED Tip If a condition is written for the CreateMarkup method, it should be written so that it can be applied to the file and the document version. For example, to restrict markup creation to working documents, use the following condition: Obj->SPFFileComposition_12->SPFRevisionVersions_21.SPFRevState='WORKING' OR Obj->SPFRevisionVersions_21.SPFRevState='WORKING'.

UpdateMarkup

To modify or consolidate existing markup layers, the layers must be unlocked and you must have access to the UpdateMarkup method. To control who can update a markup layer, set a condition on the UpdateMarkup - Access Group relationship definition. For example:

DocumentView - IsOwner

ENGINEERING - IsInOwningGroup

LimitViewMarkup

You can limit markup viewing by attaching the LimitViewMarkup method to the DocumentView group with the IsMarkupUnlockedAndUserInOwningGroup condition. In this case, users from the DocumentView group can view markups only if they are the owner of the markups or have access to the owning group of the markups.

Without the use of the LimitViewMarkup method, all users can view all markups.

LockFileMarkups

This method locks all the markup layers available for a file, even when the file is not being viewed. This method is available only in the Desktop Client.

UnlockFileMarkups

This method unlocks all the markup layers available for a file, even when the file is not being viewed. This method is available only in the Desktop Client.

LockMarkupFile

This method locks selected markup layers when a file is being viewed in SmartPlant Markup. This method is available in both the Desktop Client and the Web Client.

UnlockMarkupFile

This method unlocks selected markup layers when a file is being viewed in SmartPlant Markup. This method is available in both the Desktop Client and the Web Client.

LockMarkups

This method locks all the markup layers available for all the files related to a document, even when those files are not being viewed. This method is available only in the Desktop Client.

UnlockMarkups

This method unlocks all the markup layers available for all the files related to a document, even when those files are not being viewed. This method is available only in the Desktop Client.