Publicar um notebook como uma ferramenta da web

A partir da versão 10.9.1, o ArcGIS Notebooks permite publicar notebooks como ferramentas da web. Administradores e autores do notebook com privilégios de publicar ferramenta da web podem publicar noteooks de sua propriedade como ferramentas da web. Quando um notebook é publicado como uma ferramenta da web, um serviço de geoprocessamento assíncrono é criado na máquina do ArcGIS Notebook Server e registrado como uma ferramenta da web. Há um relacionamento de um para um entre o notebook e a ferramenta da web, o que significa que apenas uma ferramenta da web pode ser publicada por notebook, e o item da ferramenta da web recebe as mesmas permissões de compartilhamento do notebook principal. As ferramentas da web podem ser consumidas por qualquer aplicativo cliente que possa funcionar com serviços de geoprocessamento assíncrono RESTful.

A publicação de um notebook como uma ferramenta da web é suportada em notebooks com runtime de versão 6.0 ou superior. Para verificar as informações do tempo de execução de um notebook, clique no botão Informações na barra de formatação superior do editor de notebook ou na guia Configurações da página Item do Notebook. Consulte Visualizar bibliotecas disponíveisPython para saber mais sobre os tempos de execução do notebook.

Na versão 10.9.1, o editor de notebook tem um novo recurso que permite configurar parâmetros de entrada e saída para um notebook. Os parâmetros de entrada correspondem às variáveis de entrada em um notebook que você deseja externalizar para a entrada do usuário quando o notebook é executado como uma ferramenta da web. Os parâmetros de saída representam as variáveis de saída em um notebook que você deseja retornar como saídas de ferramentas da web. Quando você registra uma ou mais variáveis de entrada ou saída e publica um notebook, os parâmetros se tornam disponíveis como parâmetros de entrada ou saída para a ferramenta da web correspondente.

Anotação:

Não é necessário definir parâmetros de entrada ou saída ao publicar um notebook como uma ferramenta da web. Por exemplo, notebooks que executam tarefas com entradas e saídas pré-definidas, como camadas de feição referenciadas por, itemId podem não exigir parâmetros de entrada ou saída.

Anotação:

Os seguintes tipos de dados são suportados como parâmetros de entrada ou saída: String, Longo, Duplo, Booleano, Conjunto de Feições, Conjunto de Registros, Data e Unidade Linear. Para mais informações, consulte Tipos de dados dos serviços de geoprocessamento na documentação do ArcGIS Notebook Server REST API.

Quando uma ferramenta da web é executada, o ArcGIS Notebook Server executa automaticamente o notebook na máquina de servidor do notebook, abrindo um novo contêiner e executando o notebook sem qualquer interação do usuário. Os usuários com privilégios de notebook e com quem o notebook foi compartilhado podem acessar e executar a ferramenta da web. Além dos privilégios de notebook necessários, quaisquer outros privilégios exigidos para executar o notebook são necessários.

Anotação:

Ao criar um notebook para ser compartilhado como uma ferramenta da web, se o notebook fizer referência a um arquivo do diretório da sua área de trabalho como dados de entrada, esses arquivos não poderão ser acessados por outras pessoas com quem o notebook ou ferramenta da web é compartilhado. Se você tiver arquivos que precisam ser referenciados como dados de entrada no notebook, você poderá fazer referência ao arquivo por meio de um item de portal compartilhado no Portal for ArcGIS ou carregar e referenciar o arquivo de um diretório de dados personalizados registrado comArcGIS Notebook Server.

Por padrão, ArcGIS Notebook Server é configurado para executar no máximo 10 execuções simultâneas e não interativas de notebook por cada máquina do ArcGIS Notebook Server. Isso inclui execuções ativadas por ferramentas da web, tarefas agendadas, a API executeNotebook e ativadores de webhook. Os administradores podem aumentar esse limite, se necessário.

Anotação:

Se você não visualizar as opções Parâmetros ou Publicar no editor de notebook, você não terá o privilégio de publicar ferramentas da web ou não será o proprietário do notebook. Se você estiver em um notebook recém-criado, as opções Parâmetros e Publicar não serão exibidas até que o notebook seja salvo.

Configurar parâmetros de entrada

Os parâmetros de entrada representam variáveis de entrada em um notebook que são externalizadas quando um notebook é executado como uma ferramenta da web. Usando o painel Parâmetros no editor de notebook, você pode configurar e adicionar parâmetros de entrada como variáveis ao seu notebook.

