Publicar modelos

A publicação de um modelo cria um item de ferramenta hospedado que pode ser executado como uma ferramenta da web personalizada.

As seguintes etapas são necessárias para publicar um modelo:

1. Criar um modelo.
2. Adicionar variáveis ​​para entradas que precisam ser configuráveis ​​na ferramenta da web.
3. Definir as variáveis ​​como parâmetros do modelo.
4. Gerencie os parâmetros para personalizar a forma como eles aparecem na ferramenta da web personalizada.
5. Execute e salve o modelo.
6. Publicar o modelo.

Requisitos de licenciamento

A publicação de um modelo requer a licença e as configurações para usar o ModelBuilder, além do privilégio Publicar ferramentas da web.

Definir variáveis como parâmetros do modelo

As variáveis ​​definidas como parâmetros do modelo aparecem como parâmetros da ferramenta quando o modelo é publicado e aberto como uma ferramenta da web personalizada, permitindo que você especifique dados ou valores diferentes dos especificados quando o modelo foi criado.

As variáveis ​​de dados hospedadas na saída são definidas automaticamente como parâmetros do modelo, enquanto os dados de entrada e as variáveis ​​de valor devem ser definidos manualmente como parâmetros. Variáveis ​​de dados intermediários de saída não podem ser definidas como parâmetros do modelo.

Para definir os dados de entrada e as variáveis ​​de valor como parâmetros do modelo, complete as seguintes etapas:

1. Conclua as etapas para criar ou abrir um modelo e conectar-se a uma sessão de análise.
2. Adicione dados, ferramentas e variáveis, se necessário.
3. Clique em um elemento da variável para selecioná-lo.

   A barra de ferramentas do elemento aparece acima da variável selecionada.

4. Clique em Adicionar ou remover parâmetro .

   Um ícone de parâmetro aparece na variável, indicando que a variável foi definida como um parâmetro do modelo.

Uma vez definidas as variáveis ​​necessárias como parâmetros do modelo, você estará pronto para gerenciar os parâmetros da ferramenta da web.

Gerenciar parâmetros de ferramenta da web

A janela Gerenciar parâmetros da ferramenta da web é usada para reordenar e atualizar as configurações dos parâmetros na ferramenta da web personalizada.

Para gerenciar os parâmetros de ferramenta da web, complete as seguintes etapas:

1. Conclua as etapas para criar ou abrir um modelo que contenha dados, ferramentas, variáveis ​​e parâmetros.
2. Se ainda não o fez, conecte-se a uma sessão de análise.
3. Na barra de ferramentas de ações, clique em Gerenciar parâmetros da ferramenta da web .

   A janela Gerenciar parâmetros da ferramenta da web aparece. Os parâmetros do modelo estão listados na ordem em que foram adicionados. Cada parâmetro tem um nome ou nome alternativo. O nome alternativo está vinculado à configuração do Rótulo do parâmetro.

   Anotação:

   Não é possível adicionar ou remover parâmetros da janela Gerenciar parâmetros da ferramenta da web. Para obter informações sobre como adicionar e remover parâmetros, consulte Definir variáveis ​​como parâmetros do modelo.

