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 modelo, você trabalhará com Parâmetros de URL e mapas. Você pode trabalhar com grupos se estiver criando um modelo de grupo e poderá considerar requisitos adicionais para trabalhar com mapas base do Bing Maps, acessando mapas não-públicos e trabalhar com recursos que exigem um proxy ou Cross-Origin Resource Sharing (CORS).
Após você ter criado seu modelo de aplicativo da web, você pode adicionar seu item do aplicativo no seu portal. Se a sua organização planejar utilizar seu modelo em uma das suas galerias de aplicativo, você também pode compartilhá-lo com um dos grupos de modelos da sua organização. Para permitir aos usuários personalizar a aparência e comportamento de seu aplicativo da web personalizado, você pode torná-lo configurável.
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.
Mapas da web
Os modelos de aplicativo são projetados para funcionar com o mapa atualmente exibido no Map Viewer. Os modelos normalmente ajudam a criar um mapa baseado no mapa da web especificado no parâmetro da URL do mapa da web. Cada API da web tem um método de ajuda que cria um mapa utilizando informações do ID de 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 seus itens, 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 OAuth Basic e OAuth Popup incluídas com ArcGIS API for JavaScript.
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 seu aplicativo for fazer pedidos de domínio transversal, você precisará ativar CORS ou adicionar um proxy ao seu 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 Map Viewer ou galeria de aplicativo do grupo da sua organização, compartilhe o item no grupo sendo utilizado para esta galeria. Então o administrador de sua organização pode configurar o mapa ou configurar grupos para utilizar o grupo que inclui seu modelo.