Configurar capas de límites

Esri proporciona capas que contienen información demográfica y de límites de distintas partes del mundo. Estas capas (por ejemplo, límites de estados, provincias, áreas censales y códigos postales) contienen información local relacionada que los miembros del portal pueden utilizar en sus mapas, escenas, aplicaciones, herramientas de análisis de entidades y en ArcGIS Insights.

Considere publicar estas capas en su portal si tiene instalado ArcGIS Insights o si su portal no tiene acceso a contenido de ArcGIS Living Atlas of the World desde ArcGIS Online.

Como administrador del portal, puede descargar los archivos de definición de servicio (.sd) de la capa de límite que desee desde My Esri y usar la herramienta publishboundarylayers para publicar las capas de entidades alojadas desde los archivos.

Nota:

Al ejecutar cualquiera de las herramientas descritas en este tema, debe utilizar una cuenta de administrador del portal integrada. La URL que utilice para estas herramientas dependerá de dónde implemente ArcGIS Enterprise.

• Al ejecutar las herramientas en una implementación de ArcGIS Enterprise local, debe acceder al portal a través del puerto 7443 en lugar de hacerlo a través de Web Adaptor o un equilibrador de carga.
• Al ejecutar estas herramientas en una implementación de ArcGIS Enterprise en la nube, debe acceder al portal a través de Web Adaptor o un equilibrador de carga; no utilice el puerto 7443.

Puede publicar desde una carpeta que contenga los archivos que desea, publicar archivos individuales o proporcionar una lista de archivos en formato de archivo de texto. Asegúrese de que la cuenta utilizada para instalar Portal for ArcGIS tenga acceso de lectura a este directorio.

Al publicar estos archivos de definición de servicio (.sd) de límite en el portal, ocurre lo siguiente:

• Cada .sd se agrega como un elemento de definición de servicio en el portal. Estos archivos deben permanecer en el portal si desea actualizar las capas de límites cuando haya contenido actualizado disponible.
• Se crea una capa de entidades alojada para cada archivo .sd que publique. Cada capa de entidades alojada contiene varias capas.
• Tanto los elementos de definición del servicio como las capas de entidades alojadas son propiedad de un miembro interno del portal llamado esri_boundaries. No cambie la propiedad de estos elementos por otro usuario.
• De forma predeterminada, todos los miembros de la organización del portal tienen acceso a las capas de entidades de límites alojadas en el portal. Los miembros del portal pueden acceder a las capas de límites de la siguiente forma:
  • Buscar en el portal elementos de capas de límites o desde la pestaña Mi organización de la página Contenido.
  • Agregar capas de límites individuales a las herramientas de análisis de entidades de Map Viewer Classic desde el cuadro de diálogo Elegir capa de análisis.
  • Agregar capas de límites a Scene Viewer desde el panel Contenido.

Publicar capas de límites

Estas capas tienen una licencia en virtud del Contrato principal de licencia de Esri. Lea el resumen y las condiciones de uso antes de publicar nada.

Requisitos de uso importantes

• Estas capas tienen licencia para su uso interno en ArcGIS Enterprise, incluidas Portal for ArcGIS, ArcGIS Insights y otras aplicaciones de ArcGIS conectadas.
  • No se permite a los usuarios su uso fuera de la familia de productos de ArcGIS Enterprise ni la exportación de datos para su uso sin conexión en ArcGIS u otras aplicaciones.
  • No se permite a los usuarios compartir la capa (de forma pública o privada) para su uso externo por los miembros de otras organizaciones o el público sin el permiso escrito explícito de Esri.
• Estas capas tienen licencia para un uso de dos (2) años tras su descarga desde Esri. Puede descargar los datos más recientes cada año para ampliar la licencia.
• Cualquier visualización de estas capas debe incluir Créditos (atribución) publicado en cada capa.

Siga estos pasos para obtener archivos de límites y alojarlos como capas de entidades en su portal:

