Configurar camadas de limite

A Esri fornece camadas contendo informações demográficas e de limite para diferentes partes do mundo. Estas camadas—como limites de estado, província, área de censo e Cep—contêm informações de localização relacionadas que membros do portal podem utilizar em seus mapas, cenas, aplicativos, ferramentas de análise da feição e no ArcGIS Insights.

Considere publicar estas camadas no seu portal se você tiver o ArcGIS Insights instalado ou se o seu portal não tiver acesso ao ArcGIS Living Atlas of the World conteúdo do ArcGIS Online.

Como administrador do portal, você pode baixar os arquivos da definição de serviço da camada limite (.sd) que deseja a partir do My Esri e utilizar a ferramenta publishboundarylayers para publicar camadas de feição hospedadas a partir dos arquivos.

Anotação:

Quando você executar qualquer uma das ferramentas descritas neste tópico, você deve utilizar uma conta de administrador do portal embutida. A URL que você utiliza para estas ferramentas depende de onde você desenvolve o ArcGIS Enterprise.

• Quando você executar as ferramentas em um desenvolvimento local do ArcGIS Enterprise , você deve acessar o portal pela porta 7443 ao invés de por um adaptador da web ou balanceador de carga.
• Quando você executar estas ferramentas em um desenvolvimento do ArcGIS Enterprise na nuvem, você deve acessar o portal por um adaptador da web ou balanceador de carga; não utilize a porta 7443.

Você pode publicar de uma pasta contendo todos os arquivos que você deseja, publicar arquivos individuais ou fornecer uma lista de arquivos no formato do arquivo de texto. Tenha certeza que a conta utilizada para instalar o Portal for ArcGIS tem acesso de leitura neste diretório.

A publicação destes arquivos da definição de serviço do limite (.sd) no seu portal resulta no seguinte:

• Cada .sd é adicionado como um item da definição de serviço no portal. Estes arquivos devem permanecer no portal se você deseja atualizar as camadas de limite quando o conteúdo atualizado está disponível.
• Uma camada de feição hospedada é criada para cada arquivo .sd que você publicar. Cada camada de feição hospedada contém múltiplas camadas.
• Ambos os itens da definição de serviço e camadas de feição hospedadas são de prorpiedade de um membro do portal interno denominado esri_boundaries. Não altere a propriedade destes itens para outro usuário.
• Por padrão, todos os membros da sua organização do portal têm acesso às camadas de feição hospedadas de limite no portal. Os membros do portal podem acessar as camadas de limite utilizando o seguinte:
  • Pesquise no portal por itens da camada de limite a parti da guia Minha Organização da página Conteúdo .
  • Adicione camadas de limite individual às ferramentas de análise de feição no Map Viewer Classic a partir da caixa de diálogo Escolher Camadas de Análise.
  • Adicione camadas de limite ao Scene Viewer a partir do painel Conteúdo.

Publicar camadas de limite

Estas camadas são licenciadas sob o Contrato de Licença Master da .Esri Leia o resumo e termos de uso antes de publicar.

Importar requisitos de uso

• Estas camadas são licenciadas para uso interno no ArcGIS Enterprise, incluindo Portal for ArcGIS, ArcGIS Insights, e outros aplicativos do ArcGIS conectados.
  • Os usuários não têm permissão para utilizar fora da família de produtos do ArcGIS Enterprise ou exportar dados para uso desconectado no ArcGIS ou em outros aplicativos.
  • Os usuários não têm permissão para compartilhar a camada (pública ou privada) para uso externo por membros de outras organizações ou o público, sem permissão escrita separada da Esri.
• Estas camadas são licenciadas para uso por dois (2) anos após o download da Esri. Você pode baixar os dados mais recentes a cada ano para estender a licença.
• Qualquer exibição destas camadas deve incluir os Créditos (Atribuição) publicados com cada camada.

Siga estas etapas para obter arquivos de limite e hospedá-los como camadas de feição no seu portal:

1. Baixe arquivos compactados contendo definições de serviço (.sd) do My Esri.
2. Extraia os arquivos baixados e adicione-os em uma pasta na máquina do Portal for ArcGIS.

   Os nomes de arquivos utilizam um código de três letras para indicar as regiões às quais eles se aplicam e têm o ano no qual os dados se aplicam no final do nome. Por exemplo, USA_Boundaries_2015 contém limites dos Estados Unidos da América, tal como apareceu no ano de 2015.

   Remova quaisquer arquivos que você não deseja carregar e publicar no seu portal. Alternativamente crie um arquivo de texto contendo uma lista do subconjunto de arquivo que você deseja carregar e publicar. Formate o arquivo de texto para que haja um nome de arquivo por linha; por exemplo, para carregar limites dos Estados Unidos da América ou do mundo, o arquivo de texto deve conter o seguinte:

   USA_Boundaries_2015
   WOR_Boundaries_2015

3. Abra um terminal de comando na máquina do Portal for ArcGIS.
4. Altere os diretórios para o local da ferramenta.
5. Execute a ferramenta publishboundarylayers.

   A ferramenta é instalada no <Portal installation directory>/tools/publishboundarylayers. A sintaxe da feramenta é como segue: 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>]

   Se você não especificar uma senha ao executar a ferramenta, você será solicitado para fornecer a senha ao administrador do portal. Este usuário deve ser um membro do papel de administrador padrão no portal.

   Se você utilizar a operação --files, especifique uma lista dos arquivos da definição de serviço separados por vírgula. Se você utilizar a opção --file, especifique o local e nome de um arquivo de texto contendo a lista dos arquivos de limite que você deseja publicar.

   Neste exemplo, todos os arquivos no diretório boundaryfiles são publicados no portal local:

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

   Neste exemplo, os arquivos estão no mesmo diretório (boundaryfiles), mas dois arquivos são publicados:

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

   Neste exemplo, um arquivo de texto (boundarysubset.vi) foi criado no diretório boundaryfiles. A ferramenta lê a lista de arquivos a partir do arquivo de texto para publicar um subconjunto das camadas de limite.

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

