Publicar modelos

Al publicar un modelo, se crea un elemento de herramienta alojada que se puede ejecutar como una herramienta web personalizada.

Para publicar un modelo, es necesario seguir estos pasos:

1. Crear el modelo.
2. Agregar variables para las entradas que deben ser configurables para la herramienta web.
3. Establecer las variables como parámetros del modelo.
4. Administrar los parámetros para personalizar cómo aparecen en la herramienta web personalizada.
5. Ejecutar y guardar el modelo.
6. Pblicar el modelo.

Requisitos de licencia

Para publicar un modelo hay que tener la licencia y las configuraciones necesarias para utilizar ModelBuilder, además del privilegio Publicar modelos de análisis.

Establecer variables como parámetros del modelo

Las variables que se establecen como parámetros del modelo aparecen como parámetros de la herramienta cuando el modelo se publica y se abre como una herramienta web personalizada, lo que le permite especificar datos o valores diferentes a los especificados cuando se creó el modelo.

Las variables de datos alojadas en la salida se establecen automáticamente como parámetros del modelo, mientras que las variables de datos y valores de entrada deben establecerse manualmente como parámetros. Las variables de datos intermedios de salida no se pueden establecer como parámetros del modelo.

Para definir variables de datos de entrada y de valores como parámetros del modelo, siga estos pasos:

1. Complete los pasos para crear o abrir un modelo y conéctese a una sesión de análisis.
2. Agregue herramientas de datos y variables si es necesario.
3. Haga clic en un elemento de variable para seleccionarlo.

   La barra de herramientas de elementos aparece encima de la variable seleccionada.

4. Haga clic en Agregar o eliminar parámetro .

   Aparece un icono de parámetro en la variable, lo que indica que la variable se ha establecido como parámetro del modelo.

Una vez que haya establecido las variables necesarias como parámetros del modelo, estará listo para gestionar los parámetros de la herramienta web.

Administrar los parámetros de la herramienta web

La ventana Administrar parámetros de herramienta web se utiliza para reordenar y actualizar la configuración de los parámetros en la herramienta web personalizada.

Para administrar parámetros de herramienta web, siga estos pasos:

1. Complete los pasos para crear o abrir un modelo que contenga datos, herramientas, variables y parámetros del modelo.
2. Conéctese a una sesión de análisis, si todavía no lo ha hecho.
3. En la barra de herramientas de acciones, haga clic en Administrar parámetros de herramienta web .

   Aparece la ventana Administrar parámetros de herramienta web. Los parámetros del modelo se enumeran en el orden en que se agregaron. Cada parámetro tiene un nombre y un alias. El alias está vinculado a la opción Etiqueta del parámetro.

   Nota:

   No se pueden agregar ni eliminar parámetros desde la ventana Administrar parámetros de herramienta web. Para obtener información sobre cómo agregar y eliminar parámetros, consulte Establecer variables como parámetros de modelo.

