Práticas recomendadas

Reagindo aos eventos

Ao lidar com eventos da API do AWS Partner Central, certifique-se de que sua lógica de processamento seja idempotente para lidar com eventos duplicados. Em vez de fazer GetOpportunitychamadas imediatas para cada evento, considere agrupar ou buscar seletivamente os detalhes com base nas necessidades do seu aplicativo. Para operações ininterruptas, cuidado com as cotas.

Implementando um bloqueio otimista

O bloqueio otimista evita a substituição não intencional de dados durante atualizações simultâneas. Aqui está um cenário típico:

1. O parceiro recupera uma oportunidade de seu sistema de CRM.

2. O usuário A atualiza a oportunidade no AWS Partner Central.

3. O usuário B atualiza a mesma oportunidade ao mesmo tempo por meio da integração do CRM.

4. Se os dados mudarem, o sistema CRM tentará fazer o upload dos dados, mas retornará umConflictException.

5. O usuário analisa o erro e resolve manualmente os dados conflitantes.

Para evitar esse cenário, todas as UpdateOpportunitysolicitações devem incluir o LastModifiedDate parâmetro, que você pode obter das GetOpportunityações anteriores CreateOpportunityUpdateOpportunity, e. A atualização será bem-sucedida somente se LastModifiedDate corresponder ao nosso sistema. Caso contrário, você deve buscar a versão mais recente LastModifiedDate usando GetOpportunitye tentar novamente a atualização.

Sincronizando dados entre CRM e AWS Central de Parceiros

É essencial manter seu sistema sincronizado com os dados mais recentes do Partner Central. A seguir estão duas estratégias para garantir que seu sistema reflita os dados mais recentes:

Usando eventos (recomendado)

1. Carregue dados usando ListOpportunities.

2. Inscreva-se em eventos de oportunidades.

3. Responda a novas oportunidades ou mudanças.

   • Quando você recebe Opportunity CreatedOpportunity Updated, ou Engagement Invitation Accepted eventos, use GetOpportunity para buscar os dados mais recentes.

   • Ao receber Engagement Invitation Rejected eventos, remova as oportunidades correspondentes.

Usando a ListOpportunities enquete

1. Carregue dados usando ListOpportunities.

2. Escolha uma frequência de pesquisa, garantindo que ela não seja muito frequente para evitar esgotar sua cota de leitura diária.

3. Identifique os dados mais recentes LastModifiedDate de seus dados armazenados, garantindo que sejam originários de AWS.

4. Use o timestamp no AfterLastModifiedDate filtro ao ligar. ListOpportunities

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

5. AWS retornará oportunidades criadas ou atualizadas após o valor indicado no timestamp.

6. Repita todas as páginas retornadas usando NextToken e atualize os dados do seu sistema usando GetOpportunity.

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