La méthode DocFeatureLayer.ShareAsync crée une couche d’entités hébergée à partir d’une ou de plusieurs couches d’entités de document spécifiées valides. Les définitions et les entités des couches d’entités de document spécifiées sont supprimées du dessin, et les entités résultantes dans la zone du projet en cours sont ajoutées au dessin, dans les couches AutoCAD appropriées des nouvelles couches d’entités Web.
Voici les exigences et les comportements d'utilisation :
- L'utilisateur doit être connecté à l'organisation spécifiée et disposer d’un rôle utilisateur permettant de créer ou de publier des données.
- Un seul élément de couche d'entités hébergée contenant une ou plusieurs couches d'entités est créé à partir des couches d'entités de document spécifiées.
- En cas de réussite, chaque couche d’entités de document est remplacée par une couche d’entités Web de la nouvelle couche d’entités hébergée.
- Comme avec toutes les couches d’entités Web, seules les objets entités compris dans la zone du projet en cours sont redessinés dans la session de dessin.
- La géométrie des entités résultantes est limitée en fonction des capacités de la couche d’entités hébergée, qui peut altérer les géométries telles que les courbes de tessellation.
- Si vous n’êtes pas connecté à une organisation, vous êtes invité à saisir vos nom d’utilisateur et mot de passe.
Déclaration
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)
Paramètres
| Type | Nom | Description | Requis |
|---|---|---|---|
Document | doc | Document AutoCAD sur lequel intervenir. | Requis |
chaîne | serviceName | Nom de la nouvelle couche d’entités hébergée. Le nom sera tronqué à 90 caractères. | Requis |
IEnumerable<chaîne> | flNames | Ensemble de noms des couches d’entités de document à partager. | Requis |
chaîne | url | URL de l’organisation ArcGIS Online ou ArcGIS Enterprise dans laquelle l’élément de couche d’entités hébergée sera créé. | Requis |
chaîne | sharingSettings | Niveau de partage de la couche d’entités hébergée. Les options sont "Public", "Private" et "Organization". | Requis |
Dictionary<chaîne, objet> | hostSettings | Dictionnaire des paramètres facultatifs pour limiter les champs et renvoyer les valeurs par défaut appropriées. Les clés et valeurs sont décrites dans le tableau ci-dessous. | Facultatif |
| Clé | Type | Description de la valeur | Requis |
|---|---|---|---|
"Tags" | List<chaîne> | Balises descriptives de la nouvelle couche d’entités sous forme d’une liste de chaînes. La balise "ArcGIS for AutoCAD" est affectée par défaut sauf si les balises sont définies par l’utilisateur. | Facultatif |
"Description" | chaîne | Description de la nouvelle couche d’entités hébergée en cours de création. | Facultatif |
"Folder" | chaîne | Nom du dossier dans lequel la nouvelle couche d'entités hébergée sera créée. | Facultatif |
"DisableEditorTracking" | bool | Indique si le suivi de l’éditeur doit être désactivé sur la nouvelle couche d’entités. La valeur par défaut est false. | Facultatif |
"GroupsToShareWith" | List<chaîne> | Noms des groupes de l’organisation avec lesquels effectuer le partage. | Facultatif |
"AddGPSFields" | bool | Indique si les champs de métadonnées GPS sont ajoutés à la nouvelle couche d’entités. La valeur par défaut est false. | Facultatif |
"CreateWebFeatureLayerTemplate" | bool | Indique si la couche AutoCAD définie dans la requête de couche d’entités de document est conservée en tant que couche de symboles sur la couche d’entités qui vient d’être créée. Ce paramètre fonctionne seulement si une couche dispose d’une requête réservée à une couche et si une seule couche est définie pour la requête. La valeur par défaut est false. | Facultatif |
"EnableM" | bool | Indique si les valeurs m sont activées sur la nouvelle couche d’entités. La valeur par défaut est false. | Facultatif |
"DefaultZ" | réel double | Valeur z par défaut des nouvelles entités dans les applications de modification qui ne prennent pas en charge la modification des valeurs z. Cette valeur n’est pas utilisée lors de la modification dans ArcGIS pour AutoCAD, qui prend en charge la modification des valeurs z. | Facultatif |
Retours
| Type | Description |
|---|---|
(bool Success, IEnumerable<chaîne> Responses) | Tuple nommé dans lequel la première valeur correspond à la valeur Success et la deuxième valeur à la valeur Responses. La valeur Success est une valeur booléenne qui indique si les couches d’entités de document ont été partagées. Elle renvoie true en cas de réussite partielle. Lorsque Success a pour valeur true, la valeur Responses correspond à une collection contenant l’URL de l’élément de portail publié sous forme de chaîne. Lorsque Success a pour valeur false, la valeur Responses est une collection de messages d’erreur de type chaîne, messages d’erreur du portal compris. |
Remarques sur les conditions d’erreur
Si un paramètre n’est pas valide, cette méthode peut générer une exception ou renvoyer null.
Exemple
Afficher l’URL de l’élément de portail créé à partir du partage des couches d’entités de document Utility_Points et Service_Lines en tant que couches d’entités hébergées au sein d’un nouvel élément de couche d’entités hébergée nommé 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
*/
Voir aussi
esri_featurelayer_share : fonction AutoLISP qui crée une couche d’entités hébergée à partir d’une ou plusieurs couches d’entités de document spécifiées valides.
Vous avez un commentaire à formuler concernant cette rubrique ?