Confluence 从模板创建宏

从模板创建宏用于在页面显示按钮,然后通过按钮链接到特定的模板。

当用户单击按钮后,宏将会在编辑器中打开,然后可以开始准备添加一个新页面,新的页面通过给定的模板进行进行新增内容。

当添加这个宏到页面的时候,你可以可以指定一个蓝图或者这个宏创建的模板。你也可以为显示的按钮进行命名和定义新增页面所在的空间。

示例

屏幕截图:一个有三个按钮的页面,所有的按钮都是通过 '从模板创建宏' 创建的



参数

宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。

Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的。

这些将会在下面在括号内容中列出(example)。

参数 是否是必须 默认值 说明
按钮文本(Button Text)   'Create from Template' 当用户查看到这个宏的时候,宏显示的文本。
模板名字(Template Name)   None 选择新页面使用的模板或者蓝图。在当前空间中可用的全局或者用户新建的模板(除非你指定了空间的关键字字段)。
模板标题(Template Title)   空白 为新建的页面指定默认的标题(可选的)。你可以在标题中使用 @currentDate,@spaceName 和 @spaceKey 变量。
空间关键字(Space Key)   新建的空间默认使用的是当前的空间 支持唯一的空间定义(空间关键字),来确定新页面在那个空间中进行创建。



存储格式可以使用的参数与宏浏览器中使用的参数是不同的,具体请参考下面的表格:

参数名称 是否必须 默认值 参数描述和可以接受的值
templateId 用户创建的模板是必须需要的 (None) 用户创建模板的 ID。这个 ID 是唯一的 ID,Confluence 使用这个 ID 来为你指定模板,例如:299630593。
为了找到这个 ID,编辑你需要的模板,然后在你的浏览器中的地址栏中查看你的 URL。模板 ID 在 URL 中的参数 entityId 中。
blueprintModuleCompleteKey 需要蓝图 (None)  
templateName Yes (None) 用户创建模板的 ID(例如:299630593)或者符合要求的名字,这个名字是在蓝图插件中定义的,(例如:com.atlassian.confluence.plugins.[color=#3b73af !important]confluence-shared-files-plugin:file-list-blueprint)。
buttonLabel Yes 'Create from Template' 在页面中使用这个宏应该显示的名字。
spaceKey Yes 空间的名字,默认是当前空间 空间的唯一定义,为了指定新页面在那个空间中创建。
Title No (None) 新建页面使用的标题,你可以在标题中使用 你可以在标题中使用 @currentDate,@spaceName 和 @spaceKey 变量。这个变量将会覆盖蓝图模板中使用的标题。



来源:http://cwiki.ossez.com/pages/viewpage.action?pageId=2393253

猜你喜欢

转载自osseztec.iteye.com/blog/2016271