Verwenden Sie einen bewährten Workflow zum Bearbeiten und Dokumentieren von ArcGIS ModelBuilder-Modellen?

Haben Sie Hinweise auf Best-Practice-Beispiele oder können Sie Ihr Fachwissen darüber teilen, wie Sie Änderungen an ModelBuilder-Modellen verfolgen, Änderungen zwischen Modell- / Werkzeugversionen verfolgen und die Stabilität, Robustheit und Funktion des Modells beibehalten können?

Mir sind die ESRI-Richtlinien zum Verwalten, Kopieren und Benennen von Modellen hier bekannt .

Es würde mich interessieren, ob jemand Praktiken oder spezielle Fachkenntnisse in der Verwendung von Versionsverfolgung, Archivierung und Bearbeitung von ModelBuilder-Tools etabliert hat, die er erfolgreich verwendet, um die Modellentwicklung und -prüfung zu verfolgen und Modelle in einem stabilen Zustand zu halten.

Derzeit speichern wir nur Toolboxen auf einem Windows-Dateiserver und verwenden die Funktion " Vorherige Versionen ", wenn etwas kaputt geht.

Ich beschäftige mich mit dem Speichern von Toolboxen in Git (mit TortoiseGit und GitHub Enterprise ), die wir bereits für Python-Skripte und FME- Arbeitsbereiche verwenden. Da reguläre Toolboxen binär sind, können Sie sie nicht wie bei einfachen Textdateien unterscheiden und interaktiv zusammenführen. Sie können jedoch weiterhin Commit-Nachrichten / Verlauf, Tags, Verzweigungen abrufen und ganze Binärdateien (alle oder nichts) zusammenführen.

Ich denke, das Beste, was Sie tun können, ist, vollständig auf Python umzusteigen und Python- Toolboxen und Python-Add-Ins anstelle von ModelBuilder zu verwenden. Auch wenn Sie über FME verfügen, das fast alles kann, was Sie mit ModelBuilder tun können, und dies in der Regel viel effizienter und einfacher und selbstdokumentierender ist, mit Lesezeichen, Anmerkungen, Arbeitsbereichsbeschreibungen usw.

Mit GitHub können Sie die Wiki oder Pages-Funktionen für eine ausführlichere Dokumentation verwenden.

Eine einfachere, aber dennoch effektive Methode besteht darin, einfach eine Readme-Textdatei mit Informationen über den Zweck, die Verwendung und den Verlauf der Toolbox / des Modells einzuschließen.

Ich glaube nicht, dass es eine Möglichkeit gibt, Änderungen in einem Modell zu verfolgen, während Sie es erstellen, und ich bin mir nicht sicher, warum Sie das überhaupt tun möchten?

Wichtig ist, anderen die Gründe für Ihr Modell zu erklären. Warum müssen sich Ihre Eingaben beispielsweise in einer Datei-Geodatabase befinden, warum haben Sie ein Feld erstellt und einen Wert durch eine andere Zahl geteilt?

Diese Art von wichtigen Informationen ist für Benutzer und Entwickler von entscheidender Bedeutung, die sie abholen müssen, wenn Sie "von einem Bus überfahren werden". :) :)

Es gibt zwei Stellen, an denen ich ein Modell dokumentieren würde, als Beschriftungen im Model Builder (diese würden an Entwickler gerichtet sein) und innerhalb der Elementbeschreibung (Metadaten) des Tools. Sie können wirklich in die Stadt gehen, indem Sie nützliche Informationen hinzufügen, die einen Benutzer führen.

Leider leisten die meisten Leute, die Modelle entwickeln, schlechte Arbeit beim Hinzufügen von Informationen zu Parametern, was das Modell schwer verständlich macht, wenn Sie Monate später darauf zurückkommen. Ich weiß das ... ich habe es geschafft!

Ein paar Minuten, die Sie damit verbringen, einem Modellparameter einige Beschreibungen hinzuzufügen, können aus einem nützlichen Modell ein großartiges Tool machen, das von einer Organisation schnell übernommen wird. Andernfalls ist es nur ein weiteres halbherziges Modell, das schnell auf Ihrem Netzlaufwerk verschwindet!

Neben dem bereits Gesagten würde ich vorschlagen, Ihre Toolbox in einer ArcSDE-Datenbank zu speichern. Es kann wirklich für die gleichzeitige Ausgabe und den Zugriff helfen. Ich sichere auch diese Datenbank, damit ich im Falle eines Problems ein Rollback durchführen kann.

Weitere Informationen finden Sie in einer anderen meiner Antworten .

Auf der „Dokumentieren“ -Teil, verwenden Sie die Metadaten aka Element Beschreibung Editor finden Sie unter Kurzer Überblick zu dokumentieren Werkzeuge und Werkzeugkästen .

Das Rich-Text-Editor-Feld ist funktionsfähig, aber begrenzt. Speichern und überprüfen Sie die Ergebnisse häufig sowohl in der Vorschau der Elementbeschreibung als auch im Werkzeugdialog selbst, da einige Formatierungen durcheinander gebracht oder nicht beibehalten werden können, insbesondere Listenelemente. Sie können aus Word, Onenote, Dream Weaver usw. einfügen, um einen schnellen Start zu erhalten. Wenn die Formatierung jedoch nicht wirklich einfach ist, wird sie schnell durcheinander gebracht.

(Eine Einschränkung: Die alte Methode bestand darin, das Dialogfeld "Modell >> Bearbeiten >> Modelleigenschaften" zu verwenden und HTML-Code in das Feld "Beschreibung" einzufügen. Wenn Sie dies tun oder getan haben, greifen Sie beim Elementbeschreibungseditor auf den Inhalt zu wird kopiert, was großartig ist. Änderungen, die Sie vornehmen, werden jedoch nicht zurückkopiert. Löschen Sie daher die Version der Modelleigenschaften, um Verwirrung zu vermeiden.)

Die Versionskontrolle ist möglich, indem Sie ein wenig aus dem Kasten herausgehen: Wenn Sie die Elementbeschreibung anzeigen, rufen Sie das Kontextmenü auf, klicken Sie auf >> Quelle anzeigen und speichern Sie den HTML-Code in Ihrem Ordner Quellcodeverwaltung / Dokumente . Bilder werden weggelassen, aber wenn Sie noch etwas mehr Arbeit hinzufügen möchten, können Sie das HTML untersuchen und von dort abrufen %temp%.

Möglicherweise erhalten Sie ein höheres Maß an Kontrolle, wenn Sie auf eine kompilierte Hilfedatei (CHM) verweisen . Der Ausgangspunkt scheint Microsoft HTML Help 1.4 zu sein .