当前位置:文档之家› TRSWCM5.2发布置标手册

TRSWCM5.2发布置标手册

TRSWCM5.2发布置标手册
TRSWCM5.2发布置标手册

WCM 5.2 发布置标附录

页面发布工作原理

传统上,人们建立一个Web站点主要是靠手工维护HTML页面的方式进行的,这就要求维护人员不但要熟悉HTML技术,同

时也需要人工维护大量的页面链接,这样不仅

导致大量的死链接产生,同时也往往会严重影

响网站内容的更新速度。

TRS WCM 的发布功能为解决上述问题,

提供了一套强大的站点建立、管理工具,同时

能够实现一定的权限控制和流程控制,保证系

统的安全。在页面发布过程中,TRS WCM 的

发布功能正是依靠程序自动结合HTML模板和

数据库中的数据,生成最终的HTML页面的,同时可以自动生成页面的链接而不需要手工干预。其静态页面的工作原理见上图。

HTML 和 TRS 置标

每个页面都必须遵循Web页面标准,才能被浏览器很好的解释和显示,TRS置标本身也是符合HTML标准的附加置标方式,TRS置标和HTML、XML标准兼容。含有TRS置标的Web页面,它可以被任意可视化的Web编辑器(如:DreamWeaver、FrontPage)或非可视化的文本编辑器编辑。在频道定义时需要指定所使用的模板文件,分别控制概览页面和细览页面的表现。

TRS置标说明

置标的主要作用是控制数据在模板中的表现形式,将数据与表现分开。主要思路是TRS置标处理数据的内容,存放的位置以及如何存放等,数据的表现形式则由标准的html语言描述,例如:

这里放置文档标题

其中:第二行是TRS置标,其它部分是标准的HTML置标。TRS置标表明要

在该位置放置字段名为“标题”的字段内容。

根据系统的需要和使用方便,在TRS WCM系统的置标中主要采用了四种类型

的置标,即:

?概览置标

主要用于表示一个循环的属性,例如TRS_DOCUMENTS、TRS_CHANNELS、TRS_RELNEWS等。

?TRS_RECORD

只能在概览置标内部使用;一个概览置标内可以放置多个TRS_RECORD,用来

控制文档不同显示风格。语法如下:

(column_blocks) (column_blocks)

……

一般可以用来作为不同风格显示的控制标记,也可以实现特殊效果,比如实现

一行多列的效果。

?细览置标

主要用于引用某个具体的数据库字段,例如TRS_DOCUMENT、TRS_CHANNEL等。

?TRS_TEMPLATE

用来实现模板的嵌套,嵌套模板支持多级。语法如下:

(template_name) (template_name)和置标之间不能有其他任何字符,否则会出现解析不出正确

模板的问题。

TRS置标统一以“

与 应成对出现,其中细览置标可以这样撰写之间的内容在生成页面时,将被数

据库的输出内容所替代。每个置标都可以有多个置标属性,以实现不同的控制目的。XXX表示当前所取的对象类型,比如文档置标就是DOCUMENT;最后的字母为S表

示是一个概览置标,获取的是一个循环。

其中ID属性表示当前置标所代表的对象从哪个地方获取;例如TRS_DOCUMENTS中的ID表示的是从哪个频道获取文档集合;FIELD属性表示当

前置标获取的是对象的那个属性,和数据库字段一一对应;例如

FIELD=”DOCTITLE”/>表示获取的是当前文档的标题属性。

详细说明:

约定:

下面置标语法中所提及的,是指需要配合细览置标使用。具体的表示方式,请参照各个细览置标说明。

属性的详细说明中的斜体表示自定义的项,粗体表示默认,普通表示可选项

TRS_DOCUMENTS: 文档列表

语法

描述

显示文档列表,顺序与频道“文档列表”页面相同。显示的内容由相应的细览置标来定义。

属性

属性

属性描述 类型

取值

说明

频道名称

当前站点存在的频道名称

PARENT 当前频道的父频道 ID

表示当前的文档集合从那个频道获取

字符串

OWNER 当前频道 -1

表示为当前频道 CHILDIND EX 设置从指定频道(ID )的哪个子频道获取文档 数字 ≥0的整数 表示为第几个子频道 CHANNELT

频道类型

数字

普通频道

1 图片新闻,获取指定频道的图片新闻的文档

YPE

2 头条新闻,获取指定频道的头条新闻的文档

STARTPOS 设置从哪个位置

读取记录

数字 ≥0的整数默认为0

NUM 设置显示的最大

记录条数

数字>0的整数

默认为系统设定的最

大数目

PAGESIZE 使用分页显示,每

一页显示的记录