4. Haga clic en Expandir para mostrar la configuración de un parámetro.
5. Actualice los siguientes ajustes según sea necesario:
   • Etiqueta de parámetro: etiqueta corta para el parámetro de la herramienta. Este texto aparecerá como nombre del parámetro en el panel de herramientas de la herramienta web personalizada. La etiqueta debe ser breve, descriptiva del propósito del parámetro y estar redactada en un lenguaje sencillo.
   • Texto de ayuda emergente: breve descripción del parámetro de la herramienta. Este texto aparecerá cuando haga clic en el botón de ayuda situado junto al parámetro en el panel de la herramienta web personalizada. En función de las necesidades, incluya una descripción de lo que hace el parámetro, cómo los diferentes valores afectan a los resultados de la herramienta, las entradas compatibles y los valores predeterminados.
   • Requerido: indica si el parámetro es necesario para validar y ejecutar la herramienta. Este valor se activará y no se podrá editar si el parámetro del modelo está conectado a uno o más parámetros de herramienta obligatorios. Si todos los parámetros de herramientas conectadas son opcionales, el parámetro del modelo se puede activar para que el parámetro sea obligatorio o desactivar para que sea opcional. Hacer que un parámetro sea obligatorio obligará al usuario a proporcionar una entrada antes de que se pueda ejecutar la herramienta web.
   • Tipo de datos: indica qué entradas son compatibles con el parámetro. Este valor se basa en el tipo de datos variables y no se puede modificar.
   • Filtro: determina los límites o restringe los valores de entrada o los datos que se pueden especificar para el parámetro. Las opciones dependen del tipo de datos, tal y como se indica a continuación:
     • Doble: valor mínimo y máximo
     • Capa de entidades: lista de tipos de entidades permitidos, incluidos multipunto, punto, línea y polígono
     • Campo: lista de tipos de campos permitidos
     • Entero: valor mínimo y máximo.
     • Cadena de caracteres: lista de valores únicos
     Los filtros se restablecen para un parámetro del modelo si se crea una nueva conexión entre la variable y una herramienta en el diagrama del modelo. Los filtros deben revisarse y actualizarse tras cambiar las conexiones del modelo.
   • Incluir valor predeterminado: indica si el parámetro de la herramienta tiene un valor predeterminado. Cuando se activa, el parámetro utilizará un valor predeterminado basado en el valor de la variable. De forma predeterminada, el parámetro estará vacío cuando esté desactivado. Se puede utilizar un valor predeterminado para guiar las entradas del usuario o simplificar la herramienta web, ya que el usuario no necesita actualizar el parámetro manualmente. Este ajuste debe utilizarse para parámetros que tienen un menú de valores aceptados, como las unidades, y parámetros en los que se espera que se utilice con frecuencia el mismo valor de entrada sin necesidad de actualizarlo.

     Nota:

     Los valores predeterminados no son adecuados para la mayoría de las entradas de texto, números o capas de entidades.

     Tampoco se deben utilizar valores predeterminados para los parámetros que se desee dejar en blanco, como, por ejemplo, una capa de entidades opcional como entrada. Se utilizará el predeterminado al ejecutar la herramienta, incluso si dicho valor se borra manualmente del panel de la herramienta web publicada.

   • Valor predeterminado: indica el valor predeterminado para el parámetro de la herramienta. Para cambiar el valor predeterminado, actualice el valor de la variable en el diagrama del modelo. El valor predeterminado debe ser un valor que ofrezca un resultado preciso o preferido en la mayoría de los casos. Esta configuración solo está disponible si se habilita la opción Incluir valor predeterminado.
6. Haga clic en Contraer para ocultar la configuración del parámetro.
7. Repita los tres pasos anteriores para cada uno de los parámetros restantes.

   También puede cambiar el orden de los parámetros si es necesario.

8. Haga clic en Reposicionar junto al nombre de un parámetro y arrastre el parámetro a otra posición.

   También puede hacer clic en Reposicionar y elegir una opción del menú. Dependiendo de la posición del parámetro, las opciones serán: Subir, Bajar, Mover al principio y Mover al final.

9. Haga clic en Guardar.

Los ajustes de los parámetros de la herramienta web se guardan y la ventana Administrar parámetros de la herramienta web se cierra. Ahora ya lo tiene todo listo para publicar el modelo.

Publicar un modelo

Al publicar un modelo se crea un elemento de herramienta, que se puede compartir y ejecutar como una herramienta web personalizada.

Para publicar un modelo, siga estos pasos:

1. Complete los pasos para crear o abrir un modelo que contenga datos, herramientas, variables y parámetros.

   Nota:

   Los modelos que cumplan todos los criterios de publicación exigidos pueden publicarse sin necesidad de conectarse a una sesión de análisis. Si tiene un modelo listo para publicar, ábralo y continúe con el paso 6.

2. Conéctese a una sesión de análisis, si todavía no lo ha hecho.
3. Ejecute el modelo.

   No es obligatorio ejecutar el modelo, pero ayuda a garantizar que la herramienta web funcione correctamente.

4. Guarde el modelo.

   La herramienta web publicada se basará en el elemento del modelo de análisis guardado. El modelo debe guardarse antes de poder publicarse. Si se realiza algún cambio en el modelo, debe guardarlo de nuevo.

   Antes de publicar el modelo, obtenga una vista previa de la herramienta web para asegurarse de que se han establecido los parámetros de herramienta web correctos.

5. En la barra de herramientas del modelo, haga clic en Vista previa de la herramienta web .

   En el panel Análisis aparece una vista previa de la herramienta web. Si es necesario realizar cambios en la herramienta web, vuelva a los flujos de trabajo para configurar y administrar los parámetros. Haga clic de nuevo en Vista previa de la herramienta web para actualizar la vista previa.

   Una vez que la vista previa muestre todos los parámetros y las configuraciones que desea en la herramienta web, puede publicar el modelo.

6. En la barra de herramientas del modelo, haga clic en Publicar .

   Aparece la ventana Publicar como herramienta web. Si no se cumplen los requisitos de publicación, revise los requisitos restantes, cierre la ventana Publicar herramienta web y complete los requisitos antes de volver a este flujo de trabajo.

   Más información sobre los requisitos de publicación

   Si se cumplen los requisitos de publicación y está conectado a una sesión de análisis, puede cerrar la ventana Publicar como herramienta web, desconectarse de la sesión de análisis y repetir este paso en modo de solo lectura.

