Mit dieser Funktion wird eine Datei an ein Feature eines Web-Feature-Layers angehängt, von dem Anlagen unterstützt werden, wobei von der Benutzerrolle zumindest die Bearbeitung unterstützt wird. Neue Features müssen synchronisiert werden, bevor Anlagen hinzugefügt werden.
Syntax
(esri_webfeaturelayer_addAttachment flname ename filepath)
Argumente
- flname | Zeichenfolge | erforderlich | Ein vorhandener Web-Feature-Layer-Name in der Zeichnung.
- ename | Objektname | erforderlich | Der AutoCAD-Objektname eines Features zum Hinzufügen einer Anlage.
- filepath | Zeichenfolge | erforderlich | Zieldateipfad für die anzuhängende Datei
Beispiel 1 für die Verwendung
Damit wird der Benutzer aufgefordert, ein Objekt aus einem Web-Feature-Layer mit dem Namen "Damage_to_Residential_Buildings" ausgewählt, und es wird versucht, die Anlagendatei mit dem Namen "C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml" hinzuzufügen.(progn
(setq ename (car (entsel)))
(esri_webfeaturelayer_addAttachment
"Damage_to_Residential_Buildings"
ename
"C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml"
))
Ergebnis des Beispiels 1 für die Verwendung
Die Datei "C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml" wird dem ausgewählten Feature auf dem Server hinzugefügt, und von der Funktion wird Folgendes zurückgegeben:
(T)
Beispiel 2 für die Verwendung
Damit wird der Benutzer aufgefordert, ein Objekt aus einem Web-Feature-Layer mit dem Namen "Shelters" auszuwählen, und es wird versucht, die Anlagendatei mit dem Namen "C:\\CADwork\\Attachments\\LandSurface.xml" hinzuzufügen. Vom Web-Feature-Layer werden Anlagen jedoch nicht unterstützt.(progn
(setq ename (car (entsel)))
(esri_webfeaturelayer_addAttachment
"shelters"
ename
"C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml"
))
Ergebnis des Beispiels 2 für die Verwendung
Die Datei LandSurface.xml wird nicht hinzugefügt, und von der Funktion wird Folgendes zurückgegeben:
(nil ("Error" . "Layer does not support attachments"))
Rückgabewerte
Von dieser Funktion wird ein Wert zurückgegeben.
- Wenn der Vorgang erfolgreich war, wird eine Liste mit dem Wert "true" zurückgegeben: (T).
- Wenn bei dem Vorgang ein Fehler auftritt, wird eine Liste zurückgegeben, in der der erste Wert nil lautet. Anschließend wird eine Assoziationsliste mit dem Schlüsselwert "Error" sowie eine entsprechende Fehlermeldung in Form einer Zeichenfolge zurückgegeben: (nil ( "Error" . "<message>"))
Rückgabewerte mit Fehlern
Ein Rückgabewert mit einem Fehler kann eine der folgenden Ursachen haben:
- (nil ("Error" . "Missing required argument."))
Eines von drei erforderlichen Argumenten wurde nicht angegeben.
- (nil ("Error" . "Web feature layer not found."))
Beim angegebenen Web-Feature-Layer-Wert handelt es sich nicht um einen gültigen Web-Feature-Layer in der Zeichnung.
- (nil ("Error" . "No connected web feature layers found."))
Die Netzwerkverbindung mit dem Web-Feature-Layer wurde unterbrochen.
- (nil ("Error" . "Layer does not support attachments"))
Vom angegebenen Web-Feature-Layer werden Anlagen nicht unterstützt.
- (nil ("Error" . "File not found."))
Die angegebene Datei ist nicht vorhanden.
- (nil ("Error" . "No feature found."))
Bei dem angegebenen Objekt handelt es sich nicht um ein gültiges Feature des angegebenen Web-Feature-Layers.