Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

Introduction

Any object, including documents, can be shared by via a link. The This link contains information about the user interface configuration that is needed required to display the desired object. 

Sharing by link can be used only via a link is only possible between users that have with similar set sets of access rights . It and does not allow to bypass bypassing security in any way.

User that is The user receiving the link needs must have at least view rights to for the given object and and context objects that are needed necessary to properly correctly display the target object.

Automatic

...

Link Creation

Links can be automatically created generated and copied using the context menu function. Right Simply right-click on an object that you would like to share, then select Share → Share → Copy Link function as shown on in the image below:

...

A link will be placed in your system clipboard, similar to this one:

http://server/client/?Navigate=1&OID=5153&CID=107&VID=tree&TPID=8&GPID=10

The link, when usedclicked, will open the user interface and require prompt for login if needednecessary. You might can copy objects from either the tree or grid view. A different result will be obtained if However, copying a Room is copied from the tree (it will also be shown in tree) or from gridwill result in it being displayed in the tree as well.

In the second casecontrast, if you copy a Room from the grid view and that Room has a spot location on some a drawing, that specific drawing will also be loaded, and the specific Room will be indicated. load with the corresponding Room highlighted.


Links with Version

Additional An additional option on the menu allows the creation of links with a version ID.  As a result user will This enables users to be directed to this a specific version instead a of the default system version.   This might feature can be particularly useful when sharing an object from within a Draft or we require when access to a specific version in the past is required. 

If the version ID is not set (as in a standard link) a , the system will try attempt to locate the object in the current system version and . However, this operation might may fail if the object only exists in a Draft. 

(warning) Note Note: remember Remember to share a Draft with a user first; otherwise, otherwise they will not be able to access it.

Manual

...

Links Creation

It's possible to create links manually or by an using external software. Links These links can also use utilize an external ID , known to that is specific to a particular system. In that case a this scenario, both the domain ID and external ID must be passedprovided.

The ID system will be automatically translated translate the ID into an internal system ID, and the object will be shown displayed as usual. Parameters The parameters that can be used are listed in the table below:

...

#

Parameter

Abbr

Required

Description

1

Navigate


*

Base parameter indicating whether navigation to target object should be performed (set to Navigate=1)

2

ObjectId

OID

*

Object id, either internal or external

3

ClassId 

CID

*

Object classId (internal)

4

ClassName 

CN

*

External class name (To be used with a Domain config)

5

Domain 

DN


Doamin id, when given, objectId and classId is considered to be external. Translation is performed automatically.

6

TreePsetId 

TPID


Perspectiveset that should be used to show this object in Tree View.

7

GridPsetId

GPID


Perspective set that should be used to show this object in Grid View.

8

ViewId 

VID


Preferred view ID, mainly used by links generated by HDC.

Determines preferred target view (grid or tree) to be used to show object (e.g. Room can be seen both in tree and grid).

Available values: tree, grid

9


ContextId

CTID


Additional context object that can be used while navigating. This object will be selected in a TreeView when main object is selected in GridView.

In another words, this object will be used as a parent in TreeView, if there are multiple parents available

This parameter is mostly used by system generated URLs

10

ContextClass

CCLS


Class ID if the context object.

11

Version

VER


Version ID

12

Alternative

ALT


Alternative ID

...