La función esri_webfeaturelayer_createBranch crea la versión en rama de una capa de entidades web para la capa de entidades web especificada.
Sintaxis
(esri_webfeaturelayer_createBranch flname branchName branchInfo)
Argumentos
- flname | cadena de caracteres | obligatorio | El nombre de una capa de entidades web existente en el dibujo.
- branchName | cadena de caracteres | obligatorio | Nombre que se utilizará para la nueva versión en rama.
- branchInfo | Lista asociada | obligatorio | Información de versión en rama que se aplicará a la capa de entidades web flname como una lista asociada de pares con puntos, como sigue:
| Etiqueta asociada | Tipo de valor | Descripción del valor | Obligatorio u opcional |
|---|---|---|---|
| "DESCRIPTION" | cadena | Texto de descripción proporcionado por el creador de la versión en rama, con límite de 64 caracteres. | Opcional |
| "ACCESS" | cadena | El nivel de acceso de la versión en rama. Las opciones son "Public", "Private" y "Protected". | Requerido |
Uso de ejemplo
Intente crear una nueva versión en rama denominada SouthwestProposal para la capa de entidades web Damage_to_Commercial_Buildings.(esri_webfeaturelayer_createBranch "Damage_to_Commercial_Buildings" "SouthwestProposal"
(list
(cons "DESCRIPTION" "proposed changes")
(cons "ACCESS" "Public")
)
)
Uso de ejemplo de resultado
Crea una nueva versión en rama denominada SouthwestProposal para la capa de entidades web Damage_to_Commercial_Buildings y devuelve el nombre de rama:
("SouthwestProposal")Valores de retorno
Los siguientes son los valores de retorno posibles:
- Si todo va bien, la función devuelve una lista que contiene el nombre de versión en rama como una cadena de caracteres.
- Si se produce un error, devuelve una lista con el primer valor de nil y, a continuación, se devuelve una lista asociada que contiene el valor de clave "Error" y un mensaje de error asociado como cadena de caracteres: (nil ( "Error" . "<message>")).
Valores de retorno fallido
Se puede producir un valor de retorno fallido por cualquiera de los siguientes motivos:
- (nil ("Error" . "Missing required argument."))
No se proporcionó el argumento requerido.
- (nil ("Error" . "Service error encountered."))
Ha ocurrido un error al conectarse al servicio web.
- (nil ("Error" . "Layer does not support branch versions.")
La capa especificada no es compatible con las versiones en rama.
- (nil ("Error" . "Unable to retrieve properties from the branch version.")
Se han utilizado valores no válidos o ha ocurrido algún otro error de conexión.
- (nil ("Error" . "No connected web feature layers found.")
Se perdió la conexión de red a la capa de entidades web.
- (nil ("Error" . " Failed.")
Es posible que el nombre de rama ya exista.