iBizModel 日历部件（PSSYSCALENDAR）模型体系详解 - 教程

iBizModel 日历部件（PSSYSCALENDAR）模型体系详解

引言

iBizModel 系统日历部件模型体系是 iBizModel 架构中专门用于处理时间相关数据可视化与交互的核心组成部分。该体系基于 PSSYSCALENDAR 模型构建，提供了完整的日历功能实现框架，支持从简单的日程显示到复杂的时间轴项目管理等多种应用场景。系统日历部件不仅具备丰富的数据展示能力，还集成了强大的交互逻辑和扩展机制，是企业级应用中时间管理功能的要紧基础。

在线体验

点击访问iBizAppHUB示例系统查看日历部件更多场景

⚡ 提示：点击右侧调试工具栏，可直接查看指定视图在iBizModeling软件的配置。

模型体系架构

核心模型关系图

模型层级结构详解

1. PSSYSCALENDAR（日历部件模型）

作为日历部件体系的根模型，PSSYSCALENDAR 定义了日历的整体框架和基础配置。其核心属性包括：

• calendarstyle：日历样式枚举，支持天(DAY)、周(WEEK)、月(MONTH)、时间轴(TIMELINE)等多种显示模式
• navviewpos：导航视图位置控制，支持右侧、下方等多种布局方式
• groupmode：素材分组模式，支持自动分组、代码表分组等高级功能
• psdeid：关联的实体模型

PSSYSCALENDAR 经过引用 PSDATAENTITY 建立数据基础，依据 PSDETOOLBAR 集成操作工具，通过 PSCTRLLOGICGROUP 附加控制逻辑，形成了完整的日历功能框架。

2. PSSYSCALENDARITEM（日历部件项模型）

作为日历信息展示的核心，PSSYSCALENDARITEM 定义了具体的数据项部署：

• beginpsdefid 和 endpsdefid：时间范围定义，支持精确的时间区间控制
• itemtype：项类型标识，拥护多数据源混合显示
• psdeid：数据集所在实体
• psdedsid：数据集引用，确保素材查询的灵活性
• viewactions：操作控制集合，支持建立、编辑、删除等完整CRUD操作

通过每个日历项能够独立配置样式、颜色、图标等视觉属性，并支持拖拽编辑、上下文菜单等交互特性。

3. PSSYSCALENDARITEMRV（日历项引用视图模型）

该模型提供了日历项与详细视图的关联机制：

• psdeviewbaseid：关联的实体视图，支持点击日历项跳转到详细页面
• name：引用模式定义，控制视图打开方式
• viewparams：视图参数传递，支持上下文信息传递

凭借引用视图机制，日历部件完成了从概览到详情的无缝导航体验。

4. PSSYSCALENDARLOGIC（日历部件逻辑模型）

逻辑模型为日历部件给出了动态行为控制：

• triggertype：触发类型，支持定时器、视图事件、部件事件等多种触发方式
• dstlogictype：目标逻辑类型，支持实体界面逻辑、体系预置逻辑、前端插件等处理目标
• timer：定时器间隔，帮助周期性逻辑执行

逻辑模型使得日历部件可以根据业务规则动态调整显示内容、控制用户操作权限、构建复杂的交互流程。

关键技术特性

多数据源集成能力

PSSYSCALENDAR 支持通过多个 PSSYSCALENDARITEM 集成不同实体的数据，在同一个日历界面中显示来自多个业务模块的时间相关数据。例如，在任务管理系统可以同时显示任务计划、会议安排和资源预约。

灵活的视图配置

经过 calendarstyle 枚举，日历部件协助六种内置视图样式和用户自定义样式。每种样式都针对特定的启用场景优化：

• 天视图：适合精细的日程安排
• 周视图：平衡细节和概览
• 月视图：提供长期规划视角
• 时间轴：适合项目进度跟踪
• 复合时间轴：结合时间轴和传统日历优势

强大的交互控制

通过 PSSYSCALENDARLOGIC 和 PSSYSCALENDARITEM 的协同，日历部件支持丰富的交互作用：

• 拖拽调整时间：直接通过拖拽修改事件时间
• 上下文菜单：右键快捷操作
• 实时资料更新：定时器驱动的数据刷新
• 条件显示控制：基于业务规则的动态显示

扩展性设计

模型体系通过插件机制（pssyspfpluginid）支持功能扩展，前端样式经过 PSSYSCSS 引用支持主题定制，确保了平台的可维护性和可扩展性。

DSL 代码实现示例

基于工具返回的模型信息，以下是完整的框架日历部件 DSL 实现示例：

