

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Mapeando objetos ACE
<a name="crm-connector-mapping"></a>

O conector CRM fornece a página de **mapeamentos ACE**. A página permite mapear objetos e campos entre sua organização do Salesforce e AWS Partner Network (APN).

As seções a seguir explicam como criar mapeamentos de objetos.

**Topics**
+ [Usando a página Mapeamentos ACE](mapping-page.md)
+ [Mapeamento de vários objetos](multi-object-mappings.md)
+ [Mapeamento da lista de opções](picklist-mapping.md)
+ [Mapeando objetos ACE e Salesforce](#mapping-guidance)
+ [Sincronize registros e relatórios](crm-connector-sync-logs-and-reports.md)

# Usando a página Mapeamentos ACE
<a name="mapping-page"></a>

AWS O Partner Central fornece as seguintes formas de navegar até a página de **mapeamentos ACE**: 
+ No Iniciador de aplicativos, pesquise e escolha o conector **AWS Partner CRM.**
+ Escolha a guia **Mapeamentos ACE**.

  —OU—

  Escolha a guia **Configuração guiada** e, na seção **Mapear leads e oportunidades**, escolha **Iniciar** ou **Revisar**. 

Na página **Mapeamentos ACE**, use o painel de navegação esquerdo para alternar entre mapeamentos de oportunidades e leads. Use o **Seletor de objetos** para escolher o objeto de origem para mapear leads e oportunidades do APN. O seletor de objetos oferece suporte ao mapeamento de oportunidades padrão, objetos principais e objetos personalizados. Use os filtros **Mapping View** e **Type View** para alternar entre campos mapeados, campos não mapeados, campos obrigatórios e campos opcionais. 

Na página **Mapeamentos ACE**, a coluna **AWS Campos do objeto indica os campos** APN de destino correspondentes. Os campos **do Salesforce são campos** de origem do objeto selecionado na organização do parceiro. Os **campos do Salesforce** são filtrados para mostrar somente os tipos de dados aplicáveis disponíveis na organização a serem mapeados para o campo APN correspondente. Por exemplo, um campo de texto no APN só pode ser mapeado para um campo de texto (string) na organização do parceiro.

Os parceiros podem controlar as atualizações recebidas nos campos mapeados se não quiserem que um campo seja atualizado pela APN. **Para fazer isso, defina a **opção Ativar atualizações de entrada** como False.**

Para one-to-one mapeamento, selecione o campo de origem relevante e escolha **Salvar**.

# Mapeamento de vários objetos
<a name="multi-object-mappings"></a>

O mapeamento de vários objetos permite que os parceiros mapeiem AWS campos para um objeto de origem primária, como uma oportunidade ou lead, e para os objetos do Salesforce relacionados à fonte primária.

**nota**  
Lembre-se do seguinte ao usar o mapeamento de vários objetos:  
Ao usar o `Account` objeto Salesforce multi-object-mapping com um objeto de oportunidade, você deve definir as `Default Account` [configurações personalizadas do ACE](guided-setup-apis.md#api-sys-config-settings) para receber oportunidades.
Ao receber uma oportunidade, se você mapear para um objeto diferente do `Opportunity` objeto escolhido, certifique-se de vincular o objeto relacionado ao seu registro de oportunidade.  
Por exemplo, ao receber uma AWS recomendação pela primeira vez, a oportunidade inserida não tem nenhum objeto mapeado relacionado, a IDs *menos que* você defina as configurações personalizadas `Default Account` do ACE. Se você configurar a conta padrão, a indicação terá a IDs oportunidade escolhida ou os objetos da conta. Caso contrário, o valor do campo mapeado não será inserido. Nesse caso, você deve modificar a oportunidade de adicionar o ID do objeto relacionado e escolher **Sincronizar com AWS**. Quando AWS envia a oportunidade de volta para o Salesforce, o campo do objeto mapeado é atualizado porque tem uma referência ao ID relacionado ao objeto.
Selecione a opção **Clonar conta padrão** nas configurações personalizadas. Isso permite AWS clonar a conta padrão quando necessário, especialmente se você mapear os campos da conta para seu objeto principal.

**Para mapear objetos relacionados**

1. No Salesforce, navegue até a guia **Mapeamentos ACE** e escolha uma oportunidade ou lead.

1. **No seletor de objetos**, escolha seu objeto de origem.

   A coluna **Salesforce Fields** aparece e exibe o símbolo **>** no final de qualquer campo que contenha objetos relacionados.

1. Selecione um símbolo **>** para expandir a lista de objetos relacionados para esse campo.

1. Escolha o campo que você deseja mapear para o AWS campo.

1. Escolha **Salvar**.

# Mapeamento da lista de opções
<a name="picklist-mapping"></a>

A caixa de diálogo da lista de opções permite mapeamentos limitados e estendidos entre o campo da lista de opções do parceiro e o APN. A página **Mapeamentos ACE** também tem uma função de mapeamento automático se estiver usando o objeto de **oportunidade ACE personalizado** fornecido. Para obter mais informações sobre o objeto, consulte [Usando um objeto padrão do Salesforce ou um objeto personalizado](crm-connector-mapping.md#custom-ace-opportunity-object) mais adiante neste guia.

Se for encontrada uma correspondência exata entre os valores de campo do parceiro e o APN, esses valores serão mapeados automaticamente. A opção de mapeamento estendido permite que os parceiros mapeiem um único valor de APN para várias fontes, configurem mapeamentos de destino adicionais e definam mapeamentos padrão.

## Mapeamento limitado
<a name="limited-mapping"></a>

1. Na página **Mapeamentos ACE**, selecione um campo de origem e escolha **Mapear** Valores. 

   A caixa de diálogo de mapeamento é exibida.

1. **Para **Etapa 1: Valores primários do APN**, escolha **Mapa automático** ou o valor do Salesforce para o gerenciador de pipeline ACE correspondente e, em seguida, escolha Salvar.**

1. Repita as etapas 1 e 2 conforme necessário para mapear todos os valores do gerenciador de pipeline ACE.

1. Para fechar a caixa de diálogo de mapeamento, escolha **Fechar**. 

Os parceiros recebem uma mensagem de confirmação de que os mapeamentos de valores foram salvos. 

## Mapeamento estendido
<a name="extended-mapping"></a>

1. Se o mesmo valor de origem for mapeado para vários valores de APN, continue com o mapeamento conforme descrito anteriormente.

1. Na guia **Valores primários de APN**, escolha o mesmo mapeamento de valores para vários valores de APN. 

1. Se existirem valores não mapeados na organização do parceiro, a guia **Valor adicional do APN** permite mapear valores adicionais para o APN. Isso ajuda os parceiros a garantir que todos os valores aplicáveis em sua organização sejam mapeados de acordo com os valores apropriados da APN. 

1. Se um único valor na organização do parceiro for mapeado para mais de um valor de APN, use a guia **Valores secundários de APN** para definir o valor padrão para integrações externas. 

## Mapeando objetos ACE e Salesforce
<a name="mapping-guidance"></a>

As seções a seguir explicam como mapear objetos personalizados do ACE e do Salesforce em mapas de objetos.

### Usando um objeto personalizado de oportunidade AWS ACE
<a name="ace-opportunity-custom-object"></a>

A versão 2.0 e posterior do conector CRM inclui um objeto de oportunidade personalizado ACE. Você pode usar o objeto para gerenciar AWS oportunidades no Salesforce.

Ao usar o objeto personalizado na página de **mapeamentos ACE, os parceiros podem mapear** automaticamente os AWS campos para os campos do Salesforce. Além disso, o objeto de oportunidade personalizado está alinhado com o novo modelo de dados ACE e tem validações incorporadas à interface do usuário que ajudam os usuários a enviar novas oportunidades.

Para usar um objeto de oportunidade ACE personalizado, conclua as seguintes etapas:

1. No Salesforce, navegue até a página **Mapeamentos ACE** e escolha **Oportunidade** no painel de navegação esquerdo.

1. Em **Seletor de objetos**, escolha **ACE Opportunity**.

1. Para mapear campos do Salesforce em AWS campos, escolha o botão de **objeto ACE de mapeamento automático**.

### Usando um objeto padrão do Salesforce ou um objeto personalizado
<a name="custom-ace-opportunity-object"></a>

Os parceiros podem usar o objeto de oportunidade padrão do Salesforce ou seu próprio objeto de oportunidade personalizado. Para evitar falhas na sincronização do ACE, certifique-se de que o objeto de oportunidade personalizado contenha todos os campos obrigatórios ou campos condicionalmente obrigatórios do ACE relevantes. O tipo de dados do AWS campo mapeado deve ser o mesmo do campo do Salesforce criado no objeto personalizado. Se o tipo de dados não corresponder, o campo não aparecerá na tela de mapeamento ACE. Por exemplo, o campo de texto **customerCompanyName**pode ser mapeado somente para um campo de texto (string) no objeto de oportunidade padrão ou personalizado. Para obter os tipos de dados necessários, consulte os campos de oportunidade do ACE.

Para usar um objeto padrão do Salesforce ou um objeto personalizado, conclua as seguintes etapas:

1. Navegue até a página **Mapeamentos ACE** e escolha **Oportunidade** no painel de navegação esquerdo.

1. Em **Seletor de objetos**, escolha seu objeto.

1. **Conclua o mapeamento selecionando os campos obrigatórios do Salesforce em relação aos AWS campos correspondentes e, em seguida, escolha Salvar.**

**nota**  
O recurso Mapa Automático está disponível somente para objetos personalizados da oportunidade ACE.

# Sincronize registros e relatórios
<a name="crm-connector-sync-logs-and-reports"></a>

Os tópicos a seguir explicam como usar registros e relatórios de sincronização no aplicativo conector do AWS Partner CRM. Os tópicos também listam os tipos de registro e relatório e os dados que eles contêm.

**Topics**
+ [Registros de sincronização](#sync-logs)
+ [Relatórios](#reports)

## Registros de sincronização
<a name="sync-logs"></a>

No aplicativo conector, a guia **Registro de sincronização** exibe o status dos registros de sincronização para sincronização de APN de entrada e saída. Você usa a guia para verificar uma sincronização bem-sucedida e solucionar erros de sincronização.

Use as exibições de lista incluídas para alternar entre os registros de sincronização de **entrada** e **saída**.
+ **Orquestração de entrada** — Indica o trabalho que verifica os registros de entrada disponíveis do APN.
+ **Recuperação de registros de orquestração de entrada** — Indica a tarefa que coleta e processa os registros de entrada pendentes da APN.
+ **Orquestração de saída** — Indica o trabalho que envia transações de saída pendentes da sua organização para a APN.

A página de **registro do registro de sincronização** mostra o status da tarefa de sincronização, o número de registros na carga, o número de registros processados com êxito e o número de registros com erro.

Os detalhes do **Registro de Sincronização** relacionados mostram os detalhes de registros individuais processados como parte da tarefa de sincronização, além de seus status individuais. As tabelas a seguir explicam cada tipo de arquivo de log e seus conteúdos relacionados.

### Tipos de log
<a name="log-types"></a>


| **Finalidade** | **Definição** | 
| --- | --- | 
| Recuperação de arquivos de saída  | Criado quando a tarefa de saída é executada com base na frequência e na necessidade de sincronizar um novo conjunto de registros pendentes. AWS Os registros são criados somente quando os registros precisam corresponder à seguinte especificação de filtro para a sincronização de saída: `Updates for AWS` é `true` e `Last Sync Date` é nulo, ou `Last Sync Date` é anterior ao `Last Modified Date` e `Last Modified By` é o usuário que agendou os trabalhos de sincronização. | 
| Recuperação de arquivos de entrada  | Criado com base na sua programação de sincronização de entrada. O registro lista os callouts que verificam as transações de entrada pendentes de. AWS | 
| Recuperação de registros de entrada  | Criado somente quando o trabalho principal de recuperação de arquivos de entrada identifica transações de entrada pendentes de. AWS O registro contém os detalhes do arquivo AWS que contém os registros de oportunidades ou leads. | 

### Resultados da recuperação do arquivo de saída
<a name="outbound-file-retrieval-results"></a>


| **Direção**  | **Finalidade**  | **Status**  | **Definição**  | 
| --- | --- | --- | --- | 
| De AWS  | Recuperação de arquivos de entrada | API Success  | Uma chamada de lista para o bucket foi bem-sucedida. A chamada verificou a existência de registros de entrada pendentes que devem ser processados. | 
| De AWS  | Recuperação de arquivos de entrada | Error  | A chamada da lista falhou, normalmente devido a credenciais inválidas ou a um problema de permissão. | 

### Resultados da recuperação do arquivo de entrada
<a name="inbound-file-retrieval-results"></a>


| **Direção**  | **Finalidade**  | **Status**  | **Definição**  | 
| --- | --- | --- | --- | 
| De AWS  | Recuperação de registros de entrada  | API success  | Foi feita uma get chamada para recuperar o arquivo listado da Inbound File Retrieval operação, se um ou mais arquivos existirem e aguardarem processamento. | 
| De AWS  | Recuperação de registros de entrada | Partial  | O arquivo foi recuperado, mas o processamento falhou em alguns registros. Revise o log de sincronização para solucionar a falha. | 
| De AWS  | Recuperação de registros de entrada | Error  |  O processamento falhou em todos os registros devido a um dos seguintes motivos: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/crm-connector-sync-logs-and-reports.html)  | 
| De AWS  | Recuperação de registros de entrada | API success  | Se um ou mais arquivos estiverem presentes e aguardando processamento, uma get chamada será feita para recuperar o arquivo listado da Inbound File Retrieval operação. | 
| De AWS  | Recuperação de registros de entrada | Partial  | O arquivo foi recuperado, mas o processamento falhou em alguns dos registros. Revise o log de sincronização para solucionar a falha.  | 
| De AWS  | Recuperação de registros de entrada  | Error  | O processamento falhou em todos os registros devido a um dos seguintes motivos: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/crm-connector-sync-logs-and-reports.html)  | 
| De AWS  | Recuperação de registros de entrada  | Processed  | O processamento foi bem-sucedido e os registros foram inseridos em seu objeto mapeado. | 

## Relatórios
<a name="reports"></a>

O pacote de conectores do AWS Partner CRM inclui relatórios que permitem que você acompanhe o status da sincronização entre sua organização e o APN.<a name="view-reports-synchronization"></a>

**Para visualizar relatórios para sincronização**

1. No aplicativo do conector AWS Partner CRM, escolha a guia **Relatórios**.

1. Escolha **Todas as pastas e**, em seguida, **conector AWS Partner CRM**.

Os relatórios disponíveis incluem o seguinte:
+ **Registros de sincronização de entrada** — falhas no registro `Error: Inbound` de sincronização por dia.
+ Registros de **sincronização de entrada — registros** de sucesso `Success: Inbound` de sincronização por dia.
+ **Registros de sincronização de saída** — falhas no registro `Error: Outbound` de sincronização por dia.
+ Registros de **sincronização de saída — registros** de sucesso `Success: Outbound` de sincronização por dia.
+ **Resumo da sincronização** — Resumo dos trabalhos de sincronização de entrada e saída por dia.