Crear servicios de entidades

El proceso de creación de servicios de entidades implica la configuración de un documento de mapa para definir los datos y la simbología que expondrá el servicio. Si desea permitir la edición en el servicio también puede definir el entorno de edición.

Definir los datos

El servicio expone las capas y tablas que agrega al documento de mapa. A continuación se describen los requisitos para los datos del servicio de entidades:

• Todos los datos deben provenir de una sola geodatabase de ArcSDE.
• Todos los datos deben registrarse con la geodatabase.
• Si desea permitir la edición de datos, se requieren permisos de escritura para los datos de ArcSDE. Cuando utiliza la autenticación del SO, estos permisos se deben otorgar a la cuenta de ArcGIS for Server.
• Se admiten datos versionados y no versionados, sin embargo, se requieren datos versionados si desea editar tipos no simples (por ejemplo, ejes de red) con el servicio.

Los siguientes tipos de datos no son compatibles con los servicios de entidades:

• Anotaciones
• Dimensiones
• Terrenos
• Datasets ráster
• Capas y tablas basadas en vistas de SDE

Si estas capas están presentes en los documentos de mapa cuando intente publicar un servicio de mapas con el acceso a entidades activado, se producirán errores de analizador.

Nota:

Los servicios de mapas son compatibles con las vistas de SDE. Si quiere realizar consultas a nivel de entidad con capas y tablas derivadas de vistas de SDE, utilice un servicio de mapas.

Son compatibles las capas que forman parte de los tipos no simples, como redes geométricas, topologías y datasets de red, aunque el servicio no devuelve los propios tipos. Por ejemplo, podrá consultar las capas que forman parte de una topología, pero no consultar la propia topología.

Los servicios de entidades también permiten realizar consultas sobre datos relacionados. Por ejemplo, un documento de mapa publicado puede incluir capas y tablas que están relacionadas a través de clases de relación de la geodatabase. En este caso, el servicio de entidades permite realizar consultas sobre una capa para devolver los objetos de la capa o tabla relacionada. Tenga en cuenta que para admitir consultas que devuelven objetos relacionados, la tabla y la capa implicadas en la clase de relación se deben incluir en el documento de mapa publicado. Si la capa o la tabla de origen y/o destino no se incluye en el documento de mapa, el servicio de entidades ignorará la relación.

Si desea utilizar el servicio de entidades para editar, se recomienda que solo agregue datos al documento de mapa que desea editar. Los datos que no desea editar, como las capas de mapa base, se deben publicar en un servicio diferente. Para obtener más información acerca de la planificación de servicios operacionales y de mapas base, vea Planificación de servicios de mapa. Otra alternativa es utilizar un servicio de ArcGIS Online que se puede utilizar como mapa base. Para obtener más información sobre cómo superponer un mapa para superponer mapas y servicios on-line, vea Diseñar un mapa para superponer ArcGIS Online, Google Maps y Bing Maps.

Puede editar y eliminar entidades que tienen valores z. Para obtener más información, consulte Editar entidades con valores z en los servicios de entidades.

Si tiene datos con valores m, estas entidades se pueden eliminar, las nuevas entidades se pueden insertar y los atributos de las entidades existentes se pueden editar, pero la geometría no se puede editar. Todas las nuevas entidades tienen los valores m establecidos como NaN cuando se inserten a través de los extremos REST y SOAP. Si las entidades con valores m se editan a través del servicio de entidades en ArcMap con los comandos de edición local, se admiten todas las operaciones de edición.

Además, si desea realizar una edición utilizando el servicio de entidades en ArcMap (ver debajo), asegúrese de incluir solo una capa por clase de entidad cuando cree el documento de mapa.

Nota:

Las capas virtuales, como eventos de ruta, eventos x, y y estructuras catastrales son de solo lectura a través del servicio de entidades.

Configurar el documento de mapa

El próximo paso a seguir después de agregar los datos que desea publicar en el documento de mapa consiste en establecer las propiedades en las capas y tablas. Estas propiedades definen cómo se mostrarán los datos y lo que el cliente podrá realizar con ellos.

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 las entidades con una simbología que es consistente 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 por valores únicos, se devuelve un tipo para cada valor único en el renderizador.