//iBizModelDSL建模指令，目标：构建企业级项目管理系统日历部件
def de_project = "ProjectManagement.PROJECT"
def de_task = "ProjectManagement.TASK"
def de_meeting = "ProjectManagement.MEETING"
def mod_pm = "ProjectManagement"
// 主项目日历 - 月视图，支持多数据源
pssyscalendar(
psmoduleid: mod_pm,
codename: "ProjectMainCalendar",
name: "项目主日历",
psdeid: de_project,
calendarstyle: "MONTH",
navviewpos: "RIGHT",
navviewheight: 400.0,
navviewshowmode: 0,
enableedit: 1,
busyindicator: 1,
emptytext: "暂无日程安排",
pssyscssid: "System.CalendarTheme",
quickpsdetoolbarid: "ProjectManagement.QuickToolbar",
batpsdetoolbarid: "ProjectManagement.BatchToolbar"
){
// 项目任务项
pssyscalendaritem(
itemtype: "project_task",
name: "项目任务",
psdeid: de_task,
psdedsid: de_task + ".ActiveTasks",
beginpsdefid: de_task + ".PLAN_START_DATE",
endpsdefid: de_task + ".PLAN_END_DATE",
textpsdefid: de_task + ".TASK_NAME",
colorpsdefid: de_task + ".PRIORITY_COLOR",
bkcolorpsdefid: de_task + ".STATUS_BGCOLOR",
iconpsdefid: de_task + ".TASK_ICON",
enableviewactions: 1,
viewactions: 31, // 支持建立、编辑、查看、删除、拷贝
editmode: 1,
maxsize: 1000,
psdetoolbarid: "ProjectManagement.TaskContextMenu",
psdeviewbaseid: de_task + ".TaskDetailView"
){
pssyscalendaritemrv(
name: "edit",
psdeviewbaseid: de_task + ".TaskEditView"
)
pssyscalendaritemrv(
name: "view",
psdeviewbaseid: de_task + ".TaskDetailView"
)
}
// 会议安排项
pssyscalendaritem(
itemtype: "meeting",
name: "会议安排",
psdeid: de_meeting,
psdedsid: de_meeting + ".UpcomingMeetings",
beginpsdefid: de_meeting + ".MEETING_START_TIME",
endpsdefid: de_meeting + ".MEETING_END_TIME",
textpsdefid: de_meeting + ".MEETING_TITLE",
contentpsdefid: de_meeting + ".MEETING_AGENDA",
color: "#2E7D32",
bkcolor: "#E8F5E8",
enableviewactions: 1,
viewactions: 7, // 支持建立、编辑、查看
editmode: 0,
psdeviewbaseid: de_meeting + ".MeetingDetailView"
)
}
// 项目时间轴日历 - 用于项目进度跟踪
pssyscalendar(
psmoduleid: mod_pm,
codename: "ProjectTimeline",
name: "项目时间轴",
psdeid: de_project,
calendarstyle: "TIMELINE",
groupmode: "AUTO",
grouppsdefid: de_project + ".PROJECT_PHASE",
navviewpos: "BOTTOM",
navviewheight: 300.0,
enableedit: 1
){
pssyscalendaritem(
itemtype: "timeline_task",
name: "时间轴任务",
psdeid: de_task,
psdedsid: de_task + ".TimelineTasks",
beginpsdefid: de_task + ".ACTUAL_START_DATE",
endpsdefid: de_task + ".ACTUAL_END_DATE",
textpsdefid: de_task + ".TASK_NAME",
progresspsdefid: de_task + ".PROGRESS_PERCENT",
levelpsdefid: de_task + ".TASK_LEVEL",
enableviewactions: 1,
viewactions: 15
)
}
// 个人工作台日历 - 天视图，支持快速操作
pssyscalendar(
psmoduleid: mod_pm,
codename: "PersonalWorkbench",
name: "个人工作台",
psdeid: de_task,
calendarstyle: "DAY",
navviewpos: "NONE",
enableedit: 1,
quickpsdetoolbarid: "ProjectManagement.PersonalQuickToolbar"
){
pssyscalendaritem(
itemtype: "personal_tasks",
name: "个人任务",
psdeid: de_task,
psdedsid: de_task + ".PersonalTasks",
beginpsdefid: de_task + ".PLAN_START_DATE",
endpsdefid: de_task + ".PLAN_END_DATE",
textpsdefid: de_task + ".TASK_NAME",
colorpsdefid: de_task + ".URGENCY_COLOR",
enableviewactions: 1,
viewactions: 31,
editmode: 1
)
}

模型体系优势总结

iBizModel 系统日历部件模型体系通过层次化的模型设计和丰富的设置选项，为企业级应用提供了强大的时间数据管理能力。