Erstellen konfigurierbarer App-Vorlagen

Wenn Ihnen Berechtigungen zum Erstellen von Inhalten zugewiesen sind, können Sie eine eigene benutzerdefinierte App-Vorlage erstellen, die auf Ihrem Webserver gehostet wird. Nachdem die benutzerdefinierte App-Vorlage erstellt und konfiguriert wurde, kann Ihre App in ArcGIS gefunden werden, indem Ihre Vorlage ArcGIS Online hinzugefügt wird. Anschließend haben Sie die Möglichkeit, die App konfigurierbar zu machen, damit deren Aussehen und Verhalten angepasst werden können. Falls Ihre Organisation plant, Ihre Vorlage in eine eigene App-Galerie einzustellen, können Sie Ihre Vorlage für eine App-Vorlagengruppe freigeben.

Erstellen und Konfigurieren einer Web-App-Vorlage

Um eine benutzerdefinierte Web-App-Vorlage zu erstellen, können Sie eine vorhandene ArcGIS Configurable Apps-Vorlage herunterladen und ändern, eine vorhandene Web-App für die Arbeit mit Inhalten aus ArcGIS Online aktualisieren oder eine neue Web-App mit dem Code in einer von GitHub herunterladbaren Starter-App erstellen.

Unabhängig davon, wie Sie die App erstellen, arbeiten Sie mit URL-Parametern und Karten. Sie können mit Gruppen arbeiten, wenn Sie eine gruppenbasierte App-Vorlage erstellen. Sie müssen möglicherweise zusätzliche Anforderungen berücksichtigen, wenn Sie mit Bing Maps-Grundkarten arbeiten, auf nicht öffentliche Karten zugreifen und Ressourcen verwenden, für die ein Proxy oder CORS (Cross-Origin Resource Sharing) erforderlich ist.

Nachdem Sie Ihre App-Vorlage erstellt haben, hosten Sie sie auf Ihrem Webserver.

URL-Parameter

Wenn Sie eine Vorlage verwenden, legen Sie fest, welche Karte oder Gruppe angezeigt werden soll, indem Sie die webmap- oder group-ID als URL-Parameter in die Vorlage einfügen. Webkarten-IDs werden mit dem Parameter webmap und Gruppeninhalte mit dem Parameter group festgelegt. Damit Ihre benutzerdefinierte Vorlage mit der aktuellen Karte oder Gruppe funktioniert, müssen Sie einen Code in die Anwendung einfügen, um die aktuelle Webkarten- oder Gruppen-ID aus der URL zu extrahieren.

Beispielsweise können Sie die Karte Grundkarte von Europa in der Vorlage "Basic Viewer" anzeigen.

Beginnen Sie dazu mit der URL des "Basic Viewer":

https://www.arcgis.com/apps/View/index.html

Kopieren Sie den Teil webmap= der URL der Grundkarte von Europa:

https://www.arcgis.com/home/webmap/viewer.html?webmap=5421a40574914458892efe74f0149025

Und fügen Sie ihn ans Ende der URL des "Basic Viewer" an:

https://www.arcgis.com/apps/View/index.html?webmap=5421a40574914458892efe74f0149025

ArcGIS API for JavaScript verfügt über die Hilfsmethode esri.urlToObject zur Vereinfachung dieses Prozesses. Bei dieser Methode werden URL-Parameter in ein Objekt konvertiert.

var webmap;
var urlObject = esri.urlToObject(document.location.href);

Sobald die URL-Parameter in ein Objekt konvertiert wurden, können Sie auf verschiedene Eingaben zugreifen. Sie können beispielsweise den Wert für den Parameter der Webkarten-URL einer Variablen mit dem Namen webmap_id zuweisen.

var webmap_id = urlObject.query.webmap;
Hinweis:

Wenn die App konfigurierbar ist, müssen Sie ebenfalls einen URL-Parameter namens appid bearbeiten, der die Konfigurationseinstellungen definiert.

Webkarten

