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. # Verwenden eines früheren CRM mit Amazon S3 S3-Integration **Wichtig** AWS Partner Central hat 2024 die Annahme neuer Anfragen für diese Art von Integration eingestellt. Dieser Abschnitt gilt nur für Partner, die Amazon S3 verwenden. Informationen zu den ersten Schritten mit einer neuen benutzerdefinierten CRM-Integration finden Sie in der [API-Referenz zu AWS Partner Central](https://docs.aws.amazon.com/partner-central/latest/APIReference/aws-partner-central-api-reference-guide.html). **Topics** + [Upgrade von einem CRM mit Amazon S3 S3-Integration auf die Partner Central API](upgrade-crm-api.md) + [Konfiguration des Connectors für ein CRM mit Amazon S3 S3-Integration](s3-config.md) + [Ressourcen zur Integration](resources.md) + [Teilen von Leads](custom-lead-sharing.md) + [Teilen von Chancen](custom-opportunity-sharing.md) + [Feldkartierung](custom-field-mapping.md) + [Synchronisationszeitpläne erstellen](crm-connector-scheduling.md) + [Best Practices](best-practices.md) + [Kontingente](quotas.md) + [Versionshistorie](version-history.md) + [FAQs](faqs.md) # Upgrade von einem CRM mit Amazon S3 S3-Integration auf die Partner Central API **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 unter [Voraussetzungen für die Integration](crm-integration-setting-up.md) und weiter [Erste Schritte](crm-integration-getting-started.md) oben in diesem Handbuch. In den folgenden Abschnitten wird erklärt, wie Sie ein Upgrade von einem früheren CRM mit Amazon S3 S3-Integration auf die AWS Partner Central API durchführen. Durch das Upgrade entfallen mehrere ACE-Anforderungen, wie z. B. die Notwendigkeit eines Integrationsbenutzers und die Einrichtung von Synchronisierungsplänen. **Topics** + [Funktionen aktualisieren](api-upgrade-features.md) + [Richten Sie benannte Anmeldeinformationen ein](set-up-api-credentials.md) + [Fügen Sie die Schaltfläche „Genehmigungsstatus“ zur Seite „Opportunity Lightning Record“ hinzu](add-approval-status-button.md) + [Fügen Sie die verbleibenden Schaltflächen hinzu](add-remaining-buttons.md) + [Aktualisieren Sie die Registerkarte „Lösungsangebote“](refresh-the-solutions-from-the-solution-offerings-tab.md) # Funktionen aktualisieren Das Upgrade bietet die folgenden Funktionen: + Sie benötigen in Salesforce keinen Benutzerberechtigungssatz für die ACE-Integration mehr. + Sie müssen keinen Zeitplan mehr für ACE-Opportunities in Salesforce erstellen. + Die Partner Central-API bietet auch eine Reihe von Schaltflächen, die die folgenden Aktionen auf Ihrer **Opportunity Lightning Record-Seite** ermöglichen: + **Genehmigungsstatus** — Empfangene Opportunities AWS annehmen oder ablehnen. **Anmerkung** Diese Schaltfläche ersetzt die Liste mit dem **Status der Partnerakzeptanz**. Sie müssen die Schaltfläche verwenden, um Opportunities anzunehmen, die von AWS Ihnen initiiert wurden. + **Teilen mit AWS** — Opportunities erstellen und aktualisieren. + **Zuordnung oder Trennung — Ordnen Sie** eine Opportunity während des gesamten Opportunity-Lebenszyklus den Lösungen, AWS Produkten und AWS Marketplace Angeboten von Partnern zu oder trennen Sie die Zuordnung. + **Zuweisen — Weisen** Sie eine Opportunity einem anderen Benutzer in Ihrem Partner Central-Konto neu zu. Sie fügen die Schaltflächen hinzu, nachdem Sie benannte Anmeldeinformationen eingerichtet haben. In den folgenden Themen wird erklärt, wie Sie diese Aufgaben ausführen. # Richten Sie benannte Anmeldeinformationen ein Um ein Upgrade auf die Partner Central-API durchzuführen, richten Sie zunächst benannte Anmeldeinformationen ein. Der CRM-Connector verwendet Ihre Salesforce-Organisationsanmeldedaten, um sich bei Partner Central zu authentifizieren. **Um Anmeldeinformationen einzurichten** 1. Melden Sie sich als Systemadministrator bei Salesforce an. 1. Wählen Sie unter **Benannte Anmeldeinformationen** die Option **Neu früher** aus. 1. Geben Sie im Formular **Neue benannte Anmeldeinformationen** die Werte aus der folgenden Tabelle ein. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/partner-central/latest/crm/set-up-api-credentials.html) 1. Wählen Sie **Speichern**. 1. Kehren Sie zur **AWS Guided-Setup-Seite** zurück. Wählen Sie im Abschnitt **Authentifizierungsdetails** die Option **Überprüfen** und bestätigen Sie die Anmeldeinformationen. # Fügen Sie die Schaltfläche „Genehmigungsstatus“ zur Seite „Opportunity Lightning Record“ hinzu In den folgenden Schritten wird erklärt, wie Sie die Schaltfläche „**Genehmigungsstatus**“ zu Ihrer Opportuntiy Lightning Record-Seite hinzufügen. Mit der Schaltfläche können Sie den Status Ihrer Opportunities während des Genehmigungsprozesses einsehen. **Um die Schaltfläche hinzuzufügen** 1. Melden Sie sich als Systemadministrator bei Ihrer Salesforce-Organisation an. 1. Navigieren Sie zur **Opportunity Lightning Record-Seite**.  1. Wählen Sie den hervorgehobenen Bereich, um den Eigenschaftenbereich zu öffnen. 1. Wählen Sie **Jetzt aktualisieren** aus. 1. Wählen Sie **Bestehende Aktionen migrieren** aus und wählen Sie dann das Seitenlayout aus, von dem aus Sie die Aktionen aktualisieren möchten. -ODER- Fangen Sie bei Null an und fügen Sie die Aktionen manuell hinzu. 1. Wählen Sie in der Liste **Aktionen** die Option **Genehmigungsstatus** aus. 1. Wählen Sie **Speichern**. **Anmerkung** Sie müssen die Schritte 4 und 5 nur einmal ausführen. Die Schaltfläche „**Genehmigungsstatus**“ wird nur auf der Seite „**Opportunity Lightning Record**“ für Opportunities angezeigt, auf die AWS verwiesen wurde. # Fügen Sie die verbleibenden Schaltflächen hinzu Sie können einige oder alle der in den folgenden Schritten aufgeführten Schaltflächen hinzufügen. **Um die Schaltflächen hinzuzufügen** 1. Melden Sie sich als Systemadministrator bei Ihrer Salesforce-Organisation an. 1. Navigieren Sie zur **Opportunity Lightning Record-Seite**. 1. Wählen Sie den hervorgehobenen Bereich, um den Eigenschaftenbereich zu öffnen. 1. Wählen Sie **unter Aktionen die Option „Zuweisen**“ und wählen Sie dann einige oder alle der folgenden Elemente aus: + **Teilen mit AWS** + **Assoziieren oder trennen** + **Zuweisen** Weitere Informationen zu den Funktionen der einzelnen Tasten finden Sie weiter [Funktionen aktualisieren](api-upgrade-features.md) oben in diesem Handbuch. 1. Wählen Sie **Speichern**. # Aktualisieren Sie die Registerkarte „Lösungsangebote“ In den folgenden Schritten wird erklärt, wie Sie die Daten auf der Registerkarte **Lösungsangebote** aktualisieren. 1. Melden Sie sich als Systemadministrator bei Ihrer Salesforce-Organisation an. 1. Navigieren Sie zur Registerkarte **Lösungsangebote**. 1. Wählen Sie **Lösungen aktualisieren** aus. # Konfiguration des Connectors für ein CRM mit Amazon S3 S3-Integration **Wichtig** Ab 2024 machte AWS Partner Central diesen Integrationstyp für neue Benutzer nicht verfügbar. **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 unter [Voraussetzungen für die Integration](crm-integration-setting-up.md) und weiter [Erste Schritte](crm-integration-getting-started.md) oben in diesem Handbuch. Das veraltete CRM mit Amazon S3-Integration verwendet einen Amazon S3-Bucket, um Leads und Opportunities zu übertragen. Wir empfehlen, die Partner Central-API-Integration wie im vorherigen Abschnitt beschrieben zu verwenden, um Opportunities zu erstellen und zu verwalten. Sie können diese Konfiguration jedoch verwenden, wenn Sie den Connector zur Verwaltung von Leads in Salesforce verwenden möchten. **Topics** + [Details zur Verbindungsauthentifizierung eingeben](#apn-s3-authentication-details) + [Geben Sie die Systemkonfigurationseinstellungen ein](#apn-s3-config-settings) + [Testen der -Verbindung](#apn-s3-testing) + [Senden und Empfangen von Opportunities und Leads](#sending-receiving-opportunities-leads) + [Produktionscheckliste](ace-production-checklist.md) + [Aktualisierung des AWS Partner CRM-Connectors auf das neue Datenmodell](connector-upgrade-plan.md) + [Sandbox-Tests mit der benutzerdefinierten ACE-Opportunity und den ACE-Lead-Objekten](custom-ace-opportunity.md) + [AWS Marketplace Private Angebote mit ACE-Opportunities verknüpfen](#linking-private-offers-to-ace) ## Details zur Verbindungsauthentifizierung eingeben Partner starten den Integrationsprozess, indem sie die Details eingeben, die für die Verbindung zu ihrem Amazon S3 S3-Endpunkt erforderlich sind. Folgen Sie den einzelnen Schritten in der angegebenen Reihenfolge und schließen Sie jeden Satz ab, bevor Sie mit dem nächsten Schritt fortfahren. Die folgenden Aufgaben werden auf der Registerkarte „**AWS Geführte Einrichtung**“ ausgeführt. Informationen zur Verwendung der Registerkarte finden Sie weiter [Verwenden Sie die geführte Einrichtung](use-guided-setup.md) oben in diesem Handbuch. **Um die Authentifizierungsdetails einzugeben** 1. Öffnen Sie in Salesforce die Registerkarte „**AWS Geführte Einrichtung**“. Informationen zum Öffnen dieser Registerkarte finden Sie weiter [Verwenden Sie die geführte Einrichtung](use-guided-setup.md) oben in diesem Handbuch. 1. Erweitern Sie **Schritt 1: AWS Verbindungsauthentifizierungsdetails** und wählen Sie **Start.** 1. Wählen Sie auf der Seite **Benannte Anmeldeinformationen** **zuvor die Option Neu** aus. 1. Geben Sie im Formular **Neue benannte Anmeldeinformationen** die Werte aus der folgenden Tabelle ein. | **Feld** | **Wert** | | --- | --- | | Label (Bezeichnung) | APN-API-Verbindung | | URL | [https://s3.us-west-2.amazonaws.com](https://s3.us-west-2.amazonaws.com) | | Identitätstyp | Benannter Schulleiter | | Authentifizierungsprotokoll | AWS Signatur Version 4 | | AWS Zugriffsschlüssel-ID | Cloud-Ops stellt die ID während der erforderlichen Schritte bereit | | AWS Geheimer Zugriffsschlüssel | Cloud-Ops stellt den Zugriffsschlüssel während der erforderlichen Schritte bereit | | AWS Region | us-west-2 | | AWS Service nicht zulässig | S3 | | Autorisierungsheader generieren | checked | | Erlaube das Zusammenführen von Feldern im HTTP-Header | ungeprüft | | Erlaube das Zusammenführen von Feldern im HTTP-Hauptteil | ungeprüft | 1. Wählen Sie **Speichern**. 1. Kehren Sie zur **AWS Guided-Setup-Seite** zurück. Wählen Sie im Abschnitt **Authentifizierungsdetails** die Option **Überprüfen** und bestätigen Sie die Anmeldeinformationen. 1. Lassen Sie die Seite **„AWS Guided Setup**“ geöffnet und fahren Sie mit den nächsten Schritten fort. ## Geben Sie die Systemkonfigurationseinstellungen ein In den folgenden Schritten wird erklärt, wie Sie die richtigen Systemkonfigurationseinstellungen für die Integration eingeben. 1. Erweitern Sie **Schritt 2: Systemkonfigurationseinstellungen** und wählen Sie **Start.** 1. Suchen Sie die **AWS Partner CRM Connector-Einstellungen** und wählen Sie **Verwalten** aus. 1. Wählen Sie **Neu** und geben Sie dann die erforderlichen Werte aus der folgenden Tabelle ein. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/partner-central/latest/crm/s3-config.html) 1. Wählen Sie **Speichern**. 1. Kehren Sie zur Seite mit **AWS Anleitung zur Einrichtung** zurück. Wählen Sie im Abschnitt **Authentifizierungsdetails** die Option **Überprüfen** und bestätigen Sie die Anmeldeinformationen. ## Testen der -Verbindung Bevor Sie die Verbindung testen, stellen Sie sicher, dass Sie die Schritte in den vorherigen Abschnitten ausgeführt haben. **Testen der Verbindung** 1. Erweitern Sie **Schritt 3: Testkonfiguration für die APN-API**. 1. Wählen Sie **Test** aus. Wenn die Verbindung erfolgreich hergestellt werden kann, erhalten Sie eine Bestätigungsnachricht. ## Senden und Empfangen von Opportunities und Leads Sie senden und empfangen Opportunities und Leads, indem Sie sie mit Partner Central synchronisieren. Um eine Opportunity oder einen Lead zu synchronisieren, müssen Sie das Feld **Mit Partner Central synchronisieren** auf **True** setzen. Zu den weiteren wichtigen Feldern für die Integration gehören das **Datum der letzten APN-Synchronisierung** und die Felder „Für **die Synchronisierung mit APN berechtigt**“. Diese Felder sind für Standard-Opportunities und Leads enthalten. Sie müssen sie jedoch für alle benutzerdefinierten Quellobjekte erstellen und zuordnen. + **Synchronisieren mit Partner Central** — In der App für Standard-Opportunities und Leads enthalten. Wenn a AWS Partner sich für die Zuordnung zu benutzerdefinierten Objekten entscheidet, muss ein benutzerdefiniertes boolesches Feld erstellt und in den Opportunity- bzw. Lead-Mappings zugeordnet werden. + **Datum der letzten Synchronisierung mit APN** — Gibt an, wann der Datensatz zuletzt erfolgreich an APN gesendet oder vom APN empfangen wurde. Dieses Feld wird automatisch gesetzt, wenn der Datensatz erfolgreich an APN gesendet wurde oder eine Aktualisierung vom APN empfangen wird. + **Geeignet für die Synchronisierung mit APN** — Ein Formelfeld, das bestimmt, ob der Datensatz im nächsten geplanten Job an APN gesendet werden soll. Berechnet auf der Grundlage, ob der Datensatz seit der letzten Ausführung des Zeitplans für ausgehende Sendungen geändert wurde und ob er von einem anderen Benutzer als dem für die AWS Partner Organisation vorgesehenen Integrationsbenutzer aktualisiert wurde. # Produktionscheckliste Folgen Sie diesen Schritten, um die Produktionsinstallation Ihres AWS Partner CRM-Connectors abzuschließen. 1. Bestätigen Sie, dass Sie den [Onboarding-Prozess](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-getting-started.html) für die CRM-Integration abgeschlossen haben. In [Phase 6](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html) dieses Prozesses richten Sie Ihre Produktionsumgebung ein und führen eine Datenmigration durch, sodass Sie Geschäftschancen und Leads während der Integration verwalten können. 1. Installieren und konfigurieren Sie den CRM-Konnektor. Weitere Informationen finden Sie unter [Installation des Steckers](install-connector.md). 1. Ordnen Sie Opportunities und Lead-Objekte zu, indem Sie eine der folgenden Zuordnungsoptionen auswählen. Als Referenz finden Sie diese Liste der [erforderlichen Felder](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv) unter GitHub. + Verwenden Sie das benutzerdefinierte AWS ACE-Opportunity-Objekt, das im AWS Partner CRM-Connector enthalten ist, um Opportunities zu protokollieren und mit anderen zu teilen AWS. Mit dieser Option können Sie AWS Felder automatisch Salesforce-Feldern zuordnen. + Verwenden Sie das Salesforce-Standardobjekt und ordnen Sie die erforderlichen AWS Felder zu. + Verwenden Sie ein benutzerdefiniertes ACE-Opportunity-Objekt. Sie erstellen zunächst einen Workflow, um eine Zwischentabelle mit ACE-Opportunity-Objekten aufzufüllen, und ordnen dann die Salesforce-Felder zu AWS. 1. Weitere Informationen und Anleitungen zu Zuordnungsoptionen finden Sie unter. [Zuordnen von ACE-Objekten](crm-connector-mapping.md) 1. (Optional) Richten Sie Zeitpläne für die Synchronisierung eingehender und ausgehender Daten zwischen dem AWS Partner Netzwerk und Salesforce ein. Einzelheiten finden Sie unter. [Synchronisationszeitpläne erstellen](crm-connector-scheduling.md) 1. Um zu überprüfen, ob eine von einem Partner initiierte Verkaufschance in der Produktion verfügbar ist, stellen Sie in Ihrem Partner Central-Konto eine [Support-Anfrage bei](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-faq.html#troubleshooting) Partner Central Operations (PCO). In diesem Prozess erstellen Sie eine Dummy-Opportunity, synchronisieren sie mit und bitten den AWS Support-Mitarbeiter AWS, zu bestätigen, dass AWS er die Opportunity erhalten hat. Bitten Sie am Ende des Tests Ihren AWS Support-Mitarbeiter, die Opportunity-Anfrage abzulehnen, damit Sie sie von Ihrer Seite löschen können. 1. (Optional) Führen Sie ein Daten-Backfill durch. Dieser Prozess stellt sicher, dass sowohl AWS originäre als auch von Partnern stammende Opportunity-Empfehlungen bei future Updates identifiziert werden können. Weitere Informationen finden Sie unter [Phase 6: Produktionsgenehmigung](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html) im CRM-Onboarding-Prozess. 1. Aktivieren Sie die Produktionsintegration, um den Austausch von Dateien über den Amazon S3 S3-Bucket zu ermöglichen. Einzelheiten finden Sie unter [Phase 7: Launch](https://docs.aws.amazon.com/partner-central/latest/crm/stage-7-launch.html). # Aktualisierung des AWS Partner CRM-Connectors auf das neue Datenmodell **Wichtig** Testen und genehmigen Sie das neue Datenmodell-Upgrade in Ihrer Salesforce-Sandboxorganisation, bevor Sie Ihre Produktionsumgebung aktualisieren. Informationen zum neuen Datenmodell und zu den Änderungen zwischen dem alten und dem neuen Modell finden Sie in den folgenden [partner-crm-integration-samplesaws-samples/](https://github.com/aws-samples/partner-crm-integration-samples/tree/main/opportunity-samples) on: GitHub **Gelegenheit- - -v14.3.xlsx FieldsAndStandardValues DiffWithPrevVersion** **Opportunity-Fields.xlsx** **StandardValuesGelegenheit\$1-\$1 .xlsx** ## Voraussetzungen + Verwenden Sie Felddefinitionen für die neuen Datenmodellrichtlinien der ACE CRM-Integration und migrieren Sie alle erforderlichen offenen Opportunities und Leads in das neue Datenmodell. + Fügen Sie Spalten in Ihren benutzerdefinierten Objekten oder Standardobjekten (Objekte, die bei der Zuordnung verwendet werden) hinzu oder entfernen Sie sie. + Stellen Sie sicher, dass Sie Version 2.0 oder höher des AWS Partner CRM-Connectors verwenden. **Um ein Upgrade auf das neue Datenmodell durchzuführen** 1. Melden Sie sich als Systemadministrator bei Ihrer Salesforce-Organisation an. 1. Deaktivieren Sie alle aktiven Zeitpläne. 1. Wählen Sie **Setup**, **Benutzerdefinierte Einstellungen**, **AWS Partner CRM-Connector-Einstellungen** und aktualisieren Sie dann die Version auf **2.0** oder höher. **Anmerkung** Ab Version 2.0 ist das Feld **Version** ein Pflichtfeld. Dieses Feld gibt die Payload-Version an, die Partner für die Interaktion mit der CRM-Integration verwenden. Wenn Partner auf Version 2.0 umsteigen, müssen sie deren Spezifikationen vollständig übernehmen. Das Zurücksetzen auf frühere Versionen ist nicht zulässig. 1. Wählen Sie die Registerkarte **ACE-Zuordnung**. 1. Erstellen, überprüfen und aktualisieren Sie alle erforderlichen Feldzuordnungen und Details. Verwenden Sie für Sandbox-Tests die benutzerdefinierte ACE-Opportunity und das ACE-Lead-Objekt, um die neuen Datenmodellfunktionen zu testen. Weitere Informationen finden Sie unter [Sandbox-Tests mit der benutzerdefinierten ACE-Opportunity und den ACE-Lead-Objekten](custom-ace-opportunity.md). 1. Aktivieren Sie Zeitpläne für Opportunities und Leads. 1. Überprüfen Sie die ACE-Synchronisierungsprotokolle auf Synchronisierungsfehler und nehmen Sie etwaige Korrekturen vor. 1. Überprüfen Sie die synchronisierten Opportunities und Leads, um sicherzustellen, dass die Datentransformation korrekt ist. Sie können auch die Opportunities und Leads in ACE überprüfen, um sicherzustellen, dass die neuen Datenmodelländerungen korrekt erfasst werden. 1. Folgen Sie Ihrem Produktbereitstellungsprozess, um die Änderungen in Ihre Salesforce-Produktionsumgebung zu migrieren. **Anmerkung** Wenn Sie Hilfe benötigen, finden Sie weitere Informationen unter[Hilfe erhalten](getting-help.md). # Sandbox-Tests mit der benutzerdefinierten ACE-Opportunity und den ACE-Lead-Objekten **Anmerkung** Wenn Sie bereits CRM-Connector-Benutzer sind, finden Sie weitere Informationen unter. [Aktualisierung des AWS Partner CRM-Connectors auf das neue Datenmodell](connector-upgrade-plan.md) 1. Melden Sie sich als Systemadministrator bei Ihrer Salesforce-Organisation an. 1. Wählen Sie **Setup**, **Benutzerdefinierte Einstellungen**, **AWS Partner CRM-Connector-Einstellungen** und aktualisieren Sie Version auf **2.** 1. Wählen Sie die Registerkarte **ACE Mapping**. 1. Ordnen Sie es für **Opportunity** dem benutzerdefinierten **ACE-Opportunity-Objekt** zu. 1. Wählen Sie „**ACE-Objekt automatisch zuordnen**“. **Anmerkung** Wenn Sie auf die neue Version des CRM-Konnektors aktualisieren möchten und die benutzerdefinierte ACE-Opportunity und die ACE-Lead-Objekte aus dem Connector für Sandbox-Tests verwenden möchten, empfehlen wir, alle verfügbaren Datensätze aus der Datenbank `Field Mappings` und `Field Mapping Details` Objekte manuell zu löschen, bevor Sie die Funktion ACE-Objekt automatisch zuordnen verwenden. Sie müssen dies nur einmal tun. 1. Überprüfen Sie die Feldzuordnungen und Feldzuordnungswerte für die Auswahlliste und die Multipickliste. 1. Aktivieren Sie Zeitpläne für Opportunities und Leads. 1. Überprüfen Sie die ACE Sync-Protokolle auf Synchronisierungsfehler und nehmen Sie die erforderlichen Korrekturen vor. 1. Überprüfen Sie die synchronisierten Opportunities und Leads, um sicherzustellen, dass die Datentransformation korrekt ist. Sie können auch die Opportunities und Leads in ACE überprüfen, um sicherzustellen, dass die neuen Datenmodelländerungen korrekt erfasst wurden. ## Detaildatensätze des Synchronisierungsprotokolls für ACE-Opportunities anzeigen Sie können die Details des Synchronisierungsprotokolls für bereitgestellte ACE-Opportunities auf der Registerkarte „ AWS**Zugehörig**“ im ACE-Opportunity-Datensatz anzeigen. **Anmerkung** Diese Schritte gelten nur für AWS ACE-Opportunity-Objekte, die per E-Mail bereitgestellt wurden. Wenn Sie Standardobjekte oder benutzerdefinierte Objekte in Ihrer Salesforce-Organisation zuordnen, können Sie die Details des Synchronisierungsprotokolls auf der Registerkarte **ACE Sync Log** anzeigen. 1. Melden Sie sich bei Ihrer Salesforce-Organisation an. 1. Wählen Sie im **App Launcher AWS Partner ** **CRM-Connector** aus. 1. Wählen Sie die Registerkarte **ACE Opportunities**. 1. Wählen Sie einen ACE-Opportunity-Datensatz aus. 1. Wählen Sie die Registerkarte „**Zugehörig**“, um Details wie den **Namen des Synchronisierungsprotokolls**, **den Status**, die **Fehlermeldung** und das **Erstellungsdatum** anzuzeigen. ## AWS Marketplace Private Angebote mit ACE-Opportunities verknüpfen Sie können private Angebote direkt von der Seite mit den AWS bereitgestellten ACE-Opportunity-Datensätzen aus verknüpfen. 1. Melden Sie sich bei Ihrer Salesforce-Organisation an. 1. Wählen Sie im **App Launcher AWS Partner ** **CRM-Connector** aus. 1. Wählen Sie die Registerkarte **ACE Opportunities**. 1. Wählen Sie einen ACE-Opportunity-Datensatz aus. 1. Wählen Sie „**Privates Angebot verknüpfen**“. 1. Wählen **Sie unter Angebots-ID nachschlagen** das private Angebot aus. 1. Wählen Sie **Speichern**. # Ressourcen zur Integration AWS stellt die folgenden Ressourcen bereit, die Sie bei der Erstellung einer benutzerdefinierten Integration unterstützen. **Topics** + [Felddefinitionen](#custom-field-definitions) + [Standardwerte](#standard-values) + [Beispiele für eingehende Dateien](#sample-inbound-files) + [Beispiele für ausgehende Dateien](#sample-outbound-files) + [Beispiel verarbeiteter Ergebnisse](#sample-processed-results) + [Beispiele für Testfälle](#sample-test-cases) + [Beispielcodefragmente](#sample-code-snippets) ## Felddefinitionen Die Links in den folgenden Abschnitten listen alle Felder auf und erläutern ihre Datentypen, ihre Verwendung und alle geltenden Einschränkungen oder Formatierungsregeln. Sie dienen als Referenz, um sicherzustellen, dass beim AWS Datenaustausch zwischen Partnern diese korrekt formatiert und verstanden werden. Die folgenden Links führen Sie zu GitHub. + [Gelegenheit](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv) + [Blei](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv) ## Standardwerte In diesen Listen werden die Standardwerte und Aufzählungen für verschiedene Felder beschrieben. Sie tragen dazu bei, die Konsistenz der ausgetauschten Daten aufrechtzuerhalten, und stellen sicher, dass beide Parteien ein gemeinsames Verständnis der verwendeten Werte haben. Die folgenden Links führen Sie zu GitHub. + [Gelegenheit](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity_-_StandardValues.csv) + [Blei](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead_-_StandardValues.csv) ## Beispiele für eingehende Dateien Die folgenden Beispieldateien zeigen die Struktur der JSON-Payload für eine Datei, die von einem Partner an gesendet wurde. AWS Die folgenden Links führen Sie zu GitHub. + [Gelegenheit](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Create-Inbound-Sample.json) + [Blei](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Update-Inbound-Sample.json) ## Beispiele für ausgehende Dateien Die folgenden Beispieldateien zeigen die Struktur der JSON-Payload für eine Datei, die von einem Partner AWS gesendet wurde. Die folgenden Links führen Sie zu GitHub. + [Gelegenheit](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Outbound-Sample.json) + [Blei](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Outbound-Sample.json) ## Beispiel verarbeiteter Ergebnisse Die folgenden Dateien zeigen ein typisches Ergebnis nach der AWS Verarbeitung einer von einem Partner gesendeten Nutzlast. Die folgenden Links führen Sie zu GitHub. + [Gelegenheit](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json) + [Blei](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json) ## Beispiele für Testfälle Die folgenden Links führen Sie zu GitHub. + [Gelegenheit](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity%20-%20Testing%20Scenarios.xlsx) + [Blei](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead%20-%20Testing%20Scenarios.xlsx) ## Beispielcodefragmente Die folgenden Links führen Sie zu. GitHub + [ace\$1read\$1s3.py](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py) + [API\$1CAPEX\$1Sample\$1REST\$1ODE.CLS](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls) + [S3\$1Authentifizierung.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls) + [Beispiel\$1 .cls AceOutboundBatch](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls) + [SFDC Apex S3 sample.txt](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/SFDC_apex_s3_sample.txt) + [APEX\$1Dateien\$1von\$1S3\$1ACE\$1Partner\$1Test.cls abrufen](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_get_files_from_s3_ace_partner_test.cls) + [s3\$1ace\$1partner\$1test.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/s3_ace_partner_test.cls) # Teilen von Leads ## Wie AWS teilt man Leads 1. **Inkrementelle Exporte**: Amazon Web Services (AWS) exportiert stündlich neue Leads (und Updates) AWS, von denen empfohlen wird. 1. **Dateierstellung**: AWS generiert Lead-Dateien, die einem bestimmten Format entsprechen. Detaillierte Dateispezifikationen finden Sie unter. [Felddefinitionen](resources.md#custom-field-definitions) 1. **Datei-Upload**: Die Lead-Dateien werden in den `lead-outbound` Ordner hochgeladen. ## Leads werden konsumiert von AWS Um Leads effektiv zu nutzen AWS, erstellen Sie eine maßgeschneiderte Integration mit den folgenden Funktionen. 1. **Abrufen von Dateien**: + Scannen Sie den `lead-outbound` Ordner regelmäßig mithilfe eines geplanten Jobs in einem von Ihnen gewählten Intervall. + Rufen Sie die Lead-Dateien zur Verarbeitung ab. 1. **Datentransformation und -kartierung**: + Nachdem Sie den Inhalt jeder Datei gelesen haben, transformieren Sie die Daten und ordnen Sie sie den Lead-Datensätzen in Ihrem CRM-System (Customer Relationship Management) zu. + Hinweise zur Feldzuweisung finden Sie unter[Feldkartierung](custom-field-mapping.md). 1. **Identifizierung von Leads**: + Identifizieren Sie jeden Lead eindeutig, indem Sie entweder `partnerCrmLeadId` oder verwenden`apnCrmUniqueIdentifier`. + Wenn dieses Feld leer `partnerCrmLeadId` ist und vorhanden `apnCrmUniqueIdentifier` ist, handelt es sich bei dem Lead um eine neue Empfehlung von AWS Partner Network (APN) Customer Engagement (ACE). + Wenn beide Identifikatoren vorhanden sind, wird der Datensatz als Aktualisierung von ACE behandelt. 1. **Aufnahme von Blei**: + Erfassen Sie neue Leads oder aktualisieren Sie bestehende Leads im CRM-System. 1. **Dateiverwaltung**: + Nachdem Sie jeden Lead und die vollständigen Dateidaten erfolgreich verarbeitet haben, löschen Sie die Dateien aus dem Ausgangsordner. + Jede Datei wird automatisch im `lead-outbound-archive` Ordner archiviert. **Integrations- und Codereferenz**: + Zum Lesen von Dateien, die in den Amazon Simple Storage Service (Amazon S3) -Bucket hochgeladen wurden, können Sie Ihr CRM-System verwenden AWS Lambda oder direkt aus diesem lesen. + Verwenden Sie die folgenden Beispielcodes für Lambda und die Salesforce REST API, um CRM-Datensätze zu validieren und zu aktualisieren. + **Lambda für die Validierung von Dateien: ace\$1read\$1s3.py**[.](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py) + **Salesforce-REST-API**: [API\$1CAPEX\$1Sample\$1REST\$1](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls) ode.cls. + Wenn Sie ein anderes CRM-System als Salesforce verwenden, müssen Sie systemspezifischen Code bereitstellen, um Ihre Daten zu aktualisieren. ## Teilen von Updates zu Leads mit AWS 1. **Identifizieren Sie Leads**: Suchen Sie die Leads mit Updates, mit denen Sie sie teilen möchten AWS. 1. **Datentransformation**: Konvertieren Sie die Daten in das AWS Format, wie unter beschrieben[Felddefinitionen](resources.md#custom-field-definitions). 1. **Erstellung von Dateien**: + Generieren Sie Lead-Dateien im JSON-Format. + Hängen Sie jeder Datei einen Zeitstempel an und achten Sie darauf, dass alle Dateinamen eindeutig sind und dem Format folgen:. `{name}_MMDDYYYY24HHMMSS.json` 1. **Authentifizieren** und hochladen: + Authentifizieren Sie sich beim ACE Amazon S3 S3-Bucket. + Laden Sie die Datei in den `lead-inbound` Ordner hoch. Alle Dateien, die mit geteilt wurden, AWS werden automatisch im `lead-inbound-archive` Ordner archiviert. + Wenn Sie Dateien auf S3 hochladen, stellen Sie sicher, dass Sie dem Bucket-Besitzer vollen Zugriff gewähren. ``` aws s3 cp example.jpg s3://awsexamplebucket --acl bucket-owner-full-control ``` Ein Beispielergebnis der Ausführung dieses Befehls finden Sie unter [„Results Sample file.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)“. 1. Verarbeitung von **Dateien**: + Verarbeitet die Dateien nach Erhalt AWS automatisch. + Die Ergebnisse der Verarbeitung werden in den `lead-inbound-processed-results` Ordner im Amazon S3 S3-Bucket hochgeladen. Dazu gehören der Status von Erfolgen und Fehlern sowie etwaige Fehlermeldungen für jeden Lead. + Diese verarbeiteten Ergebnisse werden ebenfalls im `lead-inbound-processed-results-archive` Ordner archiviert. + Weitere Informationen finden Sie in der[Häufig gestellte technische Fragen — Leads und Möglichkeiten](technical-faq-leads-and-opps.md). 1. **Bearbeitung von Antworten**: + Sie müssen eine Logik entwickeln, um diese Antworten zu verarbeiten, fehlerhafte Datensätze zu überprüfen, etwaige Fehler zu korrigieren und die Daten erneut an ACE zu senden. + Beispielfehler finden Sie in den Abschnitten Häufig gestellte Fragen und Problembehandlung. + So laden Sie eine Datei aus CRM auf Amazon S3 hoch: + Verweisen Sie auf die Version der AWS Signatur. + Verwenden Sie eine HTTPS-Anfrage, um die Datei hochzuladen. + Verwenden Sie als Referenz die folgenden Dateien, um eine Datei in den Amazon S3 S3-Bucket hochzuladen: + **Zur Authentifizierung eines S3-Buckets**[: S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls) + **Zum Hochladen von Dateien** [in einen S3-Bucket: Sample\$1 .cls AceOutboundBatch](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls) + **HINWEIS:** Dateien dürfen eine Größe von 1 MB nicht überschreiten, und doppelte Dateien werden nicht verarbeitet. # Teilen von Chancen ## Wie AWS teilt man Chancen 1. **Inkrementelle Exporte**: Amazon Web Services (AWS) exportiert stündlich neue Opportunities (und Updates) AWS, auf die verwiesen wird. 1. **Dateierstellung**: AWS generiert Opportunity-Dateien, die einem bestimmten Format entsprechen. Detaillierte Dateispezifikationen finden Sie unter [Opportunity-Felddefinitionen](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv). 1. **Datei-Upload**: Opportunity-Dateien werden in den `opportunity-outbound` Ordner hochgeladen. ## Chancen nutzen von AWS Um die daraus resultierenden Chancen effektiv nutzen zu können AWS, müssen Sie eine maßgeschneiderte Integration mit diesen Funktionen einrichten. 1. **Abrufen von Dateien**: + Verwenden Sie einen geplanten Job, um den `opportunity-outbound` Ordner regelmäßig in einem von Ihnen gewählten Intervall zu scannen. + Rufen Sie die Opportunity-Dateien zur Verarbeitung ab. 1. **Datentransformation und -kartierung**: + Nachdem Sie den Inhalt jeder Datei gelesen haben, transformieren Sie die Daten und ordnen Sie sie den Opportunity-Datensätzen in Ihrem CRM-System (Customer Relationship Management) zu. + Hinweise zur Feldzuweisung finden Sie unter[Feldkartierung](custom-field-mapping.md). 1. **Identifizierung von Geschäftschancen**: + Identifizieren Sie jede Gelegenheit eindeutig, indem Sie entweder `partnerCrmOpportunityId` oder verwenden`apnCrmUniqueIdentifier`. + Falls `partnerCrmOpportunityId` leer und vorhanden, `apnCrmUniqueIdentifier` handelt es sich bei der Opportunity um eine neue Empfehlung von AWS Partner Network (APN) Customer Engagement (ACE). + Wenn beide Kennungen vorhanden sind, wird der Datensatz als Aktualisierung von ACE behandelt. 1. **Erfassung neuer Geschäftschancen: Erfassen** Sie neue Opportunities oder aktualisieren Sie bestehende Opportunities im CRM-System. 1. **Dateiverwaltung:** + Nachdem Sie jede Opportunity und die vollständigen Dateidaten erfolgreich verarbeitet haben, löschen Sie die Dateien aus dem Ausgangsordner. + Jede Datei wird automatisch im `opportunity-outbound-archive` Ordner archiviert. **Integrations- und Codereferenz**: + Zum Lesen von Dateien, die in den Amazon Simple Storage Service (Amazon S3) -Bucket hochgeladen wurden, können Sie Ihr CRM-System verwenden AWS Lambda oder direkt aus diesem lesen. + Verwenden Sie die folgenden Beispielcodes für Lambda und die Salesforce REST API, um CRM-Datensätze zu validieren und zu aktualisieren. + **Lambda für die Validierung von Dateien: ace\$1read\$1s3.py**[.](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py) + **Salesforce-REST-API**: [API\$1CAPEX\$1Sample\$1REST\$1](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls) ode.cls. + Wenn Sie ein anderes CRM-System als Salesforce verwenden, müssen Sie systemspezifischen Code bereitstellen, um Ihre Daten zu aktualisieren. ## Teilen von Updates zu Geschäftschancen mit AWS 1. **Identifizieren Sie Geschäftschancen**: Suchen Sie nach Geschäftschancen mit Neuigkeiten, mit denen Sie sie teilen möchten AWS. 1. **Datentransformation**: Konvertieren Sie die Daten in das AWS Format, wie unter beschrieben[Felddefinitionen](resources.md#custom-field-definitions). 1. **Erstellung von Dateien**: + Generieren Sie Opportunity-Dateien im JSON-Format. + Hängen Sie jeder Datei einen Zeitstempel an und achten Sie darauf, dass alle Dateinamen eindeutig sind und dem Format folgen:. `{name}_MMDDYYYY24HHMMSS.json` 1. **Authentifizieren** und hochladen: + Authentifizieren Sie sich beim ACE Amazon S3 S3-Bucket. + Laden Sie die Datei in den `opportunity-inbound` Ordner hoch. Alle Dateien, die mit geteilt wurden, AWS werden automatisch im `opportunity-inbound-archive` Ordner archiviert. + Wenn Sie Dateien auf S3 hochladen, stellen Sie sicher, dass Sie dem Bucket-Besitzer vollen Zugriff gewähren: ``` aws s3 cp example.jpg s3://awsexamplebucket --acl bucket-owner-full-control ``` Ein Beispielergebnis der Ausführung dieses Befehls finden Sie in [Opportunity Results Success Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json). 1. **Verarbeitung von Dateien:** + Verarbeitet die Dateien nach Erhalt AWS automatisch. + Die Ergebnisse der Verarbeitung werden in den `lead-inbound-processed-results` Ordner im Amazon S3 S3-Bucket hochgeladen. Dazu gehören der Status von Erfolgen und Fehlern sowie etwaige Fehlermeldungen für jede Opportunity. + Diese verarbeiteten Ergebnisse werden ebenfalls im `opportunity-inbound-processed-results-archive` Ordner archiviert. + Weitere Informationen finden Sie in der[Häufig gestellte technische Fragen — Leads und Möglichkeiten](technical-faq-leads-and-opps.md). 1. **Bearbeitung von Antworten**: + Sie müssen eine Logik entwickeln, um diese Antworten zu verarbeiten, fehlerhafte Datensätze zu überprüfen, etwaige Fehler zu korrigieren und die Daten erneut an ACE zu senden. + Beispielfehler finden Sie in den Abschnitten Häufig gestellte Fragen und Problembehandlung. + So laden Sie eine Datei aus CRM auf Amazon S3 hoch: + Verweisen Sie auf die Version der AWS Signatur. + Verwenden Sie eine HTTPS-Anfrage, um die Datei hochzuladen. + Verwenden Sie als Referenz die folgenden Dateien, um eine Datei in den Amazon S3 S3-Bucket hochzuladen: + **Zur Authentifizierung eines S3-Buckets**[: S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls) + **Zum Hochladen von Dateien** [in einen S3-Bucket: Sample\$1 .cls AceOutboundBatch](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls) + **HINWEIS:** Dateien dürfen eine Größe von 1 MB nicht überschreiten, und doppelte Dateien werden nicht verarbeitet. # Feldkartierung Die Feldzuweisung ist ein wesentlicher Schritt im Integrationsprozess, bei dem Partner die Felder ihres Kundenbeziehungsmanagementsystems (CRM) an die von Amazon Web Services (AWS) definierten Felder anpassen. Dadurch wird sichergestellt, dass beide Parteien Daten korrekt austauschen und verstehen. Im Folgenden finden Sie Richtlinien, die Sie bei diesem Prozess unterstützen sollen. ## Obligatorische Feldzuweisung + Ordnen Sie jedes Pflichtfeld dem entsprechenden Feld in Ihrem CRM-System zu. Für einen erfolgreichen Datenaustausch ist es wichtig, dass Sie sicherstellen, dass alle erforderlichen Felder zugeordnet sind. Weitere Informationen finden Sie unter [Felddefinitionen](resources.md#custom-field-definitions) + [Gelegenheit](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv) + [Blei](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv) ## Umgang mit optionalen Feldern + Machen Sie sich mit der Rolle optionaler Felder im Integrationsprozess vertraut. Entscheiden Sie auf der Grundlage Ihrer Geschäftsanforderungen, ob Sie diese Felder zuordnen möchten, und seien Sie sich der möglichen Auswirkungen bewusst, wenn sie nicht zugeordnet werden. ## Zuordnung von Werten + Ordnen Sie jeden Feldwert in Ihrem CRM dem erforderlichen Listenwert AWS Partner Network (APN) für Kundenbindung (ACE) zu, wie unter angegeben. [Felddefinitionen](resources.md#custom-field-definitions) Dies ist wichtig, um die Datenkonsistenz und -integrität aufrechtzuerhalten. ## Validierung von Datentyp und -format + Stellen Sie sicher, dass die Datentypen und Formate der Felder in Ihrem CRM-System mit den in den AWS *Felddefinitionen* angegebenen übereinstimmen. Es ist wichtig, die Konsistenz der Datentypen und -formate aufrechtzuerhalten, um Datenbeschädigungen zu verhindern und eine nahtlose Integration zu gewährleisten. ## Feldlänge und Einschränkungen + Beachten Sie die Einschränkungen der Feldlänge und andere Einschränkungen. Stellen Sie sicher, dass die Daten aus Ihrem CRM-System in die entsprechenden Felder passen, AWS ohne gekürzt zu werden oder Fehler zu verursachen. ## Validierung von Datentyp und Format + Stellen Sie sicher, dass die Felddatentypen und -formate in Ihrem CRM-System mit den unter angegebenen übereinstimmen[Felddefinitionen](resources.md#custom-field-definitions). Es ist wichtig, Datenbeschädigungen zu verhindern und eine nahtlose Integration mit konsistenten Datentypen und -formaten sicherzustellen. ## Regelmäßige Überprüfung und Aktualisierung + Überprüfen und aktualisieren Sie Ihre Feldzuordnungen regelmäßig, um Änderungen in Ihrem CRM-System oder AWS Ihren Anforderungen zu berücksichtigen. Dieser proaktive Ansatz gewährleistet die Genauigkeit und Effizienz des kontinuierlichen Datenaustauschs. ## Dokumentation zur Feldkartierung + Pflegen Sie eine umfassende Dokumentation zur Feldzuweisung. Diese Vorgehensweise hilft bei der Fehlerbehebung, bei future Updates und sorgt für Klarheit darüber, wie Daten zwischen Systemen übertragen werden. ## Testen und Validieren + Führen Sie gründliche Feldzuordnungstests durch, um zu überprüfen, ob die Daten korrekt übertragen und transformiert werden. Beheben Sie etwaige Unstimmigkeiten oder Probleme sofort, um die Datenintegrität sicherzustellen. ## Umgang mit unerwünschten Überschreibungen + Um zu verhindern, dass AWS Daten bestimmte CRM-Felder überschreiben, sollten Sie Folgendes beachten: + Erstellen Sie ein benutzerdefiniertes CRM-Feld für die Daten, die Sie schützen möchten. + Lassen Sie dieses benutzerdefinierte Feld von einem Vertriebsmitarbeiter überprüfen. + Sobald das benutzerdefinierte Feld genehmigt wurde, wird es dem Opportunity-Datensatz und der Pipeline hinzugefügt. + Dies ist besonders wichtig für Felder wie `MRR` oder`Stage`, vor allem, wenn sie bedeuten, dass ein Produkt auf den Markt gebracht wurde. ## Verwaltung nachgelagerter Abhängigkeiten + Wenn es in Ihrem System nachgelagerte Abhängigkeiten gibt, die auf Datenaustausch angewiesen sind, sollten Sie Folgendes berücksichtigen: + Erstellen Sie neue Felder in Ihrem CRM, um die AWS Daten aufzunehmen. + Richten Sie Ihre Geschäftsprozesse nach Bedarf neu aus, um eine reibungslose Integration und einen reibungslosen Datenfluss zu gewährleisten. # Synchronisationszeitpläne erstellen **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 unter [Voraussetzungen für die Integration](crm-integration-setting-up.md) und weiter [Erste Schritte](crm-integration-getting-started.md) oben in diesem Handbuch. Sie können Zeitpläne für die eingehende und ausgehende Synchronisierung zwischen Salesforce und AWS Partner Central erstellen. Die Schritte in den folgenden Abschnitten erklären, wie das geht. **Topics** + [Voraussetzungen](#scheduling-prerequisites) + [Einen Zeitplan erstellen](#creating-a-schedule) + [Deaktivierung eines geplanten Jobs](#deactivating-a-scheduled-job) + [Alle Zeitpläne anzeigen](#viewing-all-schedules) ## Voraussetzungen Stellen Sie sicher, dass Sie die folgenden Schritte ausführen, bevor Sie einen Synchronisierungszeitplan erstellen: + [Ordnen](crm-connector-mapping.md) Sie alle erforderlichen Felder mindestens einem Objekt, einer Opportunity oder einem Lead zu. + Erstellen Sie einen [Systemintegrationsbenutzer](#system-integration-user) in Salesforce. ### Einen Systemintegrationsbenutzer erstellen Bevor Sie einen Synchronisierungsplan erstellen können, müssen Sie Salesforce verwenden, um einen Systemintegrationsbenutzer mit APN-Integrationsberechtigungen zu erstellen. Um Synchronisierungspläne zu erstellen, müssen Sie sich als Systemintegrationsbenutzer bei Salesforce anmelden. Das Erstellen eines Zeitplans ohne Benutzerberechtigungen für die APN-Integration kann die APN-Integration beeinträchtigen. **Um einen Systemintegrationsbenutzer zu erstellen** 1. Melden Sie sich als Systemadministrator bei Ihrer Salesforce-Organisation an. 1. Erstellen Sie einen Benutzer in Ihrer Salesforce-Organisation. Weisen Sie dem Benutzer mit Zugriff auf die erforderlichen Objekte in Ihrer Salesforce-Organisation ein Profil zu. Weitere Informationen finden Sie unter [Einen einzelnen Benutzer hinzufügen](https://help.salesforce.com/s/articleView?id=sf.adding_new_users.htm). 1. Weisen Sie dem Benutzer den **Benutzerberechtigungssatz für die APN-Integration** zu. Weitere Informationen finden Sie unter [Benutzern einen Berechtigungssatz zuweisen](https://help.salesforce.com/s/articleView?id=sf.assign_permission_set_to_user.htm). ## Einen Zeitplan erstellen Nachdem Sie die [Voraussetzungen erfüllt](#scheduling-prerequisites) haben, können Sie Synchronisierungspläne zwischen Salesforce und APN erstellen. **Um einen Synchronisierungsplan mit APN zu erstellen** 1. Melden Sie sich bei Salesforce als Benutzer mit Benutzerberechtigungen für die Systemintegration an. 1. Wählen Sie auf der Registerkarte **Zeitpläne** die Option **Neu** aus. 1. Wählen Sie die Objekte aus, die geplant werden sollen. Sie können Zeitpläne für Leads und Opportunities oder für ein einzelnes Objekt einrichten. 1. Wählen Sie die Zeitplanhäufigkeit, von mindestens alle fünf Minuten bis maximal einmal täglich. 1. Wählen Sie **Schedule** aus. **Anmerkung** Pro Objekt kann jeweils nur ein Zeitplan aktiv sein. Wenn Sie einen neuen Zeitplan für dasselbe Objekt erstellen, wird der vorhandene Zeitplan deaktiviert. Um die eingehende Integration bei der Erstellung eines Zeitplans zu deaktivieren, wählen Sie **Inbound-Integration deaktivieren**, Zeitplan. Das Erstellen eines Zeitplans ohne Benutzerberechtigungen für die APN-Integration kann die APN-Integration unterbrechen. ## Deaktivierung eines geplanten Jobs 1. Wählen Sie auf der Seite **Terminplanung** die Option **Alle Jobs deaktivieren**, um alle aktiven Zeitpläne zu deaktivieren. 1. Fahren Sie mit dem Bestätigungsbildschirm fort, um den Synchronisierungszeitplan zu deaktivieren. ## Alle Zeitpläne anzeigen Verwenden Sie auf der Registerkarte „**Zeitpläne**“ die Filter für die Listenansicht, um zwischen den Zeitplänen „**Aktiv**“, „**Inaktiv**“ und „**Alle“ zu** wechseln. # Best Practices Verwenden Sie diese Best Practices, um die Entwicklung und Wartung Ihrer benutzerdefinierten Integration zu optimieren. ## Allgemeine bewährte Methoden 1. Ordnen Sie alle *Pflichtfelder* zu, da es sich dabei um die Pflichtfelder im AWS Partner Network (APN) -Eingabeformular für Kundenbindung (ACE) handelt. 1. Connect mit Ihrem aktuellen ACE Pipeline Manager-Benutzer her, um zu erfahren, wie der Prozess aussieht. Erfassen Sie alle einzigartigen processes/field Einsatzmöglichkeiten, damit Sie sie in Ihr Erlebnis integrieren können. 1. Erwägen Sie, separate Vertriebspipeline-Phasen für Vertriebsphasen zu erstellen, die von Amazon Web Services (AWS) gemeldet wurden (Beispiel: Phase, Zielabschlussdatum, Erwarteter monatlicher AWS Umsatz, Nächste Schritte). Wenn wir unterschiedliche Phasendefinitionen haben, überschreiben wir möglicherweise Ihre Verkaufsphasen. Wenn Sie separate Vertriebsphasen erstellen, können Sie Ihre Pipeline angemessen verwalten und haben dennoch einen Überblick darüber, was geplant AWS ist. 1. Bei von Partnern empfohlenen Verkaufschancen muss das ACE-Team approve/reject diese prüfen, bevor wir Aktualisierungen annehmen. 1. Bei AWS Weiterempfehlungen muss der Partner die Opportunities annehmen oder ablehnen. ## Protokolle für den Datenaustausch 1. **Eingabekonventionen**: Trennen Sie die Einträge in der Auswahlliste mit Mehrfachauswahl durch Semikolons voneinander und lassen Sie Leerzeichen weg. 1. **Liebe zum Detail**: Bei Feldnamen und Werten wird zwischen Groß- und Kleinschreibung unterschieden, achten Sie also auf Genauigkeit. 1. **Löschverfahren**: Führen Sie das Entfernen von Feldern durch, indem Sie den Wert `null` für das gewählte Feld übertragen. 1. **Synchronisation**: Die Synchronisationsprozesse werden stündlich ausgeführt, was zu möglichen Verzögerungen bei der Datenreflexion führen kann. Es AWS kann bis zu einer Stunde dauern, bis Aktualisierungen im AWS Kundenbeziehungsmanagement (CRM) berücksichtigt werden. Vermeiden Sie es, mehrere Dokumente pro Stunde zu versenden. ## Praxisspezifische Best Practices 1. **Eingehende Änderungen**: Um die Integrität Ihrer Daten zu schützen, deaktivieren Sie Änderungen für Felder wie`stage`, und`closedDate`. `closedLostReason` Verwenden Sie diese schreibgeschützten Felder, um Werte zu verfolgen AWS , ohne Ihre lokalen Salesforce-Werte zu beeinflussen:`awsStage`, und`awsCloseDate`. `awsClosedLostReason` 1. **Kundenkartierung und -validierung**: Stellen Sie sicher, dass die Kundenwebsite korrekt ist, da dies für AWS die CRM-Zuordnung von entscheidender Bedeutung ist. Kombinieren Sie es mit dem Kundennamen, um eine hervorragende CRM-Kontozuweisung zu erhalten. 1. **Klarheit der Projektbeschreibung: Geben** Sie eine klare Beschreibung, in der die Herausforderungen der Kunden und die Ausrichtung der Lösungen detailliert beschrieben werden. AWS nutzt dies, um die Geschäftschance zu validieren. 1. **Bereitstellung**: (Optional) Wenn Sie Kontaktdetails für Endkunden angeben, können Leads und Kampagnen AWS zurückverfolgt werden. Dies führt zu besseren Finanzierungsentscheidungen. ## Weitere bewährte Methoden 1. Halten Sie sich an die neuesten Richtlinien zur Definition von Payload-Feldern. 1. Achten Sie bei der Benennung von Sandbox-Buckets auf die Konsistenz des angegebenen Formats. 1. Verwenden Sie das empfohlene Benennungsmuster für den Produktions-Bucket. 1. Priorisieren Sie das Testen der Sandbox-Umgebung vor der Live-Bereitstellung. 1. Behalten Sie eindeutige Identifikatoren für Datensätze zwischen AWS und dem Partner bei. CRMs 1. Löschen Sie nach der Bearbeitung Dateien im ausgehenden Amazon Simple Storage Service (Amazon S3) -Ordner. Die Originale verbleiben in den Archiven. 1. Um Fehler zu vermeiden, richten Sie Validierungen auf Feldebene an der Quelle ein. # Kontingente ## Eingehende Datei an Amazon Web Services ()AWS | Operation | Limit | | --- | --- | | Maximale Möglichkeiten | 500 pro Datei | | Maximale Dateigröße | 1 MB | | Häufigkeit der Synchronisation | Nahezu in Echtzeit | | Maximale Anzahl der eingereichten Dateien | 10.000 pro 24-Stunden-Zeitraum | ## Ausgehende Datei an den Partner | Operation | Limit | | --- | --- | | Maximale Dateigröße | 5 MB | | Häufigkeit der Synchronisation | Stündlich | # Versionshistorie Aktuelle Feldversion: 14 (15. November 2023) In der folgenden Tabelle werden wichtige Änderungen an den benutzerdefinierten Integrationsfeldern für Leads und Opportunities nach 2020 beschrieben. Abonnieren Sie den RSS-Feed, um über future Updates informiert zu werden. | Änderung | Version | Datum | | --- | --- | --- | | Amazon S3 S3-Kontingente aktualisieren | 14 | 17.01.2024 | | **Änderungen in den Bereichen Integrationsmöglichkeiten:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/partner-central/latest/crm/version-history.html) | 14 | 15.11.2023 | | **Änderungen in den Bereichen Integrationsmöglichkeiten:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/partner-central/latest/crm/version-history.html) | 13 | 29.03.2023 | | **Änderungen in den Bereichen Integrationsmöglichkeiten:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/partner-central/latest/crm/version-history.html) **Änderungen der Standardwerte bei Opportunity:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/partner-central/latest/crm/version-history.html) | 12 | 09/01/2022 | | **Änderungen in den Bereichen Integrationsmöglichkeiten:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/partner-central/latest/crm/version-history.html) **Änderungen der Standardwerte in Opportunity-Feldern:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/partner-central/latest/crm/version-history.html) | 11 | 21.03.2022 | | **Änderungen in den Bereichen Integrationsmöglichkeiten:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/partner-central/latest/crm/version-history.html) **Änderungen der Standardwerte bei Opportunity:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/partner-central/latest/crm/version-history.html) | 10 | 26.01.2022 | | **Änderungen der Standardwerte für Bleifelder:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/partner-central/latest/crm/version-history.html) **Änderungen an den Feldern für Integrationsschwerpunkte:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/partner-central/latest/crm/version-history.html) **Änderungen an den Feldern für Integrationsmöglichkeiten:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/partner-central/latest/crm/version-history.html) | 9 | 16.9.2021 | | Geschlossene Codes für verlorene Gründe aktualisieren | 8 | 24.06.2021 | # FAQs Verwenden Sie diese häufig gestellten Fragen und Antworten, um Sie bei der benutzerdefinierten Integration zu unterstützen. **Topics** + [Allgemeine FAQs](general-faq.md) + [Häufig gestellte technische Fragen — Felder](technical-faq-fields.md) + [Häufig gestellte technische Fragen — Amazon S3](technical-faq-s3.md) + [Häufig gestellte technische Fragen — Leads und Möglichkeiten](technical-faq-leads-and-opps.md) + [Häufig gestellte technische Fragen — Versionierung und Abwärtskompatibilität](technical-faq-versioning.md) # Allgemeine FAQs ## Wie funktioniert die Integration? **F: Kann ich auf den Amazon Simple Storage Service (Amazon S3) -Bucket zugreifen, der für das Senden und Empfangen der Dateien verwendet wurde?** Ja. Partner können programmgesteuert auf den Amazon S3 S3-Bucket zugreifen, indem sie den secret/access Schlüssel des AWS Identity and Access Management (IAM) verwenden, der Zugriff auf den Bucket hat. Partner haben keinen Konsolenzugriff auf die Amazon S3 S3-Buckets, da sich diese Buckets im eigenen Konto von Amazon Web Services (AWS) befinden. **F: Welche Fähigkeiten benötigt der Entwickler des Partners?** Der Entwickler des Partners muss mit seinem CRM-System (Customer Relationship Management) und Amazon S3 vertraut sein. **F: Enthalten die Beispielcodedateien vollständigen Code oder muss der Partner den Code selbst schreiben?** Der Partner muss den Code auf der Grundlage der bereitgestellten Beispielcodedateien schreiben. **F: Wenn der Partner seine Lösung in Python, Golang oder einer anderen Sprache entwickelt, stellt AWS Partner Network (APN) Customer Engagement (ACE) dann ein Software Development Kit (SDK) in diesen Sprachen für diese Integration bereit?** Nein. **F: Was ist der Synchronisierungsprozess vom Amazon S3 S3-Bucket zum internen ACE?** Jede Stunde wird ein Batch-Prozess ausgeführt, um die Dateien abzurufen und Informationen zu synchronisieren. Es kann bis zu einer Stunde dauern, bis jede Aktualisierung, die das AWS Vertriebsteam an den Datensatz vornimmt, an den Bucket des Partners gesendet wird. Partner erhalten möglicherweise sofort eine E-Mail-Benachrichtigung über Aktualisierungen, die Aktualisierungen von AWS können sich jedoch dennoch um eine Stunde verzögern. **F: Wie häufig werden Lead- und Opportunity-Dateien von ACE hochgeladen?** ACE sendet die Daten zu Leads und Opportunities alle eine Stunde. **F: Gibt es eine Sandbox-Umgebung für ACE?** Ja. Wir haben zwar eine Sandbox-Umgebung für ACE, können Partnern jedoch aus Sicherheitsgründen keinen Zugriff gewähren. Stellen Sie eine Support-Anfrage bei Partner Central, wenn Sie neue Geschäftschancen oder Leads in Ihrem Bucket haben möchten. **F: Wie verwalten wir Identifikatoren im CRM und APN des Partners?** Um unseren Partnern mehr Flexibilität zu bieten, verwenden wir zwei Gruppen von Identifikatoren in unserem System. 1. `apnCrmUniqueIdentifier`: AWS verwaltet diese Kennung. Es beginnt mit „`OXXXXXX`für Opportunities“ und „`LXXXXXX`für Leads“. 1. `PartnerCrmUniqueIdentifier`/`partnerCrmLeadId`: Der Partner verwaltet diese Kennung für Opportunities bzw. Leads in seinem CRM. Partner sollten diese Kennung hinzufügen und gleichzeitig neue Möglichkeiten nutzen, um Aktualisierungen bis zu ihrem CRM zurückzuverfolgen. Wenn eine Opportunity ohne `apnCrmUniqueIdentifier` oder gesendet wird`partnerCrmUniqueIdentifier`, wird sie als neue Opportunity AWS behandelt und der Opportunity eine neue `apnCrmUniqueIdentifier` Opportunity zugewiesen. Wenn eine Opportunity mit einem `apnCrmUniqueIdentifier` Oder gesendet wird`partnerCrmUniqueIdentifier`, wird sie als Aktualisierungsaktion AWS behandelt und die bestehende Opportunity mit den Payload-Daten aktualisiert. **F: Wie verhindere ich, dass doppelte Datensätze in beiden Systemen erstellt werden?** Auf Seiten des Partner-CRM muss es für jeden Datensatz, der an ACE gesendet wird, eine eindeutige Kennung geben, die aufgerufen wird`partnerCrmUniqueIdentifier`. In ähnlicher Weise verwaltet ACE auch eine eindeutige Kennung für jeden Datensatz, der aufgerufen wird`apnCrmUniqueIdentifier`. Wenn die Daten gesendet werden, müssen sowohl ACE als auch der Partner diese beiden Felder angeben, sodass leichter erkannt werden kann, ob es sich bei dem Datensatz um eine neue Opportunity (falls leer) oder um eine bestehende Opportunity (falls ausgefüllt) handelt. # Häufig gestellte technische Fragen — Felder **F: Unterstützt die Integration das CSV-Format?** Nein. Die Integration akzeptiert nur JSON-Dateiformate. **F: Wann müssen die Dateien aus ausgehenden Ordnern gelöscht werden?** Löschen Sie die Dateien erst, nachdem Sie sie erfolgreich verarbeitet haben. **F: Wo finde ich die Originaldateien, wenn ich versehentlich die Dateien aus ausgehenden Ordnern lösche?** Die Dateien sind in den `lead-outbound-archive` Ordnern `opportunity-outbound-archive` und verfügbar. **F: Was mache ich, um Unterstützung bei der Entwicklung zu erhalten?** Wenn Sie Unterstützung bei der Entwicklung benötigen, wenden Sie sich an den AWS Partner Network (APN) -Support in Partner Central. **F: Was ist der Unterschied zwischen `opportunityOwnerName` und`opportunityOwnerEmail`?** + `opportunityOwnerName`: Der Name des Opportunity-Inhabers in der Partnerorganisation. Dies muss ein Partner Central-Benutzer sein. + `opportunityOwnerEmail`: Die E-Mail-Adresse des Opportunity-Inhabers in der Partnerorganisation. Dies muss ein Partner Central-Benutzer sein. Falls nicht angegeben, wird die Opportunity mit dem Partner Central Alliance Lead als Eigentümer erstellt. **F: Was ist die Zeitzone für alle Datumsfelder (`targetCloseDate``lastModifiedDate`,`createdDate`, und`acceptBy`)?** Die Zeitzone für die Datumsfelder ist Greenwich Mean Time (GMT). **F: Sind die eingehenden JSON-Dateien versioniert?** Nein. Amazon Web Services (AWS) unterstützt keine Versionsverwaltung der Dateien. APN Customer Engagement (ACE) verarbeitet die Datei unmittelbar nach dem Empfang und löscht sie nach erfolgreicher Verarbeitung. Wenn wir denselben Dateinamen erneut erhalten, wird er abgelehnt. **F: Welche Felder in der JSON-Datei von Amazon Simple Storage Service (Amazon S3) geben das Erstellungs- und Datum der letzten Aktualisierung eines bestimmten Leads und einer bestimmten Opportunity an?** `createdDate` und `lastModifiedDate`. **F: Wie stellen Sie fest, ob es sich bei einer Opportunity um eine neue oder bestehende Opportunity handelt?** Das Feld `PartnerCrmUniqueIdentifier` ist eine eindeutige Kennung für jede Opportunity, die wir vom Partner benötigen. Diese Kennung muss im Quell-CRM des Systems des Partners definiert werden. Wir verwenden dies, um festzustellen, ob eine Gelegenheit in besteht AWS. Falls sie existiert, aktualisieren wir die Opportunity mit den geteilten Informationen. Wenn nicht, schaffen wir eine neue Opportunity. Wenn wir Daten an den Partner senden, schließen wir `PartnerCrmUniqueIdentifier` sowohl als auch mit ein`apnCrmUniqueIdentifier`. Wenn die Opportunity, die von geteilt wurde, zum ersten Mal gesendet AWS wird, wird dir kein Wert für angezeigt`PartnerCrmUniqueIdentifier`. Dies hilft Ihnen, die Opportunity als neu von ACE zu behandeln. Sobald Sie es in Ihr CRM aufgenommen haben, senden Sie die Updates sowohl mit als auch `PartnerCrmUniqueIdentifier` an uns zurück. `apnCrmUniqueIdentifier` **F: Ist es möglich, mehr als eine ausgehende JSON-Datei und eine Ergebnisdatei in Amazon S3 zu haben?** Ja. Manchmal generieren wir möglicherweise mehr Dateien im Ausgangsordner. Ebenso verarbeiten wir Dateien, die Sie an den Eingangsordner senden, und behalten die Ergebnisdateien im Ergebnisordner. Sie müssen die Ergebnisdateien nach der Verarbeitung kennzeichnen oder löschen. **F: Enthält die ausgehende Datei mehr als einen Datensatz?** Ja. Die ausgehende Datei kann mehrere Datensätze enthalten. **F: Was passiert, wenn 20 eingehende Opportunities in einer einzigen JSON-Eingabedatei im Abschnitt „Opportunities“ gesendet werden und eine der Opportunities nicht dem APN-Standard entspricht?** Wenn das Format falsch ist, wird unabhängig von der Groß- und Kleinschreibung die gesamte Datei abgelehnt. Wenn das Format korrekt ist, aber nur eine Opportunity auf unserer Seite nicht verarbeitet werden kann, enthält die Ergebnisdatei alle 20 Opportunities und ihren Status sowie die Fehlermeldung für die fehlgeschlagene Opportunity. **F: Was sind die wichtigsten Attribute, anhand derer überprüft werden muss, ob die JSON-Datei erfolgreich verarbeitet wurde?** Dies sind die wichtigsten Attribute, anhand derer Sie nachvollziehen können, ob die JSON-Datei erfolgreich verarbeitet wurde. ``` { "inboundApiResults": [ { "warnings": null, // no warnings "partnerCrmUniqueIdentifier": "XXXX", //uniqueId from Partner side "isSuccess": true, // file successfully processed "errors": null, //no errors reported "apnCrmUniqueIdentifier": "OXXXX" //uniqueId from AWS side } ] } ``` **F: Was passiert, wenn ich eine ungültige JSON-Datei sende?** Sie erhalten diese Fehlerantwort: "`[{input JSON}]`ist nicht vom Typ`object`“. **F: Wie viele lead/opportunity Datensätze können in einer einzelnen eingehenden JSON-Datei enthalten sein?** Eine Datei kann maximal 50 Datensätze enthalten. # Häufig gestellte technische Fragen — Amazon S3 **F: Wo finde ich die REST-API-Dokumentation für Amazon Simple Storage Service (Amazon S3)?** Weitere Informationen finden Sie in der [Amazon S3 S3-REST-API-Einführung](https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html). **F: Wie erhalte ich die Amazon Web Services AWS Key Management Service (AWS KMS) -Schlüsseldetails, um mich für den Zugriff auf den Amazon S3 S3-Bucket zu authentifizieren?** AWS Partner Network (APN) verwendet eine gemeinsame Richtlinie, die den Schlüsselnamen enthält. **F: Wie authentifiziere ich Amazon S3 von Salesforce.com (SFDC) aus?** Verwenden Sie die Beispielcodedatei [S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls), um Amazon S3 von SFDC aus zu authentifizieren. **F: Wie lade ich die Datei aus dem AWS Software Development Kit (SDK) auf S3 hoch?** Verwenden Sie den folgenden AWS CLI-Befehl, um die Datei auf S3 hochzuladen. ``` aws s3 cp example.json s3://awsexamplebucket/opportunity- inbound/filename.json --acl bucket-owner-full-control ``` Die Beispielcodedatei [Sample\$1 AceOutboundBatch .cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls) enthält Code zum Hochladen der Datendatei von SFDC. **F: Wem gehört der Amazon S3 S3-Bucket?** AWS besitzt und verwaltet den Amazon S3 S3-Bucket. Sie haben programmgesteuerten Zugriff auf Ihren eigenen Amazon S3 S3-Bucket mit dem AWS Identity and Access Management (IAM-) Benutzer. **F: Gibt es separate Ordner oder Buckets für das Empfangen und Senden von Dateien?** Es gibt einen Bucket mit verschiedenen Ordnern zum Empfangen und Senden der Dateien. Weitere Informationen zu den Ordnern finden Sie im Benutzerhandbuch. **F: Muss ich über AWS Lambda das Customer Relationship Management (CRM) -System auf den Amazon S3 S3-Bucket zugreifen, oder kann ich direkt darauf zugreifen?** Sie können auf beide Arten darauf zugreifen. **F: Ist der Amazon S3 S3-Bucket gesichert oder verschlüsselt?** Ja. Wir aktivieren den standardmäßigen Verschlüsselungsmechanismus, den Amazon S3 bietet. **F: Ist es möglich, Amazon Simple Notification Service (Amazon SNS) zu aktivieren, der den Amazon S3 S3-Bucket abhört, sodass ich nur auf das Ereignis reagieren kann, anstatt regelmäßig Abfragen durchzuführen?** Nein. Derzeit unterstützt APN Customer Engagement (ACE) diese Funktion nicht. **F: Auf welche Ordner habe ich Zugriff und welchen Zweck haben die einzelnen Ordner?** Die Liste der Amazon S3 S3-Ordner finden Sie unter[Voraussetzungen für die Integration](crm-integration-setting-up.md). # Häufig gestellte technische Fragen — Leads und Möglichkeiten ## Senden und Empfangen von Leads und Opportunities **F: Gibt es eine Konvention zur Benennung von Dateien?** Jeder Dateiname muss eindeutig sein. Wir empfehlen den Dateinamen`PartnerProvided FileName+{timestamp}.json`. **F: Wie ist die Struktur der Ergebnisse?** Beispieldateien für die Ergebnisse (Erfolg und Fehler) können von den folgenden Orten heruntergeladen werden: + [Erfolgreiche Ergebnisse \$1 Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json) + [Geschäftschance — Ergebnisse — Erfolg — Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json) + [Erste Ergebnisse mit Fehlern Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results_With-Errors-Sample.json) + [Geschäftschancen bei Fehlern Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results_With-Errors-Sample.json) **F: Wie lautet die Benennungskonvention für die Ergebnisse?** `PartnerProvidedFileName_result.json` **F: Was ist, wenn ich eine zweite JSON-Datei mit demselben Namen einreiche?** Wir werden die Datei nicht verarbeiten und die Datei wird in den Archivordner verschoben. **F: Was ist die Größenbeschränkung für eingehende Dateien?** Die Größenbeschränkung für eingehende Dateien beträgt 1 MB. **F: Gibt es eine maximale Anzahl von Opportunities und Leads, die in einer JSON-Datei gebündelt werden können?** Angesichts des Limits von 1 MB empfehlen wir, dass Sie eine Opportunity oder einen Lead pro Datei haben. **F: Ich erhalte die Fehlermeldung „Zugriff verweigert“, sodass ich die Dateien nicht hochladen kann. Was soll ich tun?** Partner erhalten aus zwei Gründen die Meldung *Zugriff verweigert*. 1. Sie haben die Datei in den `outbound` Ordner statt in den `inbound` Ordner hochgeladen. Laden Sie die Datei in den `inbound` Ordner hoch. 1. Sie müssen eine Zugriffskontrollliste (ACL) bereitstellen. Verwenden Sie den folgenden Amazon Web Services (AWS) CLI-Befehl, um die Datendatei hochzuladen: ``` aws s3 cp example.json s3://awsexamplebucket --acl bucket-owner-full-control ``` **F: Was passiert, wenn Dateien mit Erweiterungen wie `.pdf``.docx`, oder etwas anderem als hochgeladen `.json` werden?** Wir lehnen die Dateien ab und generieren eine `*.error.json` Datei mit den Angaben zum Grund. **F: Was mache ich, wenn ich in der Produktion eine Fehlermeldung mit einem Datenproblem erhalte?** 1. Wenn die Daten im Customer Relationship Management (CRM) -System des Partners korrigiert werden müssen, senden Sie die überarbeitete Datei nach der Korrektur der Daten an Amazon Simple Storage Service (Amazon S3). 1. Wenn zu den Daten weitere Informationen erforderlich sind, wenden Sie sich an Ihren Partner Development Manager (PDM). 1. Falls Sie weiteren technischen Support benötigen, wenden Sie sich bitte an einen AWS Partner Network (APN-) Support-Fall im APN-Portal. **F: Wo finde ich die Ergebnisdateien und wie lange sind sie verfügbar?** Die Ergebnisdateien befinden sich in den `opportunity-inbound-results` Ordnern `lead-inbound-results` und. Sie sind verfügbar, bis Sie sie löschen. Sie können die Dateien nach erfolgreichem Abrufen löschen. **F: Wenn ich nach dem Löschen eine Ergebnisdatei suchen muss, wo können wir sie finden?** Sie finden die Ergebnisdateien in den `opportunity-inbound-results-archive/YYYY/MM/DD` Ordnern `lead-inbound-results-archive/YYYY/MM/DD` und. **F: Wie werde ich benachrichtigt, wenn bei der APN-Verarbeitung der Datei ein Fehler auftritt?** APN verfügt über Alarme, die automatisch Sev2-Tickets erstellen, um die Verarbeitungsfehler nachzuverfolgen. Wir prüfen, lösen diese und teilen sie unseren Partnern mit. **F: Welche Felder können aktualisiert werden, nachdem die Opportunity veröffentlicht wurde?** Die folgenden Felder können nur von Accelerate-Partnern von unabhängigen Softwareanbietern (ISV) aktualisiert werden: + `isThisForMarketplace` + `isNetNewBusinessForCompany` + `deliveryModel` + `awsFieldEngagement` + `additionalComments` **F: Ich habe die Fehlermeldung *Datensatz kann nicht bearbeitet* werden erhalten. Was bedeutet das?** Wenn Sie einem neuen Partner eine empfohlene Verkaufschance senden, durchläuft diese den Validierungsprozess und das APN Customer Engagement (ACE) -Team muss sie genehmigen oder ablehnen. Solange die Opportunity geprüft wird und noch nicht validiert wurde, können Sie den Datensatz nicht aktualisieren und erhalten diese Fehlermeldung. **F: Was passiert, wenn auf meiner Seite keine Aktivität stattfindet (Beispiel: Ich bearbeite die Datei nicht oder sende keine eingehende Verkaufschance)?** Wenn Sie keine Informationen senden oder die von uns bereitgestellten Dateien nicht verarbeiten, verfügen wir derzeit nicht über einen Mechanismus, um Sie zu benachrichtigen. Wir empfehlen Ihnen, Ihr System zu überwachen, um sicherzustellen, dass die Informationen an APN weitergeleitet werden. **F: Wie schnell sind die JSON-Ergebnisse nach der Einreichung einer new/updated eingehenden Opportunity/eines Leads im Ergebnisordner verfügbar?** Die Verarbeitung erfolgt fast in Echtzeit. Sie sollten die Dateien in weniger als fünf Minuten erhalten. **F: Wie geht das System damit um, wenn ich ein Inbound-Opportunity-CRM sende, das nicht den format/length Einschränkungen des APN-Standards entspricht? Generiert es den Fehlerbericht?** Wenn die Datei nicht im Felddefinitionsformat vorliegt, ruft die Ergebnisdatei von APN die Datei auf. **F: Ich habe zum Zeitpunkt des Starts keine AWS Konto-ID. Was mache ich?** Gemäß dem ACE-Prozess `Launched` bedeutet dies, dass die Arbeitslast abgeschlossen und die Abrechnung gestartet wurde. Dies erfordert eine AWS Konto-ID. Weitere Informationen finden Sie im [ACE-Programm FAQs](https://partnercentral.awspartner.com/partnercentral2/s/resources?Id=0690h000003xjjXAAQ). **F: Wie sollten die historischen Daten nach dem User Acceptance Testing (UAT) während der Umstellung auf die Produktion behandelt werden?** Wenn Aktualisierungen in ACE vorgenommen werden, senden wir diese Opportunities standardmäßig an den Amazon S3 S3-Bucket. Für historische Daten, die Sie nicht verarbeiten möchten, müssen Sie Dummy-Werte angeben, z. B. `X0001, X0002….X000N` im Extrakt für das, was Sie in Ihrem System nicht verarbeiten möchten. `partnerCrmUniqueIdentifier` Sie müssen Code schreiben, um diese Identifikatoren zu erkennen und sie entsprechend zu verarbeiten. Die übrigen Möglichkeiten bieten den richtigen `partnerCrmUniqueIdentifier` Wert. Dadurch wird sichergestellt, dass Sie die volle Kontrolle darüber haben, was in Ihrem System verarbeitet werden soll und was nicht. **F: Enthält die ausgehende Datei mehr als einen Datensatz?** Ja. Die ausgehende Datei kann mehr als einen Datensatz enthalten. **F: Warum senden die Daten bei einigen Feldern *Accept zur Ansicht*?** Bei einer AWS empfohlenen Verkaufschance oder einem Lead sind alle PII-Felder mit der Bezeichnung „*Akzeptieren“ maskiert, sodass sie angezeigt werden können*, bis die Verkaufschance oder der Lead von Ihnen akzeptiert wird. Nach der Annahme erhalten Sie im nächsten Synchronisierungszyklus alle Datenfelder. **F: Was mache ich, wenn eine neue empfohlene AWS Opportunity oder ein neuer Lead zum ersten Mal synchronisiert wird?** Wenn eine neue Verkaufschance oder ein neuer Lead zum ersten Mal synchronisiert wird, müssen Sie ihn annehmen oder ablehnen, um zusätzliche Daten zu erhalten (Beispiel: Kundenkontakte). ## Opportunitäten/Leads erstellen und aktualisieren **F: Wie kann ich im Rahmen der Integration neue Geschäftschancen, die *vom Partner empfohlen werden, in ACE* integrieren?** Um durch die Integration neue Opportunities in ACE zu erstellen, müssen Sie die erforderlichen Opportunity-Informationen im definierten JSON-Format in den `opportunity-inbound` Ordner aufnehmen. AWS verarbeitet diese Informationen, erstellt eine neue Opportunity in ACE und gibt die Ergebnisse eines successful/failed Erstellungsvorgangs im `opportunity-inbound-processed-results` Ordner weiter. **F: Wie unterscheidet die Integration zwischen der Einreichung neuer Geschäftschancen und den Aktualisierungen?** Das Feld `PartnerCrmUniqueIdentifier` für jede Opportunity ist ein erforderliches eindeutiges Identifikationsmerkmal. Diese Kennung muss im Quell-CRM Ihres Systems definiert sein. AWS verwendet dies, um festzustellen, ob in ACE bereits eine Opportunity vorhanden ist. Wenn sie in ACE verfügbar ist, verwenden wir die geteilten Informationen, um die Opportunity zu aktualisieren. Wenn sie jedoch nicht in ACE verfügbar sind, verwenden wir die geteilten Informationen, um eine neue Opportunity zu erstellen. **F: Wenn ich die Aktualisierungsfunktion bereits über die Integration implementiert habe, was muss ich tun, um mithilfe der Integration neue Opportunities einzureichen (zu erstellen)?** Sie müssen die folgenden Änderungen an der bestehenden Integration vornehmen: 1. Fangen Sie an, neue Gestaltungsmöglichkeiten in den `opportunity-inbound` Ordner aufzunehmen. Stellen Sie Updates im selben Ordner bereit. 1. Stellen Sie sicher, dass die für die Erstellung erforderlichen Pflichtfelder in der gemeinsamen Opportunity-JSON-Datei verfügbar sind. 1. Stellen Sie sicher, `PartnerCrmUniqueIdentifier` dass jede neue Opportunity ein Unikat hat, das es in ACE/Partner Central nicht gibt. Eine wichtige bewährte Methode für die Markteinführung besteht darin, die vorhandenen Daten in ACE den einzelnen Daten `PartnerCrmUniqueIdentifier` in Ihrem CRM zuzuordnen und zu aktualisieren, damit wir keine Duplikate erstellen, wenn wir Updates erhalten. Wenn Sie Unterstützung benötigen, wenden Sie sich an ACE. **F: Wie aktualisiere ich im Rahmen des Go-Live-Prozesses bestehende Opportunities in ACE mit meinem? `PartnerCrmUniqueIdentifier`** Das ACE-Team stellt Ihnen eine Liste aller offenen Möglichkeiten zur Verfügung, um Sie bei der Vorbereitung auf den Produktionsstart zu unterstützen. Sie müssen diese vorhandenen Möglichkeiten in ACE ihren jeweiligen `PartnerCrmUniqueIdentifier` Möglichkeiten zuordnen und die aktualisierte Datei zur Integration in AWS das CRM an ACE zurücksenden. Wenn Sie sich dafür entscheiden, nur einen Teil der angebotenen Möglichkeiten zu synchronisieren, AWS müssen Sie eine Logik entwickeln, um AWS Aktualisierungen für alle Opportunities zu umgehen, die Sie nicht verarbeiten möchten. Dieser Ansatz sollte auch auf future Möglichkeiten nach dem Onboarding angewendet werden. Sie müssen die damit verbundenen Möglichkeiten angeben, `partnerCrmUniqueIdentifier` die beide aufeinander abstimmen müssen. CRMs Darüber hinaus sollten Sie angeben, welche Opportunities Sie nicht aktualisieren werden (Beispiel: Markieren von abgeschlossenen, verlorenen oder abgeschlossenen Opportunities), um sie von Aktualisierungen auszuschließen. Es ist wichtig, dass allen offenen/aktiven Opportunities, die Sie AWS teilen und die Sie annehmen, eine zugewiesen wird. `partnerCrmUniqueIdentifier` **F: Kann ich nur bestimmte Felder in der Opportunity oder im Lead aktualisieren?** Ja. Sie können nur die Felder angeben, die aktualisiert werden müssen, zusammen mit den erforderlichen Kennungen. **F: Ist es möglich, das zu ändern? *ApnCrmUniqueIdentifier*** Nein. Diese Kennung bleibt für jede Opportunity konstant AWS und identifiziert sie eindeutig. **F: Was ist, wenn ich eine falsche *partnerCrmUniqueKennung eingebe***? Wenn Sie eine falsche ID angeben, wird eine neue Opportunity erstellt. Sorgen Sie für Genauigkeit, um Datenduplikationen zu vermeiden. **F: Kann ich die AWS eingereichten Stellenangebote aktualisieren?** Ja. Sie können AWS eingereichte Opportunities mit der richtigen Option aktualisieren`partnerCrmUniqueIdentifier`. **F: Wie schnell kann ich mit Ergebnissen für eingereichte Stellenangebote rechnen?** Die Verarbeitung erfolgt fast in Echtzeit, und die Ergebnisse sind normalerweise innerhalb weniger Minuten im `opportunity-inbound-processed-results` Ordner verfügbar. **F: Was kann ich tun, wenn bei eingereichten Opportunities Verarbeitungsfehler auftreten?** Überprüfen Sie die Fehlerdetails in den Ergebnisdateien, beheben Sie Probleme und wenden Sie sich an das ACE-Supportteam, um weitere Unterstützung zu erhalten. **F: Kann ich eine Opportunity über die Integration löschen?** Nein. Direktes Löschen wird nicht unterstützt. Sie können eine Opportunity so aktualisieren, dass sie den Status „*Geschlossen*“ anzeigt. **F: Was bedeutet der Fehler „*Datensatz nicht editierbar*“?** Dieser Fehler tritt auf, wenn Sie versuchen, eine Opportunity in ACE Review zu aktualisieren. Diese Opportunities können erst bearbeitet werden, wenn sie validiert wurden. **F: Was ist, wenn ich keine Updates oder neuen Opportunities sende?** Es werden keine neuen Daten empfangen und verarbeitet, wenn Sie im Rahmen der Integration keine Updates oder neue Opportunities versenden. **F: Wie lange sind die Ergebnisdateien verfügbar?** Die Ergebnisdateien sind für einen angemessenen Zeitraum verfügbar. Sie sollten sie umgehend abrufen und verwalten. # Häufig gestellte technische Fragen — Versionierung und Abwärtskompatibilität **F: Was ist eine Nutzlast beim Datenaustausch mit Amazon Web Services (AWS)?** Eine Nutzlast ist ein strukturiertes, in JSON formatiertes Datenelement, das entweder eingehend oder ausgehend gesendet AWS wird. AWS*Jeder Schlüssel in dieser JSON-Struktur wird als Feld bezeichnet, und jedem *Feld* ist ein Wert zugeordnet.* **F: Wie wird die Payload-Version bestimmt?** Die Payload-Version wird im `version` Feld der Payload selbst angegeben. Payloads, die der Felddefinition v13 entsprechen, werden als Payload-Version 1.0 betrachtet, während Payloads, die dem in der Felddefinition v14 oder höher definierten Format folgen, als Payload-Version 2.0 bezeichnet werden. **F: Was bedeutet Abwärtskompatibilität in diesem Zusammenhang, und wie wird damit umgegangen?** Die Abwärtskompatibilität stellt sicher, dass bestehende Möglichkeiten nicht scheitern, wenn in neueren Payload-Versionen neue und obligatorische Felder eingeführt werden. AWS behält dies bei, indem Feldern, die in der neuen Version erforderlich sind, automatisch Standardwerte zugewiesen werden. Möglicherweise fallen Ihnen Werte in der Benutzeroberfläche AWS Partner Network (APN) Customer Engagement (ACE) auf, die Sie nicht ausdrücklich über die Customer Relationship Management (CRM) -Integration angegeben haben. Details und Bedingungen für jedes Feld werden in der Feldbeschreibung oder in zusätzlichen Details zum Feld erklärt. **F: Ist Abwärtskompatibilität eine permanente Funktion?** Nein. Die Abwärtskompatibilität ist zeitgebunden und soll Ihnen Flexibilität bei der Planung und Implementierung bevorstehender Änderungen bieten. Nach einem bestimmten Stichtag, der im Laufe des Jahres im Rahmen einer umfassenderen Markteinführung bekannt gegeben wird, funktioniert es nicht mehr. **F: Was passiert, wenn ich mit Version 2.0 anfange, Payloads zu senden?** Sobald Sie eine Payload mit Version 2.0 senden, geht das System davon aus, dass alle erforderlichen Änderungen implementiert wurden, und die Validierungen für die neue Payload-Version gelten für alle nachfolgenden Änderungen. Es ist wichtig, dass Sie Funktionen nicht teilweise zwischen den Payloads der Versionen 1.0 und 2.0 implementieren. **F: Kann ich nach dem Update auf Version 2.0 zur Payload-Version 1.0 zurückkehren?** Nein. Der Übergang zur Payload-Version 2.0 ist ein einseitiger Prozess. Nach dem Update auf Version 2.0 können Sie nicht mehr zur Version 1.0 der Payload zurückkehren.