Beiträge in diesem Abschnitt

Meisterplan-Konnektor für Salesforce konfigurieren

Verfügbarkeit Alle Editionen

Erfahren Sie, wie Sie den Meisterplan-Konnektor für Salesforce konfigurieren, um den Import und die Aktualisierung von Projekten in Meisterplan zu automatisieren.

Voraussetzungen

Sie müssen das App-Paket installiert haben. Laden Sie es hier herunter und installieren Sie es: appexchange.salesforce.com/appxListingDetail?listingId=cd7e4291-5109-424d-a783-ce1f93a475dc

Meisterplan

  • Erforderliche Zugriffsrechte: Ihr Benutzerkonto benötigt das Recht Zugriff auf Meisterplan-APIs und Anbindung externer Anwendungen.
  • Systemkonfiguration: 
    • API-Token: Salesforce verbindet sich über die REST-API mit Meisterplan, daher benötigen Sie ein API-Token. Wir empfehlen, einen speziellen Benutzer für die Salesforce-Integration anzulegen und ihm die erforderlichen Benutzerrechte zu gewähren (siehe oben). Melden Sie sich dann bei diesem Benutzerkonto an und erstellen Sie das API-Token.
    • Benutzerdefiniertes Projektfeld: Um Salesforce-Opportunities zu importieren, muss Ihr Meisterplan-System über ein benutzerdefiniertes Projektfeld mit dem API-Namen „cust_stage_gate” verfügen. In Meisterplan-Trials heißt dieses Feld in der Regel „Stage Gate” oder „Verkaufsstatus”, und hat genau den o. g. API-Namen. Überprüfen Sie Ihr Meisterplan-System und fügen Sie gegebenenfalls ein Feld mit diesem API-Namen hinzu.

Salesforce

  • Erforderliche Zugriffsrechte: Sie müssen in Salesforce ein Systemadministrator (oder vergleichbar) mit einem Setup-Zugriff sein.

So konfigurieren Sie den Meisterplan-Konnektor für Salesforce

'Named Credential' konfigurieren

Das Paket verwendet die Elemente Named Credential and External Credential, um die URL und das API-Token sicher zu speichern und eine Verbindung zu Meisterplan's REST API herzustellen.

URL der REST API eintragen

  1. Gehen Sie zu Setup > Named Credentials. 
  2. Wählen Sie Meisterplan (vom Paket erstellt). 
  3. Klicken Sie Edit und nehmen Sie folgende Einstellungen vor (sofern noch nicht geschehen):
    • Label: Meisterplan
    • Name: Meisterplan
    • URL: Geben Sie die URL der REST API von Meisterplan ein:
    • Enabled for Callouts: aktiviert
    • External Credential: Wählen Sie MeisterplanEC im Dropdown aus
    • Generate Authorization Header: nicht angehakt
    • Allow Formulas in HTTP Header: angehakt
    • Allow Formulas in HTTP Body: nicht angehakt
      SF_Edit-MP.png
  4. Klicken Sie auf Save.

API-Token eintragen

  1. Gehen Sie zu Setup > Named Credentials > External Credentials
  2. Wählen Sie MeisterplanEC (vom Paket erstellt)
  3. Klicken Sie unter Principals > Admin Team auf das Actions-Dropdown und wählen Sie Edit:

    SF_Edit-MP#2.png
  4. Klicken Sie unter Authentication Parameters auf Add nehmen Sie folgende Einstellungen vor:
    • Name: API Token
    • Value: Meisterplans API-Token
      SF_Edit-Principal.png
  5. Klicken Sie Save.

Zugriff auf 'External Credential Named Principal'

Die 'Managed Permission Sets' können nicht bearbeitet werden. Daher empfehlen wir, ein 'Permission Set' zu erstellen, das zum Mandanten gehört, und diesem Zugriff auf den External Credential Named Principal zu geben.

Erstellen Sie ein 'Permission Set' für Mandanten

  1. Gehen Sie zu Setup > Permission Sets > New und nehmen Sie folgende Einstellungen vor:
    • Label: Meisterplan Integration NamedPrincipal Access
    • API Name (automatisch ausgefüllt): Meisterplan_Integration_NamedPrincipal_Access
    • Description: Erteilt der Meisterplan-Integration Zugriff auf 'External Credential. (Grants access to the External Credential for Meisterplan integration.)
    • License: None (oder nach Bedarf)
  2. Klicken Sie Save

'External Credential Principal' Zugriff gewähren

  1. Öffnen Sie im neuen 'Permission Set' External Credential Principal Access
  2. Klicken Sie Edit
  3. Ziehen Sie MeisterplanEC - Admin Team vom Bereich Available External Credential Principals in den Bereich Enabled External Credential Principals
  4. Klicken Sie Save
    SF_Permission-Sets.png

