CICS 的 Atom 元素引用
这些表格为以下元素之间的关系提供了参考：Atom 源文档中使用的元素；Atom 条目元素中使用的元素；<cics:fieldnames> 元素的属性；以及 CICS® 可传递给服务例程用于资源处理的参数。
在 CICS 中创建 Atom 订阅源文档时，您可以指定按 RFC 4287 中 Atom 格式规范定义的元素。 其中某些元素作为<atom:feed>元素的子元素，用于为整个Atom源提供元数据，例如源的标题。 某些元素作为<atom:entry>元素的子元素使用，为单个条目提供元数据或内容。 大多数元素既用于定义源，也用于定义单个条目；例如，每个条目都有一个由<atom:id>元素指定的唯一标识符，而源本身也拥有一个唯一标识符。 有关每个元素的完整描述，请阅读 RFC 4287。
在 CICS 中的 Atom 源文档中， CICS 使用单个原型 <atom:entry> 元素来生成各个条目。 如果在该元素中指定子元素，那么缺省情况下，此处的元数据将应用于所有条目。 然而，若您用于为Atom源提供内容的 CICS 资源包含合适的元数据，则可通过<cics:fieldnames>元素的属性告知 CICS ：子元素的数据是否存在于资源记录中，以及具体位置。 例如，您可以在资源记录中指定一个字段，用于为包含在该记录中的条目提供标题。 如果您的资源记录中缺少某些元数据（例如作者姓名），则可省略<cics:fieldnames>元素中的该属性。 CICS 要么从配置文件中对应的原型<atom:entry>元素中提供该元数据项，要么省略该项。 如果您的资源记录中不包含任何合适的元数据，则可完全省略<cics:fieldnames>元素，此时 CICS 将发布整个资源记录作为条目内容。
CICS 传递给服务例程的参数包括与<cics:fieldnames>元素属性相对应的参数。 如果您希望编写一个用于从 Atom 配置文件中获取有关资源结构的信息的服务例程，而不是将该信息直接编码到服务例程中，那么可以使用这些资源处理参数。 通过该方法，您可以创建能够处理多个资源的类属服务例程。
| 元素 | 含义 | 对于订阅源 | 对于条目 | <cics:fieldnames> 属性（用于条目） | 服务例程参数（对于条目） |
|---|---|---|---|---|---|
| <app:edited> | 上一次编辑条目的时间 | 未使用 | 必需（如果在集合中），由 CICS 生成 | edited | ATMP_ EDITED |
| <atom:author> | 主要作者的详细信息 | 必需（只要不是所有条目都包含该元素） | 可选（如果订阅源包含该元素） | 不适用（数据位于子元素中） | 不适用（数据位于子元素中） |
| <atom:category> | 对订阅源或条目进行分类的类别 | 可选 | 可选 | category | ATMP_ CATEGORY_ FLD |
| <atom:content type=" "> | 条目的内容 | 未使用 | 必需 | content, content_type | ATMP_ CONTENT_ FLD 和 ATMP_ CONTENT_ TYPE_FLD |
| <atom:contributor> | 辅助作者的详细信息 | 可选 | 可选 | 不适用（数据位于子元素中） | 不适用（数据位于子元素中） |
| <atom:email> | 作者或参与者的电子邮件地址 | 可选 | 可选 | email（仅限作者，不支持参与者） | ATMP_ EMAIL_ FLD |
| <atom:generator> | 生成订阅源的代理程序 | 由 CICS 生成 | 未使用 | 不适用（不用于条目） | 不适用（不用于条目） |
| <atom:icon> | 表示订阅源的图标 | 可选 | 未使用 | 不适用（不用于条目） | 不适用（不用于条目） |
| <atom:id> | 订阅源或条目的唯一标识 | 必填项， CICS 会在指定<cics:authority>元素时生成 | 必填项， CICS 会在指定<cics:authority>元素时生成 | atomid | ATMP_ ID_ FLD |
| <atom:link rel="self"> | 用于检索订阅源或条目文档的 URL | 必需 | 必需（对于 CICS） | 不适用（未存储在资源中） | 不适用（未存储在资源中） |
| <atom:link rel="edit"> | 用于编辑集合中条目的 URL（成员 URI） | CICS 为集合生成 | 由 CICS 生成（条目在集合中时） | 不适用（未存储在资源中） | 不适用（未存储在资源中） |
| <atom:logo> | 订阅源的徽标 | 可选 | 未使用 | 不适用（不用于条目） | 不适用（不用于条目） |
| <atom:name> | 作者或参与者的姓名 | 必需（在作者或参与者元素中） | 必需（在作者或参与者元素中） | author（仅限作者，不支持参与者） | ATMP_ AUTHOR_ FLD |
| <atom:published> | 第一次创建或发布条目的时间 | 未使用 | 可选 | published | ATMP_ PUBLISHED_ FLD |
| <atom:rights> | 订阅源的知识产权 | 可选 | 可选 | 在资源中不受支持 | 在资源中不受支持 |
| <atom:source> | 通过使用其他订阅源中的条目而获得的元数据 | 未使用 | 可选，但 CICS 不支持 | 不支持 | 不支持 |
| <atom:subtitle> | 订阅源的子标题 | 可选 | 未使用 | 不适用（不用于条目） | 不适用（不用于条目） |
| <atom:summary> | 条目内容的简要描述 | 未使用 | 必需（如果内容为非文本或 XML） | summary | ATMP_ SUMMARY_ FLD |
| <atom:title> | 订阅源的标题 | 必需 | 必需 | title | ATMP_ TITLE_ FLD |
| <atom:updated> | 上一次更新订阅源的时间 | 必需，由 CICS 生成 | 必需，由 CICS 生成 | 更新 | ATMP_ UPDATED_ FLD |
| <atom:uri> | 作者或参与者 Web 站点的 URL | 可选 | 可选 | authoruri（仅限作者，不支持参与者） | ATMP_ AUTHORURI_ FLD |