CARIS HPD : HPD Server API : Paper Product Data : P_PPRAPI : ALLOWSPECIFICCPSUPDATE
 

ALLOWSPECIFICCPSUPDATE

This API limits a paper panel so it only sees updates from source for the specified features. When the command "Compare Product to Source" is run in the editor, a message is reported in the output window when the product is limited in this manner, and the layer name is prefixed with a "( ! ". This applies to all versions of the product, including future versions, but not new editions. ALLOWALLCPSUPDATES clears this list.

Specifying the same foid more than once does not trigger an exception, and is ignored.

Input

Parameter

Type

Description

p_panelver_id

NUMBER

The panel version ID

p_foid

NUMBER

The feature object identifier (FOID) as a number, of the update which is allowed to be updated from source. See FOID Conversion Functions.

Example

DECLARE

    CURSOR c_UWTROCs IS

    select distinct foid from SRC_FEATURE_VERSIONS where objectclass_id in (

        select objectclass_id from OBJECTCLASS_VW where acronym = 'UWTROC');

    v_panel_id            CONSTANT PANEL.PANEL_ID%TYPE := 1;

BEGIN

    P_PPRAPI.allowAllCPSUpdates(v_panel_id); -- Clear any previously listed features

    -- Only allow "Compare Product to Source" to see changes to UWTROCs.

    FOR REC IN c_UWTROCs LOOP

        P_PPRAPI.allowSpecificCPSUpdate(v_panel_id, REC.foid);

    END LOOP;

END;

/

Exceptions

Panel version identifier '<panelver_id>' is invalid or does not currently exist.

FOID cannot be NULL.

FOID '<FOID>' does not exist.