4. Clique em Expandir para exibir as configurações de um parâmetro.
5. Atualize as seguintes configurações conforme necessário.
   • Rótulo do parâmetro—uma breve descrição do parâmetro da ferramenta. Este texto aparecerá como o nome do parâmetro no painel de ferramentas da ferramenta da web personalizada. O rótulo deve ser curto, descritivo da finalidade do parâmetro e escrito em linguagem simples.
   • Texto de ajuda pop-up—uma breve descrição do parâmetro da ferramenta. Este texto aparecerá quando você clicar no botão de ajuda ao lado do parâmetro no painel de ferramentas da ferramenta da web personalizada. Inclua uma descrição da função do parâmetro, como diferentes valores afetam os resultados da ferramenta, as entradas suportadas e os valores padrão, conforme necessário.
   • Exigido — Indica se o parâmetro é necessário para validar e executar a ferramenta. Se o parâmetro do modelo estiver conectado a um ou mais parâmetros de ferramenta obrigatórios, esse valor será ativado e não poderá ser editado. Se todos os parâmetros da ferramenta conectada forem opcionais, o parâmetro do modelo pode ser ativado para tornar o parâmetro obrigatório ou desativado para torná-lo opcional. Tornar um parâmetro obrigatório forçará o usuário a fornecer uma entrada antes que a ferramenta online possa ser executada.
   • Tipo de dados—indica quais entradas são compatíveis com o parâmetro. Esse valor é baseado no tipo de dados da variável e não pode ser alterado.
   • Filtro—determina os limites ou restringe os valores de entrada ou dados que podem ser especificados para o parâmetro. As opções dependem do tipo de dados, conforme descrito a seguir:
     • Duplo—um valor mínimo e um valor máximo
     • Camada de feição—uma lista de tipos de feições permitidos, incluindo múltiplos pontos, ponto, linha e polígono
     • Campo—uma lista de tipos de campo permitidos
     • Inteiro—um valor mínimo e valor máximo
     • String—uma lista de valores únicos
     Os filtros são redefinidos para um parâmetro do modelo se uma nova conexão for criada entre a variável e uma ferramenta no diagrama do modelo. Os filtros devem ser revisados ​​e atualizados após qualquer alteração nas conexões do modelo.
   • Incluir valor padrão—indica se o parâmetro da ferramenta possui um valor padrão. Quando ativado, o parâmetro usará um valor padrão com base no valor da variável. Quando desativado, o parâmetro estará vazio por padrão. Um valor padrão pode ser usado para orientar as entradas do usuário ou simplificar a ferramenta da web, pois o usuário não precisa atualizar o parâmetro manualmente. Essa configuração deve ser usada para parâmetros com um menu de valores aceitos, como unidades, e parâmetros nos quais se espera que o mesmo valor de entrada seja usado frequentemente sem a necessidade de atualização.

     Anotação:

     Os valores padrão não são adequados para a maioria das entradas de texto, número ou camada de feição.

     Os ​​valores padrão também não devem ser usados para parâmetros que talvez você queira deixar vazios, como uma entrada opcional da camada de feição. O valor padrão será usado quando a ferramenta for executada, mesmo que o valor seja limpo manualmente no painel de ferramenta da web publicada.

   • Valor padrão—indica o valor padrão para o parâmetro da ferramenta. Para alterar o valor padrão, atualize o valor da variável no diagrama do modelo. O valor padrão deve ser um valor que forneça um resultado preciso ou preferencial na maioria dos casos. Essa configuração somente está disponível se a opção Incluir valor padrão estiver ativada.
6. Clique em Recolher para ocultar as configurações de parâmetros.
7. Repita as três etapas anteriores para cada um dos parâmetros restantes.

   Você também pode alterar a ordem dos parâmetros, se necessário.

8. Clique em Reposicionar ao lado do nome do parâmetro e arraste-o para uma posição diferente.

   Como alternativa, clique em Reposicionar e escolha uma opção no menu. Dependendo da posição do parâmetro, as opções incluirão Mover para cima, Mover para baixo, Mover para superior e Mover para inferior.

9. Clique em Salvar.

As configurações dos parâmetros da ferramenta da web são salvas e a janela Gerenciar parâmetros da ferramenta da web é fechada. Agora você está pronto para publicar o modelo.

Publicar um modelo

A publicação de um modelo cria um item de ferramenta, que pode ser compartilhado e executado como uma ferramenta da web personalizada.

Para publicar um modelo, complete as seguintes etapas:

1. Complete as etapas para criar ou abrir um modelo que contenha dados, ferramentas, variáveis ​​e parâmetros.

   Anotação:

   Os modelos que atendem a todos os critérios de publicação exigidos podem ser publicados sem a necessidade de conexão a uma sessão de análise. Se você tiver um modelo pronto para publicação, abra-o e prossiga para a etapa 6.

2. Se ainda não o fez, conecte-se a uma sessão de análise.
3. Execute o modelo.

   A execução do modelo não é obrigatória, mas ajudará a garantir que a ferramenta da web funcione corretamente.

4. Salve o modelo.

   A ferramenta web da publicada será baseada no item do modelo de análise salvo. O modelo deve ser executado e salvo antes de ser publicado. Se quaisquer alterações forem realizadas no modelo, você deverá salvá-lo novamente.

   Antes de publicar o modelo, visualize a ferramenta da web para garantir que os parâmetros corretos de ferramenta da web estejam configurados.

5. Na barra de ferramentas do modelo, clique em Visualizar ferramenta da web .

   Uma visualização de ferramenta da web aparece no painel Análise. Caso sejam necessárias alterações na ferramenta da web, retorne aos fluxos de trabalho para definir e gerenciar os parâmetros. Clique em Visualizar ferramenta da web novamente para atualizar a visualização.

   Assim que a pré-visualização mostrar todos os parâmetros e configurações desejados na ferramenta da web, você poderá publicar o modelo.

6. Na barra de ferramentas do modelo, clique em Publicar .

   A janela da Publicar da ferramenta da web é exibida. Caso os requisitos de publicação não sejam atendidos, revise os requisitos restantes, feche a janela Publicar como ferramenta da web e conclua os requisitos antes de retornar a este fluxo de trabalho.

   Saiba mais sobre os requisitos de publicação

   Se os requisitos de publicação forem atendidos e você estiver conectado a uma sessão de análise, você poderá fechar a janela Publicar como ferramenta da web, desconectar da sessão de análise e repetir esta etapa no modo de somente visualização.