1. Descargue archivos comprimidos que contengan definiciones de servicio (.sd) desde My Esri.
2. Extraiga los archivos descargados y colóquelos en una carpeta en el equipo de Portal for ArcGIS.

   Los nombres de archivo usan un código de tres letras para indicar las regiones para las que son válidos y tienen el año al que se refieren los datos agregado al final del nombre. Por ejemplo, USA_Boundaries_2015 contiene fronteras de Estados Unidos tal y como se registraron en el año 2015.

   Elimine los archivos que no desee cargar ni publicar en su portal. También puede crear un archivo de texto que contenga una lista del subconjunto de archivos que desea cargar y actualizar. Aplique formato al archivo de texto para que solo haya un nombre de archivo por línea; por ejemplo, para cargar los límites de los Estados Unidos de América o del mundo, el archivo de texto contendría lo siguiente:

   USA_Boundaries_2015
   WOR_Boundaries_2015

3. Abra un terminal de comandos en el equipo de Portal for ArcGIS.
4. Cambie los directorios a la ubicación de la herramienta.
5. Ejecute la herramienta publishboundarylayers.

   La herramienta se instala en <Portal installation directory>/tools/publishboundarylayers. La sintaxis de la herramienta es la siguiente: publishboundarylayers --folder <location of sd files> [{--files <file names>|--file <name of text file>}] --url <Portal website URL> --username <portal administrator user name> [--password <portal administrator password>]

   Si no especifica una contraseña, cuando ejecute la herramienta, se le pedirá que proporcione la contraseña para el administrador del portal. Este usuario debe ser miembro del rol de administrador predeterminado en el portal.

   Si utiliza la operación --files, especifique una lista de archivos de definición de servicio, separados por comas. Si utiliza la opción --file, especifique la ubicación y el nombre de un archivo de texto que contenga la lista de archivos de límites que desee publicar.

   En este ejemplo, todos los archivos del directorio boundaryfiles se publican en un portal local:

   ./publishboundarylayers --folder /usr/data/boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladmin

   En este ejemplo, los archivos están en el mismo directorio (boundaryfiles), pero solo se publican dos archivos:

   ./publishboundarylayers --folder /usr/data/boundaryfiles --files USA_Boundaries,WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladmin

   En este ejemplo, se creó un archivo de texto (boundarysubset.vi) en el directorio boundaryfiles. La herramienta lee la lista de archivos del archivo de texto para publicar un subconjunto de capas de límites.

   ./publishboundarylayers --folder /usr/data/boundaryfiles --file /usr/tmp/boundarysubset.vi --url https://portal.domain.com:7443/arcgis --username portaladmin

Cuando finalice la publicación, habrá un elemento de definición de servicio y una capa de entidades alojada para cada archivo .sd que haya publicado.

Para confirmar que los elementos existen, puede realizar una búsqueda en el portal de todos los elementos propiedad de un miembro interno del portal llamado esri_boundaries. Escriba owner:esri_boundaries en el campo de búsqueda del portal y utilice la opción Buscar todo el contenido.

Actualizar capas de límites

En la mayoría de los casos, se proporcionan actualizaciones a una capa de límites como un nuevo archivo de definición de servicio que publica en su portal mediante la utilidad publishboundarylayers. Esto le permite usar las capas de forma independiente y analizar las dos versiones de los datos. Por ejemplo, podría haber una versión de 2015 y otra de 2017 del archivo de límites del mundo. No obstante, en ocasiones excepcionales, los archivos de definición de servicio proporcionados en My Esri se actualizan para corregir contenido. En esos casos, puede descargar el archivo actualizado y publicarlo usando la herramienta updateboundarylayers. Al hacerlo, se sobrescribe la capa de entidades alojada existente en el portal.

Como se indicó en la introducción, solo puede actualizar capas de límites si el elemento de definición de servicio de la capa sigue existiendo en el portal.

Siga estos pasos para actualizar las capas de entidades de límites en su portal:

1. Descargue archivos comprimidos que contengan archivos de definición de servicio actualizados (.sd) desde My Esri.
2. Extraiga los archivos y colóquelos en una carpeta en el equipo de Portal for ArcGIS.

   Elimine los archivos que no desee cargar ni publicar en su portal. También puede crear un archivo de texto que contenga una lista del subconjunto de archivos que desea cargar y actualizar. Aplique formato al archivo de texto para que solo haya un nombre de archivo por línea; por ejemplo, para cargar los límites de los Estados Unidos de América y del mundo, el archivo de texto contendría lo siguiente:

   USA_Boundaries_2015
   WOR_Boundaries_2015

