Sets the value of a product attribute.
Most attributes cannot be changed once the product is cut. Some attributes which can be set at any time include EXPFLD, ISUDAT and SCAMIN_FILTER.
Input
Parameter | Type | Description |
|---|---|---|
PRODUCTVERSION_ID | NUMBER | The primary key of the product version. |
ACRONYM | VARCHAR2 | The attribute acronym. Common attributes include NAME, VERSION, and PROFILE. PROFILE is the profile name. The SCAMIN_FILTER attribute is not available on Tiled Raster products. S57 Products also include by default ATTFLE, NATFLE, HORDAT, SDATUM, VERDAT, HUNITS, DUNITS, PUNITS, NAVPUR, PRCODE, EDINUM, UPDNUM, COMPSC, DATSET, COMMEN, DSPCMT, ISUDAT. See the catalogue or the product properties on the layout layer for additional attributes. The following can not be changed by this function: product group, usages, product geometry, source extractions - see the other functions in this package. |
VALUE | VARCHAR2 | The new attribute value. NULL to set the value to undefined. The following attributes cannot be set to undefined: COMPSC, EDINUM, NAME, VERSION, PROFILE. For the ISUDAT attribute use NULL or "On export" to set the issue date on export. Otherwise ISUDAT must be in YYYYMMDD format. The SCAMIN_FILTER attribute is a number. |
Example
exec p_vectorapi.SET_PRODUCT_ATTRIBUTE(&productversion_id, 'NAME', 'New name'); |
Exceptions
• Product version ID '%id%' does not exist.
• Product version %% has already been cut and can not be updated.
• Product %id% is %status% and can not be modified.
• Product version %id% has already been cut and can not be updated.
• Cannot apply changes because the product is currently being edited by %user%. Please try again later.
• Profile name '%value%' is invalid or does not currently exist.
• Attribute '%acronym%' is not an attribute of product version '%id%'.
• List attributes are not supported.
• Attribute '%ACRONYM%' must be in YYYYMMDD format.