Betriebs- und Importanleitung

Ziel

Diese Anleitung beschreibt, wie die Solution bmvcc in einer Umgebung bereitgestellt, geprueft und betrieben werden sollte.

Bestandteile der Solution

Die Solution enthaelt:

  • Dataverse-Tabellen

  • Canvas Apps

  • Model-Driven Navigation

  • Umgebungsvariablen

  • einen Custom Connector zu Bexio

  • mehrere Power-Automate-Flows

Voraussetzungen fuer den Import

Vor dem Import in eine Zielumgebung sollten folgende Voraussetzungen erfuellt sein.

Power-Platform-Grundlagen

  • Zielumgebung mit Dataverse

  • Berechtigungen zum Import unmanaged Solutions

  • Berechtigungen fuer Custom Connector, Canvas Apps und Cloud Flows

Externe und vorausgesetzte Komponenten

Folgende Abhaengigkeiten sind im Export sichtbar und muessen in der Zielumgebung vorhanden sein oder separat bereitgestellt werden:

  • Tabelle bmvcc_contact_adress

  • Lookup-bezogene Tabellen bzw. Komponenten bmvcc_contact_type, bmvcc_country, bmvcc_language

  • Canvas Component Library cre77_pagcomponents_21a73

Externe Dienste

  • Bexio-Zugang fuer den Custom Connector

  • SharePoint-Zielseite, falls die entsprechende Umgebungsvariable genutzt wird

  • Microsoft Teams, falls Benachrichtigungen aus Flows aktiv verwendet werden

Umgebungsvariablen

Die folgenden Variablen sind im Export enthalten und sollten vor Inbetriebnahme geprueft werden.

Variable

Zweck

Beobachtung aus dem Export

bmvcc_env_BusinessUnitId

Business-Unit-Kontext

Kein Defaultwert im Export

bmvcc_env_Dataverse

Dataverse-Verbindungsziel

Default verweist auf eine konkrete CRM-URL

bmvcc_env_SharePointSiteUrl

SharePoint-Ziel

Default verweist auf https://cloudcab.sharepoint.com/sites/dev

bmvcc_env_test

Testwert

Nur als Testvariable erkennbar

Empfohlene Import-Reihenfolge

  1. Externe Abhaengigkeiten und Referenzkomponenten bereitstellen.

  2. Custom Connector und notwendige Verbindungen vorbereiten.

  3. Solution bmvcc importieren.

  4. Umgebungsvariablen pro Zielumgebung setzen.

  5. Connection References pruefen und neu verbinden.

  6. Canvas Apps oeffnen und Verbindungen validieren.

  7. Cloud Flows pruefen, aktivieren und bei Bedarf parametrisieren.

  8. Fachliche Smoke-Tests durchfuehren.

Checkliste nach dem Import

Dataverse

  • Sind alle benutzerdefinierten Tabellen vorhanden?

  • Sind Formulare, Views und Beziehungen korrekt importiert?

  • Sind fehlende Lookups oder Abhaengigkeiten aufgeloest?

Canvas Apps

  • Laesst sich die Haupt-App bmvcc oeffnen?

  • Sind alle Verbindungen gueltig?

  • Ist die Component Library verfuegbar?

  • Funktionieren Datenzugriffe auf die erwarteten Tabellen?

Custom Connector

  • Ist BexioV3 importiert?

  • Ist die Authentifizierung korrekt eingerichtet?

  • Lassen sich die Operationen Allekontakte und Contact_relation testen?

Flows

  • Sind alle Flows im Status eingeschaltet, soweit gewuenscht?

  • Stimmen Trigger-Frequenzen mit dem Betriebsmodell ueberein?

  • Sind Connection References gueltig?

  • Schreiben die Flows Statusdaten in bmvcc_syncconfig?

Betriebsrelevante Beobachtungen

Geplante Flows

Die Solution enthaelt mindestens zwei geplante Synchronisationsprozesse:

  • BexioSynchKontakte: woechentlicher Lauf

  • BexioSynchRelation: taeglicher Lauf um 04:00 Uhr in W. Europe Standard Time

Diese Flows sollten nach dem Import nicht ungeprueft aktiviert werden, wenn Zielsysteme, Verbindungen oder fachliche Voraussetzungen noch nicht final konfiguriert sind.

Harte Umgebungsbezuge

Der Flow bmvcc-HerstellerBusinessunitsetzen enthaelt im Export feste Werte fuer:

  • Zielorganisation https://obsideploy.crm17.dynamics.com

  • konkreten Benutzerkontext bzw. Owner-ID

Dieser Flow ist damit nicht direkt portabel und sollte vor produktiver Nutzung angepasst werden.

Fehler- und Statusverfolgung

Die Flows verwenden erkennbar diese technischen Muster:

  • Status- und Laufzeitinformationen in bmvcc_syncconfig

  • Fehlerprotokollierung in bmvcc_bexiosyncerror

  • teilweise Teams-Benachrichtigungen bei Fehler- oder Laufereignissen

Empfohlene Betriebsprozesse

Regelmaessige Kontrollen

  • Flowlaufhistorien pruefen

  • Fehlerdatensaetze in bmvcc_bexiosyncerror kontrollieren

  • Zeitstempel und Status in bmvcc_syncconfig ueberwachen

  • Connector-Verbindungen und Token-Gueltigkeit pruefen

Aenderungsmanagement

  • Aenderungen zuerst in einer Testumgebung validieren

  • Umgebungsbezuge nicht hart in Flows hinterlegen

  • Connection References und Variablen pro Umgebung sauber trennen

  • Mapping-Flows nur kontrolliert manuell ausfuehren

Recovery bei Problemen

Wenn Synchronisationen fehlschlagen:

  1. Connection References und Authentifizierung pruefen.

  2. Letzten Lauf in Power Automate analysieren.

  3. Fehlerprotokolle in bmvcc_bexiosyncerror auswerten.

  4. Konfigurationsdatensatz in bmvcc_syncconfig pruefen.

  5. Erst nach Ursachenanalyse erneut ausfuehren.

Smoke-Test nach Bereitstellung

Ein einfacher technischer Smoke-Test kann so aussehen:

  1. Haupt-App bmvcc starten.

  2. Zugriff auf Geraete, Kontakte, Firmen und Pruefberichte pruefen.

  3. Einen manuellen Mapping-Flow in Testdaten ausfuehren.

  4. Connector-Test gegen Bexio durchfuehren.

  5. Kontrolle, ob Status- und Fehlerdaten erwartungsgemaess geschrieben werden.

Empfehlung fuer den produktiven Betrieb

  • Produktionsrelevante URLs, IDs und Besitzer nicht fest in Flows hinterlegen.

  • Betriebsrelevante Variablen konsequent ueber Umgebungsvariablen oder Konfigurationstabellen steuern.

  • Fachliche und technische Fehlerbehandlung gemeinsam definieren.

  • Vor Aktivierung geplanter Synchronisationen immer einen kontrollierten Testlauf durchfuehren.