TOC 目录编辑

TOC（Table of Contents）Editor 是 Aras Innovator 提供的图形化目录配置工具，用于管理导航面板中的分类目录（Category）和 ItemType 按钮。管理员可以在一个界面中完成所有目录项的创建、排序、访问控制和预览。

---

TOC Editor 入口

导航到 Administration → Configuration → TOC Editor 即可打开。

编辑器界面由三个区域组成：

区域	说明
Toolbar	顶部工具栏，包含保存、丢弃、新建、删除、排序等操作按钮
Contents Pane	左侧面板，展示所有 Category 和 ItemType 按钮的树形结构
Details Pane	右侧面板，展示并编辑选中项的属性配置

---

工具栏操作

按钮	说明
Save	保存当前编辑内容
Discard	丢弃未保存的修改
Add Category	新建分类目录。如果当前选中了某个 Category，新分类将成为其子分类
Add Item Type	新建 ItemType 按钮，挂在当前选中的 Category 下
Add Item	在目录中放置单条 Item 的快捷入口
Add Form	在目录中放置一个独立表单入口
Add Page	在目录中放置一个 HTML 页面入口
Delete	删除选中的 Category 或 ItemType 按钮
Move Up / Move Down	在同一层级内上下移动选中项的位置
Add to Package Definition	将新建的目录项添加到打包定义中

---

分类目录管理

创建顶级分类

1. 确保 Contents Pane 中未选中任何项（点击 Contents 标题取消选择）
2. 点击 Add Category
3. 在 Details Pane 中填写 Label（显示名称）
4. 保存

创建子分类

1. 在 Contents Pane 中选中一个父 Category
2. 点击 Add Category
3. 新分类自动成为选中分类的子级
4. 填写 Label 并保存

移动分类

选中分类后，通过以下方式调整位置：

• 拖拽：直接在 Contents Pane 中拖放到目标位置
• Move Up / Move Down：在同一父级内逐位移动

---

ItemType 按钮配置

在 Contents Pane 中选中一个 ItemType 按钮后，Details Pane 中可以配置以下属性：

配置项	说明
ItemType	关联的 ItemType（选择后，点击该按钮将打开对应的检索或新建界面）
Icon	按钮的图标，支持 SVG 格式
Label	按钮的显示文本，支持多语言
Access	控制哪个 Identity 可以在导航面板中看到此按钮

Access 仅支持单一 Identity

每个按钮只能配置一个 Identity。如果需要让多个不同的角色都能看到同一个 ItemType，需要创建多个按钮分别配置，或者使用一个包含所有目标角色的上层 Group Identity。

---

排序模式

TOC 的排序方式通过 Details Pane（未选中任何项时显示）的 Sort 字段配置：

模式	说明
Alphabetical	按字母顺序排列（默认）
Custom	按 Contents Pane 中手动排列的顺序显示

---

View As 预览

View As 功能允许管理员以特定 Identity 或语言的视角预览目录，无需切换账号登录：

1. 在 Contents Pane 底部点击 View As
2. 选择要预览的 Identity（用户/组身份）或语言
3. 目录立即以只读模式展示该 Identity 的可见内容
4. 点击 Clear 返回编辑模式

用 View As 做权限验证

在配置完 Access 后，切换到对应 Identity 的视角确认目录可见性，比切换账号登录验证效率高得多。

---

目录设计建议

• 先规划 Identity 层级，再设计目录结构：目录的 Access 配置依赖 Identity 体系，建议先理清组织架构和角色划分
• 使用 Group Identity 作为 Access 值：避免直接使用 Alias Identity（个人身份），这样人员变动时只需调整组成员
• 为不同角色提供差异化入口：同一 ItemType 可以在不同 Category 下放置多个按钮，配置不同的 Label 和 Access，为不同角色提供定制化的导航体验
• Custom 排序配合业务逻辑：将高频操作的 ItemType 放在目录靠前位置，提升用户操作效率