Los servicios de entidades admiten renderizadores simples, de valores únicos, de corte de clase y representación cartográfica. Si se utiliza un renderizador no compatible, no se iniciará el servicio. El registro del servidor se puede utilizar en este caso para determinar las capas que poseen renderizadores que no son compatibles.

Nota:

Los símbolos proporcionales, así como los renderizadores de valores únicos basados en varios campos, no son compatibles con los servicios de entidades.

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 en 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 marcan y degradan en caso de ser 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 el documento de mapa tiene capas que utilizan renderizadores de representación cartográfica, los renderizadores se identificarán como renderizadores de valor único cuando los clientes accedan al servicio a través de REST.

Nota:

Se recomienda utilizar colores RGB en los símbolos; de lo contrario, pueden ocurrir cambios menores cuando los colores se convierten al formato de color RGB.

Definir subtipos y dominios de atributo

Para mejorar la experiencia de usuario del servicio de entidades y para evitar errores al introducir datos, configure sus datasets para utilizar subtipos y dominios de atributo cuando sea necesario. Estos proporcionan formas de categorizar los datos y garantizar que se introducen los valores apropiados cuando se editan los datos. Los servicios de entidades puede 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.

Definir las plantillas de entidades

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.

En ArcMap, también puede crear nuevas plantillas o modificar las plantillas existentes para personalizar la 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 creará una plantilla predeterminada cuando realice la publicación.

Hay distintos tipos de herramientas de construcción disponibles según el tipo de entidad que creará 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 esta 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. La sección Publicar servicios de entidades describe cómo publicar un servicio de entidades.

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. Los campos de solo lectura incluyen campos administrados por el sistema —como ObjectID, GlobalID y campos del rastreo del editor— 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.

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.

Adjuntos

Los servicios de entidades le permiten consultar y editar adjuntos. Un adjunto es un archivo multimedia que está asociado con una entidad o un objeto. Por ejemplo, con los adjuntos, se pueden agregar fotografías y vídeos a una vista de pájaro, 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. Consulte información más detallada acerca de estos límites y cómo modificar la configuración de adjuntos en la sección Descargas de la Ayuda de API REST de ArcGIS.

Para obtener más información sobre cómo configurar un dataset para admitir adjuntos, consulte Habilitar adjuntos en una clase de entidad.

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. Éstos funcionan de forma similar a la herramienta de Identificar, excepto que la visualización de la información puede ser HTML personalizado. Para obtener más información sobre cómo configurar mensaje emergentes HTML en ArcMap, vea Configurar propiedades de mensajes emergentes HTML para las capas de entidades.

Si va a trabajar con el servicio de entidades en la Web y desea que las ventanas emergentes estén disponible, considere definirlos en el Visor de mapas ArcGIS.com. De manera alternativa, los desarrolladores pueden utilizar la API cliente en sí, como la ArcGIS API for JavaScript, para definir los estilos de los mensajes emergentes.

Compatibilidad con el tiempo

Los datos temporales, que son datos que representan un estado en el tiempo, son compatibles y se pueden visualizar a través de los servicios de entidades. La información del tiempo se almacena en un solo campo o en varios campos de atributos, y se puede utilizar para visualizar los datos en períodos específicos o en intervalos de hora. Los datos temporales se pueden exponer a través del servicio de entidades al habilitar 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 un dataset, vea Habilitar tiempo en los datos.

Sistemas de coordenadas

Los servicios de entidades admiten casos en los que las capas del documento de mapa poseen sistemas de coordenadas diferentes. Las traducciones del sistema de coordenadas se realizan en caso de ser necesario cuando se utiliza el servicio de entidades. Por ejemplo, si un cliente inserta una entidad mediante un servicio de entidades con un sistema de coordenadas que es diferente al sistema de coordenadas de la capa, esta se convierte al sistema de coordenadas de la capa antes de ser almacenada. Las consultas espaciales sobre geometría también se convierten al sistema de coordenadas de la capa antes de aplicarse para poder devolver los resultados correctos.

En caso de ser necesario, también se utilizan las transformaciones geográficas (datum). 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.

