CARIS HPD : HPD® Server API : Source Data : P_HPDSOURCEAPI : LINKREPRESENTATIONTOUSAGE
 

LINKREPRESENTATIONTOUSAGE

Assigns a feature to an additional usage. The feature is added to the specified usage with the same spatial representation (geometry) that the v_spatver_id uses. It is set to Under Construction on the new usage.

This function does not handle text features.

Input

Parameter

Type

Description

v_spatver_id

NUMBER

Spatial version ID. This identifies the feature and also the spatial representation to add to the usage.

v_usage_id

NUMBER

The ID of the usage to add the feature to.

v_task_id

NUMBER

The task ID (A new taskID can be obtained by using p_save_manager.AddTask).

Example

Declare

  v_project_id      CONSTANT PROJECT.PJ_ID%TYPE := 10;

  v_spatver_id      CONSTANT HPD_SPATIAL_VERSION.SPATVER_ID%TYPE := 37835;

  v_usage_id        CONSTANT USAGES.USAGES_ID%TYPE := 3;

  v_task_id         tasks.task_id%TYPE;

Begin

  -- Create a new 'save'. All edits are done under the specified project

  -- until a commit or rollback. Edits belong to a 'save'.

  P_SAVE_MANAGER.StartNewSave(v_project_id);

  v_task_id := P_SAVE_MANAGER.AddTask('ADD REPRESENTATION TO USAGE');

  p_hpdsourceapi.linkrepresentationtousage(v_spatver_id, v_usage_id, v_task_id);

End;

/

Exceptions

• Spatial version does not exist

• Usage ID does not exist

• Task ID does not exist

• The feature could not be locked

• The feature is already on that usage

• Text cannot be shared on multiple usages