<cms:include>用于运行中从OpenCms VFS动态包含文件，包含的文件被当成一个请求的附加参数。

使用一下一些属性来标识要包含的对象文件名称:

• page
• property
• attribute

如果这些属性都没有设定, <cms:include> 标签的标签体将使用别的方法得到文件名称.

注意: 如果不能通过上诉方法得到包含的文件名称, 就会调用 当前 CmsRequestContext 的 getUri() 方法返回名称.

属性:

page (file)     

    这个属性的值指明要包含的文件的 name 。属性名称 "page" 和 "file" 在这里是等价的. 

property

    这个属性的值指明要包含的指定 JSP 文件的某个属性值作为文件名称.

    这个属性的值是当前页面请求的参数列表的一个参数键名称的值. 在使用前必须通过程序来设定这个键值对.

element 

    如果目标jsp文件被 cms:template 标签分割为几个模板元素, 那么只有指定的元素被包含进来. 否则，不管jsp文件被分割为几个模板元素也会被全部包含进来。
注意: element 被作为当前请求的附加请求参数被传递.   

suffix   

cachable 

    如果这个属性的值被设置为 "false", 那么这个被包含进来的部分不会进行 Flexcache 缓存.

标签体:

如果没有设置 page/ file, property 或者 attribute 这些属性的任何一个，那么可以使用 jsp 来写标签体.

可以添加额外的键值对参数到被包含的页面, 例如： <cms:param name="myparam" value="myvalue" />.

示例用法:

包含页面 "some_page.html":

<cms:include page="some_page.html" /> or <cms:include file="some_page.html" />

读取当前文件的 "template" 属性, 并且给这个属性值追加 "_head.jsp" 作为文件名称 ("suffix"属性可选):

<cms:include property="template" suffix="_head.jsp" />

处理另一个标签，将结果作为本标签的标签体，比如这里读取某个文件的一个属性值作为标签体:

<cms:include>

<cms:property name="template" file="parent"/>

</cms:include>

设置页面请求参数列表来传递将要包含的文件的名称:

<%

...

request.setAttribute( "body", "../elements/template-body.html" );

...

%>



<cms:include attribute="body">

    <cms:param name="__locale"><%= locale %></cms:param>

</cms:include>

包含某个文件，并且传递一些属性, 将增加的属性作为键值对传递给将要包含的文件:

<cms:include file="../elements/template-nav-top.jsp">

    <cms:param name="__locale"><%= locale %></cms:param>

    <cms:param name="__navpart" value="toprow" />

</cms:include>

包含 "template" 属性指明的 jsp 文件的 “head” 模板元素:

<cms:include property="template" element="head" />

This document explains How to create structured content in opencms.

Step 1:

Open the opencms-modules.xml file which is in the below path:

\ProgramFiles\IBM\WebSphere\AppServer\profiles\default\installedApps\krishnanNode01Cell\opencms_war.ear\opencms.war\WEB-INF\config\

Step 2:

Go to the module “org.opencms.frontend.templateone.modules” by using the keyword “<name>org.opencms.frontend.templateone.modules</name>” to search.

Step 3:

Copy and paste the “type” which is shown in the below screen shot.

Step 4:

Now we have to edit the pasted “type” as per our requirement.

Step 5:

Now Copy and paste the “explorertype” as like in the screen shot given below

Now we have to edit the pasted “explorertype” as per our requirement.

Now save the changes and close the file.

Go to the link given below in OpenCms Admin Interface

/system/modules/org.opencms.frontend.templateone.modules/

Step 8:

Create your new “xsd” file inside the schemas folder.

Step 9:

Copy and paste any one of the sample xsd code and edit our changes.

In the Box 1 (red) you would edit the element name and type and also the complexType name.

Note:

The element name must be ended with the letter “s”.

In the element type you should add the text OpenCms in front of the element name as shown in the above Box 1.

For the ComplexType name also you should add the text OpenCms in front of the element name as shown in the above Box 1.

Note:

Here the element name must not be ended with the letter “s”.

In the element type you should add the text OpenCms in front of the element name as shown in the above Box 2.

For the ComplexType name also you should add the text OpenCms in front of the element name as shown in the above Box 2.

The type “OpenCmsString” is used to create the Tex Field. Refer OpenCms Documentation for the various fields.

Note:

If you are not give any label for the element the default element name in the xsd file will display in the Structured Content file.

Step 10:

Open the workplace.properties file the below path

/system/modules/org.opencms.frontend.templateone.modules/classes/org/opencms/frontend/templateone/modules/

The “test_article” which is marked in the box 1 (red) is the type name given in the opencms-modules.xml file.

The “Test” which is marked in the box 2(green) is the element name given in the samples.xsd file.

Now save the changes and close the file.

Publish the Project

After publishing the project you need to reload the Opencms instance in the server or restart the server.

Step 13:

Open the OpenCms Admin Interface now you can able to see your new structured content file.

Now you can create a new xml file by using the newly created structured content file.

Step 15:

Now you can edit your structured content file.