Após finalizar a publicação, um item da definição de serviço e da camada de feição hospedada existirá para cada arquivo .sd que você publicou.

Para confirmar que os itens existem, você pode procurar no portal por todos os itens de propriedade de um membro do portal interno denominado esri_boundaries. Digite owner:esri_boundaries no campo de pesquisa do portal e Pesquisar Todo Conteúdo.

Atualizar camadas de limite

Na maioria dos casos, as atualizações de uma camada de limite são fornecidas como um novo arquivo da definição de serviço que você publica no seu portal através do utilitário publishboundarylayers. Isto permite que você utilize as camadas de forma independente e analise as duas versões dos dados. Por exemplo, pode haver uma versão 2015 e 2017 do arquivo de limites mundiais. Em raras ocasiões, através dos arquivos da definição de serviço fornecidos no My Esri são atualizadas para conteúdo correto. Nestes casos, você pode baixar o arquivo de atualização e publicá-los utilizando a ferramenta updateboundarylayers. Isto substitui a camada de feição hospedada existente no seu portal.

Como notado na introdução, você pode atualizar somente camadas de limite se o item da definição de serviço da camada ainda existir no portal.

Siga estas etapas para atualizar camadas de feição de limite no seu portal:

1. Baixe arquivos compactados contendo arquivos da definição de serviço atualizados (.sd) do My Esri.
2. Extraia os arquivos baixados e adicione-os em uma pasta na máquina do Portal for ArcGIS.

   Remova quaisquer arquivos que você não deseja carregar e publicar no seu portal. Alternativamente crie um arquivo de texto contendo uma lista do subconjunto de arquivo que você deseja carregar e publicar. Formate o arquivo de texto para que haja um nome de arquivo por linha; por exemplo, para carregar limites dos Estados Unidos da América ou do mundo, o arquivo de texto deve conter o seguinte:

   USA_Boundaries_2015
   WOR_Boundaries_2015

3. Abra um terminal de comando na máquina do Portal for ArcGIS.
4. Altere os diretórios para o local da ferramenta.
5. Execute a ferramenta updateboundarylayers.

   A ferramenta é instalada no <Portal installation directory>/tools/publishboundarylayers. A sintaxe da feramenta é como segue: 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>]

   Se você não especificar uma senha ao executar a ferramenta, você será solicitado para fornecer a senha ao administrador do portal. Este usuário deve ser um membro do papel de administrador padrão no portal.

   Se você utilizar a operação --files, especifique uma lista dos arquivos da definição de serviço separados por vírgula. Se você utilizar a opção --file, especifique o nome de um arquivo de texto contendo a lista dos arquivos de limite que você deseja publicar.

   Neste exemplo, a ferramenta updateboundarylayers publica todos os arquivos no diretório boundaryfiles, substituindo as camadas existentes:

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

   Neste exemplo, os arquivos estão no mesmo diretório (boundaryfiles), mas somente um arquivo é publicado:

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

   Neste exemplo, um arquivo de texto (boundaryupdatesubset.vi) foi criado no diretório boundaryfiles. A ferramenta lê a lista de arquivos a partir do arquivo de texto para republicar um subconjunto das camadas de limite.

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

Ao completar a publicação, as camadas de feição hospedadas existentes terão metadados e dados atualizados.

Excluir camadas de limite

Se você decidir que uma camada de limite não é necessária no seu portal, você poderá exclui-la. Você pode procurar por uma camada no site da web do portal e exclui-la ou executar a ferramenta deleteboundarylayers. Se você deseja excluir múltiplas camadas de limite, utilize a ferramenta deleteboundarylayers.

A ferramenta deleteboundarylayers não exclui camadas que têm a proteção de exclusão habilitada.

Aviso:

Se você excluir uma camada de limite que é atualmente utilizada em um mapa, aplicativo ou cena, a camada não aparecerá mais no mapa, aplicativo ou cena. Republicar não substituirá a camada no mapa, aplicativo ou cena, pois publicar novamente cria um novo item com um novo ID no portal.

Você pode fornecer uma lista de camadas separadas por vírgula para excluir utilizando a operação --files ou fornecer um arquivo de texto contendo uma lista de camadas para excluir utilizando a operação --file.

A sintaxe para fornecer uma lista de camadas separadas por vírgula é como segue: deleteboundarylayers {--files <layer_name_list> | --file <location_of_text_file>} --url <portalURL> --username <portal_admin> [--password password]

Por exemplo, para excluir as camadas USA_Boundaries e WOR_Boundaries do portal https://portal.domain.com:7443/arcgis como um administrador do portal denominado portaladmin, digite o seguinte:

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

A sintaxe para fornecer um arquivo de texto contendo uma lista de camadas para excluir é como segue: deleteboundarylayers --file <location_of_text_file> --url <portalURL> --username <portal_admin> [--password password]

Por exemplo, excluir as mesmas camadas utilizando um arquivo, criar um arquivo de texto contendo um nome de camada por linha (como mostrado aqui) e fornecer o local e nome do arquivo de texto ao executar a ferramenta:

USA_Boundaries_2015
WOR_Boundaries_2015

No seguinte exemplo, o arquivo boundarylist está em /usr/data/boundaries. Ele contém uma lista de camadas a serem excluídas do portal, https://webadaptorhost.domain.com/webadaptorname.

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