Tabelas de atividades de e-mail

A atividade de e-mail permite-lhe monitorizar e gerir comunicações por e-mail com os clientes.

Ações em uma atividade de e-mail

Usando os serviços Web Dataverse, você pode executar as seguintes ações em uma atividade de email:

• Crie, obtenha, atualize e elimine a atividade de e-mail.

• Envie mensagens de email ou envie mensagens de email usando modelos de email (Template). Para obter mais informações sobre modelos de email, consulte Criar modelos de email.

• Anexe arquivos como anexos usando o atributo (ActivityMimeAttachment) na mensagem de email.

• Enviar mensagens de e-mail em massa.

• Configure as mensagens de e-mail recebidas a serem entregues a partir do Microsoft Exchange Server para qualquer utilizador ou fila, ou mensagens a enviar a partir de qualquer utilizador ou fila para o Microsoft Exchange Server.

  Se os atributos da Organization.RequireApprovalForuserEmail organização e Organization.RequireApprovalForQueueEmail (processar e-mails somente para usuários/filas aprovados) estiverem definidos como true (1), ocorrerá o seguinte: as mensagens de email serão entregues ou enviadas de um usuário ou fila somente se o endereço de e-mail principal do usuário ou fila for aprovado. Os atributos SystemUser.EmailRouterAccessApproval e Queue.EmailRouterAccessApproval indicam o status do endereço de e-mail principal do usuário e da fila, respectivamente, e o valor deve ser definido como 1. Caso contrário, as mensagens recebidas e enviadas serão bloqueadas. Você pode atualizar o registro de usuário ou fila para alterar o valor do atributo, se ele ainda não estiver no estado aprovado, desde que sua conta de usuário tenha o privilégio prvApproveRejectEmailAddress atribuído.

E-mail em massa

O Dataverse suporta o envio de e-mails para uma grande lista de destinatários por meio de uma solicitação de e-mail em massa. Quando uma solicitação de email em massa é enviada ao Dataverse, uma operação assíncrona é criada na fila de serviço assíncrona que envia as mensagens de email usando um processo em segundo plano. Isto proporciona-lhe um melhor desempenho do sistema.

As mensagens SendBulkMailRequest e BackgroundSendEmailRequest são usadas para o envio de mensagens de e-mail em massa. A seguir está listada a sequência usada para enviar e-mails em massa:

1. Executar o pedido SendBulkMail. Esta solicitação contém uma consulta que seleciona os destinatários de e-mail de destino e um modelo de e-mail para compor cada e-mail.

2. O serviço assíncrono cria as atividades de email para cada destinatário.

3. O serviço assíncrono envia cada mensagem de email. As mensagens de e-mail têm um status de envio "pendente".

4. O roteador de email, o Dynamics 365 for Outlook ou um componente de envio de email de terceiros pesquisa o Dataverse para mensagens de email pendentes e, se for encontrado, baixa-o usando a BackgroundSendEmail solicitação.

5. A BackgroundSendEmail solicitação executa as seguintes operações: verifica se mensagens de e-mail pendentes estão presentes, baixa o e-mail para o chamador da BackgroundSendEmailRequest mensagem e sincroniza os downloads se houver vários chamadores.

   Observação

   Seu provedor de serviços de e-mail pode ter limites que afetam quantos e-mails você pode enviar dentro de um período de tempo. Para obter mais informações: Limites > do Exchange Online Limites de envio.

6. O chamador da mensagem BackgroundSendEmailRequest recebe a mensagem de e-mail transferida e envia-a.

Anexos de e-mail

Os anexos de e-mail são ficheiros que podem ser anexados a mensagens de e-mail ou modelos de e-mail. Um arquivo anexado pode estar em qualquer formato de arquivo de computador padrão, como documentos do Office Outlook, planilhas do Office Excel, arquivos CAD e arquivos PDF. Você pode anexar vários arquivos como anexos de e-mail a um modelo de e-mail ou e-mail. O tamanho máximo dos arquivos que podem ser carregados é determinado pela propriedade Organization.MaxUploadFileSize . Essa propriedade é definida na guia Email das Configurações do Sistema no aplicativo Dynamics 365. Essa configuração limita o tamanho dos arquivos que podem ser anexados a mensagens de email, anotações e recursos da Web. A configuração padrão é 5 MB.

Para anexar um anexo de e-mail a uma mensagem de e-mail ou modelo, usa as colunas ActivityMimeAttachment.ObjectId e ActivityMimeAttachment.ObjectTypeCode enquanto cria ou atualiza uma linha de anexo de mime de atividade.

O exemplo de código a seguir mostra como anexar um anexo de email a um email:

ActivityMimeAttachment _sampleAttachment = new ActivityMimeAttachment{  
    ObjectId = new EntityReference(Email.EntityLogicalName, _emailId),  
    ObjectTypeCode = Email.EntityLogicalName,  
    Subject = "Sample Attachment",  
    Body = System.Convert.ToBase64String(new ASCIIEncoding().GetBytes("Example Attachment")),  
    FileName = "ExampleAttachment.txt"};  

