El método DocFeatureLayer.ShareAsync 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:
- El usuario 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 no ha iniciado sesión en una organización, se le pedirá que introduzca su nombre de usuario y contraseña.
Declaración
public async Task<(bool Success, IEnumerable<string> Responses)> Esri.ArcGISForAutoCAD.DocFeatureLayer.ShareAsync(Document doc, string serviceName, IEnumerable<string> flNames, string url, string sharingSettings, Dictionary<string, object> hostSettings = null)
Parámetros
| Tipo | Nombre | Descripción | Requerido |
|---|---|---|---|
Documento | doc | Documento de AutoCAD sobre el que se va a actuar. | Requerido |
cadena | serviceName | Nuevo nombre de la capa de entidades alojada. El nombre se truncará a 90 caracteres. | Requerido |
IEnumerable<string> | flNames | Conjunto de los nombres de las capas de entidades de documento que se van a compartir. | Requerido |
cadena | url | URL de la organización de ArcGIS Online o ArcGIS Enterprise donde se creará el elemento de la capa de entidades alojada. | Requerido |
cadena | sharingSettings | Nivel de uso compartido de la capa de entidades alojada. Las opciones son "Public", "Private" y "Organization". | Requerido |
Diccionario<string, object> | hostSettings | Diccionario de ajustes opcionales para limitar los campos y devolver valores predeterminados apropiados. Las claves y los valores se describen en la tabla siguiente. | Opcional |
| Clave | Tipo | Descripción del valor | Requerido |
|---|---|---|---|
"Tags" | Lista<string> | Etiquetas descriptivas de la nueva capa de entidades como lista de cadenas de caracteres. A menos que el usuario configure las etiquetas, se asignará la etiqueta "ArcGIS for AutoCAD" de forma predeterminada. | Opcional |
"Description" | cadena | Descripción de la nueva capa de entidades alojada que se va a crear. | Opcional |
"Folder" | cadena | El nombre de una carpeta donde se creará la nueva capa de entidades alojada. | Opcional |
"DisableEditorTracking" | bool | Especifica si el rastreo del editor se deshabilitará en la nueva capa de entidades. El valor predeterminado es false. | Opcional |
"GroupsToShareWith" | Lista<string> | Nombres de los grupos de la organización con los que se va a compartir. | Opcional |
"AddGPSFields" | bool | Especifica si se agregarán los campos de metadatos GPS en la nueva capa de entidades. El valor predeterminado es false. | Opcional |
"CreateWebFeatureLayerTemplate" | bool | Especifica si la capa AutoCAD configurada en la consulta de capa de entidades de documento se mantendrán como capa de símbolos en la capa de entidades web recién creada. Solo funciona si una capa tiene una consulta exclusiva de capa y la consulta solo tiene definida una capa. El valor predeterminado es false. | Opcional |
"EnableM" | bool | Especifica si los valores m se habilitarán en la nueva capa de entidades. El valor predeterminado es false. | 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 |
Devoluciones
| Tipo | Descripción |
|---|---|
(bool Success, IEnumerable<string> Responses) | Tupla nominal en la que el primer valor es el valor de Success y el segundo es el valor de Responses. El valor de Success es un valor booleano que especifica si las capas de entidades de documento se han compartido correctamente y devolverá true en casos en los que sea parcialmente satisfactorio. Cuando Success es true, el valor de Responses es un conjunto que contiene la URL del elemento del portal publicado como cadena de caracteres. Cuando Success es false, el valor de Responses es un conjunto de mensajes de error de cadena de caracteres, que incluye los mensajes de error del portal. |
Observaciones sobre las condiciones de error
Este método puede generar una excepción o devolver null si un parámetro no es válido.
Ejemplo
Imprima la URL del elemento del portal creada al compartir las capas de entidades de documento Utility_Points y Service_Lines como capas de entidades alojadas en un nuevo elemento de capa de entidades alojada denominado New_Construction. // Initialize
var doc = Application.DocumentManager.MdiActiveDocument;
var serviceName = "New_Construction";
var flNames = new List<string> { "Utility_Points", "Service_Lines" };
var url = "https://arcgis.com/";
var hostSettings = new Dictionary<string, object>
{
{ "Description", "New construction." },
{ "Tags", new List<string> { "Construction", "CADwork" } },
{ "Folder", "CADwork" },
{ "GroupsToShareWith", new List<string> { "Group1", "Group2" } },
{ "CreateWebFeatureLayerTemplate", true },
};
// Share the document feature layers
var success = await Esri.ArcGISForAutoCAD.DocFeatureLayer.ShareAsync(doc, serviceName, flNames, url, "Private", hostSettings);
// Print the portal item url
if (success.Success == true)
{
foreach (var response in success.Responses)
{
doc.Editor.WriteMessage("\nURL: " + response);
}
}
else
{
foreach (var response in success.Responses)
{
doc.Editor.WriteMessage("\nError: " + response);
}
}
/* Example output
URL: https://arcgis.com//home/item.html?id=12345abcde54321abcde12345abcde54
*/
Consulte también
esri_featurelayer_share: función de AutoSLIP que crea una capa de entidades alojada a partir de una o varias capas de entidades de documento especificadas que sean válidas.