Das Hinzufügen einer URL-Referenz zu einer vorhandenen App ist eine effektive Möglichkeit, Ihre Arbeit für Mitglieder Ihrer Organisation und die Öffentlichkeit freizugeben (je nach Freigabeberechtigungen). Neben der URL können Sie auch andere Details wie den Typ der App, deren Zweck, eine Zusammenfassung und eine Beschreibung sowie eine .zip-Datei mit dem Code hinzufügen, den Sie zum Erstellen der App verwendet haben. Wenn in ArcGIS Online eine App hinzugefügt wird, wird nur ein Verweis zur App-URL hinzugefügt. ArcGIS Online speichert keine App-Dateien.
Als Entwickler mit einem Organisationskonto können Sie außerdem Apps bei der Plattform registrieren. Dabei wird eine OAuth-Anwendung registriert, sodass Organisationsmitglieder und Benutzer außerhalb der Organisation sich bei der App anmelden können. Weitere Informationen finden Sie weiter unten im Abschnitt Hinzufügen und Registrieren einer App mit Entwickleranmeldeinformationen.
Wenn Sie die App nicht registrieren müssen, beispielsweise beim Hochladen eines Codebeispiels, führen Sie die Schritte im Abschnitt Hinzufügen einer App über eine URL weiter unten aus.
Tipp:
Eine andere Möglichkeit der Freigabe von Anwendungen für Mitglieder Ihrer Organisation und die Öffentlichkeit besteht darin, Anwendungen mit Karten und Galerieanwendungen mit Gruppen zu erstellen.
Hinzufügen einer App über eine URL
Führen Sie diese Schritte aus, um ein Element hinzuzufügen, das eine URL für den Zugriff auf eine Web-App verwendet, aber nicht registriert werden muss (z. B. Codebeispiele):
Hinweis:
Zum Hinzufügen einer registrierten App führen Sie die Schritte zum Hinzufügen und Registrieren einer App mit Entwickleranmeldeinformationen aus.
- Überprüfen Sie, ob Sie angemeldet sind und über die Berechtigung zum Erstellen von Inhalten verfügen.
- Klicken Sie auf der Registerkarte Eigene Inhalte der Inhaltsseite auf Neues Element, und klicken Sie auf Anwendung.
- Wählen Sie den App-Typ aus:
- Web Mapping: Eine Web-App, die mit einer Web-API wie JavaScript erstellt wurde.
- Desktop: Eine App für Desktops, die auf einer Desktop-Plattform wie Java oder .NET (Microsoft Windows Desktop) entwickelt wurde.
- Mobil: Eine herunterladbare App, mit einem SDK für Mobilgeräte erstellt, z. B. für iOS oder Android.
- Sonstige Anwendung: Eine Desktop-Anwendung, ein Python-Skript oder ein beliebiger Typ von generischer App ohne Details zum Zweck, zur API, zum SDK oder zur URL-Adresse.
- Für Web Mapping, Desktop oder Mobil geben Sie die URL der Anwendung ein, beispielsweise https://<myServer>/myWebMapApp.
- Für Desktop-Apps klicken Sie auf Durchsuchen und wählen die .zip-Datei aus, die die App enthält.
- Klicken Sie auf Weiter.
- Geben Sie einen Titel ein.
- Wählen Sie den Ordner unter Eigene Inhalte aus, in dem Sie das Element speichern möchten.
- Wenn in Ihrer Organisation Inhaltskategorien eingerichtet wurden, klicken Sie auf Kategorien zuweisen, und wählen Sie bis zu 20 Kategorien aus, damit andere das Element finden können.
Sie können auch mit der Eingabe eines Kategorienamens beginnen, um die Liste der Kategorien einzugrenzen.
- Geben Sie optional Tags zur Beschreibung des Elements ein.
Trennen Sie Begriffe durch Kommas (z. B. Bund Land wird als ein Tag; Bund, Land hingegen als zwei Tags betrachtet).
Während der Eingabe können Sie alle vorgeschlagenen Tags auswählen, die angezeigt werden. Vorschläge werden aus Tags erstellt, die Sie zuvor hinzugefügt haben.
- Fügen Sie optional eine aussagekräftige Zusammenfassung für die App ein.
- Klicken Sie auf Speichern.
Nach dem Hinzufügen der App wird sie unter "Eigene Inhalte" angezeigt. Wenn Sie die App zu einem späteren Zeitpunkt registrieren müssen, können Sie dazu die Registerkarte Einstellungen der Elementseite der App verwenden. Weitere Informationen finden Sie weiter unten im Abschnitt Hinzufügen und Registrieren einer App mit Entwickleranmeldeinformationen.
Sie können die Elementdetails konfigurieren, bei Bedarf Code hinzufügen und die App freigeben, wenn Sie über Berechtigungen zum Freigeben verfügen.
Hinzufügen und Registrieren einer App mit Entwickleranmeldeinformationen
Als Entwickler mit einem Organisationskonto können Sie Ihre App hinzufügen und bei der Plattform registrieren, um eine App-ID zu generieren. Verwenden Sie die App-ID in der App, um Nutzungsstatistiken zu erfassen und Benutzern die Anmeldung mit OAuth 2.0, einer standardisierten Autorisierungsumgebung, zu erlauben. Mit OAuth 2.0 führen Apps den Benutzer über eine von einer Plattform gehostete Anmeldeseite durch den Anmeldevorgang bei der Plattform. Ferner können Benutzer die App verwenden, um mit Benutzerinhalten, die mit ihrer Organisation verknüpft sind, zu arbeiten, oder andere ArcGIS Online-Funktionen, wie Geokodierung, Routing und GeoEnrichment, zu nutzen. Weitere Informationen zur Authentifizierung und zu OAuth 2.0 finden Sie unter ArcGIS Developer.
Hinweis:
Das Implementierungsmuster für Benutzeranmeldungen hängt davon ab, ob Sie eine webbasierte oder eine native App entwickeln. Die ArcGIS Developer-Dokumentation beinhaltet detaillierte Erläuterungen und Code-Beispiele für webbasierte und native Apps.
- Überprüfen Sie, ob Sie mit einem Organisationskonto angemeldet sind und Ihnen Berechtigungen zum Erstellen von Inhalten zugewiesen sind.
- Klicken Sie auf der Inhaltsseite auf der Registerkarte Eigene Inhalte auf Neues Element.
- Klicken Sie im Fenster Neues Element auf Entwickler-Anmeldeinformationen.
- Geben Sie unter Umleitungs-URLs, die URL einer Webseite oder eines Server-Endpunkts ein, die zum Umleiten von Benutzern nach der erfolgreichen Anmeldung verwendet werden soll. Klicken Sie auf Hinzufügen, um nach Bedarf weitere Umleitungs-URLs hinzuzufügen.
Die bei der Autorisierung angegebenen Umleitungs-URLs müssen mit einer der registrierten URLs übereinstimmen, andernfalls wird die Autorisierung abgelehnt.
Für Autorisierungsgenehmigungen kann auch der Sonderwert "urn:ietf:wg:oauth:2.0:oob" angegeben werden. In diesem Fall wird der Autorisierungscode in einer Portal-URL (/oauth2/approval) bereitgestellt. Dieser Wert wird in der Regel von Apps verwendet, die nicht über einen Webserver oder ein benutzerdefiniertes URL-Schema verfügen, in dem der Code bereitgestellt werden kann.
Die folgenden Formate von Umleitungs-URLs werden beispielsweise unterstützt:
- https://app.foo.com
- urn:ietf:wg:oauth:2.0:oob
- Wählen Sie unter Anwendungsumgebung eine Anwendungsumgebung für die App aus: Mehrere, Nativ, Browser oder Server.
- Geben Sie im Feld URL eine URL für die App im Format https://<myServer>/myWebMapApp ein.
- Klicken Sie auf Weiter.
- Geben Sie einen Titel ein.
- Wählen Sie den Ordner unter Eigene Inhalte aus, in dem Sie das Element speichern möchten.
- Wenn in Ihrer Organisation Inhaltskategorien eingerichtet wurden, klicken Sie auf Kategorien zuweisen, und wählen Sie bis zu 20 Kategorien aus, damit andere das Element finden können.
Sie können auch mit der Eingabe eines Kategorienamens beginnen, um die Liste der Kategorien einzugrenzen.
- Geben Sie optional Tags zur Beschreibung des Elements ein.
Trennen Sie Begriffe durch Kommas (z. B. Bund Land wird als ein Tag; Bund, Land hingegen als zwei Tags betrachtet).
Während der Eingabe können Sie alle vorgeschlagenen Tags auswählen, die angezeigt werden. Vorschläge werden aus Tags erstellt, die Sie zuvor hinzugefügt haben.
- Fügen Sie optional eine aussagekräftige Zusammenfassung für die App ein.
- Klicken Sie auf Speichern.
Die App wird Ihren Inhalten hinzugefügt, und die zugehörige Elementseite wird angezeigt. Sie können die Elementdetails konfigurieren, bei Bedarf Code hinzufügen und die App freigeben, wenn Sie über Berechtigungen zum Freigeben verfügen.
Auf der Registerkarte Einstellungen der Elementseite der App können Sie Registrierungsinformationen anzeigen, die die App-ID (Client-ID), einen geheimem Schlüssel der App (Geheimer Clientschlüssel) und die Anwendungsumgebungen umfassen. Außerdem können Sie die URL der Datenquelle oder die Umleitungs-URLs aktualisieren, den geheimen Schlüssel zurücksetzen, die Registrierung der Anwendung aufheben oder das temporäre App-Token kopieren oder erneuern.
Hinweis:
Wenn der geheime Zugriffsschlüssel der App zurückgesetzt wird, werden alle vorhandenen Benutzer und App-Token ungültig, die für die App ausgestellt wurden. Benutzer müssen sich erneut bei der App anmelden, und Apps, die mit dem geheimen Zugriffsschlüssel konfiguriert wurden, müssen eventuell aktualisiert werden.
Auf der Registerkarte Verwendung der Elementseite können Sie Nutzungsinformationen anzeigen lassen, z. B. wer sich bei der App angemeldet hat und wie viele Credits jeweils verbraucht wurden.