Zum Hauptinhalt springen

Überblick

Daten in Wert verwandeln.

OctoMesh revolutioniert die Art und Weise, wie Unternehmen Daten zwischen Softwareanwendungen austauschen, indem es sowohl Konnektivität als auch intelligente Datenzuordnung und -transformation bereitstellt. OctoMesh löst die Herausforderungen von Dateninkompatibilität, Konnektivität und Mapping und ermöglicht einen nahtlosen und effizienten Datenaustausch. OctoMesh begleitet Organisationen auf ihrer Reise der digitalen Transformation mit optimierten Verbindungen und Kopplungen, starken Sicherheitsmaßnahmen und einer intuitiven Benutzeroberfläche. Unternehmen entdecken so das volle Potenzial ihrer Daten und fördern Innovation, Effizienz und fundierte Entscheidungen in der heutigen datengetriebenen Welt.

tipp

Für die Entwicklungsumgebung müssen hauptsächlich das .NET SDK und Node.js installiert werden. Die Details finden Sie hier.

tipp

Benutzer und Passwörter siehe hier

Developer PowerShell​

Die OctoMesh-PowerShell ermöglicht es, den Prozess des Klonens, Bauens und Startens von OctoMesh inklusive Infrastruktur zu vereinfachen.

Um zu beginnen, klonen Sie das Repository https://github.com/meshmakers/octo-tools in ein Verzeichnis wie ~/Development/meshmakers/octo-tools.

mkdir ~/Development/meshmakers/
cd ~/Development/meshmakers/
git clone git@github.com:meshmakers/octo-tools.git
Windows und Pfadlänge

Falls Sie aufgrund der 260-Zeichen-Pfadlängenbeschränkung von Windows auf Probleme stoßen, empfiehlt es sich, das Verzeichnis näher an Ihr Home-Verzeichnis zu verlegen, z. B. C:\meshmakers. Andernfalls besteht eine mögliche Notlösung darin, Long Paths per Registry-Bearbeitung in PowerShell oder einer Registry File zu aktivieren. Bitte gehen Sie jedoch mit Vorsicht vor, da diese Lösung potenzielle Risiken birgt! Weitere Informationen finden Sie unter dem untenstehenden Link.

PowerShell
New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

Weitere Informationen finden Sie hier.

Fügen Sie Ihrem PowerShell-Profil das OctoMesh-Profil hinzu, indem Sie das Profil erweitern. In diesem Fall verwenden wir Visual Studio Code, wir gehen also davon aus, dass code in Ihrer PATH-Umgebungsvariable verfügbar ist.

code $PROFILE

Fügen Sie dem Profil hinzu:

. "~/Development/meshmakers/octo-tools/modules/profile.ps1"

Starten Sie PowerShell neu; während des Starts sollten Sie eine Meldung wie diese sehen

Loading Octo Profile

Nach dem Laden des OctoMesh-Developer-Profils existieren einige PowerShell-Variablen

  • $ROOTPATH: Das Basisverzeichnis von OctoMesh. z. B. ~/Development/meshmakers/. Dieses Verzeichnis wird Root-Verzeichnis genannt
  • $TOOLSPATH: Das Verzeichnis des Tool-Repositorys. z. B. ~/Development/meshmakers/octo-tools
  • $INFRASTRUCTUREPATH: Das Infrastruktur-Verzeichnis innerhalb des Tool-Repositorys. z. B. ~/Development/meshmakers/octo-tools/infrastructure
  • $NUGETPATH: Das Verzeichnis der gespeicherten NuGet-Pakete für OctoMesh. z. B. ~/Development/meshmakers/nuget
  • $GLOBALNUGETPACKAGESPATH: Der globale NuGet-Paketpfad von .NET. z. B. {use profile path}/.nuget/packages/

Projekteinstellungen anpassen​

Mit einer Datei namens Octo.User.props im Root-Verzeichnis ($ROOTPATH) von OctoMesh können Sie die Einstellungen der Projekte anpassen. Die Datei wird von MsBuild geladen und ist wie folgt aufgebaut:

<Project>
    <PropertyGroup>
       <!-- Settings -->
    </PropertyGroup>
</Project>

Standardmäßig werden die neuesten verfügbaren NuGet-Pakete verwendet. Mit der Datei Octo.User.props können Sie die Version der zu verwendenden NuGet-Pakete festlegen.

<Project>
    <PropertyGroup>
        <OctoVersion>1.2.3</OctoVersion>
    </PropertyGroup>
</Project>

IDEs verwenden​

In einer IDE wie Visual Studio oder JetBrains Rider ist etwas Konfiguration nötig. Details finden Sie hier.

Repositories klonen​

Alle git-Repositories werden auf GitHub gehostet, alle Pakete werden auf nuget oder npmjs.org gehostet.

tipp

Wir haben uns entschieden, SSH-Schlüssel zur Verbindung mit GitHub zu verwenden; daher sind einige gut zu wissende Punkte unter Git konfigurieren dokumentiert.

Um die Haupt-Repos zu klonen, müssen Sie den Befehl Invoke-CloneMainRepos innerhalb der PowerShell mit OctoMesh-Profil ausführen.

Services bauen und starten​

Sobald die Voraussetzungen erfüllt sind, stehen die folgenden Skripte zur Verfügung, um das Projekt zu bauen und die Services zu starten.

Nach dem Build müssen die Infrastruktur-Services gestartet werden. Die Schritte zum Installieren, Starten, Stoppen oder Deinstallieren finden Sie hier

Invoke-BuildAll
Install-OctoInfrastructure # First time
Start-OctoInfrastructure  # Second time
Start-Octo # start the octo mehs services
Register-OctoCliContext -Installation local -TenantId meshtest # Login to the local environment

Danach sollten die folgenden Services verfügbar sein:

Das erste Benutzerkonto erstellen​

Gehen Sie zum Identity Service, um den ersten Admin-Benutzer zu erstellen.
Danach können in Refinery Studio neue Tenants erstellt werden.

Fehlerbehebung​

Hier sind einige häufige Probleme und ihre Lösungen aufgeführt.

Probleme mit CORS​

Jede Client-Anwendung (Refinery Studio, Office Integration) bringt ihre eigene OIDC-Client-Registrierung mit den passenden allowedCorsOrigins mit, die in den lokalen Identity Service geseedet werden. Wenn ein Browser Anfragen mit einem CORS-Fehler blockiert, stellen Sie sicher, dass der von Ihnen verwendete Client mit seinem lokalen Origin registriert ist (z. B. https://localhost:4200 für Refinery Studio) — führen Sie das Identity-Seeding / Overlay für Ihre lokale Umgebung erneut aus, falls es fehlt.

Probleme mit .NET dev certificates unter Linux​

Um ein Zertifikatsproblem zu bestätigen, führen Sie den folgenden Befehl in PowerShell aus:

http get https://localhost:5003/.well-known/openid-configuration

Es ist bestätigt, wenn die Konsolenausgabe den folgenden Fehler enthält: CERTIFICATE_VERIFY_FAILED.

Lösung:
Details zur Behebung dieses Problems finden Sie unter Systemvoraussetzungen.

Weiterführende Literatur​