esri_featurelayer_share (AutoLISP)

La función esri_featurelayer_share crea una capa de entidades alojada a partir de una o varias capas de entidades de documento especificadas que sean válidas. Las definiciones y entidades de la capa de entidades de documento especificadas se eliminan del dibujo y las entidades resultantes del área del proyecto actual se agregan al dibujo en las capas de AutoCAD adecuadas de las nuevas capas de entidades web.

A continuación se indican los requisitos y comportamientos de uso:

• Debe iniciar sesión en la organización especificada y tener el rol de usuario suficiente para crear o publicar datos.
• Se crea un único elemento de capa de entidades alojada que contiene una o varias capas de entidades a partir de las capas de entidades del documento especificadas.
• Si es correcto, cada capa de entidades de documento se sustituye por una capa de entidades web a partir de la nueva capa de entidades alojada.
• Al igual que con todas las capas de entidades web, solo las entidades de entidad incluidas en el área del proyecto actual se vuelven a dibujar en la sesión de dibujo.
• La geometría de entidades resultante se limita a las funcionalidades de la capa de entidades alojada, lo que puede alterar la geometría, por ejemplo, las curvas de teselación.
• Si aún no ha iniciado sesión en una organización, se le pedirá que proporcione su nombre de usuario y contraseña.

Sintaxis

(esri_featurelayer_share sname flnames url [host_settings])

Argumentos

Se incluyen los siguientes argumentos:

• sname | cadena de caracteres | obligatorio | El nuevo nombre de la capa de entidades alojada. El nombre se truncará a 90 caracteres.
• flnames | cadena de caracteres | obligatorio | Una cadena de caracteres separada por comas de los nombres de las capas de entidades de documento que se van a compartir.
• url | cadena de caracteres | obligatorio | La dirección URL de la organización de ArcGIS Online o ArcGIS Enterprise donde se creará el elemento de la capa de entidades alojada.
• host_settings | lista asociada | opcional | Lista de ajustes opcionales como pares de puntos para limitar los campos y devolver valores predeterminados apropiados como están definidos en la tabla siguiente:

  Etiqueta asociada	Tipo de valor	Descripción del valor	Obligatorio u opcional
  "AddGPSFields"	Booleano	Valor true T o false nil que especifica si se agregarán los campos de metadatos GPS en la nueva capa de entidades.	Opcional
  "CreateWebFeatureLayerTemplate"	Booleano	Valor true T o false nil que creará una plantilla de propiedades de capa de entidades en el dibujo para cada capa de entidades de documento que se comparta, siempre que la expresión de consulta de la capa de entidades de documento sea una consulta válida de solo capa (Capa CAD = "Manholes").	Opcional
  "DefaultZ"	Doble	El valor z predeterminado de las nuevas entidades en aplicaciones de edición que no admiten la edición de valores z. Este valor no se aplica al editar en ArcGIS for AutoCAD, lo que admite la edición de valores z.	Opcional
  "Description"	Cadena de caracteres	Una descripción de la nueva capa de entidades alojada que se va a crear.	Opcional
  "DisableEditorTracking"	Booleano	Un valor true T o false nil que especifica si el rastreo del editor se deshabilitará en la nueva capa de entidades.	Opcional
  "EnableM"	Booleano	Valor true T o false nil que especifica si los valores m se habilitarán en la nueva capa de entidades.	Opcional
  "Folder"	Cadena de caracteres	Nombre de la carpeta donde se creará la nueva capa de entidades alojada.	Opcional
  "GroupsToShareWith"	Cadena de caracteres	Una única cadena de caracteres que contiene una lista separada por comas de los nombres de los grupos de la organización con los que compartir.	Opcional
  "ShareWithEveryone"	Booleano	Valor true T o false nil que especifica si la nueva capa de entidades alojada se compartirá con todos.	Opcional
  "ShareWithOrg"	Booleano	Valor true T o false nil que especifica si la nueva capa de entidades se compartirá con miembros de la organización.	Opcional
  "TAGS"	Cadena de caracteres	Una única cadena de caracteres que contiene una lista separada por comas de etiquetas descriptivas para la nueva capa de entidades.	Opcional

Uso de ejemplo

Comparta las capas de entidades de documento Sample_Points y Service_Lines como capas de entidades alojadas en un nuevo elemento de capa de entidades alojada denominado New Construction.

(esri_featurelayer_share "New_Construction" "Sample_Points,Service_Lines" "https://www.arcgis.com"
  (list 
   (cons "Tags" "tag1,tag2")
   (cons "Description" "Owner")
   (cons "Folder" "String")
   (cons "EnableM" nil)
   (cons "ShareWithEveryone" nil)
   (cons "ShareWithOrg" T)
   (cons "DisableEditorTracking" nil)
   (cons "DefaultZ" 0)
   (cons "GroupsToShareWith" "group1,group2")
  )
)

Uso de ejemplo de resultado

Comparta las capas de entidades de documento Sample_Points y Service_Lines como capas de entidades alojadas en un nuevo elemento de capa de entidades alojada denominado New Construction. Se notifican una serie de mensajes de estado en la línea de comandos. Las capas de entidades web se agregan al dibujo, las entidades se vuelven a dibujar dentro del área del proyecto y la función devuelve una lista que contiene la cadena de caracteres de la URL del elemento del portal publicado:

("https://www.arcgis.com/home/item.html? id=b233c9eec046b4b290aca11ad8a3")

Valores de retorno

Los siguientes son los valores de retorno posibles:

• Si todo va bien, la función devuelve una lista que contiene la cadena de caracteres de la URL del elemento del portal publicado.
• Si se produce un error, devuelve una lista con el primer valor de nil y 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 pueden producir valores de retorno fallido por cualquiera de los siguientes motivos:

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

  El valor de la capa de entidades especificada no es una capa de entidades válida en el dibujo.

• (nil ("Error" . "Invalid URL"))

  La URL proporcionada no es válida.

• (nil ("Error" . "Missing required argument."))

  No se ha suministrado uno de los argumentos requeridos.

• (nil ("Error" . "Only unique feature layers can be specified."))

  La misma capa de entidades de documento se incluye más de una vez.

• (nil ("Error" . "User does not have the sufficient capabilities to share as a Web Feature Layer."))

  No tiene los permisos adecuados. La cuenta de organización debe tener al menos un rol de publicador.

• (nil ("Error" . "Service name is invalid or already exists."))

  El nombre de servicio proporcionado no es válido o ya existe.

• (nil ("Error" . "Incorrect user name or password."))

  La URL de ArcGIS Online o ArcGIS Enterprise no estaba disponible a través de la web.

• (nil ("Error" . "An error occured"))

  Con la conexión y publicación se detectaron varios problemas posibles.

• (nil ("Error" . "No coordinate system set"))

  Debe tener asignado un sistema de coordenadas para el dibujo.

• (nil ("Error" . "One or more layers were not shareable."))

  Una o varias de las capas especificadas no se pueden compartir. Por ejemplo, si son de anotación o multiparche, las entidades no se pueden abrir (capa AutoCAD bloqueada).