首页 > 代码库 > 每日学习心得:SharePoint 2013 自定义列表项添加Callout菜单项、文档关注、SharePoint服务端对象模型查询

每日学习心得:SharePoint 2013 自定义列表项添加Callout菜单项、文档关注、SharePoint服务端对象模型查询

前言:

      前一段时间一直都比较忙,没有什么时间进行总结,刚好节前项目上线,同时趁着放假可以好好的对之前遇到的一些问题进行总结。主要内容有使用SharePoint服务端对象模型进行查询、为SharePoint 自定义列表项添加callout菜单。希望能够给大家带来一些帮助。

1.  在aspx页引用可视化Web部件

有时候会需要在页面中引用项目中创建的可视化Web部件,具体步骤有以下这几步:

1) 在aspx页面顶部注册该可视化Web部件

示例如下:

<%@ Register Tagprefix="NavTree"

 Namespace="Sample.WebParts.NavTreeWebPart" Assembly="$SharePoint.Project.AssemblyFullName$" %>

属性说明:

l  Tagprefix:控件在页面使用的标签名,类似于<asp:Button…>中的asp,该属性值可由用户随便设置

l  Namespace:可视化web部件所在的命名空间

l  Assebly:可视化web部件所在的程序集(不用修改)

2) 页面引用

<div><NavTree:NavTreeWebPart  id="Navtree"  runat="server"/>

</div>

说明:

黄色标亮部分NavTree为上边注册的控件标签名,NavTreeWebPart为可视化Web部件类名

3) 后台调用

   通过NavTree.Attributes的形式去获取web部件的相关属性,进行开发

2.  自定义Timer Job

在项目中有些地方需要定时的去执行某些任务,所以就会用到创建一个定时作业。主要步骤有以下几步:

1) 在SharePoint解决方案中添加一个Feature,同时点击右键为该Feature添加一个事件接收器。

在事件接收器里默认的方法都被注释了,在这些方法中,只需要对下边的两个方法取消注释即可:

//处理激活某个功能后引发的事件。

public override void FeatureActivated(SPFeatureReceiverProperties properties)        {         ……        }        //处理在停用某个功能前引发的事件。        public override void FeatureDeactivating(SPFeatureReceiverProperties properties)        {         ……        }

  

 在FeatureActivated方法中参数的properties可以根据Feature所在的范围转换为相应的对象,同时可以在该方法中实例化继承自SPJobDefinition的类

2) 创建一个继承自SPJobDefinition类的Job类

如下:

    public class SampleTimerJob : SPJobDefinition    {        public SampleTimerJob() : base()        {        }        // 创建针对web application的timer job        public SampleTimerJob(string jobName, SPWebApplication webapp)            : base(jobName, webapp, null, SPJobLockType.ContentDatabase)        {            this.Title = jobName;        }        // 执行Timer Job时要执行的方法         public override void Execute(Guid targetInstanceId)        {           ……           ……           在该方法体中可以写相应的要定期执行的业务逻辑           SPWebApplication webapp = this.Parent as SPWebApplication;        }}

  

3) 在1)中的FeatureActivated方法中调用2)中已经创建好的继承自SPJobDefinition类的SampleTimerJob类

具体实现如下:

           // 初始化 SPJobDefinition             SampleTimerJob job = new SampleTimerJob(JobName, webApp);            SPMinuteSchedule schedule = new SPMinuteSchedule();            schedule.BeginSecond = 0;            schedule.EndSecond = 5;            schedule.Interval = 10;            job.Schedule = schedule;            job.Update();

  

4) 完成以上操作之后,部署整个项目,激活Feature之后,就可以在管理中心,监控,检查作业状态,查看“作业定义”,就可以找到自定义的Timer Job

3.  使用SharePoint服务端对象模型查询

SharePoint搜索API提供了多种方式的查询,这里主要是介绍一下利用服务端对象模型查询,主要还是使用KeywordQuery类。

具体代码如下:

           KeywordQuery keywordQuery = new KeywordQuery(SPContext.Current.Site);           //KeywordQuery新建对象时的参数也可以是指定的网站集            keywordQuery.QueryText = queryStr;//指定要查询的关键字            keywordQuery.StartRow = start_row;//设置查询结果开始的行数,可以使用该属性做查询结果的分页            keywordQuery.RowLimit = pageCount;//限定返回结果的条数            keywordQuery.TrimDuplicates = false;//是否将重复项从查询结果中移除            SearchExecutor searchExecutor = new SearchExecutor();            ResultTableCollection resultTableCollection = searchExecutor.ExecuteQuery(keywordQuery);//执行查询            var resultTables = resultTableCollection.Filter("TableType", KnownTableTypes.RelevantResults);            ResultTable resultTable = resultTables.FirstOrDefault();            DataTable dataTable = resultTable.Table;//查询的结果

     

备注:

     也可以通过该类去查询托管元数据的值,但是,需要知道元数据字段映射到搜索的值

     KeywordQuery.QueryText既可以查询关键字、也可以查询托管元数据字段,同时也可以查询关键字和托管元数据字段的组合。格式如下:

     QueryText=“关键字“

     QueryText=”Author: 张三”。其中Author为托管元数据字段,如果有多个托管元数据字段,可以用AND 进行关联查询

     QueryText=“关键字 Author:张三”,如果是关键字和托管元数据字段结合查询,则只需要用空格分开即可,同时要去除“AND”字符串。

