Você usa um fluxo de trabalho comprovado para editar e documentar os modelos do ArcGIS ModelBuilder?

Você tem alguma referência a exemplos de práticas recomendadas ou pode compartilhar seus conhecimentos sobre como acompanhar edições nos modelos ModelBuilder, acompanhar alterações entre versões de modelo / ferramenta e manter a estabilidade, robustez e função do modelo?

Estou ciente das orientações da ESRI para gerenciar, copiar e nomear modelos aqui .

Eu estaria interessado se alguém estabelecesse práticas ou conhecimentos específicos no uso do rastreamento de versão, arquivamento e edição das ferramentas ModelBuilder que eles usam com sucesso para rastrear o desenvolvimento e a verificação do modelo e manter os modelos em uma condição estável.

Atualmente, apenas mantemos as caixas de ferramentas em um servidor de arquivos do Windows e fazemos a reversão usando a funcionalidade " Versões anteriores ", se algo acontecer.

Estou estudando o armazenamento de caixas de ferramentas no Git (usando o TortoiseGit e o GitHub Enterprise ), que já usamos para scripts Python e espaços de trabalho do FME . Como as caixas de ferramentas comuns são binárias, você não pode diferenciá-las e mesclá-las interativamente, como faria com arquivos de texto sem formatação, mas ainda é possível obter mensagens / histórico de confirmação, tags, ramificações e mesclar arquivos binários inteiros (tudo ou nada).

A melhor coisa que acho que você poderia fazer seria passar completamente para o Python e usar caixas de ferramentas e suplementos do Python, em vez do ModelBuilder. Além disso, se você tiver o FME que pode fazer praticamente tudo o que pode fazer com o ModelBuilder e, geralmente, com muito mais eficiência e facilidade, além de ser mais documentado, com marcadores, anotações, descrições de espaço de trabalho etc.

Com o GitHub, você pode usar seus recursos Wiki ou Páginas para obter uma documentação mais extensa.

Um método de baixa tecnologia, mas ainda eficaz, é simplesmente incluir um arquivo de texto leia-me com informações sobre o objetivo, uso e histórico da caixa de ferramentas / modelo.

Não acho que exista nenhuma maneira de rastrear alterações em um modelo enquanto você o constrói e não sei por que você faria isso de qualquer maneira?

O importante é explicar aos outros o raciocínio por trás do seu modelo. Por exemplo, por que suas entradas precisam estar em um geodatabase de arquivo, por que você criou um campo e dividiu um valor por outro número?

Esse tipo de informação importante é fundamental para os usuários e o desenvolvedor que precisam buscá-la quando você "é atropelado por um ônibus". :)

Há dois lugares em que eu documentaria um modelo, como rótulos no construtor de modelos (eles seriam direcionados aos desenvolvedores) e na descrição do item (metadados) da ferramenta. Você pode realmente ir à cidade adicionando informações úteis que orientam o usuário.

Infelizmente, a maioria das pessoas que desenvolve modelos faz um trabalho ruim ao adicionar informações aos parâmetros, o que dificulta a compreensão do modelo se você voltar meses depois. Eu sei disso ... eu consegui!

Alguns minutos passados ​​agora adicionando algumas descrições a um parâmetro de modelo podem transformar um modelo útil em uma ótima ferramenta que é adotada rapidamente por uma organização; caso contrário, é apenas mais um modelo usado que desaparece rapidamente em sua unidade de rede!

Além do que já foi dito, sugiro tentar armazenar sua caixa de ferramentas em um banco de dados ArcSDE. Pode realmente ajudar na edição e acesso simultâneos. Também faço backup desse banco de dados para reverter em caso de problema.

Para mais detalhes, dê uma olhada em outra das minhas respostas .

Na parte "documentação", use o editor de metadados, também conhecido como Descrição do Item , consulte Um rápido tour pelas ferramentas e caixas de ferramentas de documentação .

A caixa do editor de rich text é funcional, mas limitada. Salve e verifique os resultados frequentemente na visualização da descrição do item e na própria caixa de diálogo da ferramenta, pois algumas formatações podem ser confusas ou não mantidas, principalmente itens da lista. Você pode colar do Word, Onenote, Dream Weaver etc. para começar rapidamente, mas, a menos que a formatação seja realmente simples, ela será confusa às pressas.

(Uma ressalva: a maneira antiga era usar a caixa de diálogo "Modelo >> Editar >> Propriedades do modelo" e colar o código html no campo "Descrição". Se você fez ou fez isso, quando o editor de Descrição do item estiver acessando o conteúdo é copiado, o que é ótimo. No entanto, todas as edições que você fizer não serão copiadas novamente; portanto, exclua a versão das propriedades do modelo para evitar confusão.)

O controle de versão é possível saindo um pouco da caixa: ao exibir a Descrição do item, abra o menu de contexto , clique em >> Visualizar fonte e salve o html na pasta source-control / docs . As imagens são deixadas de fora, mas se você quiser adicionar um pouco mais de trabalho, poderá examinar o html e buscá-las %temp%.

Você pode obter um maior grau de controle referenciando um arquivo de ajuda compilada (CHM) . O ponto de partida parece ser a Ajuda em HTML da Microsoft 1.4 .