'Permission Sets' zuweisen

Weisen Sie allen relevanten Benutzern, die auf den Meisterplan-Konnektor für Salesforce zugreifen möchten, Permission Sets zu.

Über 'Users'

Dies ist der empfohlene Weg.

  1. Gehen Sie zu Setup > Users > Users 
  2. Öffnen Sie jeden entsprechenden Benutzer
  3. Klicken Sie auf die Liste Permission Set Assignments
  4. Klicken Sie Edit Assignments
  5. Ziehen Sie die folgenden Rechte von Available Permission Sets nach Enabled Permission Sets:
    • Meisterplan Integration User (für Endbenutzer)
    • Meisterplan Integration Admin (für Administratoren)
    • Meisterplan Integration NamedPrincipal Access (für Endbenutzer und für Administratoren)
  6. Klicken Sie Save

Über 'Permission Sets'

Das ist eine Alternative zum obigen Weg.

  1. Gehen Sie zu Setup > Permission Sets
  2. Öffnen Sie Meisterplan Integration User
  3. Klicken Sie Manage Assignments > Add Assignments
  4. Wählen Sie die entsprechenden Benutzer aus
  5. Klicken Sie Save
  6. Wiederholen Sie diese Schritte für:
    • Meisterplan Integration Admin
    • Meisterplan Integration NamedPrincipal Access

Hinweis: In manchen Organisationen oder Benutzeransichten wird Manage Assignments aufgrund von Filtern oder Einschränkungen der Listenansicht nicht angezeigt. Wenn Sie die Benutzer dort nicht sehen, folgen Sie der Anleitung zu Über 'Users' oben.

Layout der Opportunity-Seite aktualisieren

Im Opportunity Layout konfigurieren Sie die benutzerdefinierten Felder, die für die Verbindung mit Meisterplan erforderlich sind.

  1. Gehen Sie zu Setup > Object Manager > Opportunity > Page Layouts.
  2. Klicken Sie auf den Namen Ihres primären Seitenlayouts.
  3. Ziehen Sie per Drag & Drop einen Abschnitt an das Ende der vorhandenen 'Opportunity Detail'-Abschnitte , um einen neuen Abschnitt mit den folgenden Details zu erstellen:
    SF_Opportunity#1.png
    • Name des Abschnitts: Meisterplan
    • Display Section Header On: Detail Page (angehakt)
    • Layout: 2-Column
    • Tab-key Order: Left-Right
    • Klicken Sie OK.
      SF_Opportunity#2.png
  4. Suchen Sie per ‘Quick Find’ die folgenden Felder und ziehen Sie sie in den Abschnitt ‘Meisterplan’:
    1. Push to Meisterplan (linke Spalte): Ein benutzerdefiniertes, boolesches Feld das steuert, wann eine Opportunity an Meisterplan weitergeleitet wird. Wenn es auf „true“ gesetzt ist, wird ein Ablauf ausgelöst, um die erforderliche Aktion auszuführen.
    2. Meisterplan Project URL (rechte Spalte): Ein benutzerdefiniertes URL-Feld, das den direkten Link zum entsprechenden Projekt in Meisterplan speichert, nachdem die Opportunity erfolgreich übertragen wurde.
      MP_Project-URL.pngHinweis: Weitere benutzerdefinierte Felder, die im Rahmen dieser Integration eingeführt wurden, sind unten aufgeführt. Sie können diese nach Bedarf konfigurieren:
      • Meisterplan Benefit UID: Dieses Textfeld speichert die eindeutige interne ID des Finanzereignisses im entsprechenden Meisterplan-Projekt, die aus dem Betrag der Opportunity abgeleitet wird. Das Feld wird von der Integration verwendet.
      • Push Flag Auto: Dieses boolesche Feld gibt an, ob der Opportunity-Push an Meisterplan manuell oder automatisch ausgelöst wurde. Der Wert wird am Ende jedes Push-Vorgangs zurückgesetzt. Das Feld wird von der Integration verwendet.
      • Was Transferred: Dieses Formelfeld gibt an, ob eine Opportunity an Meisterplan übertragen wurde. Es kann zum schnellen Filtern in Listenansichten verwendet werden.
  5. Suchen Sie im Bereich 'Related Lists' über die Schnellsuche (‘Quick Find’) nach dem Namen der zugehörigen Liste Meisterplan Integration Logs und verschieben Sie diese ganz nach unten – unter alle anderen zugehörigen Listen. 
    MP_Integration-Logs.png
  6. Klicken Sie auf das Zahnradsymbol oberhalb der zugehörigen Liste und nehmen Sie im Dialog Related List Properties folgende Einstellungen vor:
    • Wählen Sie im Abschnitt Available Fields die folgenden Spalten aus und fügen Sie sie dem Abschnitt Selected Fields hinzu:
      • Created Date
      • Status
      • Message
    • Wählen Sie im Abschnitt Selected Fields die Spalte Meisterplan Integration Log Name aus und entfernen Sie sie, sodass sie in den Abschnitt Available Fields verschoben wird.
      MP_Integration-Logs#2.png
  7. Bestätigen Sie die Änderungen und speichern Sie das Layout.
    Hinweis: Meisterplan Integration Logs ist ein benutzerdefiniertes Objekt, das Statusmeldungen und Fehlerdetails für jede zugehörige Opportunity speichert. Das benutzerdefinierte Objekt umfasst die folgenden benutzerdefinierten Felder:
    • Opportunity: Ein Lookup-Feld (Opportunity), das den Log-Eintrag mit einer bestimmten Opportunity verknüpft.
    • Status: Ein Picklistenfeld, das angibt, ob ein Integrationsvorgang erfolgreich war oder fehlgeschlagen ist.
    • Message: Ein Langtextfeld, das Integrationsstatusmeldungen und Fehlermeldungen speichert.