数目

数字>0的整数

默认表示不进行分页

显示

WHERE 额外的检索条件,

对指定频道的记

录进行再检索

字符串

SQL检索表

达式

默认不检索

ORDER 额外的排序条件,

对指定频道的记

录进行再排序

字符串

SQL排序表

达式

默认不排序

true

如果存在更多,产生

更多链接

AUTOMORE 设置是否产生更

字符串

false

即使存在更多,不产

生更多链接

BEGINMOR E 更多链接的HTML

开始部分(A元素

之前)

字符串HTML代码默认不产生

ENDMORE 更多链接的HTML

结束部分(A元素

之后)

字符串HTML代码默认不产生

MORETEXT 设置更多链接的

描述文字

字符串Text

更多的描述文字,默

认为:“更多内容…”

MOREEXTR A 链接元素上扩展

的HTML内容

字符串HTMLAttr扩展的HTML内容

Name 目标窗口的名称

_blank新开一个窗口

_parent在父窗口打开

MORETARG ET 设置更多打开后

的窗口目标

字符串

_self在当前窗口打开

_top在顶级窗口打开

例子

显示当前频道前10条文档

显示当前频道前10条文档,同时定义更多的方式

按照一页20条显示当前频道的前500篇文档

显示“国际新闻”频道前10条文档

显示“新闻中心”第一个子频道的前10条文档

显示“新闻中心”头条新闻

TRS_RELNEWS: 相关新闻

语法

描述

检索设置的关键词及手工设置的相关文档并显示相关的新闻内容。利用MODE属性,可以获得三种不同的相关新闻集合,发布时,如果MODE没有设置,则系统默认取值为USERDEF,表示只检索手工设置的相关文档并显示。只能应用到细览模板

属性

属性 属性描述 类型 取值 说明

NUM 设置显示的最大

记录条数

数字≥0的整数

默认为系统设定的最

大数目

STARTP OS 设置从哪个位置

读取记录

数字≥0的整数默认为0

MODE 相关新闻提取的

方式

字符串USERDEF

只提取用户手工设置

的相关文档

KEYWORDS

表示从站点所有文档中提取包含当前文档设置的关键词的所有文档

ALL

表示提取USERDEF 和KEYWORDS 两种方式可以获得的所有相关新闻,并且剔除编号相同的文档

例子

人工相关,必须手动指定

自动相关,按照关键词自动进行检索 获取所有相关文档

TRS_CHANNELS: 频道列表

语法

描述

显示指定父频道的所有子频道链接。需要系统能够自动产生一个频道列表的时候,使用此项。目的在于使系统自动产生一个带有链接的频道列表,并放置在置标所在的页面中。

属性 属性

属性描述 类型

取值

说明

频道名称

当前站点存在的频道名称

PARENT 当前频道的父频道 ID

表示从那个频道获取频道集合

字符串

OWNER

当前频道

-1

表示为当前频道(ID) CHILDIN DEX 设置从指定频道(ID )的哪个子频道获取频道集合 数字

≥0的整数

表示为第几个子频道

STARTPO S 设置从哪个位置读取子频道 数字 ≥0的整数 默认为0

NUM 设置显示的最大子频道数 数字

≥0的整数 默认为系统设定的最大数目

CHILDTY PE

所取子频道的类型

数字

-1、0、 1、2

-1为取所有类型的子频道,0为普通频道,1为图片新闻,2为头条新闻,

例子

显示当前频道的子频道列表(从第2个子频道开始)

TRS_CHANNEL: 获取指定频道信息

语法

描述

显示指定频道(ID,ChildIndex)指定字段(Field)的信息。

属性 属性

属性描述

类型

取值

说明

频道名称

当前站点存在的频道名称

PARENT 当前频道的父频道 ID

指定的频道

字符串

OWNER

当前频道 -1 表示为当前频道 CHILDIN DEX 设置指定频道的子频道数字

≥0的整数

表示为第几个子频道 FIELD

频道属性名称

字符串

频道字段

名称

在数据字典中定义,默认为CHNLDESC (频道显示名称)

NUM

设置显示的最大长度

数字

>0的整数

默认不限制,必须大于“TRUNCATEDFLAG ”字

符串的长度,否则不会截断。

DATEFOR MAT 设置日期的显示格式

字符串

日期格式字符串

区别大小写(y:年 M:月 d:日 H:时 m: 分s:秒),默认为yyyy-MM-dd

HH:mm:ss ;仅仅对于日期属性有效

true

需要格式化 AUTOFOR MAT

是否按照指定方式格式化当前数据

字符串

false

不需要格式化

HTML