Hinweis:

Diese Funktionalität wird nur in Map Viewer Classic unterstützt.

Anwendungsvorlagen sind so konzipiert, dass sie mit der aktuell angezeigten Karte in Map Viewer Classic verwendet werden können. Vorlagen erstellen eine Karte in der Regel auf Basis der Webkarte, die im URL-Parameter der Webkarte angegeben ist. Jede Web API verfügt über eine Hilfsmethode zur Erstellung einer Karte anhand von Informationen aus der Webkarten-ID. Weitere Informationen zum Verwenden von APIs für die Arbeit mit Webkarten erhalten Sie unter ArcGIS API for JavaScript.

Sie können beispielsweise die ArcGIS API for JavaScript esri.arcgis.utils.createMap-Methode verwenden, um eine Karte auf Grundlage der Eingabe-ID zu erstellen. Sie können außerdem eine Rückruffunktion einfügen, die ausgeführt wird, wenn die synchrone Anforderung an esri.arcgis.utils.createMap abgeschlossen ist.

esri.arcgis.utils.createMap(webmap,"map",{
   mapOptions:{
     slider:false
   },
   bingMapsKey:bingMapsKey
}).then(function(response){
    map = response.map;
});
Hinweis:

Wenn eine Ihrer Webkarten eine Bing Maps-Grundkarte enthält, müssen Sie bei Verwendung der Methode createMap einen Bing Maps-Schlüssel angeben. Es gibt verschiedene andere Kartenoptionen, um festzulegen, ob beispielsweise Schieberegler, Navigation, Attribuierung usw. angezeigt werden sollen.

Die Funktion callback ermöglicht den Zugriff auf ein Antwortobjekt, das Zugriff auf das Kartenobjekt, Layer usw. bietet. Weitere Informationen über die Map-Klasse finden Sie unter ArcGIS API for JavaScript.

Gruppen

Gruppenvorlagen zeigen Inhalte aus den festgelegten Gruppen in einer App an.

ArcGIS REST API bietet Zugriff auf Inhalte aus ArcGIS Online. Sie können sie zum Abrufen von Gruppeninhalten auf Grundlage der Eingabegruppen-ID verwenden. Weitere Informationen zum Verwenden von ArcGIS REST API finden Sie unter Übersicht über ArcGIS REST API.

In diesem Beispiel führen Sie eine Abfrage aus, um eine Gruppe mit der Eingabe-ID zu suchen.

var portal = new esri.arcgis.Portal('https://www.arcgis.com');
dojo.connect(portal, 'onLoad',function(){
    portal.queryGroup(groupid).then(function(response){
        var group = response.results[0];
     });
});

Nachdem Sie die Gruppe gefunden haben, können Sie die Gruppe abfragen, um Elemente abzurufen.

In diesem Beispiel wird die Gruppe abgefragt, um fünf Elemente vom Typ Web Map oder Web Mapping Application zu suchen.

var queryParams = {
    q: 'type:"Web Map" -type:"Web Mapping Application"',
    num: 5
 };
group.queryItems(queryParams).then(function(response){
    var groupItems = response.results;
});

Zusätzliche Überlegungen

Web-Apps sind in der Regel so konzipiert, dass sie mit vielen Inhaltstypen funktionieren. Sie müssen die Vorlage möglicherweise für die Verarbeitung von Karten mit Bing Maps-Grundkarten, nicht öffentlichen Inhalten usw. einrichten. Spezifische Überlegungen sind unten aufgeführt.

Bing Maps-Schlüssel

Wenn eine der Karten, die Sie anzeigen möchten, eine Bing Maps-Grundkarte verwendet, müssen Sie einen Bing Maps-Schlüssel in Ihre Anwendung einbeziehen. Der Bing Maps-Schlüssel wird als Parameter der createMap-Methode bereitgestellt.

Proxy- und CORS-Unterstützung

