Die Methode DocFeatureLayer.ShareAsync erstellt einen gehosteten Feature-Layer aus einem oder mehreren gültigen angegebenen Dokument-Feature-Layern. Die Definitionen und Features des angegebenen Dokument-Feature-Layers werden aus der Zeichnung entfernt, und die resultierenden Features im aktuellen Projektbereich werden auf den geeigneten AutoCAD-Layern des neuen Web-Feature-Layers zur Zeichnung hinzugefügt.
Im Folgenden sind die Verwendungsanforderungen und Verhaltensweisen aufgeführt:
- Der Benutzer muss bei der angegebenen Organisation angemeldet sein und über die geeignete Benutzerrolle zum Erstellen oder Veröffentlichen von Daten verfügen.
- Ein einzelnes gehostetes Feature-Layer-Element, das mindestens einen Feature-Layer enthält, wird aus dem angegebenen Dokument-Feature-Layer erstellt.
- Bei erfolgreicher Ausführung wird jeder Dokument-Feature-Layer durch einen Web-Feature-Layer aus dem neuen gehosteten Feature-Layer ersetzt.
- Wie bei allen Web-Feature-Layern werden nur Feature-Objekte, die zum aktuellen Projektbereich gehören, in der Zeichnungssitzung neu dargestellt.
- Die resultierende Feature-Geometrie ist auf die Funktionen des gehosteten Feature-Layers begrenzt. Dadurch kann die Geometrie z. B. durch mosaikierte Kurven geändert werden.
- Wenn Sie nicht bei einer Organisation angemeldet sind, werden Sie aufgefordert, Ihren Benutzernamen und Ihr Kennwort einzugeben.
Deklaration
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)
Parameter
| Typ | Name | Beschreibung | Erforderlich |
|---|---|---|---|
Dokument | doc | Das AutoCAD-Dokument, das bearbeitet werden soll. | Erforderlich |
Zeichenfolge | serviceName | Der Name des neuen gehosteten Feature-Layers. Der Name wird auf 90 Zeichen gekürzt. | Erforderlich |
IEnumerable<Zeichenfolge> | flNames | Eine Sammlung der Dokument-Feature-Layer-Namen, die freigegeben werden sollen. | Erforderlich |
Zeichenfolge | url | Die URL der ArcGIS Online- oder ArcGIS Enterprise-Organisation, in der das gehostete Feature-Layer-Element erstellt wird. | Erforderlich |
Zeichenfolge | sharingSettings | Die Freigabeebene des gehosteten Feature-Layers. Die Optionen lauten "Public", "Private" und "Organization". | Erforderlich |
Dictionary<Zeichenfolge, Objekt> | hostSettings | Ein Wörterbuch der optionalen Einstellungen, um die Felder zu begrenzen und geeignete Standardwerte zurückzugeben. Die Schlüssel und Werte werden in der folgenden Tabelle näher beschrieben. | Optional |
| Schlüssel | Typ | Wertbeschreibung | Erforderlich |
|---|---|---|---|
"Tags" | List<Zeichenfolge> | Beschreibende Tags für den neuen Feature-Layer in Form einer Liste von Zeichenfolgen. Wenn keine Tags vom Benutzer festgelegt werden, wird standardmäßig das "ArcGIS for AutoCAD"-Tag zugewiesen. | Optional |
"Description" | string | Die Beschreibung des neuen gehosteten Feature-Layers, der erstellt wird. | Optional |
"Folder" | string | Der Name des Ordners, in dem der neue gehostete Feature-Layer erstellt wird. | Optional |
"DisableEditorTracking" | Boolesch | Gibt an, ob das Editor-Tracking für den neuen Feature-Layer deaktiviert wird. Die Standardeinstellung ist false. | Optional |
"GroupsToShareWith" | List<Zeichenfolge> | Die Namen der Gruppen der Organisation, für die die Freigabe erfolgen soll. | Optional |
"AddGPSFields" | Boolesch | Gibt an, ob GPS-Metadatenfelder zum neuen Feature-Layer hinzugefügt werden. Die Standardeinstellung ist false. | Optional |
"CreateWebFeatureLayerTemplate" | Boolesch | Gibt an, ob der in der Abfrage des Dokument-Feature-Layers festgelegte AutoCAD-Layer als Symbol-Layer im neu erstellten Web-Feature-Layer beibehalten wird. Dies ist nur möglich, wenn ein Layer über eine Layer-spezifische Abfrage verfügt und für die Abfrage nur ein Layer definiert ist. Die Standardeinstellung ist false. | Optional |
"EnableM" | Boolesch | Gibt an, ob M-Werte für den neuen Feature-Layer aktiviert werden. Die Standardeinstellung ist false. | Optional |
"DefaultZ" | Double | Der standardmäßige Z-Wert für neue Features in Bearbeitungsanwendungen, die die Bearbeitung von Z-Werten nicht unterstützen. Dieser Wert gilt bei der Bearbeitung in ArcGIS for AutoCAD nicht, da hier die Bearbeitung von Z-Werten unterstützt wird. | Optional |
Rückgaben
| Typ | Beschreibung |
|---|---|
(bool Success, IEnumerable<Zeichenfolge> Responses) | Ein benanntes Tupel, bei dem der erste Wert der Success-Wert und der zweite Wert der Responses-Wert ist. Der Success-Wert ist ein boolescher Wert, der angibt, ob die Dokument-Feature-Layer erfolgreich freigegeben wurden, und bei teilweisem Erfolg true zurückgibt. Wenn Success gleich true ist, ist der Responses-Wert eine Sammlung, die die URL des veröffentlichten Portalelements als Zeichenfolge enthält. Wenn Success gleich false ist, ist der Responses-Wert eine Sammlung von Fehlermeldungen in Form von Zeichenfolgen, einschließlich Fehlermeldungen aus dem Portal. |
Anmerkungen zur Fehlermeldung
Diese Methode kann eine Ausnahme auslösen oder null zurückgeben, wenn ein Parameter ungültig ist.
Beispiel
Ausgeben der URL eines Portalelements, das durch die Freigabe der Dokument-Feature-Layer Utility_Points und Service_Lines als gehostete Feature-Layer innerhalb eines neuen gehosteten Feature-Layer-Elements namens New_Construction erstellt wurde. // 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
*/
Weitere Informationen
esri_featurelayer_share: Eine AutoLISP-Funktion, die einen gehosteten Feature-Layer aus einem oder mehreren gültigen angegebenen Dokument-Feature-Layern erstellt.