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, aplicaciones, herramientas de análisis y en Insights for ArcGIS.
Considera publicar estas capas en su portal si tiene instalado Insights for ArcGIS o si su portal no tiene acceso a contenido de 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 y acceder al portal a través del puerto 7443 en lugar de hacerlo a través de Web Adaptor o un equilibrador de carga.
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 en para cada archivo .sd que publica. 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.
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, Insights for ArcGIS 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:
- Descargue archivos comprimidos que contengan definiciones de servicio (.sd) desde My Esri.
- Inicie sesión en My Esri.
- Vaya a Mis organizaciones > Descargas > Datos y contenido.
- Escriba Límite en el campo de búsqueda para filtrar por las capas de límites.
- Haga clic en Descargar para los archivos que desee.
- 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
- Abra un terminal de comandos en el equipo de Portal for ArcGIS.
- Cambie los directorios a la ubicación de la herramienta.
- 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 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 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 el portal:
./publishboundarylayers.sh --folder /usr/tmp/boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladminEn este ejemplo, los archivos están en el mismo directorio (boundaryfiles), pero solo se publican dos archivos:
./publishboundarylayers.sh --folder /usr/tmp/boundaryfiles --files USA_Boundaries,WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladminEn este ejemplo, se creó un archivo de texto (boundarysubset.txt) en el directorio boundaryfiles. La herramienta leerá la lista de archivos del archivo de texto para publicar un subconjunto de capas de límites.
./publishboundarylayers.sh --folder /usr/tmp/boundaryfiles --file 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:
- Descargue archivos comprimidos que contengan archivos de definición de servicio actualizados (.sd) desde My Esri.
- 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
- Abra un terminal de comandos en el equipo de Portal for ArcGIS.
- Cambie los directorios a la ubicación de la herramienta.
- 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, todos los archivos del directorio boundaryfiles se publican en el portal y se sobrescriben las capas existentes:
./updateboundarylayers.sh --folder /usr/tmp/boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladminEn este ejemplo, los archivos están en el mismo directorio (boundaryfiles), pero solo un archivo se vuelve a publicar:
./updateboundarylayers.sh --folder /usr/tmp/boundaryfiles --files WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladminEn este ejemplo, se creó un archivo de texto (boundaryupdatesubset.txt) en el directorio boundaryfiles. La herramienta leerá la lista de archivos del archivo de texto para volver a publicar un subconjunto de capas de límites.
./updateboundarylayers.sh --folder /usr/tmp/boundaryfiles --file 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 eliminará 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 las capas USA_Boundaries_2015 y WOR_Boundaries_2015https://portal.domain.com:7443/arcgis como administrador del portal llamado portaladmin, escriba lo siguiente:
./deleteboundarylayers.sh --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.sh --file /usr/data/boundaries/boundarylist --url https://portal.domain.com:7443/arcgis --username portaladmin