Configuración avanzada de las propiedades de las herramientas web

Las siguientes propiedades de las herramientas web son ajustes avanzados que no se pueden definir usando ArcGIS Server Manager; realmente son servicios de geoprocesamiento a los que las herramientas web hacen referencia y solo se pueden definir utilizando la REST API del administrador de ArcGIS Server federado. Solo tendrá que modificar estos ajustes para herramientas web específicas con necesidades diferentes.

Cambiar el almacenamiento dinámico

La configuración de tamaño de almacenamiento dinámico controla el tamaño máximo de archivo que se puede proporcionar desde el cliente. Se puede definir en dos niveles: ArcGIS Server o servicio.

Al cambiar el tamaño de almacenamiento dinámico en el nivel de servicio, se dispone de un mejor rendimiento que al cambiarlo desde el nivel de servidor. Desde ArcGIS Server 10.7 en adelante, el tamaño de almacenamiento dinámico se puede establecer en el nivel de servicio. El tamaño predeterminado de cada servicio es de 64 MB. Si tiene un archivo de entrada o clase de entidad mayor que el tamaño predeterminado, cambie el tamaño de almacenamiento dinámico del servicio como se indica:

  1. Desde un navegador web, vaya a https://machine.domain.com/webadaptor/admin/login.
  2. Inicie sesión en el Directorio de administrador de ArcGIS Server con una cuenta de administrador.
  3. Haga clic en el vínculo Recursos: Servicios para ver una página nueva que muestra todos los servicios publicados.
  4. Haga clic en el servicio cuyo tamaño de almacenamiento dinámico desea modificar e inicie la página con todas las propiedades del servicio.
  5. Desde la página con propiedades del servicio, haga clic en el vínculo frameworkProperties para ver la página con propiedades de servicio editables en formato JSON.
    Ejemplo de propiedades de servicio en formato JSON
  6. Si javaHeapSize no aparece en las propiedades del servicio, agregue la propiedad {"javaHeapSize":"128"} al JSON. Si se incluye javaHeapSize, aumente el valor a la cantidad adecuada.
  7. Haga clic en Guardar cambios para guardar y finalizar la edición.

Para modificar el tamaño de almacenamiento dinámico en el nivel de servidor, siga los pasos detallados que se muestran a continuación. De forma predeterminada, el tamaño máximo de almacenamiento dinámico de SOC se establece en 64 MB. Aumente el valor predeterminado de la propiedad hasta una cantidad adecuada.

  1. En un navegador web, vaya a https://machine.domain.com/webadaptor/admin/login.
  2. Inicie sesión en el Directorio de administrador de ArcGIS Server con una cuenta de administrador.
  3. Haga clic en equipos.
  4. Haga clic en el vínculo <Your Server Name>.<domain>.com.

    Por ejemplo, puede aparecer un vínculo como server1.esri.com.

  5. En la página Propiedades del equipo del servidor, haga clic en el vínculo editar.
  6. Aumente el valor de Almacenamiento dinámico máximo de SOC (en MB).
  7. Haga clic en Guardar cambios para finalizar la edición.

Tamaño de la carga

El ajuste del tamaño de la carga controla el tamaño de archivo que se puede cargar por clientes que se conectan al servicio a través de un extremo REST. Estos clientes son generalmente los clientes Web que utilizan el servicio a través de una aplicación Web personalizada. Por defecto, el límite se establece en 2 GB. Utilice esta configuración para proporcionar un valor predeterminado adecuado para evitar grandes cargas para su servicio.

  1. Abra un navegador web y vaya a https://machine.domain.com/webadaptor/admin/login.
  2. Inicie sesión en el Directorio de administrador de ArcGIS Server con una cuenta de administrador.
  3. Haga clic en Servicios.
  4. Haga clic en el nombre del servicio.
  5. Haga clic en el vínculo editar en la parte inferior de la página bajo Operaciones compatibles.
  6. En el cuadro de texto Servicio (en formato JSON):*, busque la etiqueta maxUploadFileSize y defina el tamaño máximo de archivo después del signo de dos puntos (:).

    Una entrada completa tendría un aspecto similar a "maxUploadFileSize": 100,.

  7. Haga clic en Guardar cambios.
Nota:

Al publicar una herramienta web, asegúrese de que la casilla de verificación Cargas del panel Configuración de Compartir como una herramienta web está activada. Si lo prefiere, también puede habilitar este ajuste en un servicio existente a través de ArcGIS Server Manager en la página de configuración Capacidades del servicio.

Cargar tipos

Solo se pueden cargar determinados archivos en una herramienta web. Estos archivos están restringidos por su tipo de extensión, que se establece en el nivel de servicio.

  1. Abra un navegador web y vaya a https://machine.domain.com/webadaptor/admin/login.
  2. Inicie sesión en el Directorio de administrador de ArcGIS Server con una cuenta de administrador.
  3. Haga clic en Servicios.
  4. Haga clic en el nombre del servicio.
  5. Haga clic en el vínculo editar en la parte inferior de la página bajo Operaciones compatibles.
  6. En el cuadro de texto Servicio (en formato JSON):*, busque la etiqueta allowedUploadFileTypes y agregue las extensiones de archivo que desee permitir dentro de las comillas después del signo de dos puntos (:).

    Una entrada completa tendría un aspecto similar a "allowedUploadFileTypes": ".kml,.gpx".

  7. Haga clic en Guardar cambios.
