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