Skip To Content

Servicios de entidades y aplicaciones cliente

Hay una variedad de clientes de ArcGIS disponibles que se pueden utilizar para editar (o ver) las entidades en el servicio de entidades. Los clientes pueden consumir los servicios de entidades mediante un cliente web o ArcGIS Desktop.

Clientes web de ArcGIS listos para usar

El Map Viewer Classic y las plantillas de ArcGIS Online y ArcGIS Enterprise proporcionan funciones básicas y de uso inmediato para la edición de servicios de entidades. Sin tener que programar, puede crear rápidamente una aplicación de edición web que permita a los usuarios agregar, actualizar y eliminar entidades geográficas de una base de datos.

Por ejemplo, cuando utiliza las aplicaciones listas para usar, puede hacer lo siguiente:

  • Editar capas de solo selección.
  • Rastrear ediciones. (Esto está disponible para geodatabases corporativas, no para bases de datos).
  • Controlar el acceso a entidades mediante el control de acceso basado en la propiedad. (Esto está disponible para geodatabases corporativas, no para bases de datos).
  • Evitar que los usuarios editen la geometría de entidad.

Puede agregar servicios de entidades al Map Viewer Classic en ArcGIS Online o en el sitio web de su portal a través de la URL del Directorio de servicios de ArcGIS Server correspondiente al servicio. Una vez que cree un mapa que contenga el servicio de entidades, podrá compartirlo con otras personas de su organización, integrarlo en un sitio web o pegar un vínculo (URL) de la aplicación en un mensaje de correo electrónico, un blog o un sitio web. Los mapas que cree también se pueden implementar en el servidor web de su organización descargando las plantillas de la aplicación desde ArcGIS Online. Estas plantillas son totalmente personalizables.

Los tutoriales siguientes usan un servicio de entidades junto con el ArcGIS.com map viewer para editar entidades:

También puede agregar servicios de entidades como elementos en el portal o en ArcGIS Online y compartirlos con otros miembros de su organización.

Consulte la Ayuda de Portal for ArcGIS para obtener más información sobre el uso de Portal for ArcGIS.

Clientes de ArcGIS API for JavaScript

ArcGIS API for JavaScript ofrece las funciones de edición Web y las opciones de personalización más avanzadas. Si se siente cómodo programando con esta API, puede crear una sofisticada experiencia para sus usuarios en la Web adaptando su escenario de edición para un fin, objetivo o estrategia de organización específicos. Por ejemplo, con ArcGIS API for JavaScript puede hacer lo siguiente:

  • Editar las capas solo de selección
  • Rastrear ediciones (Está disponible para geodatabases corporativas, no para bases de datos.)
  • Controlar el acceso a entidades mediante el control de acceso basado en la propiedad
  • Evitar que los usuarios editen la entidad geométrica
  • Crear, eliminar y cambiar versiones de geodatabases al vuelo ("on the fly")
  • Editar las representaciones cartográficas

Obtener el extremo REST de un servicio de entidades

Puede obtener el extremo REST, o URL, de un servicio de entidades navegando hasta el servicio en el Directorio de servicios de ArcGIS Server. Por ejemplo, la dirección URL predeterminada de un servicio de entidades del Directorio de servicios es http://gisserver.domain.com:6080/arcgis/rest/services/folder/service/FeatureServer. Un entero basado en cero se puede incorporar a la dirección URL para hacer referencia a una capa particular en el servicio. Por ejemplo, terminar una URL con /0 devuelve la primera capa del servicio.

ArcGIS Desktop

ArcGIS Desktop le permite editar los datos en los servicios de entidades. El flujo de trabajo para editar en ArcGIS Desktop es fundamentalmente diferente a la edición de un servicio de entidades a través de una aplicación web. Para obtener más información, consulte Acerca de la edición de los datos de los servicios de entidades.

Usar sync (sincronización) con servicios de entidades

Los servicios de entidades incluyen operaciones que son compatibles con los flujos de trabajo de edición sin conexión. En un entorno desconectado, el cliente (por ejemplo, un dispositivo móvil o de tiempo de ejecución) puede realizar cambios locales y después sincronizar los cambios con el servidor cuando el cliente se vuelva a conectar al servicio de entidades. Esta funcionalidad, denominada sync (sincronización), está disponible a través de la API REST de ArcGIS.

Para obtener más información acerca de la funcionalidad sync con servicios de entidades, consulte la sección sync de la Ayuda de API REST de ArcGIS Server.

Mejorar el rendimiento en la visualización de los servicios de entidades

Cuando los clientes envían solicitudes a ArcGIS Server para consultar un servicio de entidades, por lo general, la respuesta del servidor queda en caché en el servidor y se reutiliza durante cierto tiempo. No obstante, según cómo se utilicen el servicio de entidades y sus datos asociados en aplicaciones, es posible que deba ajustarse el tiempo durante el cual el navegador debe utilizar una respuesta del caché. Esto se puede lograr agregando una propiedad llamada cacheControlMaxAge a la Notación de objetos JavaScript (JSON) del servicio.

Cómo se utiliza la propiedad cacheControlMaxAge

Las respuestas de los servicios de entidades de ArcGIS Server incluyen una etiqueta de entidad (ETag) y un encabezado Cache-Control. El valor del encabezado ETag es un identificador único de la respuesta. El encabezado Cache-Control tiene un valor max-age que proporciona información al navegador en relación con el tiempo máximo durante el cual se puede reutilizar la respuesta del caché del navegador. Este valor se controla mediante la propiedad cacheControlMaxAge.

Si se repite una solicitud anterior y no se ha superado la duración máxima del caché, el navegador utiliza la respuesta del caché sin enviar la solicitud al servidor. Si se ha superado la duración máxima del caché, el navegador debe enviar la solicitud al servidor y establecer un encabezado IF-NONE-MATCH con un valor de ETag asociado correspondiente a la respuesta en su caché. ArcGIS Server evalúa la solicitud y utiliza el valor de ETag para determinar si la respuesta ha cambiado. Si la respuesta del servidor es distinta de la copia que hay en el navegador, el servidor envía una respuesta totalmente nueva al navegador. Si la respuesta es idéntica a la copia que hay en el navegador, el servidor alerta al navegador para que continúe utilizando la respuesta que tiene en el caché.

Definición del valor de la propiedad cacheControlMaxAge

Para especificar durante cuánto tiempo se permite al navegador utilizar una respuesta que esté en la caché, defina la propiedad cacheControlMaxAge. Esta propiedad puede establecerse para cachés de servicios individuales. Puesto que se reduce la necesidad de que ArcGIS Server envíe respuestas completas, esto permite que la caché del navegador sea más eficiente, ayuda a optimizar las aplicaciones y ahorra ancho de banda.

En el caso de los servicios de entidades, el valor predeterminado es de cero segundos. Esto significa que el navegador siempre vuelve a enviar las solicitudes y que ArcGIS Server procesará las solicitudes y enviará respuestas completas al navegador si el contenido ha cambiado. Este valor funciona correctamente para la mayoría de aplicaciones.

En el caso de servicios de entidades cuyos datos no cambien frecuentemente, se recomienda aumentar el valor predeterminado hasta 30 días (2.592.000 segundos) o más para minimizar el tráfico de la red.

Para agregar la propiedad cacheControlMaxAge a un servicio y especificar su valor predeterminado, se hace así:

  1. En un navegador web, abra el Directorio del administrador de ArcGIS Server e inicie sesión con un usuario que tenga privilegios de administración. La dirección URL tiene el formato http://gisserver.domain.com:6080/arcgis/admin.
  2. Haga clic en servicios y seleccione el servicio de entidades que desee modificar en la lista Servicios. Si no ve el servicio en la lista, es posible que se encuentre en un directorio debajo de la carpeta Raíz.
  3. En la página de destino del servicio de entidades, desplácese a la parte inferior y haga clic en editar.
  4. Se abre el cuadro de diálogo Permisos del servicio. Desplácese hasta la ubicación del archivo JSON en la que se insertará la propiedad cacheControlMaxAge. Dependerá de dónde esté publicado su servicio de entidades:
    • Si su servicio de entidades se publica en un ArcGIS Server federado o independiente, busque la sección "extensions" del JSON. Desplácese hasta la subsección que contiene "typeName": "FeatureServer". La propiedad cacheControlMaxAge se coloca en el parámetro properties de esta subsección.
    • Si su servicio de entidades se publica en un portal de ArcGIS Enterprise, busque la sección "jsonProperties" del JSON de las propiedades del servicio. Agregue la propiedad cacheControlMaxAge a esta sección.
  5. Agregue la propiedad cacheControlMaxAge a la sección adecuada y especifique el valor (en segundos) de la propiedad. Por ejemplo, para asignar a la propiedad max-age un valor de 30 días, inserte "properties": { "cacheControlMaxAge": "2592000", }.

    Si su servicio de entidades se publica en un ArcGIS Server federado o independiente:

      {
       "typeName": "FeatureServer",
       "capabilities": "Query,Create,Update,Delete,Uploads,Editing",
       "enabled": "true",
       "maxUploadFileSize": 0,
       "allowedUploadFileTypes": "",
       "properties": {
        "cacheControlMaxAge": "2592000",}
    }

    Su servicio de entidades se publica en un portal de ArcGIS Enterprise:

    "jsonProperties": {**
      "currentVersion": 10.6,  "serviceDescription": "",  "maxRecordCount": 2000,  "cacheControlMaxAge": "2592000",
    }
  6. Haga clic en Guardar cambios.
  7. En la página del servicio de entidades, compruebe que la propiedad cacheControlMaxAge y el valor especificado para ella aparezcan en la sección Propiedades.

Introduciendo HTML en campos de texto

Al editar un servicio de entidades en una aplicación de cliente, puede introducir HTML en los campos de texto. Por ejemplo, al editar una entidad en un cliente web, puede introducir HTML con formato en un campo de comentarios. De forma predeterminada, solo las entidades HTML y los atributos que se enumeran en la siguiente tabla se pueden introducir en los campos de texto del servicio de entidades. Si intenta agregar un atributo de entidad no compatible, se devuelve un error.

Si su flujo de trabajo de servicio de entidades requiere entidades y atributos HTML no compatibles, tendrá que deshabilitar la propiedad Filtrar contenido web. Esta propiedad está disponible a través del cuadro de diálogo Opciones avanzadas de servicio de entidades de ArcGIS Desktop o ArcGIS Server Manager. Para obtener más información, consulte lo siguiente:

Entidad HTMLAtributo HTML (si procede)

<un/a>

href, objetivo, estilo

<b>

<br>

<div>

estilo, alinear

<em>

<fuente>

tamaño, color, estilo, superficie

http, protocolo https

src, href

<i>

<img>

src, ancho altura, alt, frontera, estilo

<li>

mailto: protocolo

src, href

<ol>

<duración>

estilo

<strong>

<tabla>

ancho, altura, cellpadding, cellspacing, límite, estilo

<tbody>

<td>

altura, ancho, valign, alinear, colspan, rowspan, nowrap, estilo

<tr>

altura, valign, alinear, estilo

<u>

<ul>