贾 翠琴, 软件工程师, IBM 中国软件研发中心 郭 亮, 软件工程师, IBM 金 正俊, 软件工程师, IBM
概述
IBM 内容管理器 (WCM) 是用来创建和管理发布于互联 ，企业内部互联 以及企业门户 站上的 页内容的管理系统。它提供了一系列的工具来管理 站内容的创建， 审批以及最终的发布。这一系列工具所组成的复杂而又精密的内容管理系统使 站的建设不再仅仅是专业技术人员的领域，使非技术人员也能参予其中。
内容录入是 IBM 内容管理器所提供最基本的功能，但是管理器本身所提供的缺省的内容录入页面的设计是相对复杂的，在实际工作用户更希望能使用自己定制的内容录入页面来取代和简化这种缺省的设计。
这篇文档主要描述如何在 WCM 中创建和设置客户化的内容录入页面。
文档面向的读者群应具备一定的 WCM 使用经验，对 WCM 应该已经有了最基本的了解，并且能在 WCM 中创建最基本的站点结构。
在 WCM 中，用户可以使用下面的方法来定制和简化 WCM 的内容录入界面：
- 分配内容库角色给内容创建者
- 应用远程操作创建定制启动页面
- 使用 WCM 公共 API 来创建自己的内容录入页面
分配内容库角色给内容创建者
WCM 内容编写工具为用户提供了不同的视图来执行不同的任务。这些视图包括“我的项列表”、“内容”、“站点区域”、“类别”、“组件”、“编写模板”、“演示模板”、“工作流”以及“所有项”。
要使用户能够访问 WCM 内容编写页面首先必须分配对内容库的可视权限。
- 以系统管理员的帐户登陆门户 站服务期，登录后点击导航条进入页面 管理 》门户 站内容 》 Web 内容库；
- 选择用户并点击“确认”按钮；
- 点击链接“资源”返回上一页面；
- 点击 “完成”。
完成对内容库的授权后，用户缺省对所有视图有读的权限，如果只允许用户看到内容视图，我们可以取消其他视图的读权限。
- 以系统管理员的帐户登陆门户 站服务期，登录后点击导航条进入页面 管理 》门户 站内容 》 Web 内容库；
- 取消“参与者”所在行的“允许传播”的选择；
- 点击 “应用”；
- 点击 “完成”。
- 以系统管理员的帐户登陆门户 站服务期，登录后点击导航条进入页面 管理 》门户 站内容 》 Web 内容库；
- 选择用户并点击“确认”按钮；
- 点击链接“资源”返回上一页面；
- 点击 “完成”。
图 1. 用户内容视图
应用远程操作创建定制启动页面
在 WCM 6.1.x 中，用户还可以配置 WCM 使用自己的客户化启动页面来替换掉缺省的用户界面。
在定制启动页面中将应用 WCM 的远程操作接口来调用在 WCM 内容编写界面中的不同的视图和操作。
远程操作
WCM 的远程操作通过在 URL 中调用参数“cmAuthoringAction=action”来触发，action 的值如下：
new
Action 为 new 时可以在打开一个新建条目页面，必须在“type”参数中指定要新建条目的类型。
如：cmAuthoringAction=new&type=com.ibm.workplace.wcm.api.WCM_Content
“type”可以用下列值 :
com.ibm.workplace.wcm.api.WCM_AuthoringTemplate
com.ibm.workplace.wcm.api.WCM_Category
com.ibm.workplace.wcm.api.WCM_Content
com.ibm.workplace.wcm.api.WCM_FileComponent
com.ibm.workplace.wcm.api.WCM_HTMLComponent
com.ibm.workplace.wcm.api.WCM_ImageComponent
com.ibm.workplace.wcm.api.WCM_NumericComponent
com.ibm.workplace.wcm.api.WCM_PresentationTemplate
com.ibm.workplace.wcm.api.WCM_RichTextComponent
com.ibm.workplace.wcm.api.WCM_Site
com.ibm.workplace.wcm.api.WCM_SiteArea
com.ibm.workplace.wcm.api.WCM_Taxonomy
com.ibm.workplace.wcm.api.WCM_TextComponent
com.ibm.workplace.wcm.api.WCM_Workflow
com.ibm.workplace.wcm.api.WCM_WorkflowStage
cmAuthoringAction=new&type=com.ibm.workplace.wcm.api.WCM_Content&atid=com.ibm.workplace.wcm.api.WCM_AuthoringTemplate/ID
当创建一个新的站点区域，内容以及类别条目时，可以通过添加参数“pid”来定义要创建内容的父节点，其中 pid 的值是父节点的编 ，可以通过 WCM 公共 API 取得。
cmAuthoringAction=new&type=com.ibm.workplace.wcm.api.WCM_Content&pid=com.ibm.workplace.wcm.api.WCM_SiteArea/ID
cmAuthoringAction=new&type=com.ibm.workplace.wcm.api.WCM_SiteArea&pid= com.ibm.workplace.wcm.api.WCM_Site/ID
cmAuthoringAction=new&type=com.ibm.workplace.wcm.api.WCM_Category&pid=com.ibm.workplace.wcm.api.WCM_Taxonomy/ID
delete
Action 为 delete 时用来删除一个条目，必须在“docid”参数中指定要删除条目的编 。这个编 可以通过 WCM 的公共 API 取得。
如：cmAuthoringAction=delete&docid=com.ibm.workplace.wcm.api.WCM_Content/ID1
删除条目的时，下面的参数可以用来指定删除的是一个草稿条目
sdraft=true
edit
如：cmAuthoringAction=edit&docid=com.ibm.workplace.wcm.api.WCM_Content/ID1
sdraft=true
read
Action 为 read 时可以以只读模式打开一个条目，必须在“docid”参数中指定要读入的条目的编 。这个编 可以通过 WCM 的公共 API 取得。
如：cmAuthoringAction=read&docid=com.ibm.workplace.wcm.api.WCM_Content/ID1
读入条目的时，下面的参数可以用来指定只读的是一个草稿条目
sdraft=true
openmainview
Action 为 openmainview 时可以在编写页面打开一个可视视图，必须在“view”参数中指定要打开的视图。
如：cmAuthoringAction=openmainview&view=contentbysitearea
“view”可以用下列值 :
contentbysitearea
contentbytitle
myrecent
mydrraft
mypendingapproval
mypublished
myexpired
mydeleted
alldraftitems
allexpireditems
allpublisheditems
alldeleteditems
componentsbytype
move
Action 为 move 时用来移动一个站点区域或者内容。
如：cmAuthoringAction=move&docid=com.ibm.workplace.wcm.api.WCM_Content/ID1
移动的方向“1”表示向上，“-1”表示向下。如将一条内容向上移动一个位置，
cmAuthoringAction=move&docid=com.ibm.workplace.wcm.api.WCM_Content/ID1&pid=com.ibm.workplace.wcm.api.WCM_SiteArea/ID&moveDirection=1
link
Action 为 link 时用来将内容链接到一个站点区域。
如：cmAuthoringAction=link&docid=com.ibm.workplace.wcm.api.WCM_Content/ID1&pid=com.ibm.workplace.wcm.api.WCM_SiteArea/ID2
Copy
Action 为 copy 时用来复制一个条目。
如复制内容到一个新的站点区域下：
cmAuthoringAction=copy&docid=com.ibm.workplace.wcm.api.WCM_Content/ID&pid=com.ibm.workplace.wcm.api.WCM_SiteArea/ID2
复制操作还可以使用下面的参数，
opyAsDraft=true
重新启动复制内容的工作流，使复制后内容状态为草稿。
id=workflowname
重新定义复制内容的工作流，使复制后内容使用新的工作流。
osition=start
定位复制后内容在父节点的位置，缺省状态下为 last。
approve
Action 为 approve 时用来审批通过一个工作流条目，必须在“docid”参数中指定要审批条目的编 。
如：cmAuthoringAction=approve&docid=com.ibm.workplace.wcm.api.WCM_Content/ID
审批条目的时，下面的参数可以用来指定审批的是一个草稿条目
sdraft=true
decline
Action 为 decline 时用来拒回一个工作流条目，必须在“docid”参数中指定要拒回条目的编
如：cmAuthoringAction=decline&docid=com.ibm.workplace.wcm.api.WCM_Content/ID
viewversions
Action 为 viewversions 时用来打开条目的版本视图，必须在“docid”参数中指定条目的编
如：cmAuthoringAction=viewversions&docid=com.ibm.workplace.wcm.api.WCM_Content/ID
viewhistory
Action 为 viewhistory 时用来打开条目的历史视图，必须在“docid”参数中指定条目的编
如：cmAuthoringAction=viewhistory&docid=com.ibm.workplace.wcm.api.WCM_Content/ID
Populating fields when creating or editing content
当使用 “new”或者 “edit” 参数修改内容条目时，可以在 URL 中定义不同内容域的值 .
如使用下面的 URL 创建一个新的内容，命名为 “newcontent”
cmAuthoringAction=new&type=com.ibm.workplace.wcm.api.WCM_Content&wcmfield.content.name=newcontent
下面是在创建和修改内容时可使用的参数列表：
&wcmfield.content.name=
&wcmfield.content.title=
&wcmfield.content.description=
&wcmfield.content.authors=
&wcmfield.content.owners=
&wcmfield.content.publishDate=
&wcmfield.content.expiryDate=
&wcmfield.content.generalDateOne=
&wcmfield.content.generalDateTwo=
&wcmfield.content.workflow= (This can only be used when creating content.)
&wcmfield.content.categories=
&wcmfield.content.keywords=
&wcmfield.element.[elementname]= (You replace [elementname] with the name of the element you are populating.)
注意 : 参数 element 只能在下面类型的的内容元素中使用 :Text ，Html ，Rich text ，Option Selection ，User Selection ，Date and time ，Number ，JSP ，Link ，Component Reference
针对同一内容域可以定义多个值：
cmAuthoringAction=new&type=com.ibm.workplace.wcm.api.WCM_Content&wcmfield.content.keywords=keyword1&wcmfield.content.keywords=keyword2
定义用户类型的内容域时，必须使用下面格式：
cmAuthoringAction=new&type=com.ibm.workplace.wcm.api.WCM_Content&wcmfield.content.authors=uid=usera
定义日期类型的内容域时，必须使用 US English格式。并且或者输入日期和时间，或者只有日期输入，只有日期输入的情况下，缺省时间为 12:00:00 AM，而且使用的时区是服务器所定义的时区：
cmAuthoringAction=new&type=com.ibm.workplace.wcm.api.WCM_Content&wcmfield.content.generalDateOne=Feb 14, 2008 12:53:03 PM
cmAuthoringAction=new&type=com.ibm.workplace.wcm.api.WCM_Content&wcmfield.content.generalDateOne=Feb 14, 2008
定义 JSP 元素时，需要指定 JSP 文件所在路径：
cmAuthoringAction=new&type=com.ibm.workplace.wcm.api.WCM_Content&wcmfield.element.jspelementname=/wps/wcm/jsp/html/example.jsp
定义关联组件元素，需要指定要关联的组件：
&wcmfield.element.mycompref.type=com.aptrix.pluto.cmpnt.NavigatorCmpnt&wcmfield.element.mycompref.id=e4bdf10042d0769698ccbeb0e25cc973
定义选择组件元素，需要指定待选择的每一个选项：
&wcmfield.element.[elementname]=AA&wcmfield.element.[elementname]=BB
定义用户选择组件，需要指定待选择的每一个用户：
&wcmfield.element.[elementname]=uid=wpsadmin,o=default organization&wcmfield.element.[elementname]=uid=wpsadmin2,o=default organization
定义链接组件元素，需要定义的参数如下：
添加一个链接到内容 :
&wcmfield.element.[elementname].type=content&wcmfield.element.[elementname].id=contentID
添加链接到链接组件 :
&wcmfield.element.[elementname].type=link&wcmfield.element.[elementname].id=linkcomponentID
添加链接到图片或者文件资源组件 :
&wcmfield.element.[elementname].type=resource&wcmfield.element.[elementname].id=componentID
添加链接到外部 URL:
&wcmfield.element.[elementname].type=external&wcmfield.element.[elementname].externalReference=myurl
指定链接文本使用内容名字还是自定义文本 :
&wcmfield.element.[elementname].useReferenceLinkText=true
指定链接显示为图片 :
&wcmfield.element.[elementname].linkImage=imagecomponentID
指定链接显示的文本内容 :
&wcmfield.element.[elementname].linkText=text
指定链接的描述信息 :
&wcmfield.element.[elementname].linkDescription=text
指定链接的目标窗口 :
&wcmfield.element.[elementname].linkTarget=
_blank
_parent
_self
_top
targetname
Save
autoSave
使用此操作保存容器，后台执行，没有直观的视图，如：
&wcmfield.autosave=true
saveValidate
这个参数决定是否显示 autosave 执行中所产生的提醒和错误信息，如果设置为“true”，显示提醒和错误信息，否则不显示，缺省值为 true。
&wcmfield.saveValidate=false
Adding comments to the item history
声明：本站部分文章及图片源自用户投稿，如本站任何资料有侵权请您尽早请联系jinwei@zod.com.cn进行处理,非常感谢！