Da Ihre Anwendung domänenübergreifende Anforderungen an ArcGIS Online sendet, müssen Sie CORS aktivieren oder Ihrer Anwendung einen Proxy hinzufügen.

Hinzufügen der Vorlage zu ArcGIS Online

Nachdem Sie Ihre Web-App-Vorlage erstellt und auf Ihrem Webserver gehostet haben, kann Ihre App in ArcGIS gefunden werden, indem Ihre Vorlage ArcGIS Online hinzugefügt wird.

Hinzufügen der Vorlage als App-Element

Fügen Sie Ihre Vorlage ArcGIS Online als Web-App-Element hinzu, und geben Sie die URL zur App an. Als Zweck wählen Sie Konfigurierbar. Als API wählen Sie JavaScript.

Nachdem Sie Ihre Vorlage hinzugefügt haben, wird das Vorlagenelement unter Ihren Inhalten angezeigt und Sie können die Details bearbeiten. Fügen Sie einen beschreibenden Titel und eine Zusammenfassung hinzu, da diese Informationen angezeigt werden, wenn Benutzer dieses Element in der konfigurierbaren App-Galerie anzeigen. Sie haben auch die Möglichkeit, eine .zip-Datei zu erstellen, die Ihre Anwendungsdateien enthält, und diese an das Element anzuhängen, damit sie heruntergeladen werden kann.

Registrieren der App-Vorlage

Nachdem Sie Ihre App-Vorlage als Element hinzugefügt haben, müssen Sie die App registrieren. Durch die Registrierung Ihrer App erhalten Sie eine eindeutige App-ID. Verwenden Sie die App-ID in Ihrer App, um Nutzungsstatistiken zu erfassen und Benutzern die Anmeldung mit OAuth 2.0, einer standardisierten Autorisierungsumgebung, zu erlauben. Ferner ermöglicht es die App-ID, dass Benutzer Ihre App verwenden, um mit Benutzerinhalten, die mit der Organisation verknüpft sind, zu arbeiten, und andere ArcGIS Online-Funktionen, wie Geokodierung, Routing und GeoEnrichment, zu nutzen.

Stellen Sie beim Registrieren Ihrer Web-App-Vorlage den Typ auf Browser so ein, dass die Umleitungs-URI auf die URL der Vorlagen-App verweist.

Wenn Sie die Vorlage ApplicationBase verwenden, legen Sie die konfigurierbare oauthappid-Eigenschaft in der config/defaults.js-Datei fest.

//sample

 "oauthappid": “h4xZWhfz0an0TvqC"

Sollten Sie die ApplicationBase-Vorlage nicht verwenden, müssen Sie mit dem Identity Manager arbeiten, damit dieser die registrierte App-ID erkennt. Weitere Informationen können Sie den Beispielen OAuth Basic und OAuth Popup entnehmen.

Festlegen Ihrer App als konfigurierbar

Wenn Sie die Anpassung von Aussehen und Verhalten Ihrer Web-App ermöglichen, können Sie diese konfigurierbar machen. Sie können Benutzern beispielsweise erlauben, die App-Farben zu ändern oder andere Einstellungen für die App anzupassen.

Wenn Sie Ihre App als konfigurierbar festlegen, beinhaltet dies die Erstellung einer Konfigurationsdatei und die Verknüpfung der Informationen der Konfigurationsdatei mit dem von Ihnen erstellten App-Vorlagenelement.

Erstellen einer Konfigurationsdatei

Die App-Konfigurationsdatei ist eine JSON-Datei, mit der die Konfigurationsoptionen für die App-Vorlage definiert werden. Der Name der Konfigurationsdatei für die App "Basic Viewer" lautet beispielsweise configurationPanel.js und befindet sich im Ressourcenordner des Basic Viewer-Repositorys von Esri. Zeigen Sie ein vollständiges Beispiel einer Konfigurationsdatei an.

Hinweis:

Sie sollten den JSON-Code mithilfe eines Validators wie JSONLint prüfen, um sicherzustellen, dass Sie über ein wohlgeformtes, fehlerfreies JSON verfügen.

