View a markdown version of this page

Bonnes pratiques - AWS Partner Central
Réagir aux événementsMettre en œuvre un verrouillage optimisteSynchronisation des données entre CRM et AWS Partner Central

La référence AWS Partner Central d'API a été restructurée. Pour plus d'informations sur les opérations d'API prises en charge, consultez la référence des AWS Partner Central API.

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.

Bonnes pratiques

Réagir aux événements

Lorsque vous gérez des événements depuis l'API AWS Partner Central, assurez-vous que votre logique de traitement est idempotente pour gérer les événements dupliqués. Au lieu de passer des GetOpportunityappels immédiats pour chaque événement, pensez à regrouper ou à récupérer les détails de manière sélective en fonction des besoins de votre application. Pour des opérations ininterrompues, méfiez-vous des quotas.

Mettre en œuvre un verrouillage optimiste

Le verrouillage optimisé empêche le remplacement involontaire des données lors de mises à jour simultanées. Voici un scénario typique :

  1. Le partenaire récupère une opportunité dans son système CRM.

  2. L'utilisateur A met à jour l'opportunité sur AWS Partner Central.

  3. L'utilisateur B met à jour la même opportunité en même temps grâce à l'intégration CRM.

  4. Si les données changent, le système CRM tente de les télécharger mais renvoie unConflictException.

  5. L'utilisateur examine l'erreur et résout manuellement les données contradictoires.

Pour éviter ce scénario, toutes les UpdateOpportunitydemandes doivent inclure le LastModifiedDate paramètre, que vous pouvez obtenir à partir des informations précédentes CreateOpportunityUpdateOpportunity, et GetOpportunityles actions. La mise à jour ne réussit que si elle LastModifiedDate correspond à notre système. Si ce n'est pas le cas, vous devez récupérer la dernière version GetOpportunityet LastModifiedDate réessayer la mise à jour.

Synchronisation des données entre CRM et AWS Partner Central

Il est essentiel de synchroniser votre système avec les dernières données de Partner Central. Voici deux stratégies pour garantir que votre système reflète les données les plus récentes :

Utilisation d'événements (recommandé)

  1. Chargez les données à l'aide de ListOpportunities.

  2. Abonnez-vous à des événements d'opportunité.

  3. Répondez aux nouvelles opportunités ou aux changements.

    • Lorsque vous recevez Opportunity Created ou que vous recevez Engagement Invitation Accepted des événements, utilisez GetOpportunity pour récupérer les dernières données. Opportunity Updated

    • Lorsque vous recevez Engagement Invitation Rejected des événements, supprimez les opportunités correspondantes.

Utilisation ListOpportunities du sondage

  1. Chargez les données à l'aide de ListOpportunities.

  2. Choisissez une fréquence d'interrogation, en veillant à ce qu'elle ne soit pas trop fréquente pour ne pas épuiser votre quota de lecture quotidien.

  3. Identifiez les données les plus récentes LastModifiedDate de vos données stockées, en vous assurant qu'elles proviennent de AWS.

  4. Utilisez l'horodatage dans le AfterLastModifiedDate filtre lorsque vous appelez. ListOpportunities

    {
   "FilterList": [
       {
           "Name": "AfterLastModifiedDate",
           "ValueList": [ "2023-05-01T20:37:46Z" ] // Replace with actual timestamp of your last synced data
        }
   ]
}

  5. AWS renverra les opportunités créées ou mises à jour après la valeur indiquée sur l'horodatage.

  6. Effectuez une itération sur toutes les pages renvoyées en utilisant NextToken et mettez à jour les données de votre système à l'aide GetOpportunityde.

    {
   "NextToken": "AAMA-EFRSN...PZa942D",
   "FilterList": [
       {
           "Name": "AfterLastModifiedDate",
           "ValueList": [ "2023-05-01T20:37:46Z" ] // Replace with actual timestamp of your last synced data
        }
   ]
}