Метод DocFeatureLayer.ShareAsync создает размещенный векторный слой из одного или нескольких допустимых заданных векторных слоев документа. Указанные определения и объекты векторного слоя документа удаляются из чертежа, а полученные в результате объекты в текущей области проекта добавляются к чертежу на соответствующих слоях AutoCAD новых векторных веб-слоев.
Ниже описаны требования к использованию и поведение:
- Пользователь должен войти в указанную организацию и иметь роль с достаточными правами для создания данных.
- Один элемент размещенного векторного слоя, содержащий один или несколько векторных слоев, создается из указанных векторных слоев документа.
- В случае успеха каждый векторный слой документа заменяется векторным веб-слоем из нового размещенного векторного слоя.
- Как и для всех векторных веб-слоев, в сеансе рисования перерисовываются только объекты, включенные в текущую область проекта.
- Результирующая геометрия пространственного объекта ограничена возможностями размещенного векторного слоя, который может изменять геометрию, такую как замощающие кривые.
- Если вы не выполняли вход в организацию, вам понадобится ввести свои имя пользователя и пароль.
Декларация
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)
Параметры
| Тип | Имя | Описание | Обязательный |
|---|---|---|---|
Документ | doc | Документ AutoCAD, на основании которого следует действовать. | Обязательный |
string | serviceName | Имя нового размещенного векторного слоя. Им будет обрезано до 90 символов. | Обязательный |
IEnumerable<string> | flNames | Коллекция имен векторных слоев документа для публикации. | Обязательный |
string | url | URL-адрес организации ArcGIS Online или ArcGIS Enterprise, в которой будет создан элемент размещенного векторного слоя. | Обязательный |
string | sharingSettings | Уровень общего доступа размещенного векторного слоя. Опциями являются "Public", "Private" и "Organization". | Обязательный |
Dictionary<string, object> | hostSettings | Словарь дополнительных опций для ограничения полей и возвращения подходящих значений по умолчанию. В таблице ниже приводится описание ключей и значений. | Дополнительный |
| Ключ | Тип | Описание значения | Обязательный |
|---|---|---|---|
"Tags" | List<string> | Описательные теги для нового векторного слоя в виде списка строк. Если теги не установлены пользователем, тег "ArcGIS for AutoCAD" будет назначен по умолчанию. | Дополнительный |
"Description" | string | Описание вновь создаваемого размещенного векторного слоя. | Дополнительный |
"Folder" | string | Имя папки, в которой будет создан новый размещенный векторный слой. | Дополнительный |
"DisableEditorTracking" | bool | Указывает, будет ли отключено отслеживание изменений в новом векторном слое. По умолчанию – false. | Дополнительный |
"GroupsToShareWith" | List<string> | Имена групп организации, которым будет предоставлен общий доступ. | Дополнительный |
"AddGPSFields" | bool | Определяет, будут ли поля метаданных GPS добавлены в новый векторный слой. По умолчанию – false. | Дополнительный |
"CreateWebFeatureLayerTemplate" | bool | Указывает, будет ли слой AutoCAD, заданный в запросе векторного слоя документа, сохраняться как слой символов на новом созданном векторном веб-слое. Это работает только в том случае, если слой имеет запрос только к слою, и в запросе определен только один слой. По умолчанию – false. | Дополнительный |
"EnableM" | bool | Определяет, будут ли включены m-значения на новом векторном слое. По умолчанию – false. | Дополнительный |
"DefaultZ" | double | Z-значение по умолчанию для новых объектов в приложениях для редактирования, которые не поддерживают редактирование z-значений. Это значение не применяется при редактировании в ArcGIS for AutoCAD, которое поддерживает редактирование z-значений. | Дополнительный |
Возвращаемые значения
| Тип | Описание |
|---|---|
(bool Success, IEnumerable<string> Responses) | Именованный кортеж, в котором первое значение является значением Success, а второе — значением Responses. Значение Success является булевым значением, которое указывает, были ли векторные слои документа успешно опубликованы, и возвращает true в случае частичного успеха. Если Success равно true, значение Responses представляет собой коллекцию, содержащую URL-адрес опубликованного элемента портала в виде строки. Если Success равно false, значение Responses представляет собой коллекцию строковых сообщений об ошибках, включая сообщения об ошибках от портала. |
Замечания по условиям возникновения ошибок
Этот метод может выдать исключение или вернуть null, если параметр является некорректным.
Пример
Напечатайте URL-адрес элемента портала, созданного при публикации векторных слоев документа Utility_Points и Service_Lines в качестве размещенных векторных слоев в новом элементе размещенного векторного слоя с именем 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
*/
См. также
esri_featurelayer_share - Функция AutoLISP, которая создает размещенный векторный слой из одного или нескольких допустимых заданных векторных слоев документа.