Skip To Content

创建可配置应用程序模板

如果您拥有创建内容的权限,可创建您自己的自定义应用程序模板。 创建和配置自定义应用程序模板后,将模板添加到门户中,以使应用程序能够在 ArcGIS 中被搜索到。 然后,可以选择将应用程序设置为可配置,以允许用户自定义应用程序的外观和行为。 如果您的组织计划在其中一个图库中收入您的模板,则可以与应用程序模板群组共享模板。

创建和配置 web 应用程序模板

要创建您自定义的 web 应用程序模板,可下载一个现有 ArcGIS Configurable Apps 模板并进行修改,也可更新现有 web 应用程序以使用您的门户中的内容,或使用一种 ArcGIS Web API 构建新的 web 应用程序。

无论您以何种方式创建应用程序,都要使用 URL 参数和地图 如果要创建基于群组的应用程序模板,并且要考虑其他要求以便使用 Bing Maps 底图、访问非公开地图和使用需要代理或跨域资源共享 (CORS) 的资源,则可以使用群组

ArcGIS Enterprise(10.9 版本)门户包含 ArcGIS API 3.35 for JavaScript。 无需为新建的应用程序模板托管自己的 API 并将门户指向本地版本;web 应用程序模板将自动引用已安装的 API。 本地安装的 API 通常位于 https://webadaptorhost.domain.com/webadaptorname/jsapi/jsapi

警告:

请勿更改随 ArcGIS Enterprise 提供的 Web 应用程序模板文件,因为这些文件由门户管理,您对其进行的任何更改随后均有可能被门户覆盖。 如果要自定义模板,请执行以下操作:

  1. 复制想要自定义的现有模板文件。
  2. 将副本放置在磁盘上的不同位置。
  3. 自定义模板副本。
  4. 将副本作为新模板添加到您的门户。

Web 地图

应用程序模板旨在使用 Map Viewer 中当前显示的地图。 模板通常基于在 web 地图 URL 参数中所指定的 web 地图来创建地图。 每个 Web API 都具有一个辅助方法,即使用 web 地图 ID 中的信息来创建地图。

例如,您可使用 ArcGIS API for JavaScript esri.arcgis.utils.createMap 方法来基于输入 ID 创建地图。 也可以包含回调函数,它在完成对 esri.arcgis.utils.createMap 的同步请求时执行。

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

如果您的任何 web 地图中包含 Bing Maps 底图,则在使用 createMap 方法时需要指定 Bing Maps 密钥。 还可指定多种其他地图选项,例如是否要显示滑块、导航、属性等等。

callback 函数提供对响应对象的访问权限,该响应对象提供对地图对象、图层等的访问权限。

群组

群组模板会显示来自应用程序中指定群组的内容。

ArcGIS REST API 提供对门户内容的访问权限。 您可以使用它基于输入群组的 ID 来检索群组内容。

在此示例中,进行查询以查找带有输入 ID 的群组。

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

查找到该群组后,便可进行查询以从群组中检索项目。

在此示例中,查询该群组,以找到类型为 Web MapWeb Mapping Application 的五个项目。

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

其他考虑因素

Web 应用程序通常旨在处理多种类型的内容,因此您可能需要设置模板以处理带有 Bing Maps 底图、非公开内容等等的地图。 下面列出了特别注意事项。

Bing Maps 密钥

如果您想要显示的地图中的任意地图使用 Bing Maps 底图,则需要将 Bing Maps 密钥添加到应用程序中。 Bing Maps 密钥作为 createMap 方法的参数来提供。

代理和 CORS 支持

如果应用程序将进行跨域请求,您将需要启用 CORS 或向您的应用程序添加代理。

将模板添加到门户

创建 web 应用程序模板后,将模板添加到门户中,以使应用程序能够在 ArcGIS 中被搜索到。

将模板添加为应用程序项目

将模板作为 web 应用程序项目添加到门户,并指定应用程序的 URL。 对于用途,选择可配置。 对于 API,选择 JavaScript

添加模板后,模板项目会显示在您的内容中,您可以编辑其详细信息。 请确保项目中包含描述性的标题和摘要,以便用户在可配置应用程序库中查看此项目时会显示此信息。 也可以创建包含应用程序文件的 .zip 文件并将其附加到项目以提供下载功能。

注册应用程序模板

作为项目添加应用程序模板后,必须注册应用程序可注册您开发的基于 OAuth 2.0 的应用程序。 在门户中注册应用程序会为您提供应用程序 ID。 此应用程序 ID 是分布应用程序及获得使用情况报告的基础。

注册 web 应用程序模板时,将类型设置为浏览器,并重定向 URI,使其指向模板应用程序 URL。

使用身份管理器,以便识别已注册的应用程序 ID。 有关详细信息,请参阅包括在 ArcGIS API for JavaScipt 中的 OAuth 基本OAuth 弹出窗口示例。

将应用程序设置为可配置

您可以将自定义 web 应用程序设置为可配置,以允许用户自定义这一应用程序的外观和行为。 例如,您可以允许用户更改应用程序的颜色或自定义应用程序的其他设置。

将应用程序设置为可配置需要创建配置文件并将配置文件信息与您创建的应用程序模板项目相关联。

创建配置文件

应用程序配置文件是 JSON 文件,用于定义应用程序模板的配置选项。 请参阅配置文件的完整示例

注:

最好通过验证器(例如 JSONLint)运行 JSON 代码,从而确保 JSON 格式正确并且不含错误。

