esri_featurelayer_selectspecial returns an AutoCAD selection set from a specified feature layer based on a special criteria. This function is useful for quality assurance and compliance checking before synchronizing web feature layers or to find entities based on various editing and data states when working with feature layers.
The special search criteria include the following:
- FlaggedAsModified—AutoCAD entities that qualify as features of the specified web feature layer and that have their editing state flagged as modified.
- FlaggedAsNew—AutoCAD entities that qualify as features of the specified web feature layer and that have their editing state flagged as a new feature.
- IncorrectGeometry—AutoCAD entities that would qualify as features because of the AutoCAD layer they reside on but that are not considered features because they are of the wrong geometric type. An example is polylines that are drawn on an AutoCAD layer of ArcGIS point features.
- OutsideProjectArea—AutoCAD entities that qualify as features of the specified feature layer and that are outside the current project area boundary.
- ProxyObjectPresent—AutoCAD proxy entities that are used to represent custom object geometry, such as COGO points outside AutoCAD Civil 3D, or when no object enabler is present.
- UnclosedPolylines—AutoCAD polyline entities that would qualify as polygon features but the polyline closed flag is not set on the entity.
Syntax
(esri_featurelayer_selectspecial flname select_settings)
Arguments
- flname | string | required |—An existing web feature layer or document feature layer name in the drawing
- select_settings | associated list | required |—An associated list of select settings
| Associated label | Value type | Value description | Required or optional |
|---|---|---|---|
| "CRITERIA" | string | Search criteria: "UnclosedPolyline", "IncorrectGeometry", "ProxyObjectPresent" Web feature layer only options: "FlaggedAsModified" , "FlaggedAsNew", "OutsideProjectArea" | Required |
| "SUBTYPE" | string | Subtype name as a string. Use empty string "" to include all subtypes. | Optional |
Example usage 1
Create a selection set of all the entities that belong to the shelters feature layer that are outside the project area of the current drawing:(esri_featurelayer_selectspecial "shelters"
(list (cons "CRITERIA" "OutsideProjectArea"))
)
Result example usage 1
A selection set of all of the entities that belong to the shelters feature layer that are outside the project area of the current drawing:
<Selection set: 9f>Example usage 2
Create a selection set all of the entities that belong to the Public subtype of the Roads web feature layer that are considered by ArcGIS for AutoCAD to have been modified before synchronizing in the current drawing:(esri_featurelayer_selectspecial "Roads"
(list (cons "CRITERIA" "FlaggedAsModified")(cons "Subtype" "Public"))
)
Result example usage 2
Returns a selection set of all the entities that belong to the Public subtype of the Roads web feature layer that are considered by ArcGIS for AutoCAD to have been modified before synchronizing in the current drawing:
<Selection set: d0>Return values
The following are possible return values:
- If successful, an AutoCAD selection set object is returned.
- If failed, a list with the first value of nil, an associated list containing the key value "Error", and an associated error message as a string are returned: (nil ("Error" . "<message>"))
Failed return values
A failed return value can occur for any of the following reasons:
- (nil ("Error" . "Missing required
argument."))
One or more of the required arguments was not supplied.
- (nil ("Error" . "No feature layer specified."))
The required feature layer value was not valid or is missing.
- (nil ("Error" . "Subtype name does not exist."))
The required subtype name was not valid or is missing.