전자 메일 활동 엔터티

  • 아티클

 

게시 날짜: 2017년 1월

적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

전자 메일 활동은 고객과의 전자 메일 소통을 추적 및 관리할 수 있습니다.Microsoft Dynamics 365는 Microsoft Dynamics 365로 또는 로 부터의 전자 메일 라우팅을 관리하는 전자 메일 라우터 소프트웨어를 포함합니다. 전자 메일 활동은 전자 메일 프로토콜을 사용하여 배달됩니다.전자 메일 라우터은 다음 전자 메일 프로토콜도 지원: Exchange 웹 서비스, POP3 및 SMTP.전자 메일 라우터 소프트웨어 외에 전자 메일 활동은 Outlook용 Microsoft Dynamics 365을 사용하여 배달할 수도 있습니다.

이 항목의 내용

전자 메일 활동에 대한 작업

대량 전자 메일

전자 메일 첨부 파일

전자 메일 활동에 대한 작업

Microsoft Dynamics 365 SDK를 사용하면 전자 메일 활동에 대해 다음 작업을 수행할 수 있습니다.

  • 전자 메일 활동을 만들고, 검색, 업데이트 및 삭제합니다.

  • 전자 메일 메시지를 보내거나 전자 메일 템플릿(Template)을 사용하여 전자 메일 메시지를 보낼 수 있습니다. 전자 메일 템플릿에 대한 자세한 내용은 Template(전자 메일 템플릿) 엔터티 메시지 및 메서드를 참조하십시오.

  • 전자 메일 메시지에서 (ActivityMimeAttachment) 특성을 사용하여 파일을 첨부 파일로 첨부합니다.

  • 대량 전자 메일 메시지를 보냅니다.

  • 수신 전자 메일 메시지가 Microsoft Exchange Server에서 사용자 또는 큐로 전달되거나 발신 메시지가 사용자 또는 큐에서 Microsoft Exchange Server로 전송되도록 구성합니다. 큐에 대해 수신 전자 메일 메시지를 구성하는 방법에 대한 자세한 내용은 수신 메시지에 대해 전자 메일 구성을 참조하십시오.

    Organization.RequireApprovalForuserEmail 및 Organization.RequireApprovalForQueueEmail(사용자/큐 승인을 위해서만 전자 메일 처리) 조직 특성이 true로 설정되어 있으면(1) 사용자 또는 큐의 기본 전자 메일 주소가 승인되어야만 전자 메일 메시지가 사용자 또는 큐에서 보내지거나 사용자 또는 큐로 배달됩니다.SystemUser.EmailRouterAccessApproval 및 Queue.EmailRouterAccessApproval 특성은 사용자 및 큐 각각의 기본 전자 메일 주소의 상태를 나타내고, 값은 1로 설정해야 합니다. 그렇지 않으면 수신 및 발신 메시지는 차단 됩니다. 아직 승인된 상태가 아니고 사용자 계정에 prvApproveRejectEmailAddress 권한이 할당된 경우 특성 값을 변경하도록 사용자 또는 큐 레코드를 업데이트할 수 있습니다. 자세한 내용은 권한에 보안 역할 UI 매핑을 참조하십시오.

참고

Microsoft Dynamics 365(온라인 및 온-프레미스)에서 Email.StatusCode 특성은 null일 수 없습니다.

대량 전자 메일

Microsoft Dynamics 365은 대량 전자 메일 요청을 통해 대규모 받는 사람 목록에 전자 메일을 보낼 수 있습니다. 대량 전자 메일 요청을 Microsoft Dynamics 365에 보내면 백그라운드 프로세스를 사용하여 전자 메일 메시지를 보내는 비동기 서비스 큐에 비동기 작업이 만들어집니다. 이 기능은 향상된 시스템 성능을 제공합니다.