Nota:

Al publicar una herramienta web, asegúrese de que la casilla de verificación Cargas del panel Configuración de Compartir como una herramienta web está activada. Si lo prefiere, también puede habilitar este ajuste en un servicio existente a través de ArcGIS Server Manager en la página de configuración Capacidades del servicio.

Cambiar el número máximo de dominios

El ajuste maxDomainCodeCount controla el número de dominios que se devolverá con una respuesta de servicio. Las descripciones de dominio coinciden con un código devuelto con la respuesta de salida de la entidad. Este ajuste tiene un valor predeterminado de 1000. Si las entidades de salida tienen más de 1000 dominios participantes, no se devolverá ninguna información de dominio. Devolver la información de dominio puede aumentar el tamaño de la respuesta. Si no se necesitan dominios, defina este valor como 0 o en un valor inferior al número de dominios de un servicio.

  1. Abra un navegador web y vaya a https://machine.domain.com/webadaptor/admin/login.
  2. Inicie sesión en el Directorio de administrador de ArcGIS Server con una cuenta de administrador.
  3. Haga clic en Servicios.
  4. Haga clic en el nombre del servicio.
  5. Haga clic en el vínculo editar en la parte inferior de la página bajo Operaciones compatibles.
  6. En el cuadro de texto Servicio (en formato JSON):*, busque la etiqueta maxDomainCodeCount y establezca el límite máximo después de los dos puntos (:).

    Una entrada completa tendría un aspecto similar a "maxDomainCodeCount": 25,.

  7. Haga clic en Guardar cambios.

Carpeta temporal local

La carpeta temp local es un directorio en el que ArcGIS Server escribe las salidas intermedias cuando el servidor participa en un clúster con más de un equipo o cuando se hace referencia a los directorios mediante una ruta UNC. De esta forma, se evita la necesidad de escribir datos intermedios en una geodatabase o carpeta temporal de una ruta UNC, que puede mejorar el rendimiento del servicio. Una vez finalizada la ejecución, los resultados se copian de la carpeta temp local en el directorio de trabajos, que puede ser una ruta UNC.

Volver a utilizar el directorio de trabajos para los servicios síncronos

Si la herramienta web se basa en un servicio de geoprocesamiento síncrono, puede reutilizar el directorio de trabajos para mejorar el rendimiento aplicando "reusejobdir": "true". Normalmente, cada vez que ejecute un servicio de geoprocesamiento síncrono, se creará una carpeta de trabajos en la carpeta arcgisjobs del equipo servidor. Una vez finalizado, ArcGIS Server eliminará la carpeta de trabajos. Al establecer la propiedad reusejobdir como true, la carpeta de trabajos conservará incluso cuando una tarea termina de ejecutarse. Esto puede ahorrar tiempo al crear una GDB temporal y una carpeta temporal para la siguiente ejecución, lo que proporciona algunas ventajas de rendimiento. Opcionalmente, cuando establezca esta propiedad nuevamente en "false" o quite esta propiedad, póngase en contacto con el administrador para eliminar cualquier carpeta de trabajos existente para este servicio.

Para establecer esta propiedad, póngase en contacto con el administrador del sistema para editar la propiedad de servicio en la API del administrador.

Un JSON simplificado que muestra la propiedad reusejobdir. Se han ocultado otras propiedades para resaltar el cambio relevante para esta entidad.

{
    "serviceName": "sample",
    "type": "GPServer",
    "manyotherkeys": "manyothervalues",
    "properties": {
        "manyotherkeys": "manyothervalues",
        "reusejobdir": true,
        "executionType": "Synchronous"
    },
    "portalProperties": {},
    "extensions": []
}

Escribir mensajes en el registro de ArcGIS Server

Si una herramienta web está publicada en ArcGIS Server 11.3 o versiones posteriores, puede incluir una copia de los mensajes de su herramienta web en el registro de ArcGIS Server. El nivel del mensaje de registro de ArcGIS Server coincidirá con el nivel del mensaje de la herramienta web. Para un mensaje de herramienta web, hay tres niveles, error, advertencia o información, que coinciden con graves, advertencia o información en ArcGIS Server. Establezca manualmente los mensajes de la herramienta web mediante los mensajes de la herramienta de secuencias de comandos. Muchas herramientas de geoprocesamiento también incluyen sus propios mensajes predefinidos. Para garantizar que los mensajes se registran correctamente en ArcGIS Server, especifique debidamente la configuración de registro del servidor.

Para establecer esta propiedad, póngase en contacto con el administrador del sistema para editar la propiedad de servicio en la REST API del administrador.

Un JSON simplificado que muestra la propiedad logGPMessages. Se han ocultado otras propiedades para resaltar el cambio relevante para esta entidad.

{
    "serviceName": "sample",
    "type": "GPServer",
    "manyotherkeys": "manyothervalues",
    "properties": {
        "manyotherkeys": "manyothervalues",
        "logGPMessages": true,
        "executionType": "Asynchronous"
    },
    "portalProperties": {},
    "extensions": []
}