A partir de Portal for ArcGIS 10.5.1, puede agregar widgets personalizados a su portal. Esto significa que puede elegir los widgets personalizados en el entorno del builder al crear la aplicación. Antes de usar un widget personalizado, este debe estar alojado en un servidor web y registrado en su portal. Por motivos de seguridad, solo los administradores del portal pueden registrar el widget personalizado y las aplicaciones públicas no cargarán el widget personalizado cuando los usuarios anónimos accedan a él.
Alojar un widget personalizado en un servidor web
Alojar un widget personalizado en un servidor web no es distinto de alojar cualquier otra aplicación web. Necesita instalar y configurar un servidor web. Entre los servidores web comunes se incluyen IIS, OS X Server y Apache.
Para alojar widgets personalizados en su servidor web, siga estos pasos:
- Habilite el acceso anónimo en su servidor web.
Se debe poder acceder de forma anónima a la ubicación de alojamiento.
- Habilite HTTPS.
Habilite el acceso HTTPS en su servidor web para evitar crear contenido mixto. Web AppBuilder no permite contenido activo mixto provocado al cargar HTTP en una conexión HTTPS. Además, su servidor debe tener un certificado SSL válido emitido por una entidad de certificación para establecer la conexión HTTPS.
- Habilite el Uso compartido de recursos entre orígenes (CORS).
Web AppBuilder se ejecuta bajo el dominio de su portal, que puede ser diferente del dominio del servidor web que aloja su widget personalizado. Necesita habilitar CORS en el servidor web para permitir el acceso desde su portal.
- Agregue un controlador JSON a su servidor web.
Cada widget está formado por un archivo de manifiesto de JSON que describe las propiedades del widget. Algunos servidores web no reconocen la extensión del archivo JSON de forma predeterminada. En estos casos, deberá agregarlo a su servidor como un nuevo tipo de MIME, en el nivel de la aplicación o en otro superior. El tipo de MIME debe tener .json como extensión de nombre de archivo y application/json como tipo de MIME.
- Implemente el widget personalizado en su servidor web.
Puede copiar la carpeta del widget personalizado en su servidor web. Después de la implementación, deberá obtener la ruta de la dirección URL de acceso al archivo de manifiesto de su widget. personalizado. Un ejemplo de una ruta de dirección URL de un archivo de manifiesto es <server.domain.com>/<my widget>/manifest.json.
Registrar un widget personalizado
Debe registrar cada widget personalizado en su portal. Para hacerlo, debe iniciar sesión como administrador.
- En una ventana del navegador, inicie sesión en su portal.
- Haz clic en Mi contenido.
- Haga clic en Agregar elemento y elija Una aplicación.
- Elija Extensión de aplicación (App Builder) y proporcione la dirección URL al archivo de manifiesto.
Un ejemplo de una ruta de dirección URL de un archivo de manifiesto es <server.domain.com>/<my widget>/manifest.json.
- Haga clic en el cuadro Título.
El título del elemento se rellenará automáticamente del archivo de manifiesto. También puede editar manualmente el título.
- Agregue etiquetas en el cuadro Etiquetas.
- Haga clic en Agregar elemento.
Su widget personalizado ahora está disponible en Mi contenido como un tipo de extensión de App Builder.
Compartir un widget personalizado
Como administrador, puede compartir el widget personalizado con grupos de su organización que necesiten acceder a él o con toda la organización, si es necesario.
Precaución:
No se recomienda compartir el widget personalizado públicamente. Por motivos de seguridad, una aplicación pública no cargará el widget personalizado cuando los usuarios anónimos accedan a él. Además, una aplicación solo cargará el widget personalizado que esté registrado en la misma organización que los usuarios que tienen permiso para acceder a la aplicación.
En Mi contenido, localice su widget personalizado y compártalo con grupos de su organización. Cuando abre el builder, el widget personalizado se muestra debajo de la pestaña Personalizados en el cuadro de diálogo Elegir widget.
Actualizar un widget personalizado
Aunque no puede actualizar el widget personalizado en su portal, puede actualizar la estructura HTML y el código de JavaScript de un widget personalizado alojado en su servidor web.
Nota:
Una vez que un widget personalizado se ha implementado en un servidor web y se ha registrado como un elemento de tipo extensión de App Builder en su portal, el contenido del archivo de manifiesto se guarda en el elemento de la extensión. Esto significa que la extensión registrada no reconocerá ningún cambio realizado en el archivo de manifiesto que esté alojado en un servidor web. Le recomendamos que cree una nueva extensión en lugar de actualizar el archivo de manifiesto.