Gehen Sie wie folgt vor, um eine Konfigurationsdatei zu erstellen:

  1. Erstellen Sie mindestens einen Abschnitt, indem Sie eine Kategorie und eine Reihe von Feldern festlegen.
    {
        "configurationSettings": [
            {
                "category": "",
                "fields": []
            }
        ]
    }
  2. Legen Sie die Konfigurationsoptionen anhand der in der folgenden Tabelle aufgelisteten Feldtypen fest. Stellen Sie beim Erstellen der Konfigurationsdatei sicher, dass die fieldName-Eigenschaft innerhalb der Konfigurationseinstellungen eindeutig ist.

    FeldtypBeschreibung

    Paragraph

    Zeigt einen erläuternden Text im Dialogfeld "Konfiguration" an.

    {
           "type": "paragraph",
           "value": "* These menu items will appear in the application when the web map has layers that require them."
    }

    Zeichenfolge

    Akzeptiert Texteingabe. Beinhaltet die Eigenschaft stringFieldOption, die den Typ des auf dem Bildschirm angezeigten Textfeldes festlegt. Die Werte lauten textbox, textarea und richtext. Die Option textbox ist der Standardwert und ein einzeiliges Textfeld. Die Option textarea zeigt ein größeres Textfeld für die Eingabe von Daten an. Die Option richtext zeigt einen Richtext-Editor an, der Benutzern die Anwendung einiger Formatierungsoptionen ermöglicht, z. B. Fett- oder Kursivformatierung des Textes.

    {
            "type": "string",
            "fieldName": "description",
            "label": "Description",
            "tooltip": "",
             "stringFieldOption": richtext || textarea || textbox,
            "placeHolder": "Text that appears in the text box to provide a hint to users on text to enter"
    }

    Ausgabebeispiel

    description:"Bike Accidents"

    Boolesch

    Erstellt ein Kontrollkästchen zum Festlegen von true- oder false-Werten. Mit condition können Sie feststellen, ob die Karte die angegebene Funktionalität enthält. Wenn die Karte die Bedingung nicht erfüllt, werden das Kontrollkästchen und die Beschriftung im Konfigurationsfenster nicht angezeigt.

    {
           "type": "boolean",
           "fieldName": "tool_bookmarks",
           "condition": "bookmark",
           "label": "Bookmarks",
           "tooltip": ""
     }

    Ausgabebeispiel

    tool_bookmarks:false

    Zahl

    Erstellt ein Feld, das numerische Werte akzeptiert. Wenn das Feld nur einen bestimmten Wertebereich akzeptiert, können Sie mithilfe der Einstellung constraints die Eingabe auf einen bestimmten Wertebereich beschränken oder die Eingabewerte formatieren. Informationen zum Erstellen von Einschränkungen mit Dojo Number TextBox finden Sie in der Dojo-Dokumentation.

    { 
         "type": "number",
         "fieldName": "range",
         "label": "Range:",
         "tooltip": "",
         "constraints" :{min:0,max:10,places:0}
    }

    Ausgabebeispiel

    range:0.5

    Datum und Uhrzeit

    Erstellt eine Datumsauswahl mit verschiedenen Datumsangaben.

    {
         "type":"date",
         "fieldName" : "startDate",
         "label" : "Start Date"
    }

    Erstellt eine Zeitauswahl mit verschiedenen Uhrzeitangaben.

    {
         "type": "time",
         "fieldName": "startTime",
         "label": "Start Time"
    }

    Ausgabebeispiel (im ISO-8601-Format) für Datum und Uhrzeit

    Start Date and Time: 1970-01-01T21:30:00.000Z

    Optionen

    Erstellt eine Dropdown-Liste mit einer Reihe von Optionen.

    {
       "type": "options",
       "fieldName": "theme",
       "tooltip": "Color theme to use",
       "label": "Color Scheme:",
       "options": [{
         "label": "Blue",
         "value": "blue"
       }, {
         "label": "Green",
         "value": "green"
       }, {
         "label": "Orange",
         "value": "orange"
       }]
     }

    Ausgabebeispiel

    theme:"blue"

    Farbauswahl

    Zeigt eine Farbauswahl zum Auswählen einer Farbe aus einer Palette oder zum Festlegen von HEX-, RGB- oder HSV-Werten an. Stellt zudem einen Schieberegler für die Transparent sowie die Option "Keine Farbe" bereit.

    {
       "type": "color", 
       "label": "Choose a selection color",
       "fieldName": "selectionColor",
       "transparency" : true,
       "noColor" : true
     }

    Ausgabebeispiel

    selectionColor:"#829254"

    Dialogfeld "Webkarte"

    Zeigt ein Dialogfeld an, um nach einer neuen Karte zu suchen, die in der App angezeigt werden soll. Geben Sie optional eine Bedingung zum Testen der Karte an. Wenn die angegebene Bedingung nicht erfüllt wird, wird eine Validierungsmeldung im Konfigurationsfenster angezeigt, die bestätigt, dass die Karte die Anforderungen nicht erfüllt. Es gibt folgende gültige Zeichenfolgen für Bedingungen:

    • time: Die Karte hat aktivierte Zeiteigenschaften.
    • edit: Die App weist mindestens einen editierbaren Layer auf.
    • featurelayer: Die Karte weist mindestens einen Feature-Layer auf.
    • filter: Für die Karte ist ein interaktiver Filter definiert.
    • 4x: Die Karte enthält Inhalte, die in Version 4.x von ArcGIS API for JavaScript noch nicht unterstützt werden.
    {
       “type”: “webmap”,
       “conditions”: [“time”, “edit”, “featurelayer”, “filter”, “4x”]
     }

    Ausgabebeispiel

    webmap:"739ef0cf75de432995c77dd44ec8f652"

    Dialogfeld "Webszene"

    Zeigt ein Dialogfeld an, um nach einer neuen Webszene zu suchen, die in der App angezeigt werden soll.

    {
       "type": "webscene"
     }

    Ausgabebeispiel

    webscene:"ab41c86a588748128e6f5d80990a2395"

    Dialogfeld "Gruppe"

    Zeigt ein Dialogfeld an, um nach einer neuen Gruppe zu suchen, die in der App angezeigt werden soll.

    {
       "type": "group"
    
     }

    Ausgabebeispiel

    group:"449d00a4478d4849bbb65612355d6cd1"

    Auswahl mehrerer Layer und Felder

    Stellt eine Strukturansicht der Layer und Felder in der Karte dar, die mit den unterstützten Typen und Geometrietypen übereinstimmen. Ermöglicht Endbenutzern von Apps die Auswahl mehrerer Layer und mehrerer Felder für jeden Layer.

    Hinweis:

    Wenn für editOnly der Wert true festgelegt ist, enthält die Feldliste nur editierbare Felder.

    {  
                   "label":"Select search layers and fields",
                   "fieldName":"searchLayers",
                   "type":"multilayerandfieldselector",
                   "editOnly":true,  
                   "tooltip":"Select layer and fields to search",
                   "layerOptions":{  
                      "supportedTypes":[  
                         "FeatureLayer"
                      ],
                      "geometryTypes":[  
                         "esriGeometryPoint",
                         "esriGeometryLine",
                         "esriGeometryPolyline",
                         "esriGeometryPolygon"
                      ]
                   },
                   "fieldOptions":{  
                      "supportedTypes":[  
                         "esriFieldTypeString"
                      ]
                   }
                }

    Ausgabebeispiel

    searchLayers: [{
        "id":"Whittier_Hazards_821",
        "fields":[],
        "type":"FeatureLayer"
    }]

    Layer- und Feldauswahl

    Zeigt eine Dropdown-Liste mit Layern in der Karte an, die nach den aufgelisteten Typen und Geometrien gefiltert ist. Geben Sie optional mindestens eine Feldauswahl an, um Benutzern die Auswahl eines Layers und von Feldern zu ermöglichen.

    Hinweis:

    Wenn für editOnly der Wert true festgelegt ist, enthält die Feldliste nur editierbare Felder.

    {  
                   "type":"layerAndFieldSelector",
                   "fieldName":"tableLayer",
                   "label":"Layer to display in table",
                   "tooltip":"Layer to display in table",
                   "fields":[  
                      {  
                         "multipleSelection":true,
                         "editOnly":true,    
                         "fieldName":"hiddenFields",
                         "label":"Hide the selected fields",
                         "tooltip":"Fields to hide in table",
                         "supportedTypes":[  
                            "esriFieldTypeSmallInteger",
                            "esriFieldTypeInteger",
                            "esriFieldTypeSingle",
                            "esriFieldTypeDouble",
                            "esriFieldTypeString"
                         ]
                      }
                   ],
                   "layerOptions":{  
                      "supportedTypes":[  
                         "FeatureLayer"
                      ],
                      "geometryTypes":[  
                         "esriGeometryPoint",
                         "esriGeometryLine",
                         "esriGeometryPolygon"
                      ]
                   }
                }

    Ausgabebeispiel

    tableLayer: {
        id: "2014CyclingAccidents_All_874",
        fields: [{
            id: "urlField",
            fields: ["Casualty_Severity"]   
        }]
    }

    Optionsschaltfläche

    Erstellt eine Optionsschaltfläche, mit der immer nur eine Option ausgewählt werden kann. Die ausgewählte Option wird auf "True" gesetzt.

    {
       "type": "radio",
       "fieldName": "layout",
       "tooltip": "Custom Layout",
       "label": "Custom Layout:",
       "items": [{
         "label": "Sidebar",
         "value": "sidebarmenu"
       }, {
         "label": "FullWidth",
         "value": "fullwidth"
       }, {
         "label": "default",
         "value": "Default",
         "checked": true
       }]
     }

    Ausgabebeispiel

    customLayout:"fullmap"

    Grundkarten

    Zeigt eine Dropdown-Liste aller benannten Esri Grundkarten an.

    {
      “type”: “basemaps”,
       “fieldname” :”my_basemap”,
       “label”: “Alternate Basemap”
    }

    Ausgabebeispiel

    my_basemap:"satellite"

    Bedingungsfunktionen

    Zeigt Inhalte basierend auf einer TRUE- oder FALSE-Bedingung an bzw. blendet sie aus. Wenn das Kontrollkästchen Layer-Liste anzeigen beispielsweise deaktiviert ist, werden die Layer-Liste und alle zugehörigen Optionen (z. B. Sublayer in Layer-Liste einbeziehen) ausgeblendet.

    {
                   "type":"conditional",
                   "condition": false,
                   "fieldName":"showtitle",
                   "label":"Display Map Title",
                   "items":[
                     {
                        "placeHolder":"Defaults to web map title",
                        "label":"Title:",
                        "fieldName":"title",
                        "type":"string",
                        "tooltip":"Defaults to web map title"
                     },{
                          "type":"paragraph",
                          "value":"Enter a value to override the default title font size "
                       },
                       {
                          "type":"string",
                          "label":"Title font size",
                          "tooltip":"Specify title font size",
                          "fieldName":"titlefontsize",
                          "placeHolder":"20px"
                       }
                   ]
                }
    }

    Suchen

    Konfiguriert einen Suchbereich für die Suche von Features im Feld eines Feature-Layers oder von Adressen mit einem Locator. Wenn Sie eine Feature-Suche konfigurieren, können Benutzer den Feature-Layer und Suchfelder auswählen.

    {
    “type”: “Search”,
      “fieldName”: “searchConfig”,
    “label”: “Configure Search Options”
    }

    Ausgabebeispiel

    searchConfig: {
    sources: [{
    locator: {
        url: "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer",
        _url: {
            path: "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer",
            query: null
        },
            normalization: true
        },
        url: "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer",
        name: "ArcGIS World Geocoding Service",
        enableSuggestions: true,
        singleLineFieldName: "SingleLine",
        enable: true,
        id: "dojoUnique3"
    }],
    activeSourceIndex: 0,
    enableSearchingAll: false
    }

    ScaleList

    Zeigt eine Liste der vordefinierten Maßstabsebenen, aus dem Benutzer zur Auswahl stehen. Beispielsweise Länder, Bundesstaaten, Bundesstaat, Landkreise, Landkreis, Metro, Großstadt, Kleinstadt, Stadtviertel.

    {
        “type”: “scaleList”,
        “fieldName”: “customUrlLayerZoomScale”,
        “label”: “Choose zoom level”
    }

    Ausgabebeispiel

    “customUrlLayerZoomScale”: 12000

    ExtentMap

    Erstellt eine Auswahl mit Optionen für die Kartenzentrierung und für Zoomstufen.

    {
       "type":"extentMap",
       "label": "Select center and zoom",
       "fieldName": "mapExtent"
    }

    Ausgabebeispiel

    mapExtent: {
      level: 2,
      coords: {
         latitude: 51.304,
         longitude: -98.7231
         }
    }