Da mesma forma, para anexar o anexo de e-mail a um modelo em vez de um e-mail, substituirá os valores dos atributos ActivityMimeAttachment.ObjectId e ActivityMimeAttachment.ObjectTypeCode como mostrado no código acima.

ObjectId = new EntityReference(Template.EntityLogicalName, _templateId), ObjectTypeCode = Template.EntityLogicalName,  

Para obter um exemplo de código completo sobre como criar anexos de email, consulte Exemplo: Criar, recuperar, atualizar e excluir um anexo de email.

Reutilizar anexos de e-mail

Quando cria um registo de anexo de e-mail, o ficheiro anexado é guardado como um BLOB de ficheiro. O atributo ActivityMimeAttachment.AttachmentId do registo de anexo de e-mail identifica exclusivamente o BLOB do ficheiro. Isso é feito para facilitar a reutilização dos anexos de arquivo com outros registros de e-mail e modelo de e-mail, sem criar e armazenar várias cópias do mesmo arquivo no banco de dados.

Para reutilizar um anexo de ficheiro existente:

1. Recupere a ActivityMimeAttachment linha que contém o arquivo anexo que você deseja reutilizar, conforme mostrado no exemplo de código a seguir:

   ActivityMimeAttachment retrievedAttachment = 
       (ActivityMimeAttachment)_serviceProxy
       .Retrieve(ActivityMimeAttachment.EntityLogicalName, _emailAttachmentId, new ColumnSet(true));  
   

2. Crie um novo anexo de e-mail, associe-o à linha de e-mail ou modelo de e-mail necessária e aponte-o para o arquivo anexado da linha recuperada ActivityMimeAttachment , conforme mostrado no exemplo de código a seguir:

   ActivityMimeAttachment _reuseAttachment = new ActivityMimeAttachment{  
     ObjectId = new EntityReference(Email.EntityLogicalName, _emailId),  
     ObjectTypeCode = Email.EntityLogicalName,  
     Subject = "Sample Attachment",  
     AttachmentId = retrievedAttachment.AttachmentId};  
   

Como se está a reutilizar um arquivo de anexo existente, não precisa especificar os valores de coluna ActivityMimeAttachment.Body e ActivityMimeAttachment.FileName ao criar e associar linhas de anexos a e-mails ou modelos de e-mails.

Armazenamento de e-mail

As descrições de e-mail (corpo do e-mail) foram armazenadas até este ponto no repositório relacional Dataverse. Isso está mudando à medida que a coluna Email.Description na tabela de atividades de email está sendo realocada para o armazenamento de Blob do Azure não estruturado. O armazenamento de Blob do Azure também é usado para armazenamento de anexos, anotações, arquivos e imagens.

Período de transição

Espera-se que a migração de dados do repositório de relações Dataverse para o armazenamento de Blob do Azure para todos os clientes comece em maio de 2023. Esta migração de dados ocorrerá como um processo em segundo plano (trabalho). Espera-se que a movimentação inicial de dados para clientes existentes dure cerca de 6 a 12 semanas, e possivelmente até mais, dependendo do tamanho dos dados. Após a movimentação inicial de dados, qualquer migração restante é um processo contínuo. Todas as descrições de email com mais de doze meses serão movidas automaticamente para o armazenamento de Blob do Azure e esse período de transição de doze meses não pode ser alterado. Os e-mails mais recentes não serão movidos até completarem 12 meses. O trabalho de migração de descrição de e-mail é executado periodicamente - cerca de uma vez a cada 30-60 dias por locatário.

Essa migração de dados será transparente para você, com a exceção de que você verá uma redução no tamanho da tabela ActivityPointer depois que o processo de migração for totalmente concluído. No centro de administração do Power Platform, no relatório de Capacidade, estará disponível um novo item de linha de e-mail em Utilização de ficheiros. O resultado final é um aumento no consumo geral de armazenamento de arquivos e uma redução no armazenamento de banco de dados consumido.

As limitações mencionadas na próxima seção começarão a ser aplicadas a todos os dados que já foram movidos para o armazenamento de blobs do Azure gerenciado pelo Dataverse, mesmo que toda a movimentação de dados não esteja concluída.

Limitações de pesquisa e filtragem

Para corpos de descrições de email armazenadas no Blob Storage do Azure, certas limitações se aplicam à filtragem, localização e pesquisa dessas descrições de email, conforme descrito abaixo.

Filtering

A filtragem em descrições de e-mail não é suportada. Alguns pontos específicos a considerar são os seguintes.

• FetchXML - Você não será capaz de pesquisar em corpos de e-mail usando FetchXML.
• Busca rápida e localização avançada - A filtragem de descrições de e-mail usando esses métodos não é suportada.

A procurar

Você pode habilitar a pesquisa Dataverse em descrições de e-mail para pesquisar descrições de e-mail.

Consulte também

Quadros de atividades
Exemplo: Enviar um e-mail
Tabela de e-mail
Tabela ActivityMimeAttachment