7. Haga lo siguiente para el nuevo elemento:
   • Proporcione un título.

     El título no puede contener espacios. Puede actualizar el título del elemento de la herramienta una vez publicado desde la página del elemento.

   • Elija una carpeta en Mi contenido donde desee guardar el elemento.
   • Proporcione etiquetas y un resumen que describan el elemento.
8. Haga clic en Publicar.

   Se publica el modelo y se crea un elemento de herramienta.

9. Haga clic en Abrir elemento de herramienta web para abrir los detalles del elemento de herramienta o cierre la ventana Publicar como herramienta web.

Puede abrir la herramienta web personalizada desde el panel Herramientas haciendo clic en Abrir herramienta web personalizada. También puede compartir el elemento de herramienta con su organización o con grupos desde la página de detalles.

Nota:

Los elementos de la herramienta no se pueden compartir con el público.

Sobrescribir una herramienta web

Cuando un modelo ya se ha publicado, el botón Publicar se sustituye por el botón Sobrescribir. Puede realizar cambios en la herramienta web existente actualizando el modelo y siguiendo los pasos para publicarlo mediante el botón Sobrescribir.

Publicar requisitos

Para poder publicar un modelo de análisis como herramienta web, deben cumplirse todos los requisitos que se describen a continuación.

Privilegios de publicación de usuario

Su cuenta de usuario debe cumplir los requisitos de licencia para publicar modelos de análisis como herramientas web. Si su cuenta no cumple los requisitos de licencia, el botón Publicar no estará disponible.

Para actualizar los privilegios de su cuenta de usuario, póngase en contacto con el administrador de su organización.

Crear una salida alojada

Un modelo de análisis debe crear una capa de entidades alojada o una capa de tablas antes de poder publicarse como herramienta web. De forma predeterminada, todas las herramientas agregadas a un modelo crean resultados intermedios, en lugar de resultados alojados.

Para cumplir este requisito, asegúrese de que una herramienta tenga el parámetro Capa de resultados establecido en Crear capa alojada o Sobrescribir capa existente. Los resultados alojados se establecerán como parámetros del modelo y se agregarán al mapa web después de ejecutar el modelo o la herramienta web. Cree una capa alojada para el resultado que desea visualizar como resultado del análisis, por ejemplo, la última herramienta del modelo. Para obtener los mejores resultados, cree solo salidas alojadas para una herramienta en el modelo.

Más información sobre las salidas de modelo

Administrar los parámetros de la herramienta web

Los errores en los parámetros de la herramienta web deben resolverse en la ventana Administrar parámetros de herramientas web.

Aparece el mensaje El valor predeterminado está fuera del rango del filtro si el valor predeterminado y el rango del filtro no son compatibles (por ejemplo, si los valores del filtro son números entre 1 y 10 y el valor predeterminado es 11). El valor predeterminado del parámetro del modelo se basa en el parámetro variable y los valores de filtro se establecen en la ventana Administrar parámetros de la herramienta web. Para resolver el error, actualice los valores del filtro en la ventana Administrar parámetros de la herramienta web o cambie el valor de la variable para actualizar el valor predeterminado del parámetro.

Las herramientas están listas para ejecutarse

Todas las herramientas y los datos de entrada y salida necesarios deben presentar el estado preparado para ejecutarse o ejecutado. Si uno o varios de los elementos necesarios no están listos para ejecutarse, este requisito no se cumplirá. Para resolver este problema, abra el elemento de la herramienta para revisar los errores o configurar los parámetros necesarios. Para poder realizar modificaciones en el modelo, debe estar conectado a una sesión de análisis y el modelo debe estar activo.

Guardar los cambios del modelo

Los cambios pendientes en el modelo deben guardarse. La herramienta web publicada se basa en el elemento del modelo de análisis guardado. Si el modelo tiene cambios sin guardar, la publicación no estará habilitada.

Ejecutar el modelo

Se recomienda ejecutar el modelo completo con éxito antes de publicarlo como herramienta web, para garantizar que esta funcione correctamente y genere los resultados esperados.

Limitaciones

No se puede obtener información de campo para los parámetros de herramientas web creados a partir de variables de campo cuando el dataset de entrada es una salida de una herramienta de análisis o cuando se utiliza la misma variable de campo para varios datasets de entrada. En consecuencia, se aplican las siguientes limitaciones al parámetro de la herramienta web:

• El parámetro de la herramienta web no tendrá un menú de opciones de campo. En su lugar, aparecerá un cuadro de texto en el que podrá escribir el nombre del campo.
• Los filtros de tipo de campo configurados en la ventana Administrar parámetros de herramienta web no se tendrán en cuenta.