Gostaria de fornecer um feedback sobre a documentação de configuração do Event Editor, em particular a documentação relativa à modificação do arquivo config.json para uso real. Embora eu tenha conseguido colocar o Event Editor em funcionamento sem muita dificuldade, isso se deve ao fato de eu já ter um conhecimento razoável sobre a operação e administração do ArcGIS Server e Portal. Sem essa experiência prévia, não acredito que teria conseguido configurar o Event Editor com sucesso usando a documentação fornecida.
A documentação para modificar o arquivo config.json (Configurando a aplicação web do Event Editor) é particularmente deficiente em fornecer detalhes úteis e exemplos para implementações no Portal. Ofereço humildemente as seguintes sugestões específicas:
- Propriedade: webmap - O arquivo de configuração de webmap rwc.json usado como exemplo é quase inútil. A documentação desse arquivo deveria explicar, em detalhes, cada elemento do arquivo .json do webmap. A documentação deveria explicar ao usuário como obter URLs de webmap e outras propriedades relevantes no ArcGIS Server, assim como como fazer o mesmo para elementos de camada basemap no ArcGIS Online. Capturas de tela deveriam ser fornecidas.
- Propriedade: geometryServiceUrl - A documentação deveria informar ao usuário como localizar a URL do serviço de geometria no ArcGIS Server, com capturas de tela apropriadas.
- Propriedade: proxyUrl - O link fornecido leva o usuário para a página inicial genérica da documentação da API JavaScript 3.x do ArcGIS Server - não direciona para nenhum tópico pertinente à propriedade em questão.
- Propriedade: security: portalAppId - Deveria ser fornecido um link para o tópico sobre como obter o Portal App ID para o aplicativo web registrado (Configurando Portal for ArcGIS ou ArcGIS Online para Event Editor), assim como uma discussão sobre por que isso é importante do ponto de vista da segurança.
As sugestões acima devem ser consideradas melhorias mínimas; elas ajudarão o usuário a colocar o Event Editor em funcionamento de forma razoavelmente segura em uma implementação no Portal, mas não muito além disso. Seria muito útil fornecer ao usuário uma visão geral passo a passo da configuração; talvez um diagrama de fluxo com links incorporados seria apropriado. Um vídeo tutorial também poderia ser muito útil. Em geral, a documentação parece ser direcionada para alguém que já sabe como fazer a configuração, e que apenas precisa de um documento de referência. Não parece ser direcionada para usuários APR pela primeira vez, muito menos para usuários novatos na administração do Portal e ArcGIS Server. Se a intenção é ajudar a promover a adoção ampla do APR, a documentação existente não está ajudando muito.