Ejemplo de flujo de trabajo: servicio de entidades de un avistamiento de pájaros

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 expondrá a través del servicio de entidades de una vista de pájaro. El servicio de entidades permitirá a la comunidad de usuarios publicar sus vistas de pájaros 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.

Definir los datos

El primer paso para crear un servicio de entidades consiste en definir los datos que estarán disponibles en el servicio. En este ejemplo, comienza con una clase de entidad denominada Bird_Sightings en una geodatabase de ArcSDE. Para asociar adjuntos con esta clase de entidad, éstos se deben agregar en ArcCatalog. Para hacer esto, conéctese a ArcSDE, haga clic con el botón derecho en la clase de entidad, y a continuación, elija Adjuntos y Crear adjuntos. Se crea una tabla que almacenará los adjuntos y una clase de relación que relaciona la clase de entidad con la tabla de adjuntos. Consulte información sobre cómo agregar adjuntos a una clase de entidad en Habilitar adjuntos en una clase de entidad.

Nota:

Algunos tipos de datos requieren el control de versiones para poderlos editar en una geodatabase. Este mismo requisito también se aplica a la edición de los servicios de entidades. Para obtener más información, consulte Un recorrido rápido por las versiones.

Definir la simbología

Una vez que se configuraron los datos en una geodatabase de ArcSDE, el próximo paso 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 la vista de pájaro basado 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, haga clic en la pestaña Simbología y en Categorías, elija Valores únicos. A continuación, puede seleccionar el campo que desea utilizar para simbolizar la capa. En este caso, hay tres tipos de vista únicos (vista de pájaro, vista de nido y vista de pájaro poco frecuente), de modo que el servicio devolverá tres tipos (uno para cada tipo de vista).

Resultados de la representación en pantalla simple en un tipo para la capa Bird_Sightings.

Resultados de la representación en pantalla de valores únicos en tres tipos para la capa Bird_Sightings.

Ahora que ya se seleccionó el renderizador, el próximo paso a seguir es elegir los símbolos que representarán a cada tipo de vista. En este caso, se seleccionará un símbolo de pájaro en el selector de símbolos de Esri. Los colores de primer plano y de fondo se establecen de forma diferente para cada tipo de vista para 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.

Símbolos de marcador de caracteres se utilizan para simbolizar los distintos tipos de vista de pájaro.

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 los pájaros introducir vistas de pájaros 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 un plantilla predeterminada por tipo cuando publica el servicio. No obstante, también puede crear nuevas plantillas o modificar las plantillas existentes para personalizar la 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 y elija Editar entidades, a continuación, seleccione Organizar plantillas de entidades. En Capas, seleccione la capa y haga clic en Nuevas plantillas. Aparece el asistente Plantillas, donde puede crear plantillas. Elija crear plantillas para todos los tipos diferentes de vistas de pájaro. Una vez que se hayan creado plantillas, puede utilizarlas para crear plantillas adicionales.

Para este servicio de entidades, desea agregar una plantilla adicional para el tipo de vista de pájaro poco frecuente. Las vistas de pájaros poco frecuentes pueden ser aquellos pájaros que están en el área fuera de estación 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 vistas de pájaros 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.

Propiedades de plantilla para las Vistas de pájaros en peligro que requieren Vistas de pájaros de estudios de seguimiento y fuera de estación que no requieren estudios de seguimiento.

La plantilla para las vistas de pájaros poco frecuentes en peligro tiene el tipo de vista establecido en Vistas de pájaros poco frecuentes y la descripción establecida en En peligro. La plantilla para las vistas de pájaros poco frecuentes fuera de estación tiene el tipo de vista establecido en Vistas de pájaros 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, las vistas de pájaros poco frecuentes en peligro requieren una topografía de seguimiento, para que el atributo Seguimiento se pueda establecer en Sí por defecto. No se requiere un seguimiento para las vistas de pájaros poco frecuentes fuera de estación, de modo que el atributo Seguimiento se puede establecer en No.

Establecer algunos de los atributos a valores predeterminados en las plantillas simplifica 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 ArcGIS for Desktop para las consultas y la edición.

Para obtener más información acerca de la publicación de un servicio de entidades, consulte Publicar servicios de entidades.