1. No editor de notebook, clique em Parâmetros.
2. Clique em Adicionar.
3. Selecione a entrada para Direção.
4. Forneça um nome para Nome da variável.

   Anotação:

   Deve corresponder a um nome de variável que esteja no código do notebook ou já esteja configurado no notebook.

5. Forneça um nome para Nome de exibição para o parâmetro de ferramenta da web.
6. No menu suspenso Tipo de dados, selecione um tipo de dados para o parâmetro de entrada.
7. Forneça um valor de Default value para o parâmetro de entrada. Consulte Tipos de dados dos serviços de geoprocessamento para obter a sintaxe dos valores padrão para os tipos de dados suportados.
8. Para Description, forneça uma descrição para o parâmetro de entrada.
9. Clique em Salvar para salvar o parâmetro de entrada.
10. Para adicionar parâmetros de entrada adicionais, repita as etapas 1 a 9.
11. Após adicionar todos os seus parâmetros de entrada, selecione uma célula em seu notebook para os parâmetros a serem inseridos e clique em Inserir como variáveis.
12. Clique em Salvar para salvar o notebook.

Configurar parâmetros de saída

Você pode configurar a saída de um notebook publicado como ferramenta da web, configurando os parâmetros de saída do painel Parâmetros no editor de notebook.

1. No editor de notebook, clique em Parâmetros.
2. Clique em Adicionar.
3. Selecione a saída do parâmetro Direction.
4. Forneça um nome para Variable name.

   Anotação:

   Deve corresponder a um nome de variável que esteja no código do notebook ou já esteja configurado no notebook.

5. Insira um nome para Display name do parâmetro de ferramenta da web.
6. No menu suspenso Data type, selecione um tipo de dados para o parâmetro de entrada.
7. Insira um valor de Default value do parâmetro de saída. Consulte Tipos de dados dos serviços de geoprocessamento para obter a sintaxe dos valores padrão para os tipos de dados suportados.
8. Para Description, digite uma descrição do parâmetro de saída.
9. Clique em Salvar para salvar o parâmetro de saída.
10. Selecione uma célula em seu notebook. Clique no botão Adicionar para adicionar o snippet de código do Python para escrever a saída de ferramenta da web.

    É recomendado selecionar uma célula próxima à parte inferior do notebook, abaixo das células onde as saídas são criadas.

11. Inspecione o snippet de código adicionado para garantir que os nomes das variáveis de saída correspondam à saída definida no notebook e faça quaisquer ajustes adicionais no snippet de código.
12. Repita as etapas 1 a 11 para quaisquer parâmetros de saída adicionais.
13. Clique em Salvar para salvar o notebook.

Publicar uma ferramenta da web

Você pode publicar um notebook como uma ferramenta da web a partir do painel Publicar no editor de notebooks.

1. Salve seu notebook para garantir que a cópia mais recente do notebook seja publicada.
2. Execute manualmente as células do notebook de forma interativa para garantir que não haja erros.

Anotação:

Ignore as células que contenham snippet de código para os parâmetros de saída, pois eles não são executados no modo interativo.
3. Clique em Publicar na barra de formatação do editor de notebook.
4. Forneça um título e uma descrição para a ferramenta da web nos campos Title e Description no painel Publicar.
5. Verifique todos os parâmetros de entrada e saída.
6. Clique em Publicar para publicar o notebook como uma ferramenta da web.
7. Após a ferramenta da web ser publicada com sucesso, clique em Visualizar detalhes para visualizar a página de detalhes do item para a ferramenta da web.

Excluir uma ferramenta da web

Você pode excluir um serviço de geoprocessamento publicado de um notebook, excluindo o item de ferramenta da web.

1. Na barra de formatação superior do editor de notebook, clique em Publicar.
2. Clique em Visualizar detalhes para visualizar o item da página de detalhes para a ferramenta da web.
3. Clique em Configurações.
4. Clique em Excluir item e confirme que deseja remover o item de ferramenta da web e o serviço de geoprocessamento publicado no ArcGIS Notebook Server.

Editar um parâmetro de entrada ou saída existente

Você pode fazer alterações em um parâmetro de entrada ou saída existente no painel Parâmetros no editor de notebook.

Anotação:

Se um notebook já tiver sido publicado como uma ferramenta da web, você deverá clicar no botão de alternância Habilitar edição no painel Parâmetros antes de fazer alterações em seus parâmetros. Seja cauteloso ao fazer alterações em seus parâmetros após o notebook ser publicado como uma ferramenta da web, pois essas alterações podem interromper qualquer aplicativo da web que use a ferramenta da web.

1. Na barra de formatação superior do editor de notebook, clique em Parâmetros.
2. Clique no botão de opções ao lado do parâmetro e clique emEditar.
3. Atualize o parâmetro e clique em Salvar.
   1. Se um parâmetro de entrada foi atualizado, limpe ou remova manualmente a célula existente com as variáveis de entrada e repita a etapa para inserir os parâmetros de entrada como variáveis no notebook.
   2. Se um parâmetro de saída foi atualizado, limpe manualmente o snippet de código correspondente à variável de saída e repita as etapas para adicionar o snippet de código para o parâmetro de saída ao notebook.
4. Clique em Salvar para salvar o notebook.

Excluir um parâmetro de entrada ou saída existente

Você pode excluir parâmetros de entrada ou saída existentes do painel Parâmetros.

1. Na barra de formatação superior do editor de notebook, clique em Parâmetros.
2. Clique no botão de opções ao lado do parâmetro e clique em Excluir.
3. Clique em Excluir para remover o parâmetro permanentemente.
4. Limpe ou remova manualmente a variável de entrada ou snippet de código de saída no notebook.
5. Clique em Salvar para salvar o notebook.

Utilizar a extensão de mapa

Ao executar uma ferramenta da web no Map Viewer Classic, a extensão do mapa é passada para o notebook como uma variável de Python denominada context, junto com outros parâmetros de entrada, conforme mostrado abaixo.

context = {
    "extent": {
        "ymin": -25203428.462408017,
        "xmin": -46101923.491795965,
        "ymax": 25203428.462407943,
        "xmax": 46101923.491795965,
        "spatialReference": {
            "wkt": "PROJCS[\"WGS_1984_Web_Mercator_Auxiliary_Sphere\",GEOGCS[\"GCS_WGS_1984\",DATUM[\"D_WGS_1984\",SPHEROID[\"WGS_1984\",6378137.0,298.257223563]],PRIMEM[\"Greenwich\",0.0],UNIT[\"Degree\",0.0174532925199433]],PROJECTION[\"Mercator_Auxiliary_Sphere\"],PARAMETER[\"False_Easting\",0.0],PARAMETER[\"False_Northing\",0.0],PARAMETER[\"Central_Meridian\",0],PARAMETER[\"Standard_Parallel_1\",0.0],PARAMETER[\"Auxiliary_Sphere_Type\",0.0],UNIT[\"Meter\",1.0]]"
        },
    }
}

Você pode usar o valor da variável context para definir a extensão dos fluxos de trabalho de análise espacial em seu notebook. Para testar seus fluxos de trabalho de análise espacial com uma extensão do mapa antes de publicar o notebook como uma ferramenta da web, declare a variável context com um valor padrão.

Quando estiver pronto para publicar, insira os parâmetros de entrada como variáveis após a célula onde você declara a variável context.

Solucionar problemas de uma ferramenta da web

Após publicar um notebook como uma ferramenta da web, você poderá validar se a ferramenta da web será executada com sucesso executando a tarefa a partir do diretório de serviços do ArcGIS Notebook Server.

1. Em um navegador da web, abra o diretório de serviços https://notebookserver.domain.com/webadaptorcontext/rest/services do ArcGIS Notebook Server.
2. Entre como o proprietário de ferramenta da web.
3. Identifique o serviço e navegue até a página de tarefas.
4. Clique em Enviar trabalho.
5. Forneça quaisquer parâmetros de entrada e clique em Enviar trabalho.
6. Opcionalmente, clique no link Verificar Detalhes do Trabalho Novamente para verificar o status do trabalho.

   Se a ferramenta da web for concluída com sucesso, serão fornecidos links para as saídas. Uma visualização em HTML da execução do notebook é fornecida como saída por padrão, tanto para execuções com sucesso quanto para falhas.

7. Baixe e visualize a visualização em HTML do notebook para verificar se houve quaisquer problemas durante a execução de ferramenta da web.
8. Se a ferramenta da web falhar, confirme se o notebook foi executado com sucesso no editor de notebook.