Alfresco Dashlet 的添加

Alfresco DM的个人桌面My Alfresco Dashboard可以让用户自行添加组件 Dashlet，开发人员可以根据需要定制开发个性化的Dashlet，用以增强系统功能或提升工作效率。以下的步骤描述如何向Dashboard添加新的组件Dashlet:

这里，我们以一个Helloworld的例子来说明

1. 编写Dashlet配置文件，如：helloworld.get.desc.xml 内容如下

   <webscript>
     <shortname>Hello world</shortname>
     <description>Hello world dashlet</description>
     <url>/ui/hellow?p={param?}</url>
     <authentication>user</authentication>
     <transaction>none</transaction>
   </webscript>
 

保存并放在alfresco的文件目录 /alfresco/WEB-INF/classes/alfresco/templates/webscripts/org/alfresco/portlets下

2. 编写Dashlet模板文件， 如：helloworld.get.html.ftl 使用freemaker的脚本语言来输出html内容，完成后存放在步骤一相同目录下

3. 编写调用JSP文件，如：helloworld-webscript.jsp 内容如下

  <%@ taglib uri="/WEB-INF/repo.tld" prefix="r" %>

  <r:webScript scriptUrl="/wcs/ui/helloword-webscript.jsp" />

保存并放在alfresco的文件目录 /alfresco/jsp/dashboards/dashlets下

4. 编写界面配置文件 web-client-config-custom.xml, 这个文件通常存放在目录 /tomcat/shared/classes/alfresco/extension下，打开这个文件并添加以下内容

  <config evaluator="string-compare" condition="Dashboards">
       <dashboards>
           <dashlets>
           <dashlet id="hello-world-webscript" label="Hello world!"
           description="Hello World WebScript" jsp="/jsp/dashboards/dashlets/helloword-webscript.jsp" />
           </dashlets>
       </dashboards>
  </config>

5. 重启Alfresco应用程序

6. 打开服务接口页面，如：http://localhost:8080/alfresco/service/index, 并点击"Refresh Web Scripts", 稍等片刻，组件列表就会被更新，新的组件Dashlet已经可以使用了