Dynamics CRM邮件附件,你真的了解吗?

时间:2023-03-10 01:09:25
Dynamics CRM邮件附件,你真的了解吗?
关注本人微信和易信公众号: 微软动态CRM专家罗勇 ,回复160或者20151014可方便获取本文,同时可以在第一时间得到我发布的最新的博文信息,follow me!
听人问起怎么读取到一封邮件所有的附件,有人说附件也是存储在注释实体(annotation)中,我的记忆中是一个另外一个实体,SDK中有如下的原文:An activity mime attachment represents an attachment to an email message or an email template. The schema name for this entity is ActivityMimeAttachment. 这个意思中文翻译过来就是,一个ActivityMimeAttachment 实体记录代表着一个邮件或者一个邮件模板的附件。众说纷纭,但是实践出真知,让我用一个有图有真相的博文来说明下吧。
我们先来查看下元数据吧,这个实体的中文显示名称是 附件,但是元数据中还有另外一个实体的显示名称也叫附件,这个实体的架构名称是 Attachment ,描述是 电子邮件活动的附件。从本博文后面可以知道,邮件附件的文件信息是存储在这个实体中,那么注释的附件内容是不是存储在这个实体中呢?下片博文(Dynamics CRM中的注释(Note)及RollupRequest消息初探)再实践验证。我将这个实体(ActivityMimeAttachment)的字段属性截图放在下面:值得注意的是这个实体的 IsValidForAdvancedFind 是false,也就是不会出现在高级查询中。
Dynamics CRM邮件附件,你真的了解吗?
我们先通过快速创建一封邮件。
Dynamics CRM邮件附件,你真的了解吗?
邮件大致内容如下,注意我为本邮件上传了一个附件,名称为 logo.png,其实就是素格格*特产店的logo:
Dynamics CRM邮件附件,你真的了解吗?
然后我参考下SDK中的章节 Sample: Create, retrieve, update, and delete an email attachment ,Sample: Retrieve email attachments for an email template 等, 使用了如下的代码:
        static void Main(string[] args)
{
var service = GetOrganizationService();
var fetchXML = string.Format(@"<fetch mapping='logical' output-format='xml-platform' version='1.0' distinct='false' no-lock='true' count='1'>
<entity name='email'>
<attribute name='subject' />
<attribute name='regardingobjectid' />
<attribute name='from' />
<attribute name='to' />
<attribute name='statuscode' />
<attribute name='activityid' />
<filter type='and'>
<condition value='微软MVP罗勇测试附件的邮件主题' attribute='subject' operator='eq' />
</filter>
</entity>
</fetch>");
EntityCollection ec = service.RetrieveMultiple(new FetchExpression(fetchXML));
if (ec.Entities.Count == )
{
Console.WriteLine("邮件的ID是" + ec.Entities[].GetAttributeValue<Guid>("activityid") + "下面是附件信息:");
QueryExpression query = new QueryExpression
{
EntityName = "activitymimeattachment",
ColumnSet = new ColumnSet("filename","subject","filesize","mimetype","activityid","activitymimeattachmentid","body"),
Criteria =
{
FilterOperator = LogicalOperator.And,
Conditions =
{
new ConditionExpression
{
AttributeName = "objecttypecode",
Operator = ConditionOperator.Equal,
Values = {"email"}
},
new ConditionExpression
{
AttributeName = "objectid",
Operator = ConditionOperator.Equal,
Values = {ec.Entities[].GetAttributeValue<Guid>("activityid")}
}
}
}
};
var i = ;
foreach (var entity in service.RetrieveMultiple(query).Entities)
{
Console.WriteLine("第" + i + "个附件:");
Console.WriteLine("filename:" + entity.GetAttributeValue<string>("filename"));
Console.WriteLine("filesize:" + entity.GetAttributeValue<int>("filesize"));
Console.WriteLine("mimetype:" + entity.GetAttributeValue<string>("mimetype"));
Console.WriteLine("subject:" + entity.GetAttributeValue<string>("subject"));
Console.WriteLine("activityid:" + entity.GetAttributeValue<EntityReference>("activityid").Id);
Console.WriteLine("activitymimeattachmentid:" + entity.GetAttributeValue<Guid>("activitymimeattachmentid"));
Console.WriteLine("body:" + entity.GetAttributeValue<string>("body"));
Console.WriteLine("--------------------------------------------------"); i++;
}
}
Console.WriteLine("程序运行完成!");
Console.ReadKey();
}

运行结果如下,可以得知filesize应该是以字节为单位的,附件的内容应该是以base64编码后存储等等信息:

Dynamics CRM邮件附件,你真的了解吗?
当然如果有多个附件也是可以得,我去掉了读取显示body字段,运行结果如下:
Dynamics CRM邮件附件,你真的了解吗?
我发现一个问题,就是这两个附件的 activityid 字段值是相同的,那么我可以用这个条件来查询出一个邮件的所有附件吗?试试看,代码如下:
       static void Main(string[] args)
{
var service = GetOrganizationService();
var fetchXML = string.Format(@"<fetch mapping='logical' output-format='xml-platform' version='1.0' distinct='false' no-lock='true' count='1'>
<entity name='email'>
<attribute name='subject' />
<attribute name='regardingobjectid' />
<attribute name='from' />
<attribute name='to' />
<attribute name='statuscode' />
<attribute name='activityid' />
<filter type='and'>
<condition value='微软MVP罗勇测试附件的邮件主题' attribute='subject' operator='eq' />
</filter>
</entity>
</fetch>");
EntityCollection ec = service.RetrieveMultiple(new FetchExpression(fetchXML));
if (ec.Entities.Count == )
{
Console.WriteLine("邮件的ID是" + ec.Entities[].GetAttributeValue<Guid>("activityid") + "下面是附件信息:");
QueryExpression query = new QueryExpression
{
EntityName = "activitymimeattachment",
ColumnSet = new ColumnSet("filename","subject","filesize","mimetype","activityid","activitymimeattachmentid"),
Criteria =
{
FilterOperator = LogicalOperator.And,
Conditions =
{
new ConditionExpression
{
AttributeName = "activityid",
Operator = ConditionOperator.Equal,
Values = {ec.Entities[].GetAttributeValue<Guid>("activityid")}
}
}
}
};
var i = ;
foreach (var entity in service.RetrieveMultiple(query).Entities)
{
Console.WriteLine("第" + i + "个附件:");
Console.WriteLine("filename:" + entity.GetAttributeValue<string>("filename"));
Console.WriteLine("filesize:" + entity.GetAttributeValue<int>("filesize"));
Console.WriteLine("mimetype:" + entity.GetAttributeValue<string>("mimetype"));
Console.WriteLine("subject:" + entity.GetAttributeValue<string>("subject"));
Console.WriteLine("activityid:" + entity.GetAttributeValue<EntityReference>("activityid").Id);
Console.WriteLine("activitymimeattachmentid:" + entity.GetAttributeValue<Guid>("activitymimeattachmentid"));
Console.WriteLine("--------------------------------------------------");
i++;
}
}
Console.WriteLine("程序运行完成!");
Console.ReadKey();
}
测试结果表明是可以的,后面邮件使用了现有附件以后我也进行了测试,也是可以得。
下面介绍下重复利用附件,也就是新邮件使用现有附件,我先用代码创建一封邮件,然后把现有的附件附加到新建的邮件:
        static void Main(string[] args)
{
var service = GetOrganizationService();
WhoAmIRequest whoAmIRequest = new WhoAmIRequest();
WhoAmIResponse whoAmIResponse = service.Execute(whoAmIRequest) as WhoAmIResponse;
Entity fromEntity = new Entity("activityparty");
fromEntity["partyid"] = new EntityReference("systemuser", whoAmIResponse.UserId);
Entity toEntity = new Entity("activityparty");
toEntity["partyid"] = new EntityReference("account", new Guid("858AB47F-494A-E511-80D2-000D3A802FAC"));
Entity emailEntity = new Entity("email");
emailEntity["to"] = new Entity[] { toEntity };
emailEntity["from"] = new Entity[] { fromEntity };
emailEntity["subject"] = "微软MVP罗勇测试邮件使用现有附件";
emailEntity["description"] = "<a href='http://sugege.top'>素格格*特产店</a>";
var emailId = service.Create(emailEntity);
var activityMimeAttachment = new Entity("activitymimeattachment");
activityMimeAttachment["objectid"] = new EntityReference("email",emailId);
activityMimeAttachment["objecttypecode"] = "email";
activityMimeAttachment["filename"] = "sugege.png";//不设置这个字段的值,附件不会显示文件名
activityMimeAttachment["filesize"] = ;//设置了这个字段的值,附件也不会显示文件大小(字节),囧
activityMimeAttachment["attachmentid"] = new Guid("b8ef5a55-1872-e511-80e6-000d3a804b9b");//该字段不能使用new EntityReference类型来赋值
service.Create(activityMimeAttachment);
Console.WriteLine("程序运行完成!");
Console.ReadKey();
}
代码运行结果是新增了一个邮件如下:这里有个问题就是,你双击打开这个邮件附件会看不到附件内容,而是一个上传附件的窗口给你,这和普通的使用新建附件不同,这个做的不好。
Dynamics CRM邮件附件,你真的了解吗?
 
但是我如果查询这个邮件的附件信息会发现有点儿不同,比如filesize为0,mimetype为空值,囧。
Dynamics CRM邮件附件,你真的了解吗?
那你可能会问如果邮件附件不是现有的附件,而是新建上传的附件,会不会有同样的问题,我们用代码来测试下:
       static void Main(string[] args)
{
var service = GetOrganizationService();
WhoAmIRequest whoAmIRequest = new WhoAmIRequest();
WhoAmIResponse whoAmIResponse = service.Execute(whoAmIRequest) as WhoAmIResponse;
Entity fromEntity = new Entity("activityparty");
fromEntity["partyid"] = new EntityReference("systemuser", whoAmIResponse.UserId);
Entity toEntity = new Entity("activityparty");
toEntity["partyid"] = new EntityReference("account", new Guid("858AB47F-494A-E511-80D2-000D3A802FAC"));
Entity emailEntity = new Entity("email");
emailEntity["to"] = new Entity[] { toEntity };
emailEntity["from"] = new Entity[] { fromEntity };
emailEntity["subject"] = "微软MVP罗勇测试邮件使用新附件";
emailEntity["description"] = "<a href='http://sugege.top'>素格格*特产店</a>";
var emailId = service.Create(emailEntity);
var activityMimeAttachment = new Entity("activitymimeattachment");
activityMimeAttachment["objectid"] = new EntityReference("email", emailId);
activityMimeAttachment["objecttypecode"] = "email";
activityMimeAttachment["subject"] = "附件示例";
activityMimeAttachment["filename"] = "mvpluoyong.txt";//不设置这个字段的值,附件不会显示文件名
activityMimeAttachment["body"] = System.Convert.ToBase64String(new UTF8Encoding().GetBytes(@"微软MVP罗勇测试邮件使用新附件"));
service.Create(activityMimeAttachment);
Console.WriteLine("程序运行完成!");
Console.ReadKey();
}
产生的邮件如下:
Dynamics CRM邮件附件,你真的了解吗?
查询结果如下,可以知道查询出来的结果是齐的了,双击打开附件也是可以看到附件内容的,比用现有附件好。
Dynamics CRM邮件附件,你真的了解吗?
表面上的说完了,我们稍微理解下在系统中是如何存储的,实体ActivityMimeAttachment在数据库中对应了一个表activitymimeattachment,但是这个表并没有存储附件的文件名,大小,内容等信息,而是这个表activitymimeattachment 通过 AttachmentId字段和另外一个实体Attachment对应的表Attachment关联起来,附件的具体内容都是存储在这个表中的。