7. Faça o seguinte para o novo item:
   • Forneça um título.

     O título não pode conter espaços. Você pode atualizar o título do item da ferramenta após a publicação, na página do item.

   • Escolha uma pasta em Meu conteúdo onde você deseja salvar o item.
   • Forneça tags e um resumo que descreva o item.
8. Clique em Publicar.

   O modelo é publicado e um item da ferramenta é criado.

9. Clique em Abrir item de ferramenta da web para abrir os detalhes do item da ferramenta ou feche a janela Publicar como ferramenta da web.

Você pode abrir a ferramenta web da personalizada no painel Ferramentas clicando em Abrir ferramenta da web personalizada. Você também pode compartilhar item da ferramenta com sua organização ou grupos a partir da página de detalhes.

Anotação:

Você não pode compartilhar itens da ferramenta com o público.

Substituir uma ferramenta da web

Quando um modelo já foi publicado, o botão Publicar é substituído pelo botão Substituir. Você pode fazer alterações na ferramenta da web existente atualizando o modelo e completando as etapas para publicar o modelo usando o botão Substituir.

Requisitos de publicação

Todos os requisitos descritos abaixo devem ser atendidos para habilitar a publicação de um modelo de análise como uma ferramenta da web.

Publicação de privilégios de usuário

Sua conta de usuário deve atender aos requisitos de licenciamento para publicar modelos de análise como ferramentas da web. Se sua conta não atender aos requisitos de licenciamento, o botão Publicar não estará disponível.

Para atualizar os privilégios da sua conta de usuário, entre em contato com o administrador da sua organização.

Criar uma saída hospedada

Um modelo de análise deve criar uma camada de feição ou uma camada de tabela hospedada como saída antes de poder ser publicado como uma ferramenta da web. Por padrão, todas as ferramentas adicionadas a um modelo criam saídas intermediárias, em vez de saídas hospedadas.

Para atender a esse requisito, certifique-se de que uma das ferramentas tenha o parâmetro Camada de resultado definido como Criar camada hospedada ou Substituir camada existente. Os resultados obtidos serão definidos como parâmetros do modelo e adicionados ao mapa da web após a execução do modelo ou da ferramenta da web. Crie uma camada hospedada para a saída que deseja visualizar como resultado da análise, como a última ferramenta do modelo. Para obter melhores resultados, crie saídas hospedadas apenas para uma ferramenta no modelo.

Saiba mais sobre as saídas do modelo

Gerenciar parâmetros de ferramenta da web

Os erros nos parâmetros da ferramenta da web devem ser resolvidos na janela Gerenciar parâmetros da ferramenta da web.

A mensagem O valor padrão está fora do intervalo do filtro será exibida se o valor padrão e o intervalo do filtro não forem compatíveis (por exemplo, os valores do filtro são números entre 1 e 10 e o valor padrão é 11). O valor padrão para o parâmetro do modelo é baseado no parâmetro variável e os valores de filtro são definidos na janela Gerenciar parâmetros da ferramenta da web. Para resolver o erro, atualize os valores do filtro na janela Gerenciar parâmetros de ferramenta da web ou altere o valor da variável para atualizar o valor padrão do parâmetro.

As ferramentas estão prontas para uso

Todas as ferramentas, entradas e saídas necessárias devem estar prontas para uso ou já terem sido executadas. Se um ou mais elementos necessários não estiverem prontos para uso, este requisito não será atendido. Para resolver esse problema, abra o elemento da ferramenta para revisar os erros ou definir os parâmetros necessários. Você deve estar conectado a uma sessão de análise e o modelo deve estar ativo antes de poder atualizá-lo.

Salve as alterações do modelo

As alterações pendentes no modelo devem ser salvas. A ferramenta da web publicada é baseada no item do modelo de análise salvo. Se o modelo tiver alterações não salvas, a publicação não será ativada.

Execute o modelo

É recomendado executar o modelo completo com sucesso antes de publicá-lo como uma ferramenta da web, para garantir que a ferramenta funcionará corretamente e criará os resultados esperados.

Limitações

As informações de campo não podem ser obtidas para parâmetros de ferramentas da web criados a partir de variáveis ​​de campo quando o conjunto de dados de entrada é a saída de uma ferramenta de análise ou quando a mesma variável de campo é utilizada para múltiplos conjuntos de dados de entrada. Como resultado, as seguintes limitações se aplicam ao parâmetro de ferramenta da web:

• O parâmetro de ferramenta da web não terá um menu de opções de campo. Em vez disso, uma caixa de texto estará disponível para digitar o nome do campo.
• Filtros de tipo de campo definidos na janela Gerenciar parâmetros de ferramenta da web não serão considerados.