Si crea un mapa que se publica como un servicio de entidades, debe plantearse la finalidad del servicio de entidades y dónde se almacenan los datos de este servicio, ya que ello afecta a la forma de crear, administrar y utilizar el servicio de entidades.
Este tema abarca la creación de un servicio de entidades para su publicación en un sitio independiente o un sitio federado de ArcGIS GIS Server y cómo hacer que el servicio de entidades haga referencia a los datos de una geodatabase o una base de datos que usted ha registrado con el sitio de GIS Server.
Antes de crear el mapa, prepare los datos para que cumplan los requisitos del servicio de entidades y registre los data stores con el sitio de GIS Server. Cuando tenga listos los datos, cree y configure un mapa que contenga los datos que desea publicar, defina la simbología y otras propiedades de datos del mapa y defina una plantilla de entidades para el entorno de edición (si desea que el servicio de entidades sea editable).
Configurar un mapa
Después de preparar y registrar los datos, agréguelos a un mapa en ArcGIS Pro o ArcMap y defina las propiedades de las capas y tablas. Estas propiedades definen cómo aparecen los datos y lo que el cliente puede realizar con ellos.
Configurar un mapa en ArcGIS Pro
Consulte Crear un mapa web en la Ayuda de ArcGIS Pro para más información sobre la configuración de un mapa para su publicación.
Configurar un documento de mapa en ArcMap
Una vez definidos los datos, agréguelos al ArcMap documento de mapa que desee publicar y defina las propiedades en las capas y tablas. Estas propiedades definen cómo aparecen los datos y lo que el cliente puede realizar con ellos.
La configuración del documento de mapa es similar para los datos de base de datos y de geodatabase. Sin embargo, si el documento de mapa contiene datos de geodatabase, puede configurar el mapa para beneficiarse de la funcionalidad adicional que solo está disponible para geodatabases antes de publicarlo.
Definir un nombre de capa
Al agregar una clase de entidad o una tabla a un mapa, el nombre predeterminado es el nombre totalmente calificado de la tabla dentro de la base de datos. Como mínimo, debe cambiar el nombre de la capa para que no contenga el nombre de la base de datos ni el nombre de usuario. Haga clic con el botón derecho del ratón en cada capa de la tabla de contenido y, a continuación, haga clic en Propiedades. En la pestaña General, escriba un nombre útil que represente el contenido de la capa y no contenga el nombre de la base de datos ni el nombre de usuario.
Por ejemplo, si agrega al mapa la clase de entidad "rivers" desde una geodatabase corporativa denominada mygdb y la clase de entidad es propiedad del usuario gdbdata, el nombre de capa predeterminado del mapa es mygdb.gdbdata.rivers. Cambie el nombre de la capa rivers.
Puede cambiar aún más el nombre de la capa si define para la capa una consulta de definición que determina qué entidades se visualizan en el mapa. Por ejemplo, si define una consulta de definición de modo que solo se visualicen los ríos que se encuentran a menos de 5 millas de una mina, sería útil cambiar el nombre de la capa para reflejarlo; por ejemplo, cambie el nombre de la capa rivers near mines. Si la clase de entidad participa en una clase de relación y, por tanto, los datos relacionados se incluirán en el servicio que publique, puede cambiar el nombre de la capa para reflejarlo. Por ejemplo, si la clase de entidad "rivers" participa en una clase de relación que la une a una tabla que contiene información de cuencas hidrográficas, podría cambiar el nombre de la capa rivers and watersheds.
Definir la simbología
Un servicio de entidades le permite consultar entidades y también obtener su simbología. Los clientes pueden utilizar esta información para dibujar entidades con una simbología en consonancia con lo que se define en el servicio.
Los símbolos que devuelve el servicio se basan en la simbología de las capas en el documento de ArcMap. Cada símbolo en cada capa se denomina tipo. Por ejemplo, una capa simbolizada con un solo renderizador (un símbolo) posee un tipo. Si se utiliza un renderizador de valores únicos, se devuelve un tipo por cada valor único del renderizador.
Los servicios de entidades admiten renderizadores simples, de valores únicos, de corte de clase y representación cartográfica. Si utiliza un renderizador no compatible, no se iniciará el servicio. Utilice el registro de ArcGIS Server para determinar las capas que poseen renderizadores no compatibles.
Nota:
Los servicios de entidades publicados desde ArcMap no admiten símbolos proporcionales ni simbología de valores únicos basados en varios campos.
La mayoría de los tipos de símbolos se pueden utilizar con un servicio de entidades; sin embargo, en algunos casos, los símbolos se pueden degradar.
Para las capas de línea, se admiten símbolos de línea simple. Si se utilizan otros símbolos, el servicio de entidades los convierte a un símbolo de línea simple que represente mejor el símbolo original. Por ejemplo, un símbolo de línea cartográfica en el documento de mapa se puede dibujar como una línea continua simple en un cliente del servicio de entidades. Si un símbolo de línea es complejo o tiene varias capas, el servicio de entidades degrada la línea para representar mejor el símbolo de la línea original.
Para las capas de polígono, se admiten rellenos simples y símbolos de relleno de imagen. Si se utilizan otros símbolos, el servicio de entidades los degrada a símbolos de relleno simple. Para los símbolos de relleno multicapa, el servicio de entidades solo considera la capa superior. Además, un símbolo de contorno del símbolo de relleno tiene el mismo nivel de compatibilidad para las capas de línea según se describe anteriormente.
Para las capas de punto, se admiten marcadores simples y símbolos de marcador de imagen. Si se utilizan otros símbolos, el servicio de entidades los degrada a símbolos de marcador de imagen. Los símbolos de marcador multicapa también se degradan a símbolos de marcador de imagen donde las capas se fusionan en una sola capa. Las propiedades de máscara, en las que se puede establecer un halo para un símbolo de marcador, no se admiten.
Cuando se inicia un servicio de mapas con acceso a entidades, los símbolos se activan y degradan si es necesario. En los casos en los que se requiere una degradación, se agrega una advertencia en el registro del servidor para describir los símbolos que se degradaron.
También es importante tener en cuenta que, si tiene capas en el documento de mapa que utilizan renderizadores de representación cartográfica, los renderizadores se informan como renderizadores de valor único cuando los clientes acceden al servicio a través de REST.
Nota:
Esri recomienda utilizar colores RGB en los símbolos; de lo contrario, pueden producirse cambios menores cuando los colores se convierten al formato de color RGB.
Definir plantillas de entidad
Se pueden insertar nuevas entidades a través de un servicio de entidades mediante el uso de plantillas de entidades desde el documento de mapa. Una plantilla le permite digitalizar una nueva entidad y tener los valores predeterminados del atributo establecidos según corresponda. Los servicios de entidades necesitan una plantilla para cada tipo de entidad. Cuando empiece a editar una sesión o a publicar el servicio, se creará una plantilla predeterminada para cada tipo.
Para los datos de la base de datos se usan siempre las plantillas predeterminadas. Puede crear plantillas personalizadas para utilizarlas con los datos de la geodatabase. Consulte la sección Plantillas de entidades personalizadas para obtener más información.
Establecer un rango de escala
De forma predeterminada, los servicios de entidades solo muestran 1.000 entidades. Establezca el rango de escala para las capas de entidades del mapa que publica para que la capa no se muestre en una escala en la que aparecerían más entidades de las permitidas.
Para definir un rango de escala para una capa de entidades, haga clic con el botón derecho en la capa de la tabla de contenido de ArcMap y haga clic en Propiedades. Establezca el Rango de escala en la pestaña General del cuadro de diálogo Propiedades de capa.
Propiedades del campo
Las propiedades de campo establecidas en ArcMap se exponen mediante el servicio de entidades; esto incluye el alias del campo, su visibilidad y una propiedad de solo lectura del campo. Los campos de solo lectura incluyen los campos administrados por el sistema, como ObjectID, GlobalID y campos del rastreo del editor (solo en la geodatabase) y los campos configurados como de solo lectura en el documento de mapa.
Cuando se aplica una actualización, si se establece un valor para un campo de solo lectura, el servicio de entidades ignora este valor. Cuando se aplica un inserto, se aplican valores predeterminados para los campos invisibles y de solo lectura. Si no se han definido valores predeterminados se aplican los Nulos. Si el campo no puede almacenar valores nulos, la inserción no se realiza correctamente.
Descripción de capa e información de copyright
Las descripciones de capa y los créditos (copyrights) especificados en el documento de mapa se exponen para cada capa en el servicio de entidades como una descripción de capa e información de copyright, respectivamente.
Mensajes emergentes HTML
Los servicios de entidades admiten mensajes emergentes HTML configurados en ArcMap. Los mensajes emergentes HTML comprenden una forma fácil y potente de compartir información sobre entidades con formato HTML. Estos funcionan de forma similar a la herramienta Identificar, salvo en que la información visualizada puede ser HTML personalizado. Para obtener más información sobre cómo configurar mensajes emergentes HTML en ArcMap, consulte Configurar las propiedades de HTML emergentes para las capas de entidades.
Si trabaja con el servicio de entidades en la web y desea que los elementos emergentes estén disponibles, considere la posibilidad de definirlas en el Map Viewer. Los desarrolladores también pueden utilizar la propia API cliente para definir los estilos de los mensajes emergentes.
Compatibilidad con el tiempo
Los servicios de entidades admiten datos temporales, es decir, datos que representan un estado en el tiempo. Almacene la información de tiempo en uno o varios campos de atributos y utilice esta información para visualizar los datos en intervalos de tiempo o en momentos concretos. Para exponer datos temporales para una capa a través del servicio de entidades, habilite el tiempo en la pestaña Hora del cuadro de diálogo Propiedades de capa. Para obtener más información acerca de cómo habilitar el tiempo en una capa, vea Habilitar tiempo en los datos.
Sistemas de coordenadas
El documento de mapa que publique como servicio de entidades puede contener capas con distintos sistemas de coordenadas. Cuando los clientes acceden al servicio de entidades, dicho servicio traduce el sistema de coordenadas si es necesario. Por ejemplo, si un cliente inserta una entidad mediante un servicio de entidades con un sistema de coordenadas diferente al sistema de coordenadas de la capa, el servicio de entidades convierte el sistema de coordenadas de la entidad de forma que coincida con el sistema de coordenadas de la capa antes de almacenar la nueva entidad. Las consultas espaciales sobre geometría también se convierten al sistema de coordenadas de la capa antes de aplicarse para devolver los resultados correctos.
El servicio de entidades también utiliza transformaciones geográficas (datum) si es necesario. Por ejemplo, si la capa se almacena en NAD27 y se inserta una entidad a través del servicio con un sistema de coordenadas de WGS 1984, se produce una transformación de datum de WGS 1984 a NAD27 antes de almacenar la entidad. Puede controlar el método de transformación al configurar las transformaciones en las propiedades del marco de datos del documento de mapa antes de su publicación. Se produce una transformación predeterminada si no se define una en el mapa.
Nota:
Aunque puede publicar capas independientes que tienen diferentes sistemas de coordenadas, todos los registros de una tabla individual deben usar el mismo sistema de coordenadas.
Datos unidos
Puede definir uniones de atributos para capas o tablas en el documento de mapa. Cuando publica un servicio de mapas con capacidad de acceso a entidades en un sitio de GIS Server, las columnas unidas se incluyen en el servicio de mapas, pero no se incluyen en el servicio de entidades. El servicio de entidades solo incluye las columnas de la tabla de unión (la tabla o la clase de entidad en la que ha definido la unión). Si la simbología de la capa se basa en una columna unida, el servicio de mapas incluye el renderizador que utilizó para simbolizar entidades, pero el servicio de entidades vuelve a mostrar un renderizador simple. Si el renderizador de la capa se basa en una columna de la clase de entidad más a la izquierda de la unión, el servidor de mapas y el servidor de entidades incluyen el renderizador.
No se pueden publicar datos unidos en un portal de ArcGIS Enterprise ni en ArcGIS Online. Quite las uniones antes de publicar un servicio de entidades (capa de entidades alojada) en cualquiera de estas aplicaciones.
Funcionalidad adicional de las geodatabases
Si los datos están almacenados en una geodatabase, puede utilizar algunas funciones adicionales. Configure esta funcionalidad antes de publicar un servicio de entidades.
Definir subtipos y dominios de atributo
Si los datos publicados se encuentran en una geodatabase, configure los datasets de modo que usen subtipos y dominios de atributos cuando sea necesario para mejorar la experiencia del usuario con el servicio de entidades y evitar errores en la introducción de datos. Estos proporcionan formas de categorizar los datos y garantizar que se introducen los valores apropiados cuando se editan los datos. Los servicios de entidades pueden detectar y utilizar los subtipos y dominios. Por ejemplo, si tiene un dominio que limita el color de una boca de riego a rojo, amarillo o azul, verá una lista desplegable en la aplicación Web que le permite la selección de solo uno de estos tres colores.
Nota:
Si publica un servicio de entidades sin copiar datos, la información del subtipo se incluye en el servicio de entidades independientemente del renderizador que utilice. Si publica una capa de entidades en ArcGIS Online o un portal de ArcGIS Enterprise, la información de subtipo solo se incluye cuando se publican capas mediante un renderizador de valor único en una columna de subtipo.
Plantillas de entidades personalizadas
En ArcMap, puede crear plantillas o modificar las plantillas existentes para personalizar la experiencia de edición a través del servicio de entidades. Esto incluye la configuración de una herramienta de construcción predeterminada que se utiliza para crear ese tipo de entidad. Si elimina una plantilla de un tipo de entidad en concreto, se crea una plantilla predeterminada cuando realiza la publicación.
Hay distintos tipos de herramientas de construcción disponibles según el tipo de entidad que cree la plantilla. Por ejemplo, si posee una plantilla de línea solo puede seleccionar las herramientas que se pueden utilizar para crear entidades de línea. La herramienta de construcción que se guardó con las plantillas está disponible a través del servicio de entidades. La única excepción es la herramienta de punto denominada Punto al final de la línea, que no es admitida por el servicio de entidades. Para obtener más información acerca de las plantillas, vea Configurar las propiedades de la plantilla de entidad.
Cuando se guarda el documento de mapa, las plantillas se guardan con las capas en el mapa. Cuando se publica el documento de mapa, estas plantillas están disponibles para los clientes del servicio de entidades. Una vez que se definen las capas, los tipos y las plantillas en el documento de mapa, puede publicar el servicio.
Adjuntos
Los servicios de entidades le permiten consultar y editar adjuntos. Un adjunto es un archivo multimedia asociado a una entidad o un objeto de una geodatabase. Por ejemplo, con los adjuntos, se pueden agregar fotografías y vídeos a un avistamiento de aves y se puede visualizar al hacer clic en el punto de la vista. Para utilizar esta entidad, primero se deben configurar los datasets dentro de una geodatabase para admitir adjuntos. Cuando estos datasets se publican y se agregan a un documento de mapa, los clientes pueden consultar, insertar y eliminar los adjuntos mediante el servicio de entidades.
Hay límites impuestos sobre el tamaño y tipos de archivo que puede adjuntar a un servicio de entidades. Para obtener más información sobre estos límites y sobre la manera de modificar la configuración de adjuntos, consulte Cargas en la Ayuda de la API REST de ArcGIS.
Para obtener más información sobre cómo configurar un dataset para admitir adjuntos, consulte Habilitar adjuntos.
Ejemplo de flujo de trabajo de ArcMap: servicio de entidades de un avistamiento de aves
La siguiente sección lo guía por un ejemplo sobre cómo configurar un documento de mapa, definir los datos y definir la simbología que se expone a través del servicio de entidades de un avistamiento de aves. El servicio de entidades permite a los miembros de la comunidad ornitológica publicar sus avistamientos de aves directamente en el mapa y adjuntar archivos multimedia como fotografías, archivos de audio y archivos de vídeo en puntos de observación específicos.
Nota:
Los pasos de este ejemplo se pueden aplicar a las geodatabases y bases de datos; sin embargo, los adjuntos de entidades y las plantillas de entidades personalizadas no están disponibles en las bases de datos. Puede omitir el contenido que analiza esta función si los datos con los que trabaja no están almacenados en una geodatabase.
Definir los datos
El primer paso para crear un servicio de entidades consiste en definir los datos que estarán disponibles en el servicio. Este ejemplo comienza con una clase de entidad denominada Bird_Sightings de una geodatabase. Para asociar adjuntos con esta clase de entidad, estos se deben agregar en ArcCatalog o en la ventana ArcCatalog o la ventana Catálogo en ArcMap. Para ello, conéctese a la base de datos, haga clic con el botón derecho en la clase de entidad, y a continuación, elija Administrar > Crear adjuntos. Se crea una tabla que almacena los adjuntos y una clase de relación que relaciona la clase de entidad con la tabla de adjuntos. Para obtener más información sobre cómo agregar adjuntos a una clase de entidad, consulte Habilitar adjuntos.
Nota:
Determinados tipos de datos de geodatabases corporativas se deben registrar como versionados para permitir la edición. Este mismo requisito también se aplica a la edición de los servicios de entidades. Para obtener más información, consulte Descripción general del versionado tradicional.
Definir la simbología
Una vez que se han configurado, el paso siguiente consiste en agregar los datos a ArcMap y definir la simbología. Los símbolos que devuelve el servicio de entidades se basan en la simbología de las capas en el documento de ArcMap. Cada símbolo en cada capa se denomina tipo. En este ejemplo, por defecto, la capa Bird_Sightings está simbolizada con un solo renderizador (un símbolo).
Sin embargo, en este caso, desea simbolizar la capa de avistamiento de aves basada en el tipo de vista. Para hacer esto, se puede utilizar un único renderizador. Para cambiar la forma de renderizar una capa, haga clic con el botón derecho en la capa y elija Propiedades. En el cuadro de diálogo Propiedades de capa, haga clic en la pestaña Simbología y elija Valores únicos en Categorías. A continuación, puede seleccionar el campo que desea utilizar para simbolizar la capa. En este caso, hay tres tipos de avistamientos únicos (de aves, de nidos y de aves poco frecuentes); por consiguiente, el servicio devolverá tres tipos (uno por tipo de avistamiento).
Una vez seleccionado el renderizador, el paso siguiente es elegir los símbolos que representan a cada tipo de vista. En este caso, se selecciona un símbolo de pájaro del selector de símbolo de Esri. Los colores de primer plano y de fondo se establecen de forma diferente para cada tipo de avistamiento con el fin de que se puedan distinguir fácilmente en el servicio de entidades. Cuando se publica el documento de mapa, los símbolos se convierten en gráficos PNG, los cuales se devuelven al cliente.
Una vez que se configura a simbología, el próximo paso a seguir es definir el entorno de edición que estará disponible en el servicio de entidades.
Definir el entorno de edición
El objetivo de este servicio de entidades es permitir a aquellos usuarios que les gustan las aves puedan introducir avistamientos de aves y toda información relevante en un mapa. La edición a través de un servicio de entidades se logra mediante el uso de plantillas de entidad desde el documento de mapa. Si no crea ninguna plantilla, se crea una plantilla predeterminada por tipo cuando publica el servicio. No obstante, también puede crear plantillas o modificar las plantillas existentes para personalizar la experiencia de edición.
En este ejemplo, desea crear plantillas para este servicio de entidades. Para hacer esto, haga clic con el botón derecho en la clase de entidad, elija Editar entidades y, a continuación, elija Organizar plantillas de entidades. En Capas, seleccione la capa y haga clic en Nuevas plantillas. Se abre el asistente de Plantilla, donde puede crear plantillas. Elija crear plantillas para todos los tipos diferentes de avistamientos de aves. Una vez creadas las plantillas, cópielas para crear plantillas adicionales.
Para este servicio de entidades, desea agregar una plantilla adicional para el tipo de avistamiento de aves poco frecuentes. Los avistamientos de aves poco frecuentes pueden ser aquellas aves que se encuentren dentro del área fuera de temporada o en peligro. Para crear una copia de una plantilla, seleccione la plantilla que desea copiar y haga clic en Copiar. En este caso, se crea una copia de la plantilla de la vista de pájaro poco frecuente de modo que cada una de ellas se puede personalizar para representar los dos tipos de avistamientos de aves poco frecuentes. Para personalizar una plantilla, haga doble clic en ella en la ventana Organizar plantillas de entidades. Se muestran las propiedades de plantilla, en las que puede editar el nombre de las plantillas y los valores de campo predeterminados.
La plantilla para los avistamientos de aves poco frecuentes en peligro tiene el tipo de vista establecido en Avistamientos de aves poco frecuentes y la descripción establecida en En peligro. La plantilla para los avistamientos de aves poco frecuentes fuera de estación tiene el tipo de vista establecido en Avistamientos de aves poco frecuentes y la descripción establecida en Fuera de estación.
El resto de los atributos también se pueden establecer a los valores predeterminados correspondientes dentro de cada plantilla. En este caso, los avistamientos de aves poco frecuentes en peligro requieren una topografía de seguimiento para que el atributo Seguimiento se pueda establecer en Sí. No se requiere un seguimiento para los avistamientos de aves poco frecuentes fuera de temporada; por consiguiente, el atributo Seguimiento se puede establecer en No.
Establecer algunos de los atributos a valores predeterminados en las plantillas racionaliza la edición para los usuarios finales ya que solo deben seleccionar el tipo de entidad y digitalizarlo. Una vez que se definen las capas, los tipos y las plantillas en el documento de mapa, puede publicar el servicio. Una vez publicado, los usuarios finales pueden acceder al servicio a través de clientes web o de ArcGIS Desktop para las consultas y la edición.
Para obtener más información, consulte Publicar un servicio de entidades.
Otros tutoriales de ejemplo
Si necesita más información sobre la configuración y el uso de un servicio de entidades, los siguientes tutoriales proporcionan ejemplos paso a paso sobre el modo de configurar un documento de mapa, definir los datos y definir la simbología que se expone a través de un servicio de entidades para llevar a cabo una edición web. Los tutoriales varían en función de si almacenó los datos en una base de datos o una geodatabase corporativa.
Geodatabase corporativa
Siga los tutoriales de geodatabases corporativas si los datos se han almacenado en una geodatabase corporativa:
Tutorial: Edición web utilizando los datos de una geodatabase corporativa
Tutorial: Edición web utilizando los datos replicados de una geodatabase corporativa
Tutorial: Configurar datos del servicio de entidades para su uso sin conexión
Base de datos
Si los datos se han almacenado en una base de datos, siga el tutorial correspondiente:
Tutorial: Realizar la edición web utilizando datos de una base de datos