Skip To Content

Crear plantillas de aplicaciones

Para crear su propia plantilla de aplicación web, puede descargar y modificar una de las plantillas existentes, actualizar una aplicación web existente para que funcione con contenido de su portal o crear una aplicación web nueva con una de las API web de ArcGIS. Independientemente de cómo cree su propia plantilla, deberá trabajar con parámetros de direcciónURL y mapas. Si crea una plantilla de grupo, puede trabajar con grupos y considerar requisitos adicionales para trabajar con mapas base de Bing Maps, acceder a mapas no públicos y trabajar con recursos que requieran un proxy o el uso compartido de recursos de distinto origen (CORS). También puede agregar el elemento a su portal y, si su organización tiene previsto usar la plantilla en su galería de plantillas, compartirla con uno de los grupos de plantillas de la organización.

Portal for ArcGIS incluye ArcGIS API 3.15 for JavaScript. No es necesario alojar su propia API y direccionar el portal en la versión local para plantillas de aplicación recién creadas; las plantillas de la aplicación web hacen referencia de forma automática a la API instalada. La API instalada localmente suele estar disponible en https://webadaptorhost.domain.com/webadaptorname/jsapi/jsapi.

Precaución:

No modifique los archivos de plantilla de aplicación web que se proporcionan con Portal for ArcGIS, ya que el portal administra estos archivos y cualquier modificación que se haga puede ser sobrescrita posteriormente por el portal. Si desea personalizar las plantillas, haga lo siguiente:

  1. Haga una copia del archivo de plantilla existente que desea personalizar.
  2. Ponga la copia en una ubicación o un disco diferente.
  3. Personalice la copia de la plantilla.
  4. Agréguela al portal como una plantilla nueva.

En este tema se explica cómo se crea una plantilla de aplicación web. Se da por hecho que dispone de privilegios para crear contenido y compartirlo con grupos de su organización. Después de crear la plantilla, puede hacerla configurable. Las plantillas configurables permiten a los usuarios personalizar el aspecto y el comportamiento de la aplicación.

Mapas web

Las plantillas de aplicación se han diseñado para trabajar con el mapa web visualizado en Map Viewer. Normalmente, las plantillas crean un mapa basado en el mapa Web especificado en el parámetro webmap de la dirección URL. Cada API web dispone de un método de ayuda que crea un mapa utilizando información del Id. del mapa web.

Por ejemplo, para crear un mapa basado en el Id. introducido, se puede usar el método esri.arcgis.utils.createMap de ArcGIS API for JavaScript. También puede incluir una función de devolución de llamada que se ejecute cuando la solicitud sincrónica a esri.arcgis.utils.createMap se haya completado.

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

Si alguno de los mapas web incluye un mapa base de Bing, es necesario especificar una clave de Bing Maps al utilizar el método createMap. Hay varias opciones de mapas más que puede especificar, por ejemplo si se debe visualizar el deslizador, la navegación y la atribución, entre otras.

La función de callback proporciona acceso a un objeto de respuesta que, a su vez, permite acceder al objeto del mapa y a sus capas, entre otros elementos.

Registrar la plantilla de la aplicación

Si trabaja con elementos protegidos en la plantilla de aplicación, primero deberá registrarlos en la plataforma. Para ello, agregue un nuevo elemento de Aplicación de representación cartográfica en la red y establezca la dirección URL en la plantilla de la aplicación alojada en su servidor web.

Una vez agregados los elementos, es necesario registrar la aplicación Puesto que es una aplicación web, mantenga el tipo definido como Browser con Redirect URI apuntando a la dirección URL de la aplicación de la plantilla.

Una vez registrada la aplicación, debería disponer de un Id. de aplicación único.

Trabaje con el Administrador de identidades para que reconozca el Id. de la aplicación registrada. Para obtener más información, consulte los ejemplos OAuth Basic y OAuth Popup OAuth que se suministran con ArcGIS API for JavaScipt.

Grupo

Las plantillas de grupo muestran contenido del grupo especificado como aplicación.

La API REST de ArcGIS proporciona acceso al contenido de su portal. Se puede usar para recuperar contenido de un grupo a partir del ID de grupo introducido.

En este ejemplo, se realiza una consulta para buscar un grupo con el Id. de entrada.

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];
     });
});

Una vez encontrado el grupo, se pueden realizar consultas para recuperar elementos del grupo.

En este ejemplo, se realiza una consulta al grupo para encontrar cinco elementos de tipo Web Map o Web Mapping Application.

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

Consideraciones adicionales

Por lo general, las aplicaciones web están diseñadas para trabajar con muchos tipos distintos de contenido, así que es posible que sea necesario configurar la plantilla para manejar mapas con mapas base de Bing Maps, contenido que no sea público, etc. A continuación se indican las consideraciones específicas.

Clave de Bing Maps

Si cualquiera de los mapas que se desea mostrar utiliza un mapa base de Bing Maps, se deberá incluir una clave de Bing Maps en la aplicación. La clave de Bing Maps se proporciona como un parámetro del método createMap.

Soporte para proxy y CORS

Si la aplicación va a realizar solicitudes entre dominios distintos, se deberá habilitar CORS o agregar un proxy a la aplicación.

Agregar la plantilla a su portal

Después de crear la plantilla y alojarla en el servidor web, agregue la plantilla al portal como elemento de aplicación web y especifique la dirección URL de la aplicación. Para este fin, elija Configurable. Para la API, elija JavaScript.

No olvide incluir un título descriptivo y un resumen, ya que esta información se muestra cuando los usuarios pasan el puntero por encima de la plantilla en la galería de plantillas. Opcionalmente, se puede crear un archivo ZIP que contenga los archivos de aplicación y adjuntarlo al elemento para permitir la descarga.

Usar la plantilla en la galería de aplicaciones de su organización

Para utilizar la plantilla en la galería de aplicaciones de Map Viewer de su organización o en la galería de aplicaciones de grupos, comparta el elemento con el grupo que se esté utilizando para dicha galería. A continuación, el administrador de la organización puede configurar el mapa o configurar grupos para usar el grupo que incluya la plantilla.