解析大型.NET ERP系统 通用附件管理功能
大型系统具备一个通用的附件管理功能，对于单据中无法清晰表达的字段，用一个附件图片或附件文档表示是最好的方法了。比如物料清单附加一张CAD图纸，销售订单评审功能中附加客户的各种表格，通用附件功能对系统起到画龙点睛的作用。一图解千言，先来看一下界面设计模式，看起来和一般的数据输入功能相同。
首先是设计附件表，它的定义参考下面的代码。
CREATE TABLE [dbo].[Attachment] ( [Index] [int] NOT NULL, [MasterTable] [nvarchar] (50) COLLATE SQL_Latin1_General_CP1_CI_AS NOT NULL CONSTRAINT [DF__Attachmen__Maste__5165187F] DEFAULT (''), [MasterKey] [decimal] (10, 0) NOT NULL CONSTRAINT [DF__Attachmen__Maste__52593CB8] DEFAULT ((0)), [FileType] [nvarchar] (10) COLLATE SQL_Latin1_General_CP1_CI_AS NOT NULL CONSTRAINT [DF__Attachmen__FileT__534D60F1] DEFAULT (''), [FilePath] [nvarchar] (250) COLLATE SQL_Latin1_General_CP1_CI_AS NULL, [CreatedDate] [datetime] NULL, [CreatedBy] [nvarchar] (10) COLLATE SQL_Latin1_General_CP1_CI_AS NULL, [RevisedDate] [datetime] NULL, [RevisedBy] [nvarchar] (10) COLLATE SQL_Latin1_General_CP1_CI_AS NULL, [Description] [nvarchar] (60) COLLATE SQL_Latin1_General_CP1_CI_AS NULL, [KeySegment1] [nvarchar] (30) COLLATE SQL_Latin1_General_CP1_CI_AS NULL, [KeySegment2] [nvarchar] (30) COLLATE SQL_Latin1_General_CP1_CI_AS NULL, [KeySegment3] [nvarchar] (30) COLLATE SQL_Latin1_General_CP1_CI_AS NULL, [KeySegment4] [nvarchar] (30) COLLATE SQL_Latin1_General_CP1_CI_AS NULL, [KeySegment5] [nvarchar] (30) COLLATE SQL_Latin1_General_CP1_CI_AS NULL, [Size] [decimal] (18, 0) NULL, [File] [image] NULL, [UploadedBy] [nvarchar] (10) COLLATE SQL_Latin1_General_CP1_CI_AS NULL, [UploadedDate] [datetime] NULL, [Md5Hash] [nvarchar] (32) COLLATE SQL_Latin1_General_CP1_CI_AS NULL ) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY] GO ALTER TABLE [dbo].[Attachment] ADD CONSTRAINT [PK_Attachment] PRIMARY KEY CLUSTERED ([Index], [MasterTable], [MasterKey]) ON [PRIMARY] GO EXEC sp_addextendedproperty N'MS_Description', N'附件', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', NULL, NULL GO EXEC sp_addextendedproperty N'MS_Description', N'索引', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'Index' GO EXEC sp_addextendedproperty N'MS_Description', N'附件所附加的主表', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'MasterTable' GO EXEC sp_addextendedproperty N'MS_Description', N'主键', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'MasterKey' GO EXEC sp_addextendedproperty N'MS_Description', N'文件类型', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'FileType' GO EXEC sp_addextendedproperty N'MS_Description', N'文件路径', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'FilePath' GO EXEC sp_addextendedproperty N'MS_Description', N'创建日期', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'CreatedDate' GO EXEC sp_addextendedproperty N'MS_Description', N'建立人', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'CreatedBy' GO EXEC sp_addextendedproperty N'MS_Description', N'修改日期', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'RevisedDate' GO EXEC sp_addextendedproperty N'MS_Description', N'修改人', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'RevisedBy' GO EXEC sp_addextendedproperty N'MS_Description', N'名称', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'Description' GO EXEC sp_addextendedproperty N'MS_Description', N'关键词', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'KeySegment1' GO EXEC sp_addextendedproperty N'MS_Description', N'关键词', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'KeySegment2' GO EXEC sp_addextendedproperty N'MS_Description', N'关键词', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'KeySegment3' GO EXEC sp_addextendedproperty N'MS_Description', N'关键词', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'KeySegment4' GO EXEC sp_addextendedproperty N'MS_Description', N'关键词', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'KeySegment5' GO EXEC sp_addextendedproperty N'MS_Description', N'附件大小', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'Size' GO EXEC sp_addextendedproperty N'MS_Description', N'附件内容', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'File' GO EXEC sp_addextendedproperty N'MS_Description', N'上传人', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'UploadedBy' GO EXEC sp_addextendedproperty N'MS_Description', N'上传日期', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'UploadedDate' GO EXEC sp_addextendedproperty N'MS_Description', N'哈希值', 'SCHEMA', N'dbo', 'TABLE', N'Attachment', 'COLUMN', N'Md5Hash' GO
在以前的一篇文章中解释过，为什么需要给每个数据库表增加一个Recnum(记录编号)的数字值字段，我们在这里要记录下的业务功能表中要使用附件的功能，也就是要记下表中的Recnum的值。
MasterTable用于程序分组显示附件，当上传的附件比较多而又不容易到每个独立的功能中去查找，需要设计一个附件浏览器功能，用于查看系统中的所有附件。
有了以上两个基础，附件功能基本上完成。再来增加附件文件存储或下载查看功能。
先来看一下附件的存储方法。可以直接将附件存放在数据库中，也可以考虑增加一个FTP服务器，将附件传送到文件服务器中。当附件文件过大时，存在数据库中会影响数据库性能，优点是便于迁移。存放在FTP服务器中，优点是性能会好，缺点是要考虑文件系统的相关事项。比如用户A上传一个附件文件DOC20150718.pdf，用户B也上传了一份同样的文件DOC20150718.pdf，后上传的文件名不能覆盖前面已经上传的文件名。解决方法是用GUID表示文件名，数据库中记录下文件的GUID，这样可以解决文件重复性问题，但不能解决文件可读性问题。在FTP目录中打开文件夹结构，看到都是GUID作文件名的文件，不利于搜索。于是需要考虑文件名可读性的问题，比如按照用户和时间的组合来命名。还是以前面的文件名DOC20150718.pdf为例子，当前登陆用户名是A，我可以将此文件重命名为用户+年+月+日+小时分钟+ 文件名+ 流水号的文件编码方案给文件命名，于是上面的文件名变成A-201507182110-DOC20150718-0012.pdf，文件名中的时间部分已经精确到分钟，重复的可能性大大降低，增加了可读性。我按照这个规则再写一个文件重命名工具，万一这些文件与ERP系统脱离关系，用软件工具简单的重命名，也可以恢复到当初用户上传时使用的文件名。
再来看阅读器编码。PDF阅读器和DOCX阅读器来自于RadControls_WinForms_2013，它内置了这两种文档的阅读器控件，调用起来简洁。PDF阅读器代码调用如下：
private Telerik.WinControls.UI.RadPdfViewer readerPDF; this.readerPDF.Visible = true; if (attachment != null && attachment.Length > 0) { MemoryStream stream = new MemoryStream(attachment); this.readerPDF.LoadDocument(stream); }
DOCX文档阅读器代码调用参考如下：
IDocumentFormatProvider provider = GetProviderByExtension(extension); if (provider == null) { throw new FileLoadException("Unable to find format provider for extension " + extension); } using (Stream stream = File.OpenRead(file)) { RadDocument document = provider.Import(stream); this.readerWord.Document = document; document.LayoutMode = DocumentLayoutMode.Paged; readerWord.ChangeSectionPageOrientation(PageOrientation.Rotate270); readerWord.Focus(); }
.NET有功能强大的文件API Aspose 软件包，包含市面上几乎所有文件的转换接口，这是.NET的File API。对于不可直接阅读的文件，如Excel，PowerPoint等常见文件格式，可考虑调用Aspose 文件接口转化为PDF，再调用PDF阅读器显示。Aspose 在文件处理方面应用相当广泛，与文件转化相关的功能推荐用此接口。
总结一下通用附件管理功能的三个要点：
1 如何关联业务功能表，主要保存Recnum记录编号。
2 如何存储附件, FTP文件服务器或数据库image二进制字段。
3 如何查看文档, PDF和DOCX文档阅读器，其它常见文档转化为PDF。