Anzeige der zugehörigen Liste Meisterplan Integration Logs innerhalb eines Opportunity‑Layouts:
MP_Integration-Logs#3.png

Die konsolidierten Meisterplan‑Integrationsprotokolle können außerdem über den App Launcher > Meisterplan > Meisterplan Integration Logs angezeigt werden: 
MP_Integration-Logs#4.png

'Integration Settings' des Meisterplan-Konnektors für Salesforce konfigurieren

'Integration Settings' öffnen

  1. Gehen Sie zu App Launcher > Meisterplan:
    App-Launcher#1.png
  2. Klicken Sie auf den Tab Integration Settings und stellen Sie sicher, dass die folgenden Abschnitte verfügbar sind:
    • Connection
    • Field Mappings
    • Sync Rules
      App-Launcher_Sync-Rules.png

Verbindung testen (Test Connection)

  1. Klicken Sie im Abschnitt Connection auf Test Connection, um die Verbindung zu Meisterplan zu prüfen:
    App-Launcher_Test-Connection.png
    Hinweis: Wenn der Verbindungstest die Meldung 'Not Connected" zurückgibt, lesen Sie den Abschnitt Troubleshooting weiter unten. 
  2. Klicken Sie auf die Schaltfläche Rotate Token, um schnell zur Liste der Named Credentials zu navigieren und dort das API‑Token von Meisterplan hinzuzufügen oder es zu aktualisieren:
    App-Launcher_Rotate-Button.png

Felder zuordnen (Field Mappings)

Aktivieren Sie im Abschnitt Field Mappings die Zuordnung Stage → Order Status, sofern das Feld in Ihrem Meisterplan‑System existiert und für Ihre Organisation relevant ist:
Field-Mappings.png

Synchronisierungsregeln (Sync Rules)

  1. Geben Sie im Abschnitt Sync Rules > Initial den Probability Threshold (%) ein und wählen Sie bei Bedarf die Qualified Stages per Mehrfachauswahl aus. Eine Opportunity wird mit Meisterplan synchronisiert, sobald entweder die definierte Wahrscheinlichkeitsschwelle (Probability Threshold (%)) erreicht wird oder die Stage einem in der Pickliste Qualified Stages festgelegten Status entspricht:
    Sync-Rules#1.png
  2. Aktivieren Sie im Abschnitt Sync Rules > Update die für Ihre Organisation relevanten Felder. Nachdem das Projekt in Meisterplan erstellt wurde, werden Aktualisierungen übertragen, sobald sich die ausgewählten Felder ändern. Wenn keine Felder ausgewählt sind, erfolgt lediglich ein einmaliger Initialimport ohne weitere Aktualisierungen.
    Sync-Rules#2.png
  3. Aktivieren Sie im Abschnitt Sync Rules > Migration die Option Migrate existing Opportunities, wenn Sie bestehende Opportunities nachträglich in Meisterplan übernehmen möchten, und legen Sie den Stichtag für das Abschlussdatum (Close‑Date Cut‑off) entsprechend den Anforderungen Ihrer Organisation fest. Datensätze, die die Initial-Regel erfüllen und deren Abschlussdatum am oder nach dem festgelegten Stichtag liegt, werden in Meisterplan erstellt oder aktualisiert, sobald Sie auf die Schaltfläche Migrate Now klicken:
    Sync-Rules#3.png

Flows verifizieren (Verify Flows)

Diese Integrationslösung führt die folgenden Flows ein, um die Erstellung und Aktualisierung von Opportunities in Meisterplan zu ermöglichen.

