Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Upgrade von Amazon S3 auf API-based Integration
Anmerkung
Bei den Themen in diesem Abschnitt wird davon ausgegangen, dass Sie die Voraussetzungen für eine AWS Partner Central-Integration, eine AWS Marketplace-Integration oder beides erfüllt haben. Weitere Informationen finden Sie in Voraussetzungen für die Integration und weiter Erste Schritte oben in diesem Handbuch.
Empfehlung: Führen Sie diese Aktivitäten zuerst in einer Sandbox-Umgebung durch, testen Sie sie gründlich und stellen Sie sie dann in der Produktionsumgebung bereit.
In diesem Abschnitt erfahren Sie, wie Sie Ihren AWS Partner CRM Connector von Amazon S3-based auf API-based Integration aktualisieren. Die API-based Integration ersetzt das alte Amazon S3-Bucket-Modell durch eine bidirektionale Echtzeitsynchronisierung über IAM-Rollen und APIs.
Eine vollständig interaktive Komplettlösung mit Screenshots finden Sie im Upgrade-Workshop für den AWS Partner CRM Connector
Das Upgrade umfasst die folgenden Schritte:
Voraussetzungen
Reihenfolge der Vorgänge bei der Migration
Partner fragen häufig, ob sie in der AWS Konsole auf das neue Partner Central-Erlebnis migrieren oder zuerst ein Upgrade von Amazon S3 auf API durchführen sollen. Hier ist der empfohlene Ansatz:
| Szenario | Empfehlung |
|---|---|
| Derzeit auf Amazon S3, noch nicht in der neuen Version von Partner Central | Migrieren Sie zuerst zur API und dann parallel oder später zur neuen Partner Central-Umgebung |
| Derzeit auf Amazon S3, bereits mit neuer Partner Central-Erfahrung | Fahren Sie direkt mit der API-Migration fort |
| Sie nutzen bereits die API, haben aber noch keine neue Erfahrung mit Partner Central | Migrieren Sie nach Belieben zu einem neuen Partner Central-Erlebnis |
Die Kontoverknüpfung ist die einzige schwierige Voraussetzung
Die Kontoverknüpfung ist die einzige schwierige Voraussetzung für die S3-to-API Amazon-Migration. Eine Migration auf das neue Partner Central-Erlebnis ist NICHT erforderlich, um das API-Upgrade zu starten.
Wichtige Informationen:
S3-based Amazon-Integrationen sind veraltet und stehen neuen Benutzern nicht mehr zur Verfügung.
Amazon S3-Partner sollten planen, die Migration zur API so schnell wie möglich abzuschließen, um eine Beeinträchtigung des Service zu vermeiden.
In der Dokumentation zur AWS Partner-CRM-Integration finden Sie den aktuellen Zeitplan zum Ende der Nutzungsdauer des Amazon S3-Backends.
Stellen Sie sicher, dass Partner Central mit einem verknüpft ist AWS Konto
Der S3-based Amazon-Connector authentifizierte sich mithilfe von Berechtigungen für einen verwalteten Amazon S3-Bucket im AWS Verwaltungskonto. Der API-based Connector authentifiziert sich stattdessen über IAM-Rollen auf dem eigenen verknüpften AWS Konto des Partners, um die Partner Central-APIs direkt aufzurufen. Aus diesem Grund ist die Kontoverknüpfung die schwierige technische Voraussetzung: Ohne sie hat der Connector keine Möglichkeit, die Partner Central-APIs mit den erforderlichen Berechtigungen zu erreichen.
Warum könnte das fehlen
Bei der AWS Veröffentlichung der Partner Central-API für den Verkauf im November 2024 wurde die Kontoverknüpfung eingeführt, damit Partner programmgesteuert auf diese APIs zugreifen können. Ab Connector-Version 3.0 (ebenfalls November 2024) wurde die Kontoverknüpfung zu einer Voraussetzung für die API-based Synchronisierung. Partner, die ihren S3-based Amazon-Connector vor diesem Datum eingerichtet haben, hätten die Kontoverknüpfung nicht abgeschlossen.
Verknüpfen Sie Ihr Partner Central-Konto mit Ihrem AWS Hauptkonto. Wählen Sie Ihr Konto von Anfang an sorgfältig aus. Es ist zwar möglich, die Verknüpfung mit einem anderen Konto aufzuheben und erneut zu verknüpfen, dies führt jedoch zu Problemen mit der Datenpersistenz und erfordert manuellen Abgleich.
Regeln für die Kontoauswahl — das AWS Konto muss:
Ein kostenpflichtiges Konto mit gutem Ruf (kein kostenloses Kontingent)
Gehört dem Unternehmen des Partners (kein Konto eines Vertriebshändlers)
Haben Sie eine Rechnungsadresse, die dem primären Geschäftssitz des Partners entspricht
KEINE Sandbox, kein Entwickler, kein Privatkonto oder management/payer kein Konto
Die Kontoverknüpfung ist dauerhaft
Die Kontoverknüpfung ist nach der Migration von Partner Central zur AWS Konsole dauerhaft. Alle APN-Ressourcen (ACE-Möglichkeiten, Verlauf, Einladungen mehrerer Partner) sind dauerhaft mit diesem Konto verknüpft. Wählen Sie sorgfältig aus.
Ressourcen:
Abschnitt „Kontoverknüpfung“ des Upgrade-Workshops
auf der AWS-Workshop-Website Verknüpfung von Konten
auf der Partner Central-Website aufheben
Optional: Migrieren Sie zur neuen Partner Central-Oberfläche unter AWS Konsole
Dieser Schritt ist für das Amazon S3-to-API Connector-Upgrade nicht erforderlich. Die Kontoverknüpfung allein bietet die erforderliche API-based Funktionalität. Durch die Migration auf das neue Partner Central-Erlebnis hat Ihr Team jedoch Zugriff auf zusätzliche Funktionen:
Partner Central-Agenten (Co-Sell Agent, Finanzierungsagent, Autonome Kundenakquise)
Eine zentrale AWS Konsole zur Verwaltung der Partneraktivitäten zusammen mit Ihren Ressourcen AWS
Bessere Sichtbarkeit der Ereignisse im Opportunity-Lebenszyklus direkt in der Konsole
Änderung des Formats der Lösungs-ID
Wenn Sie zur neuen Partner Central-Umgebung migrieren und dann neue Lösungen erstellen, verwenden diese Lösungen das neue soln-* Format. Der CRM Connector unterstützt dieses Format noch nicht; er benötigt das alte S-* Format für das solutionOffered Feld. Ältere Lösungen, die vor der Migration erstellt wurden, behalten das S-* Format bei und funktionieren weiterhin.
Weitere Informationen finden Sie im Partner Central-Migrationsleitfaden.
Pre-migration Datenbereinigung
Bevor Sie mit der Migration beginnen, stellen Sie sicher, dass die S3-based Amazon-Integration sauber ist. Der kritischste Schritt besteht darin, noch ausstehende geplante Jobs zu entfernen, die den API-based Connector und den Backfill-Prozess beeinträchtigen könnten.
Wenn Sie Amazon S3-Zeitpläne über die Connector-Benutzeroberfläche deaktivieren, verbleiben die zugrunde liegenden geplanten Salesforce-Jobs (mit APN-Präfix) im System. Wenn diese immer noch vorhanden sind, wenn Sie das Auffüllen starten oder die API-based Synchronisierung aktivieren, schreiben sowohl der alte Scheduler als auch der neue Connector möglicherweise gleichzeitig in dieselben Datensätze, was zur Erstellung doppelter Opportunities oder zu Datenkonflikten führt.
Eine Deaktivierung in der Benutzeroberfläche reicht nicht aus
Das Deaktivieren von Zeitplänen in der Connector-Benutzeroberfläche reicht nicht aus. Sie müssen auch die zugrunde liegenden Einträge für geplante Jobs im Salesforce-Setup löschen. Die Überprüfen und deaktivieren Sie Zeitpläne für Amazon S3 vollständige schrittweise Anleitung finden Sie unter.
Einrichten AWS Infrastruktur
In dieser Phase muss ein Salesforce-Administrator mit einem IT-Cloud-Administrator zwei neue Komponenten einrichten: eine externe Salesforce-Client-Anwendung und AWS Infrastrukturkomponenten (EventBridge Regeln und IAM-Rollen).
Richten Sie die externe Salesforce-Kundenanwendung ein
Bei der Amazon S3-Version durchliefen beide Synchronisierungsrichtungen einen gemeinsamen Amazon S3-Bucket pro Partner. Die API-Version dreht dies für eingehende Updates um — Partner Central überträgt Ereignisse jetzt in Echtzeit direkt an Ihre Organisation über. EventBridge Die externe Client-App ermöglicht den Fluss von OAuth 2.0-Client-Anmeldeinformationen, sodass Benachrichtigungen sofort zugestellt EventBridge werden können.
Der Salesforce-Administrator sollte die Anweisungen im Abschnitt „Externe Client-Anwendung in Salesforce
Einrichten AWS components
Die AWS Infrastruktur für die API-Version umfasst:
EventBridgefür die Verarbeitung von Ereignissen in Echtzeit
IAM-Rollen für sichere Authentifizierung
Diese Komponenten ersetzen das Amazon S3-Bucket-Zugriffsmodell, das in der vorherigen Version verwendet wurde.
Der IT-Cloud-Administrator sollte die CloudFormation Vorlage bereitstellen, indem er den Anweisungen im Abschnitt „ AWS Komponenten
Schließen Sie die Einrichtung und Konfiguration in Salesforce ab
Die restliche Konfiguration wird von einem Salesforce-Administrator durchgeführt. Schließen Sie zuerst Aktivitäten in Sandbox ab, testen Sie und wechseln Sie dann zur Produktion.
Installieren Sie die neueste Version des AWS Partner CRM Connectors von Salesforce aus und folgen Sie dann den Anleitungen zur Einrichtung AppExchange
Überprüfen und passen Sie Ihre Zuordnungen an
Bei der Amazon S3-Version stützte sich die ausgehende Synchronisierung auf Sync with AWS und -Felder. Has Updates for AWS Diese werden in der API-based Integration nicht mehr verwendet.
Bei der API-Version wird die ausgehende Synchronisierung über die Einstellung „Teilen mit AWS Integration aktivieren“ in den benutzerdefinierten Einstellungen des AWS
Partner CRM Connectors gesteuert (Companion_App_Settings__c). Wenn diese Option aktiviert ist, werden ACE Opportunities automatisch mit anderen geteilt AWS , sobald ein qualifizierendes Update erfolgt.
Die wichtigsten Punkte:
Das ACE Opportunity-Objekt wird als Landefläche empfohlen — es entspricht den AWS Opportunity-Datenpunkten in Partner Central und ermöglicht eine automatische Zuordnung.
Wenn Sie die ACE Opportunity bereits für Ihr Integrations-Mapping verwendet haben, ändert sich die zugrunde liegende Konfiguration nicht. Das aktualisierte Paket führt jedoch neue Felder ein, die in früheren Versionen nicht vorhanden waren.
Überprüfen Sie alle Automatisierungen, die auf die alten S3-era Amazon-Felder (
Sync_with_AWS__c,Has_Updates_for_AWS__c) verweisen, um die neuen Entsprechungen zu verwenden.
Das ACE Opportunity-Datenmodell ist auf der Website verfügbar. GitHub
Die neueste Connector-Version enthält eine Flow-Vorlage, mit der Sie Ihre Standard-Opportunity der ACE-Opportunity zuordnen können. Weitere Informationen finden Sie unter Flow-Vorlagen.
Überprüfen Sie die erforderlichen Felder und Schaltflächen und fügen Sie sie hinzu
Der Connector hat seit Version 3.0+ neue Felder und Schaltflächen eingeführt. Sie müssen das Seitenlayout Ihres Lightning-Datensatzes manuell aktualisieren.
Fügen Sie der ACE Opportunity Lightning-Datensatzseite die folgenden Schaltflächen hinzu:
| Button | Zweck |
|---|---|
| Teilen mit AWS | Leitet die Gelegenheit manuell per API an Partner Central weiter. |
| Aktualisieren von AWS | Ruft die neuesten Daten von Partner Central in diesen ACE Opportunity-Datensatz ab. |
| Accept/Reject | Akzeptieren oder lehnen Sie angebotene AWS Opportunities ab. |
| Associate/Disassociate | Für AWS-genehmigte Partnerlösungen, Produkte und Marketplace-Angebote eine Verknüpfung herstellen oder die Verknüpfung aufheben. |
| Assign | Weisen Sie eine Opportunity einem anderen Benutzer in Ihrem Partner Central-Konto zu. |
Entfernen Sie die folgenden veralteten Schaltflächen von der ACE Opportunity Lightning-Datensatzseite:
| Button | Grund |
|---|---|
| Senden an AWS | Ersetzt durch Teilen mit AWS. |
| Privates Angebot verknüpfen | Ersetzt durch Associate/Disassociate. |
Fügen Sie der Registerkarte „ACE Opportunity“ die folgenden Schaltflächen für die Listenansicht hinzu:
Chancen annehmen — Chancen, die Bulk-accept mehrfach AWS empfohlen wurden.
Chancen zuweisen — Bulk-reassign mehrere Gelegenheiten.
Überprüfen Sie für neue Felder alle Felder, die nach Connector Version 3.0 hinzugefügt wurden
Überprüfen und deaktivieren Sie Zeitpläne für Amazon S3
Mit API-based diesem Ansatz sind keine geplanten Jobs mehr erforderlich — die Integration läuft in Echtzeit.
Um geplante Jobs zu deaktivieren
Navigieren Sie in der AWS Partner CRM Connector-App zur Registerkarte Zeitpläne.
Wählen Sie „Alle Jobs deaktivieren“ und wählen Sie dann erneut „Deaktivieren“.
Löschen Sie auch die geplanten Datensätze. So entfernen Sie die verbleibenden geplanten APN-Jobs aus dem Setup:
So entfernen Sie geplante APN-Aufträge aus dem Setup
Navigieren Sie zu Setup. Suchen Sie nach „Geplant“ und wählen Sie Geplante Jobs aus.
Überprüfen Sie die Liste auf alle APN-related Jobs. Wählen Sie Löschen, um sie zu löschen.
CustomLogInteractionBatch Lauf weiter
Lassen Sie den CustomLogInteractionBatch Job laufen (AppExchange App Analytics).
Löschen Sie geplante Jobs, deaktivieren Sie sie nicht einfach
Lassen Sie Jobs nicht im Status „deaktiviert, aber nicht gelöscht“ stehen. Verbleibende Jobs haben in Kombination mit der API-based Echtzeitsynchronisierung zur Erstellung doppelter Opportunities geführt.
Bereinigen
Deaktivieren Sie ältere Validierungsregeln
Einige ältere Validierungsregeln müssen deaktiviert werden und andere müssen aktiv bleiben. In diesem Abschnitt des Workshops finden Sie die
Stellen Sie außerdem sicher, dass die folgenden Legacy-Flows deaktiviert wurden:
Synchronisieren Sie ACE Opportunity mit der Partner Central-API
Suche nach einem privaten Angebot
Benachrichtigung über einen Fehler bei der APN-Synchronisierung
Das Feld „Privates Angebot“ wird auf ACE Opportunity aktualisiert
Das Feld „Ace Opportunity“ im Datensatz „Synchronisierungsprotokolldetails“ wird
Einheitlicher Standard-ACE Opportunity-Synchronisierungsablauf (Vorlage)
Testen Sie Ihren Prozess, bevor Sie zur Produktion übergehen. Sehen Sie sich das Testen anhand der Einstellungen
Vollständige Auffüllung der Möglichkeiten von AWS zu Salesforce
Führen Sie ein Backfill durch, um sicherzustellen, dass die Daten zwischen den Umgebungen übereinstimmen. Das awsapn__Last_Modified_Date__c Feld in der ACE-Opportunity muss mit dem Datum der letzten Änderung in Partner Central übereinstimmen, damit zukünftige Aktualisierungen synchronisiert werden können. Die Amazon S3-Integration hat dieses Feld nicht aufgefüllt, daher ist es bei Opportunities, die von Amazon S3 migrieren, leer — die Auffüllung füllt es aus.
Das Backfill bietet drei Modi:
| Mode | Was macht es | Wann sollte dies verwendet werden? |
|---|---|---|
| Nur Angebote aktualisieren, bei denen das Datum der letzten Änderung fehlt | Aktualisiert nur Datensätze, die awsapn__Last_Modified_Date__c leer sind | Für die S3-to-API Amazon-Migration empfohlen |
| Aktualisieren Sie nur AWS Möglichkeiten, die bereits in Salesforce vorhanden sind | Aktualisiert alle Datensätze, die bereits eine APN-CRM-ID haben | Sichere Alternative für die Migration |
| Aktualisieren Sie alle AWS Möglichkeiten | Überträgt die gesamte Partner Central-Pipeline in Salesforce | Nur bei Neuinstallationen verwenden |
Bevor Sie das Backfill ausführen:
Vergewissern Sie sich, dass alle geplanten APN-Jobs gelöscht (nicht nur deaktiviert) wurden.
Deaktivieren Sie den Flow „ACE Opportunity to Partner Central API synchronisieren“, falls er aktiv ist.
Deaktivieren Sie in den benutzerdefinierten Einstellungen die Option „Teilen mit AWS Integration aktivieren“ (
Companion_App_Settings__c).Schließen Sie die unter beschriebene Datenbereinigung vor der Migration ab. Pre-migration Datenbereinigung
Nach Abschluss des Backfills:
Re-enable Aktivieren Sie „Mit AWS Integration teilen“ — dadurch wird die fortlaufende Synchronisierung unterstützt.
Der Ablauf „ACE Opportunity mit der Partner Central-API synchronisieren“ muss NICHT erneut aktiviert werden.
Stellen Sie sicher, dass eine Stichprobe von Datensätzen ausgefüllt
awsapn__Last_Modified_Date__cist.
Weitere Informationen finden Sie im Abschnitt „
Post-migration: Ereignisse überwachen EventBridge
Nach der Migration erhält Ihre Salesforce-Organisation Echtzeit-Updates von Partner Central über EventBridge. So überprüfen Sie, ob die Ereignisse ablaufen:
CloudWatch Metriken: Navigieren Sie zu CloudWatch > Metriken > EventBridge. Wählen Sie „Aufrufe“ und „Ihr FailedInvocations API-Ziel“ aus.
Salesforce-Synchronisierungsprotokolle: Suchen Sie bei jeder ACE-Opportunity in der Themenliste „Synchronisierungsprotokoll“ nach den neuesten eingehenden Einträgen.
EventBridge Regelüberwachung: Überprüfen Sie die von der CloudFormation Vorlage erstellte Regel auf aktuelle übereinstimmende Ereignisse.
| Symptom | Wahrscheinliche Ursache | Auflösung |
|---|---|---|
| Keine eingehenden Updates in Salesforce | Das Token für externe Client-Anwendungen ist abgelaufen | Re-authenticate die verbundene App; überprüfen Sie die OAuth-Anmeldeinformationen im API-Ziel EventBridge |
| Die Ereignisse hören nach der Arbeit auf | Timeout der Salesforce-Sitzung | Überprüfen Sie den Zustand des API-Ziels EventBridge; stellen Sie die Verbindung erneut her |
| Teilweise Aktualisierungen (einige Felder fehlen) | Die Feldzuordnung stimmt nicht überein | Auf die neueste Connector-Version aktualisieren; Feldzuordnungen überprüfen |
Behebung häufiger Migrationsprobleme
| Fehler/Symptom | Ursache | Auflösung |
|---|---|---|
FIELD_CUSTOM_VALIDATION_EXCEPTIONwenn Sie auf „Aktualisieren von AWS“ klicken | Ältere Validierungsregeln wurden nicht deaktiviert | Deaktiviere ACEOppNew_PreventUpdatesWhenPOSubmitted und ACEOpp_PreventUpdatesWhenPOSubmitted |
| Doppelte Opportunities | Verbleibende geplante Jobs oder mehrere Integrationsbenutzer | Löschen Sie ALLE geplanten APN-Jobs. Vergewissern Sie sich, dass nur ein Benutzer berechtigt ist. APN Business Admin |
| Synchronisieren Sie Protokolleinträge, die schnell wachsen | Datensätze, die die Validierung nicht bestanden haben, versuchen es in jedem Zyklus erneut | Identifizieren Sie fehlerhafte Datensätze mithilfe von Synchronisierungsprotokollen. Korrigieren Sie fehlende Pflichtfelder. |
| Das Auffüllen überschreitet die Speichergrenzen | Zu viele Datensätze gleichzeitig | In kleineren Chargen ausführen. Überwachen Sie den Speicher. |
| „Aktualisieren von AWS“ zeigt veraltete Daten an | awsapn__Last_Modified_Date__cNichtübereinstimmung | Re-run gezieltes Auffüllen mit der Option „Nur Aktualisierungsmöglichkeiten, bei denen das Datum der letzten Änderung fehlt“ |
| Opportunities aus Partner Central werden nicht angezeigt | EventBridge Verbindungsproblem oder automatisches Teilen deaktiviert | Überprüfen Sie den Zustand des EventBridge API-Ziels. Vergewissern Sie sich, dass „Mit AWS Integration teilen aktivieren“ aktiviert ist. |
Hilfe erhalten
Wenn Sie auf Probleme stoßen, die mit den vorangegangenen Schritten nicht gelöst werden können:
Öffnen Sie eine Support-Anfrage: Partner Central → Support → Neuen Fall öffnen
→ CRM-Integration Unterstützung bei der Migration: Bei komplexen Migrationen (über 500 Möglichkeiten, benutzerdefinierte Integrationen oder frühere Produktionsvorfälle) können Sie über Ihren Alliance Lead Support anfordern.