按照HTML 方式格式化代码(回车?
, 空格?  等等) HTMLValu e

按照HTML 元素属性的方式转义数据(&?& "?" 等等) JAVASCRI PT

按照JavaScript 数据规则转义数据("?\” \?\\等等)

AUTOFOR MATTYPE

格式化类型

字符串

XML

按照XML 元素属性的方式转义数据(&?& "?" 等等) AUTOLIN

是否产生链

字符串 true

产生当前频道的链接

K

接,应用于CHNLNAME CHNLDESC

false 不产生链接 Name

目标窗口的名称 _blank

新开一个窗口 _parent 在父窗口打开 _self 在当前窗口打开 TARGET

链接打开后的窗口目标

字符串

_top

在顶级窗口打开 EXTRA

链接元素上扩展的HTML 内容 字符串 HTMLAttr 扩展的HTML 内容 true

产生链接内容提示 LINKALT 是否产生链接的内容提示 字符串

false

不产生

LINKALT TEXT

设置链接的内容提示文字

字符串 Text

链接的内容提示文字,默认为当前属性值

TRUNCAT EDFLAG

频道名称被截断后,附

加在后面的字符串

字符串 Text

默认”...”,即三个半角省略号

例子

显示科教新闻频道的名称,并且产生链接

显示新闻中心第一个子频道的信息,并且产生链接

TRS_DOCUMENT:文档详细信息

语法

[EXTRA=”A元素上扩展的HTML内容”] [TARGET=”窗口目标”] [LINKALT=”链接是否显示提示”] [LINKALTTEXT=”链接提示内容”] >通用细览

描述

从文档提取指定属性[FIELD],按照指定的方式生成内容替换当前的置标内容。

属性

属性 属性描述 类型 取值 说明

文档字段名称在数据字典中定义, 默认为DOCTITLE(文档标题)

DOCSOURC

E

文档来源

DOCFROM文档来源FIELD文档属性名称字符串

DOCSECUR

ITY

文档安全级别

NUM 设置显示的最大

长度

数字>0的整数默认不限制

DATEFORM AT 设置日期的显示

格式

字符串

日期格式

字符串

区别大小写(y:年 M:月

d:日 H:时 m: 分s:

秒),默认为

yyyy-MM-dd

HH:mm:ss;仅仅对于日

期属性有效

true需要格式化

AUTOFORM AT 是否按照指定方

式格式化当前数

字符串

false不需要格式化

AUTOFORM ATTYPE 格式化类型字符串HTML

按照HTML方式格式化代

码(回车?
空格

? 等等)

HTMLValu e 按照HTML元素属性的方式转义数据(&?& "?"等等)

JAVASCRI PT 按照JavaScript数据规则转义数据("?\”\?\\等等)

XML 按照XML元素属性的方式转义数据(&?& "?"等等)

true 产生当前文档的链接,对于来源为来源链接。对于DocTitle,默认为true,但在细览页面AUTOLINK无效。

AUTOLINK 是否产生链接,不

允许AUTOLINK

的字段有:

DOCHTMLCON,D

OCHTMLCONTEN

T,DOCPUBHTML

CON,DOCPUBTI

ME,DOCSECURI

TY

字符串

false

不产生链接;对于其它属

性默认为false。

Name目标窗口的名称

_blank 新开一个窗口

_parent 在父窗口打开

_self 在当前窗口打开

TARGET 链接打开后的窗

口目标

字符串

_top 在顶级窗口打开

EXTRA 链接元素上扩展

的HTML内容

字符串HTMLAttr扩展的HTML内容

true 产生链接内容提示

LINKALT 是否产生链接的

内容提示

字符串

false不产生

LINKALTT EXT 设置链接的内容

提示文字

字符串Text

链接的内容提示文字,默

认为当前属性值

例子

显示标题字段的内容,不设定长度

显示标题字段的内容,并设定长度为50显示日期字段的内容,并且格式化日期显示摘要,并且格式化

显示文档来源

TRS_APPENDIX:文档附件

语法

附件

描述

在细览中显示当前文档的附件内容。

属性 属性

属性描述

类型

取值 说明 PIC 图片 FILE 文件 LINK 链接 MODE 附件类型 字符串

ALL

所有附件

FIELD 附件属性名称 字符串字段名称

WCMAppendix 的字段名称

-1 表示获取所有的附件 INDEX 获取指定序号的附件 数字 ≥0的整数 指定的序号 true 产生当前附件的链接 AUTOLIN

K 是否产生链接 字符串false 不产生链接 EXTRA 链接元素上扩展的HTML 内容字符串HTMLAttr 扩展的HTML 内容 BEGINHT M L 附件前面额外HTML 代码 字符串HTMLAttr 附件前面额外HTML 代码

ENDHTML

附件后面额外HTML 代码 字符串

HTMLAttr 附件后面额外HTML 代码

true

产生图片说明 MEMO 是否产生图片说明。此属性只对图片附件有效

字符串

false

不产生图片说明

BEGINHT ML 图片说明前面

额外HTML代

码。此属性只对

图片附件有效

字符串HTMLAttr

附件前面额外HTML 代

ENDHTML 图片说明后面

额外HTML代

码。此属性只对

图片附件有效

字符串HTMLAttr

附件后面额外HTML代


如果没有设置FIELD,默

认为

SEPERAT OR 多个附件之间

的分隔符

字符串

\n

如果设置了Field,默认

\n

例子

显示文档的第一个图片附件

显示文档的第一个文件附件

显示文档的第一个链接附件

TRS_CURPAGE:当前位置

语法

当前页面

描述

显示该页面在当前站点中的地图,可以显示自己或包含自己和所有父节点的层次关系,可以应用到概览模板和细览模板中。

属性

属性 属性描述 类型 取值 说明

VALUE路径中频道字符串Separato频道名称之间的分隔符

名称之间的分隔符

r 默认为 “>” true 仅仅显示自己 ONLY

仅仅显示当前频道

字符串

false 显示完整的路径 true 路径中每一个节点产生链接 AUTOLINK

是否产生链

字符串

false 不产生链接 Name 目标窗口的名称 _blank

新开一个窗口 _parent 在父窗口打开 _self 在当前窗口打开 TARGET

链接打开后的窗口目标

字符串

_top

在顶级窗口打开 EXTRA

链接元素上扩展的HTML 内容

字符串HTMLAttr

扩展的HTML 内容

例子

显示当前所在的频道路径

TRS_DATETIME:发布日期

语法

发布日期

描述

显示发布该页面的发布日期

细览置标;独立使用;可以应用到概览模板和细览模板

属性

DATEFORMAT

说明

z DATEFORMAT字符串,设置日期的显示格式。

日期格式字符串,区别大小写(y:年 M:月 d:日 H:时 m:

分s:秒)

默认为yyyy-MM-dd HH:mm:ss;

仅仅对于日期属性有效

例子

显示当前的发布时间

TRS_REPLACE:替换内容

语法

替换内容

描述

根据名称显示在频道中定义替换内容的内容。独立使用,可以应用到概览模板和细览模板。

属性

VALUE

说明

VALUE="替换名称"属性是必须要设置的。

例子

如果在频道A和B中都定义了替换内容DEMO,并分别给他们赋值https://www.doczj.com/doc/1310123412.html,https://www.doczj.com/doc/1310123412.html,。同时在他们使用的共同模板C中使用替换内容。发布后,在频道A页面的TRS_REPLACE置标放置的地方用

href=https://www.doczj.com/doc/1310123412.html,>https://www.doczj.com/doc/1310123412.html,替换,在频道B 页面的TRS_REPLACE置标放置的地方用https://www.doczj.com/doc/1310123412.html,替换。

在模板中替换已定义内容

TRS_RECPATH:记录路径

语法

当前记录路径

描述

显示当前记录的绝对路径,可应用到概览模板和细览模板中。

属性

说明

例子

……

记录路径’>详细报道

TRS_RECORD:分组显示置标

语法

描述

获取指定记录数的数据并结合column_block中定义的内容显示

不能独立使用;必须结合概览置标才能使用

属性

NUM

说明

z NUM 数字设置显示的最大记录条数

>0的整数,默认为1

例子

多行显示文档,一行显示三篇文档

TRS_TEMPLATE:嵌套模板

语法

嵌套模板名称

描述

指定当前的位置使用嵌套模板的内容

属性

说明

例子

指定当前位置使用[页面头部嵌套模板]的内容

置标撰写样例:

显示当前频道前10条文档

Code:

标题入库时间

发布结果:

...

标题入库时间
文档1(标题根据实际情况而变])2005-01-01 13:20:31
文档2(标题根据实际情况而变)2005-01-02 13:20:31
文档3(标题根据实际情况而定)2005-01-03 13:20:31

显示当前频道前10条文档,同时定义更多的方式

Code:

标题入库时间

发布结果:

...

标题入库时间
文档1(标题根据实际情况而变])2005-01-01 13:20:31
文档2(标题根据实际情况而变)2005-01-02 13:20:31
文档3(标题根据实际情况而定)2005-01-03 13:20:31

更多新闻

按照一页20条显示当前频道前500篇文档

Code:

相关主题
文本预览
标题入库时间