Entidades de atividade de e-mail

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

A atividade de email permite controlar e gerenciar a segurança nas comunicações de email com os clientes. O Microsoft Dynamics 365 inclui o software E-mail Router que gerencia o roteamento de email para ou de Microsoft Dynamics 365. A atividade de email é entregue usando protocolos de email.E-mail Router oferece suporte aos protocolos a seguir de email: Exchange Web services, POP3 e SMTP. Além do software de E-mail Router, a atividade de email também podem ser entregue usando Microsoft Dynamics 365 para Outlook.

Neste tópico

Ações em uma atividade de email

Email em Massa

Anexos de Email

Ações em uma atividade de email

Ao usar SDK do Microsoft Dynamics 365, você pode executar as seguintes ações em uma atividade de email:

• Criar, recuperar, atualizar e excluir a atividade de email.

• Envie mensagens de email, ou envie mensagens de email usando modelos de e-mails (Template). Para obter mais informações sobre modelos de email, consulte Mensagens e métodos modelo de entidade (modelo de email).

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

• Envie mensagens de email em massa.

• Configure as mensagens de email recebidas a serem entregues de Microsoft Exchange Server para qualquer usuário ou fila, ou mensagens de saída a serem enviadas de qualquer usuário ou fila para Microsoft Exchange Server. Para obter informações sobre como definir mensagens de email de entrada para filas, consulte Configurar email para mensagens de entrada.

  Se os atributos da organização Organization.RequireApprovalForuserEmail e Organization.RequireApprovalForQueueEmail (processar email somente para usuários/filas aprovados) são definidos como verdadeiro (1), ocorre o seguinte: as mensagens de email são entregues ou enviadas de um usuário ou fila somente se o endereço de email principal do usuário ou da fila for aprovado. Os atributos SystemUser.EmailRouterAccessApproval e Queue.EmailRouterAccessApproval indicam o status do endereço de email principal do usuário e fila respectivamente, e o valor deve ser definido como 1. Caso contrário, as mensagens de entrada e de saída serão bloqueadas. Você pode atualizar o registro de usuários ou fila para alterar o valor do atributo, se ainda não estiver estado aprovado, pois sua conta de usuário possui o privilégio prvApproveRejectEmailAddress atribuído. Para obter mais informações, consulte Interface do usuário com função de segurança para mapeamento de privilégios.

Observação

Em Microsoft Dynamics 365 (online e local), o atributo Email.StatusCode não pode ser null.

Email em Massa

Microsoft Dynamics 365 oferece suporte ao envio de email para uma grande lista de destinatários por meio de uma solicitação de email em massa. Quando uma solicitação de email em massa é enviada para Microsoft Dynamics 365, uma operação assíncrona é criada na fila de serviço assíncrono que envia as mensagens de email usando um processo em segundo plano. Isso oferece melhor desempenho do sistema.

As mensagens SendBulkMailRequest e BackgroundSendEmailRequest são usadas para enviar mensagens de email em massa. O seguinte lista a sequência usada para enviar email em massa:

1. Execute a solicitação SendBulkMail. A solicitação contém uma consulta para selecionar os destinatários de email de destino e um modelo de email para compor cada email.

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

3. O serviço assíncrono envia cada mensagem de email. As mensagens de email tem um status de envio "pendente".

4. O e-mail router, Microsoft Dynamics 365 para Outlook, ou um componente de terceiros de envio de email sonda Microsoft Dynamics 365 para mensagens de email pendentes e, se uma for encontrada, ele baixa usando a solicitação BackgroundSendEmail.

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

6. O chamador da mensagem BackgroundSendEmailRequest recebe a mensagem de email baixada e a envia.

Anexos de Email

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

Para anexar um anexo de email com uma mensagem de email ou modelo, use os atributos ActivityMimeAttachment.ObjectId e ActivityMimeAttachment.ObjectTypeCode ao criar ou atualizar um registro de anexo que imita uma atividade.

O seguinte exemplo de código mostra como adicionar 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"};

De modo semelhante, para adicionar um anexo a um modelo em vez de um email, você substituirá os valores dos atributos ActivityMimeAttachment.ObjectId e ActivityMimeAttachment.ObjectTypeCode no seguinte código:

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.

Reutilizando anexos de email

Quando você cria um registro de anexo de email, o arquivo anexado é salvo como um BLOB de arquivo. O atributo ActivityMimeAttachment.AttachmentId do registro de anexo de email identifica o BLOB do arquivo. Isso é feito para facilitar a reutilização de anexos de arquivo com outros registros de email e modelo de email, sem criar e armazenar vários cópias do arquivo no banco de dados.

Para reutilizar um anexo de arquivo existente:

1. Recupere o registro de ActivityMimeAttachment que contém o arquivo de anexo desejado para reutilizar, conforme mostrado no seguinte exemplo de código:

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

2. Crie um novo registro de anexo de email, associe-o ao registro de email ou modelo de email necessário e aponte para o arquivo anexado no registro de ActivityMimeAttachment recuperado, conforme mostrado no seguinte exemplo de código:

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

   Como você está reutilizando um arquivo de anexo existente, não é necessário especificar os valores do atributo ActivityMimeAttachment.Body e ActivityMimeAttachment.FileName enquanto está criando e associando registros de anexo de email a emails ou modelos de email.

Confira Também

Entidades de atividade
Código de exemplo para entidades de atividade
Enviar e-mail de mensagens e métodos da entidade
Mensagens e métodos de entidade ActivityMimeAttachment (anexo de email)

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais