使用SharePoint Client OM来查询列表的注意事项(2)
2010-11-05 15:16 by Windie Chai, ... 阅读, ... 评论, 收藏, 编辑上一篇文章提到了使用Client OM来查询SharePoint列表时需要两次指定结果集里包含的字段,范例是C#调用托管的Client OM,本文来介绍一下如何JavaScript来调用Client OM查询列表。
先创建几个全局变量:
var tf_contex; var tf_list; var tf_items;
然后是一个初始化的函数:
function DoQuery() { tf_context = new SP.ClientContext.get_current(); tf_list = tf_context.get_web().get_lists().getByTitle("TestList"); var query = new SP.CamlQuery(); query.set_viewXml("<View><ViewFields><FieldRef Name='Entity_SysCode'/></ViewFields><Query><Where><Contains><FieldRef Name='_x822a__x73ed_'/><Value Type='Text'>" + "CA1143" + "</Value></Contains></Where></Query></View>"); tf_items = tf_list.getItems(query); tf_context.load(tf_items,"Include(Entity_SysCode,_x8f66__x8f86__x724c__x7167_,_x822a__x73ed_)"); tf_context.executeQueryAsync(onListsLoaded, onQueryFailed); }
可以发现使用JavaScript来调用Client OM和使用托管代码很像,我们依然要两次指定结果集里要包含的字段,第一次是在CamlQuery.set_viewXml方法中,第二次是在clientContext.load方法中。
最后在调用context.executeQueryAsync方法时,传递了两个方法引用,第一个会在executeQueryAsync执行成功时触发,第二个则是在发生错误时触发,这两个方法的代码如下:
function onListsLoaded() { var items = tf_items.getEnumerator(); while (items.moveNext()) { alert(item.get_item("Entity_SysCode")); } } function onQueryFailed(sender, args) { alert('Request failed. \nError: ' + args.get_message() +'\nStackTrace: ' + args.get_stackTrace()); }
当然,仅仅这样还是不够的,还得让页面执行上面的初始化函数,因为JavaScript Client OM定义在SP.js这个文件中,所以我们还得确保这个文件已经被加载完毕,Client OM专门提供了一个方法来做这件事情:
SP.SOD.executeOrDelayUntilScriptLoaded(DoQuery, "SP.js");
SharePoint 2010提供的Client OM是一套强大而又便利的API,使用Client OM,以前我们在SharePoint上进行的许多展示型开发,现在只需要一个存放代码的文档库,再搭配SharePoint内置的“内容编辑器”Web部件”就可以做到,再也不需要服务器的管理权限了。