Me gustaría ofrecer algunos comentarios sobre la documentación de configuración de Event Editor, en particular la documentación relativa a la modificación del archivo config.json para su uso real. Aunque pude poner en marcha Event Editor sin demasiadas dificultades, eso fue solo porque ya tengo un conocimiento razonable en la operación y administración de ArcGIS Server y Portal. Sin esa experiencia previa, no creo que hubiera podido configurar correctamente Event Editor usando la documentación proporcionada.
La documentación para modificar el archivo config.json (Configuración de la aplicación web Event Editor) es particularmente deficiente en proporcionar detalles útiles y ejemplos para implementaciones en Portal. Humildemente ofrezco las siguientes sugerencias específicas:
- Propiedad: webmap - El archivo de configuración de ejemplo rwc.json para webmap es casi inútil. La documentación para este archivo debería explicar, en detalle, cada elemento del archivo .json del webmap. La documentación debería explicar al usuario cómo obtener URLs de webmap y otras propiedades relevantes en ArcGIS Server, así como cómo hacer lo mismo para los elementos de capa basemap en ArcGIS Online. Se deberían proporcionar capturas de pantalla.
- Propiedad: geometryServiceUrl - La documentación debería indicar al usuario cómo localizar la URL del servicio de geometría en ArcGIS Server, con capturas de pantalla apropiadas.
- Propiedad: proxyUrl - El enlace proporcionado lleva al usuario a la página principal genérica de la documentación del ArcGIS Serve JavaScript API 3.x - no lleva a ningún tema pertinente a la propiedad mencionada.
- Propiedad: security: portalAppId - Debería proporcionarse un enlace al tema para obtener el Portal App ID para la aplicación web registrada (Configuración de Portal for ArcGIS o ArcGIS Online para Event Editor), así como una discusión sobre por qué esto es importante desde el punto de vista de seguridad.
Las sugerencias anteriores deberían considerarse mejoras mínimas; ayudarán al usuario a poner en marcha Event Editor de manera razonablemente segura en una implementación Portal, pero no mucho más. Sería muy útil proporcionar al usuario una visión general paso a paso de la configuración; quizás un diagrama de flujo con enlaces integrados sería apropiado. Un video tutorial también podría resultar muy útil. En general, la documentación parece estar dirigida a alguien que ya sabe cómo hacer la configuración, y solo necesita un documento de referencia. No parece estar dirigida a usuarios primerizos de APR, mucho menos a usuarios novatos en administración de Portal y ArcGIS Server. Si el objetivo es ayudar a promover una adopción generalizada de APR, la documentación existente no está ayudando mucho.
