A adição de uma referência de URL para um aplicativo existente é um caminho efetivo para compartilhar seu trabalho com membros da sua organização e o público (dependendo dos seus privilégios de compartilhamento). Além da URL, você pode compartilhar outros detalhes como o tipo de aplicativo, sua finalidade, resumo e descrição, e um arquivo .zip com o código usado para criar o aplicativo. Adicionar um aplicativo no ArcGIS Online apenas adiciona uma referência à URL do aplicativo; o ArcGIS Online não armazena os arquivos do aplicativo.
Como um desenvolvedor de aplicativo com uma conta organizacional, você também pode registrar aplicativos com a plataforma. Isso envolve o registro de um aplicativo OAuth para que membros da organização e usuários fora da organização possam entrar no aplicativo. Consulte a seção Adicionar e registrar um aplicativo usando credenciais de desenvolvedor abaixo para obter mais informações.
Caso não seja necessário registrar seu aplicativo—por exemplo, ao carregar uma amostra de código—siga as etapas na seção Adicionar um aplicativo a partir de uma URL abaixo.
Dica:
Outra maneira de compartilhar aplicativos com membros da sua organização e o público é criar aplicativos com mapas e aplicativos de galeria com grupos.
Adicionar um aplicativo a partir de uma URL
Siga estas etapas para adicionar um item que usa uma URL para acessar um aplicativo na web, mas não precisa ser registrado (por exemplo, amostras de código):
Anotação:
Para adicionar um aplicativo registrado, siga as etapas para adicionar e registrar um aplicativo usando credenciais de desenvolvedor.
- Verifique se você está registrado e tem privilégios para criar conteúdo.
- Na guia Meu conteúdo da página de conteúdo, clique e Novo item e clique em Aplicativo.
- Escolha o tipo de aplicativo:
- Mapeamento da web—Um aplicativo da web construído com uma API da web como JavaScript.
- Desktop—Um aplicativo para desktops, construído em uma plataforma de desktop como Java ou .NET (Microsoft WindowsDesktop).
- Móvel—Um aplicativo que pode ser baixado, construído para dispositivos móveis com um SDK como iOS ou Android.
- Outra aplicação—Um aplicativo de desktop, script Python ou qualquer tipo de aplicativo genérico para o qual você não tenha detalhes sobre a finalidade, API, SDK ou endereço URL do aplicativo.
- Para mapeamento móvel, desktop ou da web, digite a URL do aplicativo, por exemplo,https://<myServer>/myWebMapApp.
- Para aplicativos de desktop, clique em Procurar e escolha o arquivo .zip que contém o aplicativo.
- Clique em Avançar.
- Digite um título.
- Escolha uma pasta em Meu conteúdo onde você deseja salvar o item.
- Se a sua organização tiver configurado categorias de conteúdo, clique em Atribuir categorias e selecione até 20 categorias para ajudar as pessoas a encontrar o item.
Você também pode começar digitando um nome de categoria para restringir a lista de categorias.
- Opcionalmente, digite as tags que descrevem o item.
Separe os termos com vírgulas (por exemplo, Território federal são considerados uma tag; Federal, território são considerados duas tags).
Enquanto você digitar, será possível selecionar quaisquer tags sugeridas que apareçam; as sugestões são geradas a partir de tags que você adicionou anteriormente.
- Opcionalmente, adicione um resumo que descreva o aplicativo.
- Clique em Salvar.
Após adicionar o aplicativo, ele aparecerá em seu conteúdo. Se você precisar registrá-lo posteriormente, poderá fazer na guia Configurações da página de item do aplicativo. Consulte a seção Adicionar e registrar um aplicativo usando credenciais de desenvolvedor abaixo para obter mais informações.
Você pode configurar os detalhes do item, anexar código, se necessário, e compartilhar o aplicativo se você tiver privilégios de compartilhamento.
Adicione e registre um aplicativo usando credenciais de desenvolvedor
Como um desenvolvedor com uma conta organizacional, você pode adicionar e registrar seu aplicativo com a plataforma para gerar um ID do Aplicativo. Utilize o ID do aplicativo no aplicativo para coletar as estatísticas de uso e permitir aos usuários entrar na plataforma com OAuth 2.0, uma estrutura de trabalho de autorização padronizada. Com o OAuth 2.0, os aplicativos guiam o usuário para entrar na plataforma através de uma página de registro da plataforma hospedada. Também permite ao aplicativo trabalhar com conteúdo de usuário associado com sua organização, como também, trabalhar com outros recursos do ArcGIS Online tais como, geocodificação, rota e GeoEnriquecimento. Para mais informações sobre autenticação e OAuth 2.0, consulte ArcGIS Developer.
Anotação:
O padrão de implementação para logins de usuário difere um pouco, dependendo se você está desenvolvendo um aplicativo baseado na web ou um aplicativo nativo.A documentação do ArcGIS Developer inclui detalhes e amostras de código para aplicativos baseados na web e aplicativos nativos.
- Verifique se você está registrado com uma conta organizacional e tem privilégios para criar conteúdo.
- Clique na guia Meu Conteúdo da página de conteúdo, e clique em Novo item.
- Na janela Novo item, clique em Credenciais do desenvolvedor.
- Em URLs de Redirecionamento, insira a URL para uma página da web ou parâmetro do servidor que será usado para redirecionar os usuários após o registro bem-sucedido. Clique em Adicionar para adicionar mais URLs de redirecionamento conforme necessário.
As URLs de redirecionamento especificadas durante a autorização devem corresponder a uma das URLs registradas, caso contrário, a autorização será rejeitada.
Um valor especial de urn:ietf:wg:oauth:2.0:oob também pode ser especificado para concessões de autorização. Isso resulta na entrega do código de autorização a uma, URL do portal (/oauth2/approval). Esse valor normalmente é usado por aplicativos que não têm um servidor da web ou um esquema de URL personalizado onde o código pode ser entregue.
Veja a seguir exemplos de formatos de URL de redirecionamento suportados:
- https://app.foo.com
- urn:ietf:wg:oauth:2.0:oob
- Em Ambiente do aplicativo, escolha um ambiente do aplicativo para o aplicativo—Múltiplo, Nativo, Navegador ou Servidor.
- Na caixa URL, digite uma URL para seu aplicativo no formato https://<myServer>/myWebMapApp.
- Clique em Avançar.
- Digite um título.
- Escolha uma pasta em Meu conteúdo onde você deseja salvar o item.
- Se a sua organização tiver configurado categorias de conteúdo, clique em Atribuir categorias e selecione até 20 categorias para ajudar as pessoas a encontrar o item.
Você também pode começar digitando um nome de categoria para restringir a lista de categorias.
- Opcionalmente, digite as tags que descrevem o item.
Separe os termos com vírgulas (por exemplo, Território federal são considerados uma tag; Federal, território são considerados duas tags).
Enquanto você digitar, será possível selecionar quaisquer tags sugeridas que apareçam; as sugestões são geradas a partir de tags que você adicionou anteriormente.
- Opcionalmente, adicione um resumo que descreva o aplicativo.
- Clique em Salvar.
O aplicativo é adicionado ao seu conteúdo e a página do item aparece. Você pode configurar os detalhes do item, anexar código, se necessário, e compartilhar o aplicativo se você tiver privilégios de compartilhamento.
Na guia Configurações da página de item do aplicativo, você pode visualizar as informações de registro, que incluem o ID do aplicativo (ID do Cliente), um segredo do aplicativo (Segredo do Cliente) e os ambientes do aplicativo. Você também pode atualizar a URL da fonte de dados ou URLs de redirecionamento, redefinir o segredo, cancelar o registro do aplicativo ou, copiar ou renovar o token temporário do aplicativo.
Anotação:
A redefinição de segredo do aplicativo invalida todos os tokens de usuário e aplicativo existentes emitidos para o aplicativo. Os usuários devem entrar no aplicativo novamente e os aplicativos configurados com o segredo podem precisar ser atualizados.
Na guia Uso da página do item, você pode visualizar informações de uso sobre quem entrou no aplicativo e o número de créditos consumidos.