3. Abra un terminal de comandos en el equipo de Portal for ArcGIS.
4. Cambie los directorios a la ubicación de la herramienta.
5. Ejecute la herramienta updateboundarylayers.

   La herramienta se instala en <Portal installation directory>/tools/publishboundarylayers. La sintaxis de la herramienta es la siguiente: updateboundarylayers --folder <location of files> [{--files <file names>|--file <name of text file>}] --url <Portal home page URL> --username <portal administrator user name> [--password <portal administrator password>]

   Si no especifica una contraseña, cuando ejecute la herramienta, se le pedirá que proporcione la contraseña para el administrador del portal. Este usuario debe ser miembro del rol de administrador predeterminado en el portal.

   Si utiliza la operación --files, especifique una lista de archivos de definición de servicio, separados por comas. Si utiliza la opción --file, especifique el nombre de un archivo de texto que contenga la lista de archivos de límites que desee publicar.

   En este ejemplo, la herramienta updateboundarylayers publica todos los archivos del directorio boundaryfiles y se sobrescriben las capas existentes:

   ./updateboundarylayers --folder /usr/data/boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladmin

   En este ejemplo, los archivos están en el mismo directorio (boundaryfiles), pero solo se vuelve a publicar un único archivo:

   ./updateboundarylayers --folder /usr/data/boundaryfiles --files WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladmin

   En este ejemplo, se creó un archivo de texto (boundaryupdatesubset.vi) en el directorio boundaryfiles. La herramienta lee la lista de archivos del archivo de texto para volver a publicar un subconjunto de capas de límites.

   ./updateboundarylayers --folder /usr/data/boundaryfiles --file /usr/tmp/boundaryupdatesubset.vi --url https://portal.domain.com:7443/arcgis --username portaladmin

Una vez finalizada la publicación, las capas de entidades alojadas existentes contendrán datos o metadatos actualizados.

Eliminar capas de límites

Si decide que una capa de límites no es necesaria en su portal, puede eliminarla. Puede buscar la capa en el sitio web del portal y eliminarla desde ahí o puede ejecutar la herramienta deleteboundarylayers. Si desea eliminar varias capas de límites, utilice la herramienta deleteboundarylayers.

La herramienta deleteboundarylayers no elimina capas que tengan habilitada la protección contra eliminación.

Precaución:

Si elimina una capa de límites que se está utilizando en un mapa, aplicación o escena, la capa ya no aparecerá en dicho mapa, aplicación o escena. Al volver a publicar no se reemplazará la capa en el mapa, aplicación o escena porque se crea un elemento nuevo con un nuevo Id. en el portal.

Puede proporcionar una lista de capas separadas por comas para eliminarlas utilizando la operación --files o puede proporcionar un archivo de texto que contenga una lista de las capas que desea eliminar mediante la operación --file.

La sintaxis para proporcionar una lista de capas separadas por comas es la siguiente: deleteboundarylayers {--files <layer_name_list> | --file <location_of_text_file>} --url <portalURL> --username <portal_admin> [--password password]

Por ejemplo, para eliminar del portal https://portal.domain.com:7443/arcgis las capas USA_Boundaries_2015 y WOR_Boundaries_2015 como administrador del portal llamado portaladmin, escriba lo siguiente:

./deleteboundarylayers --files USA_Boundaries_2015,WOR_Boundaries_2015 --url https://portal.domain.com:7443/arcgis --username portaladmin

La sintaxis para proporcionar un archivo de texto que contenga una lista de las capas que se van a eliminar es la siguiente: deleteboundarylayers --file <location_of_text_file> --url <portalURL> --username <portal_admin> [--password password]

Por ejemplo, para eliminar las mismas capas utilizando un archivo, cree un archivo de texto que contenga un nombre de capa por línea (como se muestra aquí) y proporcione la ubicación y el nombre del archivo de texto cuando ejecute la herramienta:

USA_Boundaries_2015
WOR_Boundaries_2015

En el ejemplo siguiente, el archivo de boundarylist está en /usr/data/boundaries. Contiene una lista de las capas que se van a eliminar del portal, https://webadaptorhost.domain.com/webadaptorname.

./deleteboundarylayers --file /usr/data/boundaries/boundarylist --url https://portal.domain.com:7443/arcgis --username portaladmin