SendBulkMailRequest 및 BackgroundSendEmailRequest 메시지는 대량 전자 메일 메시지를 보내는 데 사용됩니다. 다음은 대량 전자 메일을 보내는 데 사용되는 순서입니다.

  1. SendBulkMail 요청을 실행합니다. 이 요청에는 대상 전자 메일 받는 사람과 각 전자 메일 구성에 필요한 전자 메일 템플릿을 선택하는 쿼리가 포함됩니다.

  2. 비동기 서비스는 받는 사람마다 전자 메일 활동을 만듭니다.

  3. 비동기 서비스는 각 전자 메일 메시지를 보냅니다. 전자 메일 메시지에는 보내기 "보류" 상태가 있습니다.

  4. 전자 메일 라우터 Outlook용 Microsoft Dynamics 365 또는 타사 전자 메일 전송 구성 요소는 보류 중인 전자 메일 메시지에 대해 Microsoft Dynamics 365을 폴링하고 발견되면 BackgroundSendEmail 요청을 사용하여 다운로드합니다.

  5. BackgroundSendEmail 요청은 보류 중인 전자 메일 메시지가 있는지를 확인하고, 전자 메일을 BackgroundSendEmailRequest 메시지 호출자에게 다운로드하고, 여러 호출자가 있을 경우 다운로드를 동기화하는 등의 작업을 수행합니다.

  6. BackgroundSendEmailRequest 메시지의 호출자는 다운로드한 전자 메일 메시지를 받고 보냅니다.

전자 메일 첨부 파일

전자 메일 첨부 파일은 전자 메일 메시지 또는 전자 메일 템플릿에 첨부할 수 있는 파일입니다. 첨부된 파일은 Microsoft Office Word 문서, Microsoft Office Excel 스프레드시트, CAD 파일, PDF 파일 같은 표준 컴퓨터 파일 형식이 될 수 있습니다. 전자 메일 또는 전자 메일 템플릿에 전자 메일 첨부 파일로 여러 개의 파일을 첨부할 수 있습니다.업로드할 수 있는 최대 파일 크기는 Organization.MaxUploadFileSize 속성에서 결정됩니다. Dynamics 365 응용 프로그램의 시스템 설정에 있는 전자 메일 탭에서 이 속성을 설정합니다. 이 설정은 전자 메일 메시지, 메모 및 웹 리소스에 첨부할 수 있는 파일의 크기를 제한합니다. 기본 설정은 5MB입니다.

전자 메일 첨부 파일을 전자 메일 메시지 또는 템플릿에 첨부하려면 활동 MIME 첨부 파일 레코드를 만들거나 업데이트하는 동안 ActivityMimeAttachment.ObjectId 및 ActivityMimeAttachment.ObjectTypeCode 특성을 사용합니다.

다음 코드 샘플에서는 전자 메일 첨부 파일을 전자 메일에 첨부하는 방법을 보여 줍니다.

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"};

마찬가지로 전자 메일 대신 템플릿에 전자 메일 첨부 파일을 첨부하려면 위의 코드에서 ActivityMimeAttachment.ObjectId 및 ActivityMimeAttachment.ObjectTypeCode 특성의 값을 다음과 같이 바꿉니다.

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

전자 메일 첨부 파일을 만드는 방법에 대한 전체 코드 샘플은 샘플: 전자 메일 첨부 파일 만들기, 검색, 업데이트 및 삭제를 참조하십시오.

전자 메일 첨부 파일 재사용

전자 메일 첨부 파일 레코드를 만들 때 첨부된 파일은 파일 BLOB으로 저장됩니다. 전자 메일 첨부 파일 레코드의 ActivityMimeAttachment.AttachmentId 특성은 파일 BLOB를 고유하게 식별합니다. 동일한 파일의 사본을 여러 개 만들어 데이터베이스에 저장하지 않고 다른 전자 메일 및 전자 메일 템플릿 레코드를 사용하여 첨부 파일을 재사용할 수 있도록 수행됩니다.

기존 첨부 파일을 재사용하려면

  1. 다음 코드와 같이 재사용하려는 첨부 파일이 포함된 ActivityMimeAttachment 레코드를 검색합니다.

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

  2. 다음 코드 예제와 같이 새 전자 메일 첨부 파일 레코드를 만들고, 필요한 전자 메일 또는 전자 메일 템플릿 레코드에 연결하고, 검색한 ActivityMimeAttachment 레코드의 첨부된 파일을 가리킵니다.

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

    기존 첨부 파일을 재사용하므로 전자 메일 첨부 파일 레코드를 만들어 전자 메일 또는 전자 메일 템플릿에 연결하지만 ActivityMimeAttachment.Body 및 ActivityMimeAttachment.FileName 특성 값을 지정 필요가 없습니다.

참고 항목

활동 엔터티
활동 엔터티에 대한 샘플 코드
Email 엔터티 메시지 및 메서드
ActivityMimeAttachment(전자 메일 첨부 파일) 엔터티 메시지 및 메서드

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 저작권 정보