Servicios de entidades y aplicaciones cliente

Existe una gran variedad de clientes de ArcGIS que puede utilizar para editar o ver las características de un servicio de entidades, como clientes web o ArcGIS Pro.

Clientes web de ArcGIS listos para usar

Visor de mapas 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 las capas.
• Rastrear ediciones.
• Controlar el acceso a entidades mediante el control de acceso basado en la propiedad.
• Evitar que los usuarios editen la geometría de entidad.

Puede agregar servicios de entidades a Visor de mapas utilizando la URL del Directorio de servicios de ArcGIS Server. Tras crear y guardar un mapa que contenga un servicio de entidades, podrá compartir el mapa 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 pueden implementarse utilizando las plantillas de aplicación disponibles en su organización. Estas plantillas son totalmente personalizables.

También puede agregar servicios de entidades como elementos en una organización de ArcGIS Enterprise o ArcGIS Online y compartir los elementos con otros miembros de esa organización.

Clientes de ArcGIS Maps SDK for JavaScript

ArcGIS Maps SDK for JavaScript proporciona las funciones de edición Web y las opciones de personalización más avanzadas. Si no tiene problema en programar con esta API, puede adaptar la experiencia de edición a un propósito, objetivo o estrategia organizativa concretos. Por ejemplo, con ArcGIS Maps SDK for JavaScript, puede hacer lo siguiente:

• Editar capas de solo selección.
• Rastrear ediciones.
• Controlar el acceso a entidades mediante el control de acceso basado en la propiedad.
• Evitar que los usuarios editen la geometría de entidad.
• Crear, eliminar y cambiar al vuelo versiones de geodatabases referenciadas.
• 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 URL predeterminada de un servicio de entidades del Directorio de servicios es https://gisserver.example.com:6443/arcgis/rest/services/folder_name/service_name/FeatureServer.

Para acceder a una capa específica del servicio de entidades, incorpore un número entero de base cero a la URL. Por ejemplo, incorporar /0 a la URL proporciona acceso a la primera capa del servicio; incorporar /1 a la URL proporciona acceso a la segunda capa del servicio.

Utilizar servicios de entidades en ArcGIS Pro

Puede agregar servicios de entidades a ArcGIS Pro para ver y editar los datos que contienen.

El flujo de trabajo para editar en ArcGIS Pro es fundamentalmente diferente a la edición de un servicio de entidades a través de una aplicación web. Para saber más, consulte Editar servicios de entidades en la ayuda de ArcGIS Pro.

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 sitio de ArcGIS Server 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.

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 una solicitud anterior se repite 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 de la 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 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 la caché.

Definir el 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 web 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 procesa las solicitudes y envia 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 de entidades y especificar su valor predeterminado, siga estos pasos:

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 https://gisserver.example.com:6443/arcgis/admin.

2. Haga clic en servicios y elija 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. Desplácese hasta la parte inferior de la página del servicio de entidades de destino y haga clic en editar.

   Aparecerá el cuadro de diálogo Propiedades del servicio.

4. Inserte la propiedad cacheControlMaxAge en el archivo JSON.

   El lugar en el que inserte la propiedad dependerá de si el servicio de entidades hace referencia a datos registrados o es un servicio de entidades alojado.

   • Para un servicio de entidades que haga referencia a una fuente de datos registrada, busque la sección "extensions" del JSON. Busque la subsección que contiene el texto "typeName": "FeatureServer" e inserte la propiedad cacheControlMaxAge en el parámetro properties de esta subsección.
   • Para un servicio de entidades alojado, localice la sección "jsonProperties" del JSON de propiedades del servicio. Agregue la propiedad cacheControlMaxAge a esta sección.
5. Cambie el valor de la propiedad cacheControlMaxAge al valor deseado (en segundos).

   El siguiente ejemplo muestra que se establece la propiedad cacheControlMaxAge a 30 días (2592000 segundos) para un servicio de entidades que hace referencia a un data store registrado:

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

   El siguiente ejemplo muestra que se establece la propiedad cacheControlMaxAge a 30 días (2592000 segundos) para un servicio de entidades alojado.

   "jsonProperties": {**
     "currentVersion": 11.5,
     "serviceDescription": "",
     "maxRecordCount": 2000,
     "cacheControlMaxAge": "2592000",
   }

6. Haga clic en Guardar cambios.

En la página del servicio de entidades del Directorio de administrador de ArcGIS Server, compruebe que la propiedad cacheControlMaxAge y el valor especificado para ella aparezcan en la sección Propiedades.

Proporcionar HTML en campos de texto

Al editar un servicio de entidades en una aplicación cliente, puede utilizar entidades HTML y atributos 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.

Nota:

De forma predeterminada, solo las entidades HTML y los atributos que se enumeran en la siguiente tabla se pueden utilizar 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 requiere entidades y atributos HTML no compatibles, debe deshabilitar la propiedad Filtrar contenido web en el servicio de entidades. A esta propiedad se puede acceder a través del cuadro de diálogo Opciones avanzadas de ArcGIS Server Manager. Para obtener más información, consulte Editar las propiedades del servicio en Server Manager.

Entidad HTML	Atributo HTML (si procede)
<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>