Integration von Google Sheets in die SkyCiv-API

Wäre es nicht schön, Ihre Statik zu erstellen, Design, und Optimierung direkt in Google Sheets? Würde es nicht viel Zeit sparen, ein einfaches Werkzeug zu haben, das eine Handvoll Parameter als Eingabe verwendet, um ein vollständiges Strukturmodell zu erstellen und zu analysieren??

In diesem Artikel stellen wir die Integration der SkyCiv API mit Google Tabellen, mit Google Apps-Skript. Apps-Skript ist a Cloud-basierte JavaScript-Plattform, mit der Sie Aufgaben in Google-Produkten integrieren und automatisieren können, So können Sie ganz einfach Ihre eigenen Apps erstellen, um sich wiederholende Aufgaben zu automatisieren, indem Sie alle Funktionen von Google-Produkten und jedem anderen Dienst kombinieren, der über HTTP-Anfragen kommunizieren kann. Dies ist der Fall von SkyCiv, unsere API erhält ein Objekt mit den Modellinformationen und den Funktionen, die SkyCiv auf dem Modell ausführen soll. Nachdem alle Berechnungen durchgeführt wurden, die API antwortet mit den Ergebnissen der Analyse, Design, und Optimierung je nachdem, was zurückgegeben werden soll.

Diese Lösung ergibt sich aus dem Problem, dass Sie das Modell der Strukturen, die Ihr Unternehmen typischerweise entwirft, manuell erstellen und die Ergebnisse aus der Analyse-/Design-/Optimierungssoftware manuell in eine Tabellenkalkulation übertragen müssen, um diese Ergebnisse weiterzuverarbeiten. Als Beispiel, Wir werden erklären, wie Sie in SkyCiv S3D eine Kalkulationstabelle erstellen, mit der ein Stützmauer-über-Pfahl-Modell erstellt werden kann, Analyse ausführen, und die Ergebnisse zurück in die Tabellenkalkulation.

Das Modell besteht aus einer Platte, die den Wandstiel darstellt, auf einem Fundamentbalken, der von zwei Pfählen getragen wird. Es ist eine ziemlich einfache Struktur, aber jedes Mal von Grund auf neu zu modellieren kann eine sehr mühsame Aufgabe sein. Hier ist die Schritt-für-Schritt-Anleitung, wie Sie eine Tabellenkalkulation mit der SkyCiv-API kommunizieren und die Modellierungs- und Analyseprozesse automatisieren können.

Hinweis: Die in diesem Beispiel verwendete Tabellenkalkulation zusammen mit dem gesamten zugehörigen Code, kann zugegriffen werden Hier, Denken Sie daran, dass Sie zuerst eine Kopie in Ihrer Ablage erstellen müssen, indem Sie zu Datei . gehen>Eine Kopie machen

Die Eingabe

Der erste Schritt besteht darin, den Parametersatz zu identifizieren, der das strukturelle System vollständig beschreiben kann. Bei der beschriebenen Stützmauer, wir müssen den Stamm geometrisch beschreiben, das Fundament, und die stapel, zusätzlich, wir brauchen die Eigenschaften des tragenden Bodens sowie die Lasten, die auf die Wand aufgebracht werden. Das gesagt, Die Parameter, die das Modell beschreiben, sind in einigen Tabellen im ersten Blatt organisiert.

Der Code

Der gesamte Code wird direkt in die Apps Script-Benutzeroberfläche geschrieben. Um zum Code-Editor zu gelangen, Sie können in der Menüleiste auf gehen Erweiterungen > Apps-Skript

Benutzerinteraktion

Damit der Benutzer mit den Funktionen interagieren kann, die wir schreiben werden, können wir der Benutzeroberfläche ein Menüelement hinzufügen, das geht ganz einfach mit folgendem Code:

Abrufen von Daten aus der Tabelle

Im Code, wir benötigen alle Daten zu den geometrischen Parametern, Ladungen, und Supportbedingungen aus der Tabelle, zu diesem Zweck, wir erstellen ein Apps Script Objekt (einem JavaScript sehr ähnlich) unter Verwendung der im folgenden Snippet gezeigten Struktur:

Modell erstellen

Die wichtigste Funktion ist die, die das Modellobjekt erstellt, das an die SkyCiv-API gesendet wird, es folgt einigen Regeln, die in unserem zu finden sind API-Dokumentation. Wir müssen viele for-Schleifen und bedingte Anweisungen schreiben, um dieses Modellobjekt erfolgreich zu erstellen (Knoten, Elementen verarbeiten, Abschnitte, Ladungen, etc...). Der gesamte Code ist zu finden Hier.

API-Objekt erstellen

Das im vorherigen Schritt erstellte Modell muss in ein API-Objekt eingesteckt werden, das alle Anweisungen für die API enthält, damit es weiß, was zu tun ist, den allgemeinen Aufbau des API-Objekts finden Sie auch in unserem API-Dokumentation. Für dieses Beispiel, Wir werden eine Sitzung starten, das Modell einstellen, die Platten ineinandergreifen, lösen, und speichere das Modell. Der gesamte Code ist zu finden Hier. Das API-Objekt enthält auch die Authentifizierungsdaten, bestehend aus Ihrer bei SkyCiv registrierten E-Mail und Ihrem Schlüssel, falls Sie die Beispieltabelle ausführen, Stellen Sie sicher, dass Sie diese Informationen in der Authentifizierungsblatt.

Stellen Sie die Anfrage an die SkyCiv-API

Wie bereits erwähnt, Dieses API-Objekt wird mit einer POST-HTTP-Anfrage an die SkyCiv-API gesendet, diese Anfrage wird mit dem folgenden Code ausgeführt:

Das 'Antwort'-Objekt enthält, was die API auf die Anfrage geantwortet hat, Diese Antwort kann in der Tabellenkalkulation oder im Code gemäß Ihren spezifischen Anforderungen weiterverarbeitet werden. Es beinhaltet Reaktionen, Verschiebungen, betont, interne Kräfte, etc...

Die Ergebnisse

Wenn Sie das Skript zum ersten Mal ausführen, du musst es autorisieren, und sobald das Modell erstellt und analysiert ist, Die Ergebnisse werden in der von Ihnen im Code angegebenen Weise in die Tabelle zurückgegeben.. Die ganze Tabelle sieht so aus:

Das Skript erhält eine URL, unter der das Modell gespeichert wurde, Wenn Sie zu dieser URL gehen, können Sie dies überprüfen, Modifiziere und löse das Modell, alles in der SkyCiv S3D-Benutzeroberfläche:

Das Beste an dieser Integration ist, dass Sie den Zeitaufwand für die Modellierung dieser typischen Strukturen deutlich reduzieren können. Durch einfaches Anpassen der Eingabeparameter erhalten Sie ein lösungsfertiges Modell und können die Ergebnisanalyse weiter automatisieren, Design-Exploration, Designprüfungen, und Optimierung durch die Kombination des Besten der SkyCiv-API, Skript für Google Tabellen und Apps.

Viel Spaß beim Codieren!