Bei einem Add-in handelt es sich um eine benutzerdefinierte Funktionalität, die von Entwicklern oder Benutzern mit dem ArcGIS Pro SDK 3.1 for .NET entwickelt wird. Add-ins lassen sich nahtlos in ArcGIS Pro integrieren. Häufig wird mit Add-ins die Benutzeroberfläche zur Bereitstellung neuer Werkzeuge angepasst. Diese werden auf der Menüband-Registerkarte Add-in, auf anderen Registerkarten oder in anderen Bereichen der Anwendung (z. B. in benutzerdefinierten Bereichen) angezeigt.
Hinweis:
In ArcGIS Pro 3.0 und höher werden nur Add-ins geladen, die mit ArcGIS Pro SDK 3.0 und höheren Versionen kompiliert wurden. Weitere Informationen finden Sie unter ProConcepts 3.0 Migration Guide.
Bei einem Add-in handelt es sich um eine komprimierte Datei mit der Erweiterung .esriAddInX. Dies ist ein einfacher Dateityp, der per E-Mail gesendet, im Portal heruntergeladen oder wie andere Dateien ausgetauscht werden kann.
Add-ins können mit einem Installationsdienstprogramm in einem lokalen Ordner installiert oder über einen festgelegten bekannten Ordner heruntergeladen werden. Beide Methoden werden in den folgenden Abschnitten beschrieben. Add-ins werden über den Add-in-Manager auf der ArcGIS Pro-Seite Einstellungen angezeigt und gelöscht.
Add-ins stellen eigene Funktionen bereit, können jedoch auch Sicherheitsrisiken mit sich bringen und zu einem instabilen Softwareverhalten führen. Daher ist es wichtig, dass Sie die Quelle eines Add-in kennen und ihr vertrauen.
Wenn Sie eigene Add-ins erstellen möchten, benötigen Sie ArcGIS Pro SDK. Auf der ArcGIS Developer-Website finden Sie Lernprogramme, die Sie bei der Entwicklung Ihres ersten Add-in unterstützen.
Installieren eines Add-in mit dem Installationsdienstprogramm
Wenn Sie ein Add-in mit dem Installationsdienstprogramm installieren, wird das Add-in in das Standardverzeichnis %System Drive%\Users\<username>\Documents\ArcGIS\AddIns\ArcGISPro kopiert. Vor dem Kopieren der Datei wird mit dem Dienstprogramm geprüft, ob sich in dem Verzeichnis nicht bereits eine neuere Version des Add-in befindet.
- Navigieren Sie zum Speicherort einer Add-in-Datei (*.esriAddInX) auf Ihrem Computer oder in einem Netzlaufwerk.
- Doppelklicken Sie auf die Datei, um das Fenster Esri ArcGIS-Add-in-Installationsdienstprogramm aufzurufen.
Lesen Se die Informationen im Fenster des Esri ArcGIS-Add-in-Installationsdienstprogramms.
- Klicken Sie auf Add-in installieren, um fortzufahren.
Das Add-in wird in das Standardverzeichnis kopiert und installiert. Eine Kopie der Datei bleibt in dem Verzeichnis, in dem Sie diese gefunden haben.
- Nachdem Sie ArcGIS Pro geöffnet haben, beenden Sie die Anwendung, und starten Sie sie neu.
Das Add-in kann nun verwendet werden.
Hinweis:
Wenn das Add-in für eine 2.x-Version von ArcGIS Pro geschrieben wurde, wird eine Warnmeldung angezeigt. Wenn Sie daraufhin mit der Installation fortfahren, wird das Add-in in das Standardverzeichnis kopiert, jedoch nicht geladen.
Laden eines Add-in über einen bekannten Ordner
Sie können einen lokalen Ordner oder einen Netzwerkordner als bekannten Speicherort für Add-ins festlegen. Beim Programmstart prüft ArcGIS Pro diesen Ordner und lädt automatisch alle Add-ins, die sich hier befinden.
Durch das Festlegen eines bekannten Ordners in einem Netzlaufwerk können Add-ins ganz bequem von vielen Personen am Arbeitsplatz verwendet werden. Das kann jedoch dazu führen, dass ArcGIS Pro langsamer startet. Wenn Sie einen Netzwerkordner verwenden, sollten Sie einen Unterordner des Stammordners verwenden. Zudem sollte dieser Unterordner nur Add-in-Dateien enthalten.
- Wenn ein Projekt geöffnet ist, klicken Sie auf die Registerkarte Projekt im Menüband. Alternativ können Sie auf der ArcGIS Pro-Startseite auf die Registerkarte Einstellungen
klicken. - Klicken Sie in der Liste der seitlichen Registerkarten auf Add-in-Manager.
- Klicken Sie im Add-in-Manager auf Optionen.
- Klicken Sie auf der Registerkarte Optionen auf Ordner hinzufügen.
- Navigieren Sie im Dialogfeld "Durchsuchen" zu dem Ordner, den Sie als bekannten Ordner festlegen möchten.
- Klicken Sie auf den Ordner, um ihn auszuwählen. Klicken Sie auf OK.
Der vollständige Pfad zum Ordner wird in der Liste der bekannten Ordner angezeigt.
Hinweis:
Die Option ist standardmäßig ausgewählt, damit alle Add-ins im bekannten Ordner geladen werden. Wenn Sie möchten, dass nur von Esri bereitgestellte Add-ins oder nur von einem vertrauenswürdigen Herausgeber digital signierte Add-ins geladen werden, können Sie eine andere Option auswählen.
- Beenden Sie ArcGIS Pro.
- Verwenden Sie den File Explorer, um .esriAddInX-Dateien in den bekannten Ordner im Verzeichnis auf der Festplatte zu kopieren.
- Starten Sie ArcGIS Pro.
Daraufhin werden Add-ins im bekannten Ordner geladen. Der Ordner wird bei jedem Start von ArcGIS Pro auf neu hinzugefügte oder gelöschte Add-ins geprüft.
Tipp:
Wenn Sie einen bekannten Ordner nicht mehr verwenden möchten, klicken Sie zunächst auf den Ordner in der Liste der bekannten Ordner und dann auf Ordner entfernen. Starten Sie ArcGIS Pro erneut.
Anzeigen von Add-ins
Die verfügbaren Add-ins werden im Add-in-Manager angezeigt.
- Wenn ein Projekt geöffnet ist, klicken Sie auf die Registerkarte Projekt im Menüband. Alternativ können Sie auf der ArcGIS Pro-Startseite auf die Registerkarte Einstellungen klicken.
- Klicken Sie in der Liste der seitlichen Registerkarten auf Add-in-Manager.
- Klicken Sie im Add-in-Manager auf der Registerkarte Add-ins auf ein Add-in, um Informationen darüber anzuzeigen.
Löschen eines Add-in
Wenn Sie ein Add-in nicht mehr benötigen, können Sie es löschen. Wenn Sie ein installiertes Add-in löschen, wird es in ArcGIS Pro deinstalliert, und die .esriAddInX-Datei wird in den Papierkorb des Systems verschoben.
Vorsicht:
Wenn Sie ein Add-in, das über einen bekannten Ordner in einem Netzlaufwerk geladen wurde, mit dem Add-in-Manager löschen, wird die .esriAddInX-Datei endgültig gelöscht, so als würden Sie die Datei mit dem File Explorer im Verzeichnis auf der Festplatte löschen.
- Öffnen Sie den Add-in-Manager, und wählen Sie wie in der Beschreibung im Abschnitt Anzeigen von Add-ins weiter oben ein Add-in aus.
- Klicken Sie auf Dieses Add-In löschen.
Das Add-in wird zum Löschen markiert, bleibt in Ihrer aktuellen ArcGIS Pro-Sitzung jedoch verfügbar.
- Beenden Sie ArcGIS Pro, und starten Sie das Programm erneut.
Das Add-in wird deinstalliert und im Add-in-Manager entfernt.
Hinweis:
Add-ins, die im Add-in-Manager unter der Überschrift Freigegebene Add-ins angezeigt werden, können Sie nicht löschen, da diese von Ihrem Softwareadministrator verwaltet werden. Weitere Informationen finden Sie im Abschnitt Verwaltungseinstellungen weiter unten.
Deaktivieren von Add-ins
Wenn sich ArcGIS Pro nicht erwartungsgemäß verhält oder nach der Installation von Add-ins nicht mehr funktioniert, können Sie Add-ins deaktivieren, indem Sie ArcGIS Pro über die Windows-Eingabeaufforderung mit einem bestimmten Parameter starten. Wenn sich die Software nach dem Deaktivieren von Add-ins normal verhält, müssen Sie möglicherweise Add-ins löschen.
Um Add-ins zu deaktivieren, starten Sie ArcGIS Pro mit dem folgenden Befehl über die Befehlszeile:
"%ProgramFiles%\ArcGIS\Pro\bin\ArcGISPro.exe" /disableaddins
Daraufhin werden im Add-in-Manager keine Add-ins mehr angezeigt. Wenn Sie Add-ins wieder aktivieren möchten, beenden Sie ArcGIS Pro ganz normal, und starten Sie die Software erneut.
Verwaltungseinstellungen
Als Softwareadministrator können Sie Änderungen an der Registrierung vornehmen, um zu verhindern, dass Benutzer auf Add-ins zugreifen, bekannte Ordner festlegen und Sicherheitsstufen für Add-ins festlegen.
Erstellen Sie im Windows-Registrierungs-Editor unter HKEY_LOCAL_MACHINE > SOFTWARE > ESRI > ArcGISPro > Settings den Schlüssel Add-in-Ordner, und verwenden Sie Zeichenfolgenwerte zum Festlegen von bekannten Ordnern. Add-in-Dateien in diesen Ordnern werden im Add-in-Manager als freigegebene Add-ins angezeigt. Weitere Informationen zu diesen Registrierungseinstellungen finden Sie unter ArcGIS Pro Registry Keys.