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 de la organización pueden utilizar en sus mapas, escenas, aplicaciones y herramientas de análisis de entidades.

Le recomendamos que publique estas capas si su organización no tiene acceso al contenido de ArcGIS Living Atlas of the World desde ArcGIS Online.

Como administrador, puede descargar los archivos de definición de servicio (.sd) de la capa de límites 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 integrada de administrador del portal. La URL que utilice para estas herramientas depende del lugar de la implementación de ArcGIS Enterprise.

• Al ejecutar las herramientas en una implementación local de ArcGIS Enterprise, 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.

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 ejecutar el servicio de Portal for ArcGIS tenga acceso de lectura a esta carpeta.

Al publicar estos archivos de definición de servicio (.sd) de límites en su organización, ocurre lo siguiente:

• Cada .sd se agrega como un elemento de definición de servicio. Estos archivos deben permanecer en la organización 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 de la organización llamado esri_boundaries. No cambie la propiedad de estos elementos por otro usuario.

• De forma predeterminada, todos los miembros de la organización tienen acceso a las capas de entidades alojadas de límites. Los miembros pueden acceder a las capas de límites de la siguiente forma:

  • Buscar en la organización 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.

  • 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 de licencia principal de Esri. Lea el resumen y las condiciones de uso antes de publicar nada.

Requisitos de uso importantes:

• Estas capas tienen licencia de uso interno en ArcGIS Enterprise y aplicaciones de ArcGIS conectadas.

  • No se permite a los usuarios utilizar los datos fuera de la familia de productos ArcGIS Enterprise ni exportarlos para su uso sin conexión en ArcGIS u otras aplicaciones.

  • No se permite a los usuarios compartir la capa (ya sea de forma pública o privada) para su uso externo por parte de miembros de otras organizaciones o del público en general, sin el permiso por escrito específico 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:

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 organización. 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 una terminal de comandos en el equipo de Portal for ArcGIS.

4. Abra una ventana de comandos en el equipo de Portal for ArcGIS.

5. Cambie los directorios a la ubicación de la herramienta.

6. Ejecute la herramienta publishboundarylayers.

   La herramienta está instalada 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>]

   La herramienta está instalada 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 una cuenta de administrador. Este usuario debe ser miembro del rol de administrador predeterminado en la organización.

   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 una organización local:

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

   publishboundarylayers --folder d:\data\boundaryfiles --url https://portal.example.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.example.com:7443/arcgis --username portaladmin

   publishboundarylayers --folder d:\data\boundaryfiles --files USA_Boundaries_2015,WOR_Boundaries_2015 --url https://portal.example.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.

   En este ejemplo, se creó un archivo de texto (boundarysubset.txt) 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.example.com:7443/arcgis --username portaladmin

   publishboundarylayers --folder d:\data\boundaryfiles --file c:\temp\boundarysubset.txt --url https://portal.example.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 la organización de todos los elementos propiedad de un miembro interno llamado esri_boundaries. Escriba owner:esri_boundaries en el campo de búsqueda y utilice Buscar todo el contenido.

Actualizar capas de límites

En la mayoría de los casos, se proporcionan actualizaciones para una capa de límites como un nuevo archivo de definición de servicios que publica 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.

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.

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

1. Descargue archivos comprimidos que contengan archivos de definición de servicio (.sd) actualizados 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. 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 una terminal de comandos en el equipo de Portal for ArcGIS.

4. Abra una ventana de comandos en el equipo de Portal for ArcGIS.

5. Cambie los directorios a la ubicación de la herramienta.

6. Ejecute la herramienta updateboundarylayers.

   La herramienta está instalada 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>]

   La herramienta está instalada 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 una cuenta de administrador. Este usuario debe ser miembro del rol de administrador predeterminado.

   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.example.com:7443/arcgis --username portaladmin

   updateboundarylayers --folder d:\data\boundaryfiles --url https://portal.example.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.example.com:7443/arcgis --username portaladmin

   updateboundarylayers --folder d:\data\boundaryfiles --files WOR_Boundaries --url https://portal.example.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.

   En este ejemplo, se creó un archivo de texto (boundaryupdatesubset.txt) 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.example.com:7443/arcgis --username portaladmin

   updateboundarylayers --folder d:\data\boundaryfiles --file c:\temp\boundaryupdatesubset.txt --url https://portal.example.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, puede eliminarla. Puede buscar la capa en la organización 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.

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 las capas USA_Boundaries_2015 y WOR_Boundaries_2015 https://portal.example.com:7443/arcgis como administrador de la organización con el nombre portaladmin, escriba lo siguiente:

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

deleteboundarylayers --files USA_Boundaries_2015,WOR_Boundaries_2015 --url https://portal.example.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 boundarylist está en /usr/data/boundaries. Contiene una lista de las capas que se van a eliminar de la organización con la URL https://portal.example.com/portal.

En el ejemplo siguiente, el archivo boundarylist.txt está en c:\data\boundaries. Contiene una lista de las capas que se van a eliminar de la organización con la URL https://portal.example.com/portal.

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

deleteboundarylayers --file c:\data\boundaries\boundarylist.txt --url https://portal.example.com/portal --username portaladmin