Verknüpfen der Konfigurationsinformationen mit dem Vorlagenelement

Nachdem Sie die Konfigurationsdatei erstellt haben, müssen Sie die JSON-Konfigurationsinformationen mit Ihrer App-Vorlage verknüpfen, damit sie konfiguriert werden kann.

  1. Klicken Sie auf der Elementseite Ihrer App-Vorlage auf die Registerkarte Einstellungen und dann oben auf den Link Web Mapping-Anwendung.
  2. Fügen Sie im Feld Konfigurationsparameter den JSON-Code aus der Konfigurationsdatei ein.
    Hinweis:

    Für das Feld Konfigurationsparameter ist ein gültiges JSON erforderlich. Sie sollten Ihr JSON mithilfe eines Validators wie JSONLint prüfen, um sicherzustellen, dass Sie über ein wohlgeformtes, fehlerfreies JSON verfügen.

  3. Speichern Sie Ihre Einstellungen.

Beispiel für eine Konfigurationsdatei

Nachfolgend finden Sie ein Beispiel für eine vollständige Konfigurationsdatei:

{
    "configurationSettings": [
        {
            "category": "General Settings",
            "fields": [
                {
                    "type": "options",
                    "fieldName": "theme",
                    "tooltip": "Color theme to use",
                    "label": "Color Scheme:",
                    "options": [
                        {
                            "label": "Blue",
                            "value": "blue"
                        },
                        {
                            "label": "Green",
                            "value": "green"
                        },
                        {
                            "label": "Orange",
                            "value": "orange"
                        }
                    ]
                },
                {
                    "type": "string",
                    "fieldName": "layer",
                    "label": "Analysis Layer",
                    "tooltip": "Feature Layer with Facilities to search"
                },
                {
                    "type": "string",
                    "fieldName": "orgname",
                    "label": "Organization Name:",
                    "tooltip": "",
                    "stringFieldOption": "richtext",
                    "placeHolder": "Organization Name"
                },
                {
                    "type": "number",
                    "fieldName": "bufferdistance",
                    "label": "Search Distance (miles)",
                    "value": "1"
                }
            ]
        }
    ],
    "values": {
        "theme": "orange",
        "bufferdistance": 1
    }
}

Einstellen Ihrer Vorlage in die Galerie der Organisation

Wenn Sie Ihre Vorlage in der Configurable Apps- oder Gruppen-Apps-Galerie der Organisation verwenden möchten, geben Sie das Element für alle Benutzer und für die Gruppe frei, die für diese Galerie verwendet werden. Anschließend kann der Administrator Ihrer Organisation die Karte konfigurieren oder Gruppen konfigurieren, um die Gruppe zu verwenden, die Ihre Vorlage enthält.