Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Mise à niveau d'Amazon S3 vers API-based l'intégration
Note
Les rubriques de cette section partent du principe que vous avez rempli les conditions requises pour une intégration AWS Partner Central, une intégration AWS Marketplace, ou les deux. Pour plus d'informations, reportez-vous à Prérequis pour l'intégration et Prise en main plus tôt dans ce guide.
Recommandé : effectuez d'abord ces activités dans un environnement Sandbox, effectuez des tests approfondis, puis déployez en production.
Cette section explique comment passer d'Amazon à l' API-based intégration de votre connecteur CRM S3-based pour AWS partenaires. L' API-based intégration remplace l'ancien modèle de compartiment Amazon S3 par une synchronisation bidirectionnelle en temps réel via des rôles IAM et des API.
Pour une présentation entièrement interactive avec des captures d'écran, consultez l'atelier de mise à niveau du AWS Partner CRM Connector
La mise à niveau implique les étapes suivantes :
Conditions préalables
Ordre de migration des opérations
Les partenaires demandent souvent s'ils souhaitent migrer vers la nouvelle expérience Partner Central dans la AWS console ou passer d'Amazon S3 à l'API dans un premier temps. Voici l'approche recommandée :
| Scénario | Recommendation |
|---|---|
| Actuellement sur Amazon S3, mais pas encore sur la nouvelle expérience Partner Central | Migrez d'abord vers l'API, puis migrez vers la nouvelle expérience Partner Central en parallèle ou ultérieurement |
| Actuellement sur Amazon S3, déjà sur la nouvelle expérience Partner Central | Procédez directement à la migration des API |
| Déjà sur l'API, pas encore sur la nouvelle expérience Partner Central | Passez à la nouvelle expérience Partner Central à votre convenance |
L'association de comptes est la seule condition préalable
L'association de comptes est la seule condition préalable à la S3-to-API migration vers Amazon. La migration vers la nouvelle expérience Partner Central n'est PAS requise pour démarrer la mise à niveau de l'API.
Informations clés :
Les S3-based intégrations Amazon sont obsolètes et ne sont plus disponibles pour les nouveaux utilisateurs.
Les partenaires d'Amazon S3 doivent prévoir de terminer la migration vers l'API dès que possible afin d'éviter toute dégradation du service.
Consultez la documentation relative à l'intégration CRM pour les AWS partenaires pour obtenir les dernières informations sur la fin de vie du backend Amazon S3.
Assurez-vous que Partner Central est lié à un AWS compte
Le S3-based connecteur Amazon s'est authentifié à l'aide d'autorisations sur un compartiment Amazon S3 géré dans le compte AWS de gestion. Le API-based connecteur s'authentifie plutôt via des rôles IAM sur le AWS compte associé du partenaire pour appeler directement les API Partner Central. C'est pourquoi l'association de comptes est une condition technique préalable : sans elle, le connecteur n'a aucun moyen d'accéder aux API Partner Central avec les autorisations nécessaires.
Pourquoi cela pourrait manquer
Lors de la AWS publication de l'API Partner Central pour la vente en novembre 2024, l'association de comptes a été introduite pour permettre aux partenaires d'accéder à ces API par programmation. À partir de la version 3.0 du connecteur (également novembre 2024), l'association de comptes est devenue une exigence pour la API-based synchronisation. Les partenaires qui ont configuré leur S3-based connecteur Amazon avant cette date n'auraient pas finalisé l'association de leur compte.
Associez votre compte Partner Central à votre AWS compte principal. Choisissez votre compte avec soin dès le départ. Bien qu'il soit possible de dissocier et de réassocier un autre compte, cela crée des problèmes de persistance des données et nécessite des efforts de rapprochement manuels.
Règles de sélection des comptes : le AWS compte doit être :
Un compte payant en règle (pas de niveau gratuit)
Détenu par la société du partenaire (pas le compte d'un distributeur)
Disposer d'une adresse de facturation correspondant à l'adresse commerciale principale du partenaire
IL NE S'AGIT PAS d'un bac à sable, d'un développeur, d'un compte personnel ou d'un compte management/payer
L'association des comptes est permanente
L'association des comptes est permanente après la migration de Partner Central vers la AWS console. Toutes les ressources APN (opportunités ACE, historique, invitations multipartenaires) sont liées de manière permanente à ce compte. Choisissez avec soin.
Ressources :
Section relative à la création de liens entre les comptes de l'atelier de mise à niveau
sur le site Web d'AWS Workshops Conditions requises pour associer des comptes et politique IAM
Dissocier les comptes
sur le site Web de Partner Central
Facultatif : migrez vers la nouvelle expérience Partner Central dans AWS Console
Cette étape n'est pas requise pour la mise à niveau S3-to-API du connecteur Amazon. L'association de comptes fournit à elle seule les API-based fonctionnalités nécessaires. Cependant, la migration vers la nouvelle expérience Partner Central permet à votre équipe d'accéder à des fonctionnalités supplémentaires :
Agents centraux partenaires (Co-Sell agent, agent de financement, prospection autonome)
Une expérience de AWS console centralisée pour gérer les activités des partenaires parallèlement à vos AWS ressources
Visibilité améliorée des événements liés au cycle de vie des opportunités, directement depuis la console
Modification du format de l'ID de solution
Si vous migrez vers la nouvelle expérience Partner Central, puis créez de nouvelles solutions, celles-ci utiliseront le nouveau soln-* format. Le connecteur CRM ne prend pas encore en charge ce format ; il nécessite l'ancien S-* format pour le solutionOffered champ. Les solutions existantes créées avant la migration conservent le S-* format et continuent de fonctionner.
Consultez le guide de migration de Partner Central pour plus de détails.
Pre-migration nettoyage des données
Avant de commencer la migration, assurez-vous de bien S3-based intégrer Amazon. L'étape la plus critique consiste à supprimer les tâches planifiées persistantes qui peuvent interférer avec le API-based connecteur et le processus de remplissage.
Lorsque vous désactivez les planifications Amazon S3 via l'interface utilisateur du connecteur, les tâches planifiées Salesforce sous-jacentes (avec le préfixe APN) restent dans le système. S'ils sont toujours présents lorsque vous démarrez le remplissage ou que vous activez la API-based synchronisation, l'ancien planificateur et le nouveau connecteur peuvent écrire simultanément dans les mêmes enregistrements, ce qui entraîne la création de doublons d'opportunités ou des conflits de données.
La désactivation dans l'interface utilisateur n'est pas suffisante
Il ne suffit pas de désactiver les planifications dans l'interface utilisateur du connecteur. Vous devez également supprimer les entrées de tâches planifiées sous-jacentes dans Salesforce Setup. Voir Vérifiez et désactivez les planifications pour Amazon S3 l'intégralité des étapes à suivre.
Configuration AWS infrastructure
Cette phase nécessite qu'un administrateur Salesforce travaille avec un administrateur informatique cloud pour configurer deux nouveaux composants : une application cliente externe Salesforce et des composants d' AWS infrastructure (EventBridge règles et rôles IAM).
Configuration de l'application client externe Salesforce
Avec la version Amazon S3, les deux directions de synchronisation passaient par un compartiment Amazon S3 partagé par partenaire. La version de l'API inverse cette option pour les mises à jour entrantes : Partner Central transmet désormais les événements directement à votre organisation en temps réel via. EventBridge L'application client externe active un flux d'informations d'identification client OAuth 2.0 afin de EventBridge pouvoir envoyer des notifications au fur et à mesure.
L'administrateur Salesforce doit suivre les instructions de la section
Configuration AWS components
L' AWS infrastructure de la version de l'API comprend :
EventBridgepour le traitement des événements en temps réel
Rôles IAM pour une authentification sécurisée
Ces composants remplacent le modèle d'accès au compartiment Amazon S3 utilisé dans la version précédente.
L'administrateur informatique du cloud doit déployer le CloudFormation modèle en suivant les instructions de la section
Finaliser l'installation et la configuration dans Salesforce
Le reste de la configuration est effectué par un administrateur Salesforce. Terminez d'abord les activités dans Sandbox, testez, puis passez à la production.
Installez la dernière version du connecteur AWS Partner CRM depuis Salesforce AppExchange
Passez en revue et ajustez vos mappages
Avec la version Amazon S3, la synchronisation sortante reposait sur les Has Updates for AWS champs Sync with AWS et. Ils ne sont plus utilisés dans l' API-based intégration.
Dans la version API, la synchronisation sortante est contrôlée via le paramètre Activer le partage avec AWS intégration dans les paramètres personnalisés du AWS
Partner CRM Connector (Companion_App_Settings__c). Lorsque cette option est activée, les opportunités ACE sont automatiquement partagées avec AWS chaque fois qu'une mise à jour éligible est effectuée.
Points clés :
L'objet ACE Opportunity est recommandé comme zone d'atterrissage. Il correspond aux points de données sur les AWS opportunités dans Partner Central et permet le mappage automatique.
Si vous utilisiez déjà ACE Opportunity pour votre mappage d'intégration, la configuration sous-jacente ne change pas. Cependant, le package mis à jour introduit de nouveaux champs qui n'étaient pas présents dans les versions précédentes.
Passez en revue toutes les automatisations qui font référence aux anciens S3-era champs Amazon (
Sync_with_AWS__c,Has_Updates_for_AWS__c) pour utiliser les nouveaux équivalents.
Le modèle de données ACE Opportunity est disponible sur le GitHub site Web
La dernière version du connecteur inclut un modèle de flux pour vous aider à mapper votre opportunité standard à l'opportunité ACE. Pour plus de détails, consultez la section Modèles de flux.
Vérifiez et ajoutez les champs et boutons obligatoires
Le connecteur a introduit de nouveaux champs et boutons depuis la version 3.0+. Vous devez mettre à jour manuellement la mise en page de votre Lightning Record.
Ajoutez les boutons suivants à la page d'enregistrement ACE Opportunity Lightning :
| Button | Objectif |
|---|---|
| Partagez avec AWS | Transmet manuellement l'opportunité à Partner Central via une API. |
| Actualiser à partir de AWS | Extrait les dernières données de Partner Central dans cet enregistrement ACE Opportunity. |
| Accept/Reject | Acceptez ou rejetez les opportunités AWS recommandées. |
| Associate/Disassociate | Associez ou dissociez des solutions partenaires, des produits et des offres de marché AWS approuvés. |
| Assign | Réattribuez une opportunité à un autre utilisateur de votre compte Partner Central. |
Supprimez les anciens boutons suivants de la page d'enregistrement ACE Opportunity Lightning :
| Button | Raison |
|---|---|
| Envoyer à AWS | Remplacé par Partager avec AWS. |
| Lien vers l'offre privée | Remplacé par Associate/Disassociate. |
Ajoutez les boutons d'affichage de liste suivants à l'onglet ACE Opportunity :
Acceptez les opportunités : Bulk-accept plusieurs opportunités AWS recommandées.
Attribuez des opportunités — opportunités Bulk-reassign multiples.
Pour les nouveaux champs, passez en revue tous les champs ajoutés après la version 3.0 du connecteur
Vérifiez et désactivez les planifications pour Amazon S3
Grâce à API-based cette approche, les tâches planifiées ne sont plus nécessaires : l'intégration s'effectue en temps réel.
Pour désactiver les tâches planifiées
Accédez à l'onglet Horaires de l'application AWS Partner CRM Connector.
Choisissez Désactiver toutes les tâches, puis sélectionnez Désactiver à nouveau.
Supprimez également les enregistrements planifiés. Pour supprimer les tâches planifiées APN restantes de l'installation, procédez comme suit :
Pour supprimer les tâches planifiées APN de la configuration
Accédez à Configuration. Recherchez « Planifié » et sélectionnez Travaux planifiés.
Consultez la liste pour toutes les APN-related offres d'emploi. Choisissez Del pour les supprimer.
Continuez à CustomLogInteractionBatch courir
Continuez à exécuter le CustomLogInteractionBatch travail (AppExchange App Analytics).
Supprimez les tâches planifiées, ne vous contentez pas de les désactiver
Ne laissez pas les tâches dans l'état « Désactivé mais non supprimé ». Les tâches persistantes ont entraîné la création de doublons d'opportunités lorsqu'elles sont combinées à une synchronisation API-based en temps réel.
Nettoyage
Désactiver les anciennes règles de validation
Plusieurs règles de validation existantes doivent être désactivées et d'autres doivent rester actives. Consultez cette section de l'atelier
Assurez-vous également que les anciens flux suivants ont été désactivés :
Synchroniser ACE Opportunity avec l'API Partner Central
Recherche d'offres privées
Notification d'échec de synchronisation APN
Mise à jour du champ Offre privée sur ACE Opportunity
Mise à jour du champ Ace Opportunity dans l'enregistrement détaillé du journal de synchronisation
Flux Standard-ACE de synchronisation des opportunités unifié (modèle)
Testez votre procédé avant de passer à la production. Consultez les tests à partir des paramètres
Remplacement complet des opportunités de AWS vers Salesforce
Effectuez un remblai pour garantir la correspondance des données entre les environnements. Le awsapn__Last_Modified_Date__c champ de l'ACE Opportunity doit correspondre à la date de dernière modification dans Partner Central pour que les prochaines mises à jour soient synchronisées. L'intégration Amazon S3 n'a pas renseigné ce champ. Par conséquent, les opportunités migrant depuis Amazon S3 seront vides. Le remplissage le remplira.
Le remblai propose trois modes :
| Mode | Ce qu'il fait | Quand l’utiliser |
|---|---|---|
| Seules les opportunités d'actualisation sont manquantes. Date de dernière modification | Met à jour uniquement les awsapn__Last_Modified_Date__c enregistrements vides | Recommandé pour la S3-to-API migration vers Amazon |
| Uniquement AWS les opportunités de rafraîchissement qui existent déjà dans Salesforce | Met à jour tous les enregistrements qui possèdent déjà un identifiant APN CRM | Une alternative sûre pour la migration |
| Actualisez toutes les AWS opportunités | Intégre l'intégralité du pipeline Partner Central à Salesforce | À utiliser uniquement sur des installations fraîches |
Avant de procéder au remblayage :
Vérifiez que toutes les tâches planifiées APN sont supprimées (pas simplement désactivées).
Désactivez le flux « Synchroniser ACE Opportunity to Partner Central API » s'il est actif.
Désactivez Activer le partage avec AWS intégration dans les paramètres personnalisés (
Companion_App_Settings__c).Effectuez le nettoyage des données avant la migration décrit dans. Pre-migration nettoyage des données
Une fois le remblayage terminé :
Re-enable Activez le partage avec AWS intégration : cela permet une synchronisation continue.
Le flux « Sync ACE Opportunity to Partner Central API » n'a PAS besoin d'être réactivé.
Vérifiez qu'un échantillon d'enregistrements
awsapn__Last_Modified_Date__cest renseigné.
Pour plus de détails, consultez la section
Post-migration: Surveillance des EventBridge événements
Après la migration, votre organisation Salesforce reçoit des mises à jour en temps réel de Partner Central via. EventBridge Pour vérifier le bon déroulement des événements :
CloudWatch Métriques : Accédez à CloudWatch > Métriques > EventBridge. Vérifiez les invocations et FailedInvocations la destination de votre API.
Journaux de synchronisation Salesforce : sur n'importe quelle opportunité ACE, consultez la liste associée au journal de synchronisation pour les entrées entrantes récentes.
EventBridge Surveillance des règles : vérifiez la règle créée par le CloudFormation modèle pour les derniers événements correspondants.
| Symptôme | Cause probable | Résolution |
|---|---|---|
| Aucune mise à jour entrante dans Salesforce | Le jeton de l'application client externe a expiré | Re-authenticate l'application connectée ; vérifier les informations d'identification OAuth dans API Destination EventBridge |
| Les événements s'arrêtent après le travail | Délai d'expiration de la session Salesforce | Vérifiez l'état de santé de la destination de l'API EventBridge ; reconnectez-vous |
| Mises à jour partielles (certains champs sont manquants) | Inadéquation de la cartographie des champs | Mise à niveau vers la dernière version du connecteur ; vérification des mappages de champs |
Résolution des problèmes de migration courants
| Erreur/Symptôme | Cause profonde | Résolution |
|---|---|---|
FIELD_CUSTOM_VALIDATION_EXCEPTIONlorsque vous cliquez sur « Actualiser à partir de AWS » | Les anciennes règles de validation ne sont pas désactivées | Désactivez ACEOppNew_PreventUpdatesWhenPOSubmitted et ACEOpp_PreventUpdatesWhenPOSubmitted |
| Des opportunités dupliquées | Tâches planifiées persistantes ou plusieurs utilisateurs d'intégration | Supprimez TOUTES les tâches planifiées APN. Vérifiez qu'un seul utilisateur est en possessionAPN Business Admin. |
| Les enregistrements des journaux de synchronisation augmentent rapidement | Les enregistrements dont la validation échoue sont réessayés à chaque cycle | Identifiez les enregistrements défaillants à l'aide des journaux de synchronisation. Corrigez les champs obligatoires manquants. |
| Le remblai dépasse les limites de stockage | Trop d'enregistrements à la fois | Exécutez en petits lots. Surveillez le stockage. |
| « Actualiser à partir de AWS » affiche des données périmées | awsapn__Last_Modified_Date__cinadéquation | Re-run remplissage ciblé en utilisant « Seules les opportunités de rafraîchissement sans la date de dernière modification » |
| Les opportunités de Partner Central n'apparaissent pas | EventBridge problème de connexion ou partage automatique désactivé | Vérifiez EventBridge l'état de santé de l'API Destination. Vérifiez que « Activer le partage avec AWS intégration » est activé. |
Obtenir de l'aide
Si vous rencontrez des problèmes que les étapes précédentes ne peuvent pas résoudre :
Ouvrez un dossier d'assistance : Partner Central → Support → Ouvrir un nouveau dossier
→ Intégration CRM Assistance à la migration : pour les migrations complexes (plus de 500 opportunités, intégrations personnalisées ou incidents de production antérieurs), demandez une assistance complète par l'intermédiaire de votre responsable d'alliance.
