dp2API之GetItemInfo - DigitalPlatform/dp2 GitHub Wiki

#GetItemInfo() – 获得实体记录信息和其从属的书目记录信息

        LibraryServerResult GetItemInfo(
            string strBarcode,
            string strResultType,
            out string strResult,
            out string strItemRecPath,
            out byte[] item_timestamp,
            string strBiblioType,
            out string strBiblio,
            out string strBiblioRecPath);

用途：获得实体记录信息和其从属的书目记录信息 参数表： 类型 参数名 说明 string strBarcode 册条码号 string strResultType 希望在strResult参数中返回何种格式的信息 out string strResult 返回有关册记录的信息 out string strItemRecPath 返回册记录的路径 out byte[] item_timestamp 返回册记录的时间戳 string strBiblioType 希望返回的书目信息类型 out string strBiblio 返回(册记录所从属的)书目记录的信息 out string strBiblioRecPath 返回(册记录所从属的)书目记录路径

返回值： 成员 返回值 说明 LibraryServerResult.Value -1 出错 0 没有找到所指定的册记录 1 找到册记录。成功 >1 找到多于一条册记录，返回值是找到的记录数，这是一种不正常的情况 LibraryServerResult.ErrorInfo 出错信息

权限：需要getiteminfo、getentities注或order权限。 注：这个权限值getentities是即将废弃的用法，请尽量用等同权限值getiteminfo

strBarcode参数指定了册条码号。这个参数还有两种特殊的用法，一种是用"@path:"连接一个册记录路径(后方还可以选择接续一段”$prev”或”$next”，表示希望获得指定记录路径位置的前一条或者后一条记录)；另一种是用"@refID:"连接一个参考ID字符串。

strResultType参数指定需要在strResult参数中何种格式的信息。其值为xml/html/text之一。

格式名 说明 xml 表示返回册记录的原始XML格式字符串。 html 表示返回册记录的HTML格式字符串。这是由dp2Library数据目录中的cfgs/itemxml2html.cs和cfgs/itemxml2html.cs.ref脚本文件定义的。 注：dp2Library中每个实体库其记录都是一致的格式，因此也使用同样的配置文件来发生各种格式的信息 text 表示返回册记录的纯文本格式字符串。这是由dp2Library数据目录中的cfgs/itemxml2text.cs和cfgs/itemxml2text.cs.ref脚本文件定义的。 如果此参数值为空(或者为”recpath”)，则表示strResult参数中不返回任何数据。不过，无论这个参数为什么值，strItemRecPath参数中都会返回册记录路径，如果册记录不是没有找到的话。 strBiblioType参数指定需要在strBiblio参数中何种格式的信息。其值为xml/html/text之一。

格式名 说明 xml 表示返回书目记录的原始XML格式字符串。 html 表示返回书目记录的HTML格式字符串。这是由内核层次相关书目库下的cfgs/loan_biblio.fltx配置文件定义的。 text 表示返回书目记录的纯文本格式字符串。这是由内核层次相关书目库下的cfgs/loan_biblio_text.fltx配置文件定义的。 如果此参数值为空，则表示strBiblio参数中不返回任何数据(这时strBilbioRecPath参数中也不返回书目记录的路径)。如果要在strBiblioRecPath中返回书目记录路径而在strBiblio参数中不返回任何信息，请在调用前将strBiblioType参数值设置为”recpath”