执行以下操作来创建配置文件:

  1. 通过指定类别和各个部分的字段集来创建一个或多个部分。
    {
        "configurationSettings": [
            {
                "category": "",
                "fields": []
            }
        ]
    }
  2. 使用下表列出的字段类型指定配置选项。 创建配置文件时,请确保 fieldName 属性在配置设置中具唯一性。

    字段类型描述

    段落

    在配置对话框中显示说明文本。

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

    字符串

    接受文本输入。 包括 stringFieldOption 属性,该属性用于指定在屏幕上显示的文本框类型。 值为 textboxtextarearichtexttextbox 选项为默认值,其形式为单行文本框。 textarea 选项可显示更大的文本框以便输入数据。 richtext 选项显示一个供用户在文本中应用某些格式(例如,将字体设置为粗体或斜体)的富文本编辑器。

    {
            "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"
    }

    示例输出

    description:"Bike Accidents"

    布尔型

    创建指定 true 值或 false 值的复选框。 使用 condition 查看地图中是否包含指定的功能。 如果地图不满足条件,则复选框和标注不会显示在配置面板中。

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

    示例输出

    tool_bookmarks:false

    数值

    创建接受数值的字段。 如果字段只接受特定范围的值,可以使用 constraints 设置将输入限制为特定范围的值,或者规定输入值的格式。

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

    示例输出

    range:0.5

    日期和时间

    创建包含日期选择的日期选择器。

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

    创建包含时间选择的时间选择器。

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

    日期和时间的示例输出(ISO-8601 格式)

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

    选项

    创建具有一系列选项的下拉列表。

    {
       "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"
       }]
     }

    示例输出

    theme:"blue"

    颜色选取器

    显示颜色选取器,可在其中从调色板中选择颜色或指定十六进制、rgb 或 hsv 值。

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

    示例输出

    selectionColor:"#829254"

    Web 地图对话框

    显示一个对话框,可在其中浏览或搜索要在应用程序中显示的新地图。也可以指定一个测试地图的条件。 如果未满足该指定条件,则配置面板上会出现一条验证消息,确认地图没有满足要求。 有效的条件字符串如下:

    • time - 地图已启用时间
    • edit - 应用程序至少具有一个可编辑图层
    • featurelayer - 地图至少具有一个要素图层
    • filter - 地图中已定义一个交互式过滤器
    • 4x - 地图中包含 ArcGIS API for JavaScript 4x 版本尚不支持的内容
    {
       “type”: “webmap”,
       “conditions”: [“time”, “edit”, “featurelayer”, “filter”, “4x”]
     }

    示例输出

    webmap:"739ef0cf75de432995c77dd44ec8f652"

    Web 场景对话框

    显示一个对话框,可在其中浏览或搜索要在应用程序中显示的新 web 场景。

    {
       "type": "webscene"
     }

    示例输出

    webscene:"ab41c86a588748128e6f5d80990a2395"

    群组对话框

    显示一个对话框,可在其中浏览或搜索要在应用程序中显示的新群组。

    {
       "type": "group"
    
     }

    示例输出

    group:"449d00a4478d4849bbb65612355d6cd1"

    多个图层和字段选择器

    在地图中显示与受支持类型和几何类型相匹配的图层树视图和字段。 允许应用程序最终用户为每个图层选择多个图层和多个字段。

    注:

    如果将 editOnly 设置为 true,则字段列表将仅包含可编辑字段。

     {  
                   "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"
                      ]
                   }
                }

    示例输出

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

    图层和字段选择器

    在地图中显示按所列出类型和几何过滤的图层下拉列表。 还可指定一个或多个字段选择器,以允许用户选择图层和字段。

    注:

    如果将 editOnly 设置为 true,则字段列表将仅包含可编辑字段。

      {  
                   "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"
                      ]
                   }
                }

    示例输出

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

    单选按钮

    创建一次只能选择一个选项的单选按钮。 所选选项将设置为 true。

    {
       "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
       }]
     }

    示例输出

    customLayout:"fullmap"

    底图

    显示包含所有已命名的 Esri 底图的下拉列表。

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

    示例输出

    my_basemap:"satellite"

    条件分析

    基于真或假条件显示或隐藏内容。 例如,如果取消选中显示图层列表复选框,则图层列表和所有相关选项(例如在图层列表中包括子图层)均会隐藏。

       {
                   "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"
                       }
                   ]
                }
    }

    搜索

    配置搜索窗格以使用定位器在要素图层或地址的字段中查找要素。 在配置要素搜索时,用户可以选择要素图层和搜索字段。

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

    示例输出

    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
    }

    比例表

    显示用户可选择的预定义比例级别的列表。 例如,Countries、States、State、Counties、County、Metro、City、Town、Neighborhood。

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

    示例输出

    “customUrlLayerZoomScale”: 12000

    ExtentMap

    创建带有地图中心和缩放级别选项的选择器。

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

    示例输出

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

关联配置信息与模板项目

创建配置文件后,必须关联 JSON 配置信息与您的应用程序模板,以将模板设置为可配置。

  1. 在应用程序模板的项目页面上,单击设置选项卡,然后单击顶部的 Web 制图应用程序链接。
  2. 配置参数框中,粘贴配置文件中的 JSON 代码。
    注:

    配置参数框需要有效的 JSON。 最好通过验证器(例如 JSONLint)运行 JSON,从而确保 JSON 格式正确并且不含错误。

  3. 保存您的设置。

配置文件示例

以下为完整的配置文件示例:

{
    "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
    }
}

将模板收入组织的图库中

如果想要使用组织的 Map Viewer 应用程序库或群组应用程序库中的模板,请与所有人和使用该库的群组共享项目。 然后您组织的管理员可以通过配置地图配置群组来使用包括模板的群组。