Para criar seu próprio modelo de aplicativo da web personalizado, você pode baixar e modificar um dos modelos existentes, atualizar um aplicativo da web existente para funcionar com conteúdo do seu portal ou construir um novo aplicativo da web utilizando um dos ArcGIS Web APIs. Independente de como você cria seu próprio modelo, você irá trabalhar com parâmetros da URL e mapas. Você pode trabalhar com grupos se estiver criando um modelo de grupo e pode considerar requisitos adicionais para trabalhar com mapas base Bing, acessar mapas que não sejam públicos e trabalhar com recursos que exigem um proxy ou Cross-Origin Resource Sharing (CORS). Você também adicionará seu item no portal e, se a sua organização planejar utilizar o modelo na sua galeria de modelo, o compartilhe com um dos grupos de modelos da sua organização.
O Portal for ArcGIS inclui ArcGIS API 3.15 for JavaScript. Não há necessidade de hospedar seu próprio API e apontar o portal na versão local para os modelos de aplicativo recentemente criados; os modelos de aplicativo da web referenciam automaticamente o API instalado. O API instalado localmente está normalmente disponível em https://webadaptorhost.domain.com/webadaptorname/jsapi/jsapi.
Aviso:
Não altere os arquivos do modelo de aplicativo da web fornecidos com o Portal for ArcGIS, pois estes arquivos são gerenciados pelo portal, e quaisquer alterações poderão ser subsequentemente substituídas pelo portal. Se você desejar personalizar os modelos, faça o seguinte:
- Crie uma cópia do arquivo de modelo existente que você deseja personalizar.
- Substitua a cópia em um local diferente no disco.
- Personalize a cópia do modelo.
- Adicione no seu portal como um novo modelo.
Este tópico abrange como criar um modelo de aplicativo da web. Ele assume que você tem privilégios para criar conteúdo e compartilhar em grupos na sua organização. Após criar o seu modelo, você poderá torná-lo configurável. Modelos configuráveis permitem aos usuários personalizarem o visual e comportamento de um aplicativo.
Mapas da web
Os modelos de aplicativo são projetados para funcionar com o mapa exibido atualmente no visualizador de mapa. Os modelos normalmente ajudam a criar um mapa baseado no mapa da web especificado no parâmetro da URL do mapa da web. Cada um dos web API tem um método de ajuda que cria um mapa utilizando informações de ID do mapa da web.
Por exemplo, você poderá utilizar o método do ArcGIS API for JavaScript esri.arcgis.utils.createMap para criar um mapa baseado no ID de entrada. Você também pode incluir uma função de retorno que executa quando o pedido síncrono para esri.arcgis.utils.createMap é finalizado.esri.arcgis.utils.createMap(webmap,"map",{
mapOptions:{
slider:false
},
bingMapsKey:bingMapsKey
}).then(function(response){
map = response.map;
});
Anotação:
Se alguns dos mapas da web incluir mapas base do Bing Maps, você precisará especificar a chave do Bing Maps ao utilizar o método createMap. Há várias outras opções de mapa que você pode especificar, como por exemplo, exibir o controle deslizante, navegação, atribuição, e mais.
A função callback fornece acesso a um objeto de resposta que fornece acesso ao objeto de mapa, camadas, e mais.
Registrar o modelo de aplicativo
Se você estiver trabalhando com itens seguros no seu modelo de aplicativo, você desejará primeiro registrá-lo com a plataforma. Para fazer isto, adicione um novo item do Aplicativo de Mapeamento da Web e configure a URL para o modelo de aplicativo hospedado no seu servidor da web.
Após adicionar seu item, você precisa registrar o aplicativo. Já que é um aplicativo da web, mantenha o tipo configurado para Browser com Redirect URI apontando para a URL de aplicativo do modelo.
Após registrar seu aplicativo, você deve agora ter um único ID de aplicativo.
Trabalhe com o Gerenciador de Identidade de forma que ele reconheça o ID do aplicativo registrado. Para mais informações, consulte as amostras Fundamentos do OAuth e Pop-up do OAuth incluídas com ArcGIS API for JavaScipt.
Grupo
Os modelos de grupo exibem o conteúdo do grupo especificado como um aplicativo.
O ArcGIS REST API permite acessar o conteúdo a partir do portal. Você pode utilizá-lo para recuperar o conteúdo do grupo baseado no ID do grupo de entrada.
Neste exemplo, você executará uma consulta para localizar um grupo com o 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];
});
});Após localizar o grupo, você pode consultá-lo para recuperar os itens a partir deste grupo. Neste exemplo, você consulta o grupo para localizar cinco itens do tipo Web Map ou 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;
});
Considerações adicionais
Os aplicativos da web são normalmente projetados para funcionar com vários tipos de conteúdo diferentes, então talvez seja necessário instalar o modelo para manipular os mapas com mapas base do Bing Maps, conteúdo não-público, e assim por diante. As considerações específicas estão listadas abaixo.
Chave do Bing Maps
Se algum dos mapas que você deseja exibir utilizar um mapa base do Bing Maps, você precisará incluir a chave do Bing Maps no aplicativo. A chave do Bing Maps é fornecida como um parâmetro para o método createMap.
Suporte de Proxy e CORS
Se o seu aplicativo solicitar o domínio-cruzado, você precisará habilitar Cross-Origin Resource Sharing (CORS) ou adicionar um proxy no aplicativo.
Adicionar o modelo no seu portal
Após criar o modelo e hospedá-lo no seu servidor da web, adicione o modelo no seu portal como um item do aplicativo da web e especifique a URL do aplicativo. Para a finalidade, escolha Configurável. Para API, escolha JavaScript.
Certifique-se de incluir um resumo e título descritivo, pois estas informações são exibidas quando usuários pairam o ponteiro sobre o item do modelo na galeria de modelo. Opcionalmente, você pode criar um arquivo ZIP que contém os arquivos do aplicativo e anexá-lo ao item para fornecer o recurso de download.
Utilizar o modelo na galeria de aplicativo da sua organização
Se você desejar utilizar o modelo na galeria de aplicativo do visualizador de mapa ou galeria de aplicativo do grupo da sua organização, compartilhe o item no grupo sendo utilizado para esta galeria. Então o administrador da sua organização pode configurar o visualizador de mapa ou configurar grupos para utilizar o grupo que inclui seu modelo.