Skip To Content

esri_webfeaturelayer_set (AutoLISP)

Updates the properties of the specified web feature layer.

Syntax

(esri_webfeaturelayer_set flname subtype service_properties)

Arguments

  • flname | string | required | An existing web feature layer name in the drawing.
  • subtype | string | optional | An existing subtype name defined for the feature layer, or empty string, "", for all subtypes or if there are no subtypes.
  • service_properties | associated list | required | An associated list of web feature layer properties as dotted pairs as defined in the following table:

    Associated labelValue typeValue descriptionRequired or optional
    "BRANCH"

    String

    Name of the affected editing branch.

    optional

    "CADLAYER"

    String

    Name of the AutoCAD layer to override the default layer name when tracking features of a web feature layer.

    optional

    "DEFINITIONEXPRESSION"

    String

    WHERE clause expression to limit features from the layer by attribute values. The syntax of the WHERE clause is determined by the source data.

    optional

    "DESCRIPTION"

    String

    The block name if the type is {Block Reference, or a description if the type is AECC_COGO_POINT}.

    optional

    "EDITMODE"

    Integer

    The editing option. {1=edit, 0=no edit}.

    optional

    "SAVEASTEMPLATE"

    String

    Valid value: {Local}.

    optional

    "TYPE"

    String

    The default element type of {POINT, Block Reference, or AECC_COGO_POINT}.

    optional

Example usage 1

Attempt to set the web feature layer editing properties for the editor01.sampleBranch branch of the Damage_to_Commercial_Buildings web feature layer to read-only

(esri_webfeaturelayer_set "Damage_to_Commercial_Buildings" ""
  (list
  (cons "EDITMODE" 0)
  (cons "BRANCH" "editor01.sampleBranch") 
  )
)

Result example usage 1

Sets the web feature layer editing properties for the editor01.sampleBranch branch of the Damage_to_Commercial_Buildings web feature layer to read-only, and returns a list of true:

(T)

Example usage 2

Attempt to set the default AutoCAD layer name to track features of the Commercial subtype of the Olympia_Meters web feature layer to the AutoCAD layer AB-METERS-EX to override the default layer.

(esri_webfeaturelayer_set "Olympia_Meters" "Commercial"
  (list
  (cons "CADLAYER" "AB-METERS-EX")
  )
)

Result example usage

Sets the web feature layer editing properties for the Commercial subtype of the Olympia_Meters web feature layer to an editing mode of read-only and return a list of true:

(T)

Return values

  • If successful the function returns a list of true: (T)
  • If failed, returns a list with the first value of nil and then an associated list containing the key value "Error" and an associated error message as a string: (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 is not supplied.

  • (nil ("Error" . "Web feature layer not found."))

    The specified web feature layer value is not a valid web feature layer in the drawing.