dp2API之GetBiblioInfos

GetBiblioInfos() – 获得书目信息

        LibraryServerResult GetBiblioInfos(
            string strBiblioRecPath,
            string[] formats,
            out string[] results,
            out byte[] baTimestamp);

用途：获得一条书目记录的多种格式信息。

权限：需要getbiblioinfo或order权限。如果formats参数中包含”summary”，则还需要getbibliosummary或order权限。

strBiblioRecPath参数指定了书目记录路径。其值有一种特殊用法，可以在书目记录路径字符串后面接续"$prev"或"$next"，表示希望获得这个位置的前一条或后一条书目记录的信息。

formats参数指定了希望获得的信息格式，这是一个字符串数组，元素值可以在xml/html/text/@???/summary/outputpath/metadata/targetrecpath中选用一个或者多个。

formats参数可用值表 格式名 说明 xml XML字符串。这是记录的原始格式

html HTML字符串。如果为MARC格式数据库，根据内核数据库下配置文件cfgs/loan_biblio.fltx创建的HTML字符串

text 纯文本字符串。如果为MARC格式数据库，根据内核数据库下配置文件cfgs/loan_biblio_text.fltx创建的HTML字符串

@??? 书目局部数据。通过library.xml中C#脚本函数GetBiblioPart()创建的字符串内容。GetBiblioPart()函数的原型如下：

	public int GetBiblioPart(XmlDocument bibliodom,
		string strPartName,
		out string strResultValue)

详情可参考本手册3.2小节。注意strPartName中是不包括’@’字符的局部名称

summary 书目摘要字符串。这个格式是由dp2Kernel层次相关书目库下的cfgs/summary.fltx配置文件定义的。如果这个配置文件不存在，软件会自动探索寻找相关书目库下的cfgs/summary.cs和cfgs/summary.cs.ref配置文件，如果这两个文件存在，则会用它们来创建摘要字符串

outputpath 书目记录的实际路径。这在strBiblioRecPath参数值后部包含了’$’部分时非常必要，因为这时strBiblioRecPath中的内容并不是书目记录的实际路径

metadata 书目记录的元数据XML字符串

targetrecpath 书目记录MARC格式中998字段$t子字段的内容，即该书目记录的“目标记录路径”

iso2709:utf-8|backup 返回iso2709格式，默认utf-8，不带backup时，按照登录账号权限返回对应信息，带backup时返回完整信息（需backup权限） 和 marc:syntax|backup 返回marc机内格式，syntax表示返回编码方式，不带backup时，按照登录账号权限返回对应信息，带backup时返回完整信息（需backup权限）

===

results参数中返回的内容，和formats参数中列出的格式顺序是对应的。

用户账户通过定义“权限”就可以满足一般场合的需求。如果访问的用户配置了“存取定义”参数，则本API还会进一步进行权限限制判断。详细情况请参见SetBiblioInfo() API的介绍文字。