4.  SharePoint 2013 自定义列表项使用Callout 标注控件

在SharePoint 2013默认的列表项中,有用到标注控件,如下图所示,如何在我们自定义的列表中使用该控件呢?下面就通过示例进行讲解。

 

如上图所示,callout控件有以上几部分组成,分别为title,callout action和menu entity。

l  Title:用来显示callout的标题

l  Callout action:用来执行一些操作

l  Menu entity:相当于某一个callout action中又有很多操作其中的一项

4.1 创建Callout控件

在创建callout控件之前,必须要确保加载了callout.js文件,如下:

            

SP.SOD.executeFunc("callout.js", "Callout", function () {                //创建callout控件                var callout=CalloutManager.createNew({                    ID: "Callout"+ListItemID,                    launchPoint: targetElement,//页面上某个元素                    beakOrientation: "leftRight",//callout弹出框的位置                    title: FileName,//callout的标题                    openOptions: {                        event: "click",//触发callout的行为:点击                        showCloseButton: true//是否显示callout关闭按钮                    },                    content: FileName//callout要展示的内容                });            ……….            ……….            });

  

4.2 添加Callout Action

           这里只是作为示例,演示添加了一个callout action,如果需要添加多个action,操作于此相同

               //创建一个callout action                var calloutAction1 = new CalloutAction({                    text: "查看属性",                    tooltip: "查看属性",                    isEnabledCallback: function () { return true; },                    onClickCallback: function (event, action) {                        alert(‘查看属性’);//在该方法中可以写自己的逻辑代码区实现想要的功能,此处为示例                        callout.close();                    }                });                callout.addAction(calloutAction1);//创建完callout action之后,需要将该action添加到callout控件上                ………….                ………….

  

4.3 添加具有多项menuEntry的Callout Action

//创建一个callout action,该行为与一般的action一样,只不过多了menuEntries属性,该属性为一个menuEntry的数组,可以根据需要添加多个CalloutActionMenuEntry对象,每一个对象就相当于一个Action。

                var calloutAction3 = new CalloutAction({                    text: "...",                    menuEntries: [                    new CalloutActionMenuEntry("浏览文件", function () { alert("浏览文件"); }),                    new CalloutActionMenuEntry("详细信息", function () { alert("详细信息"); })                    ]                });                callout.addAction(calloutAction3);//将该Action添加到callout控件上

完成以上操作之后就可以得到如最初所示的效果了。

该示例只是演示了如何对列表项添加callout控件,在实际的运用中,如果需要对自定义的列表项添加callout控件,需要在页面加载之时就为每一个列表项创建并绑定callout控件,因此可以将以上的创建callout控件、添加callout Action的代码封装成为一个函数,在页面加载之时执行该函数即可,如下:

function createcallout(targetElement,Title,Content){            //此处的代码即为上边的3个步骤中的代码            SP.SOD.executeFunc("callout.js", "Callout", function () {                //创建callout控件                var callout=CalloutManager.createNew                ………                ………}

  

封装完成之后,我们还需要获得该方法所需的参数,主要通过获取页面元素的属性作为方法的参数,其中的.bs-launchpoint 为页面元素的一个特殊属性,页面元素HTML如下:

    

<a title="打开菜单" class="ms-lstItmLinkAnchor ms-ellipsis-a js-callout-launchPoint bs-launchpoint"                           attr_filename=‘<%#Eval("FileName") %>‘                          attr_content = ‘<%#Eval("Content") %>‘>                           <img class="ms-ellipsis-icon" alt="打开菜单" src="http://www.mamicode.com/Images/spcommon.png?rev=23" /></a>

   

还需要将其再封装为一个方法,如下:

function initialCallout(){    $(‘.bs-launchpoint‘).each(function () {//通过在列表的列表项上加一个特殊的样式,来获取该列表项的页面元素的dom对象,并依次作为参数传递给createCallout方法,并调用该方法,                createCallout(                    $(this)[0],                    $(this).attr(‘attr_filename‘),                    $(this).attr(‘attr_content‘)});}

  

完成以上操作之后,执行以下代码即可:

_spBodyOnLoadFunctions.push(initialCallout);//该方法为SharePoint自带的js方法,主要作用将传入的方法名注册,在body的 onl oad方法里执行。

到这里基本上就完成了所有的操作,就可以在自定义的列表项中使用callout控件了。

5.  SharePoint 文档关注

在搜索中心搜索到相关的文件之后,弹出的标注控件的callout Action有“关注”这一项,截图如下:

 

如何在自定义的列表项中添加“关注”功能呢?

主要是用过followingcommon.js中的window.SetFollowStatus(….)方法实现的。

与上述的4中对自定义列表项添加callout控件所描述的一样,只需要在callout控件中在添加一个callout Action即可。具体实现如下:

要使用SetFollowStatus()方法需要保证先加载了followingcommon.js,如下所示,

SP.SOD.executeFunc(‘followingcommon.js‘, null, function () {window.SetFollowStatus(url, true, true);}

  

该方法有三个参数,第一个为要关注的列表项的url具体格式如下:

url: http://weburl?listid=_listId&itemId=_itemId

剩下的两个参数,均设为true即可。

这样在页面列表项的callout控件中点击之后即可看到“关注”callout action项,点击之后,如果关注成功,页面右上会有提示。截图如下:

 

 

每日学习心得:SharePoint 2013 自定义列表项添加Callout菜单项、文档关注、SharePoint服务端对象模型查询