Flow-Label Beschreibung
MP PushFlag Initial Template Dieser Flow setzt automatisch das Flag Push to Meisterplan, sobald die initialen Auslösebedingungen erfüllt sind (z. B. wenn die Opportunity‑Wahrscheinlichkeit den definierten Schwellenwert erreicht oder überschreitet).
Er stellt sicher, dass Opportunities, die den konfigurierten Aufnahmekriterien entsprechen, ohne manuelles Eingreifen für die Übertragung nach Meisterplan markiert werden.
MP PushFlag Update Template
Dieser Flow aktualisiert das Flag Push to Meisterplan, wenn sich bestimmte überwachte Felder der Opportunity ändern (z. B. Wahrscheinlichkeit, Phase, Abschlussdatum oder andere konfigurierte Felder).
Er stellt sicher, dass eine Opportunity, die nach einer Aktualisierung für die Übertragung qualifiziert ist, entsprechend markiert wird.
MP Push OnFlag Template Dieser Flow wird ausgeführt, sobald das Flag Push to Meisterplan auf 'true' gesetzt wird.
Bei Auslösung überträgt er die Opportunity‑Daten an Meisterplan, sodass ein entsprechendes Projekt erstellt oder aktualisiert werden kann.
Dieser Flow fungiert als letzter Schritt im Übertragungsprozess und stellt sicher, dass qualifizierte Opportunities automatisch und ohne Verzögerung an Meisterplan gesendet werden.
  1. Gehen Sie zu Setup > Flows.
  2. Filtern Sie nach Flow Labels, die mit MP anfangen.
  3. Überprüfen Sie, ob alle drei Flows auf Active gesetzt sind.

Troubleshooting

'Test Connection' gibt 'Not Connected' zurück

  • Überprüfen Sie, ob Sie die korrekte URL der REST API konfiguriert haben.
  • Stellen Sie sicher, dass Sie das richtige API‑Token eingegeben haben.
  • Vergewissern Sie sich, dass die External Credential Zugriff auf ein Permission Set hat.
  • Überprüfen Sie, ob das Permission Set dem Benutzer zugewiesen ist, der die Verbindung testet.

Opportunities werden trotz korrekter Trigger nicht an Meisterplan übertragen

In seltenen Fällen werden die Opportunity‑Flows für den Initial‑Push oder Update‑Push beim Erstellen oder Aktualisieren einer Opportunity nicht wie erwartet ausgelöst. Ursache hierfür ist ein bekanntes Problem der Salesforce‑Plattform, das Flows in Managed Packages betrifft (Details siehe: https://salesforce.stackexchange.com/questions/425456/managed-package-error-in-field-names-in-decisions-due-to-namespace-prefix).

Da Flows innerhalb von Managed Packages nicht bearbeitet werden können, enthält das Paket editierbare Flow‑Vorlagen.
Wenn Sie feststellen, dass Opportunities nicht an Meisterplan übertragen werden, können Sie die aktiven Flows schnell auf Basis dieser Vorlagen neu erstellen.
  • Flow erstellen und aktivieren: MP PushFlag Initial
    • Gehen Sie zu Setup > Flows.
    • Filtern Sie nach dem Flow‑Label MP PushFlag Initial Template
    • Öffnen Sie den Flow im Flow Builder
    • Klicken Sie oben rechts auf Save as New Flow.
    • Im Dialog Save as geben Sie Folgendes ein:
      • Flow‑Label: MP PushFlag Initial
      • Flow‑API‑Name: MP_PushFlag_Initial
    • Klicken Sie Save
    • Klicken Sie anschließend oben rechts im Flow Builder auf Activate.
    • Gehen Sie zurück zur Flow‑Liste, wählen Sie MP PushFlag Initial Template > Actions > View Details and Versions und klicken Sie auf Deactivate Action
  • Flow erstellen und aktivieren: MP PushFlag Update
    • Gehen Sie zu Setup > Flows
    • Filtern Sie nach dem Flow‑Label MP PushFlag Update Template
    • Öffnen Sie den Flow im Flow Builder
    • Klicken Sie oben rechts auf Save as New Flow.
    • Im Dialog Save as geben Sie Folgendes ein:
      • Flow Label: MP PushFlag Update
      • Flow API Name: MP_PushFlag_Update
      • Klicken Sie Save
    • Klicken Sie anschließend oben rechts im Flow Builder auf Activate.
    • Gehen Sie zurück zur Flow‑Liste, wählen Sie MP PushFlag Update Template > Actions > View Details and Versions und klicken Sie auf Deactivate Action

Artikel teilen:

War dieser Beitrag hilfreich?
0 von 0 fanden dies hilfreich
Sie brauchen mehr Hilfe? Kontaktieren Sie unseren Support.
Zurück an den Anfang