XML 要素

用于所有格式的常用功能

• 要素类型 - 销售价格成本计算

  类型为 1 的要素（文本要素）包含数据，而类型为 2 和 3 的要素用于创建子部分（定义起始和结束要素）。

• 数据来源

  在文本要素是指定应从何处检索数据的数据源时使用。最常用的数据源是 1-“字段”，用在从表或虚拟字段中获取数据时。

  数据字段的来源也可以用于自定义输出媒体选择。打开 (MNS205) 和文档媒介控制对象。连接媒介 (CRS949) 中的“主题”、“电子邮件文本”和“文件名”字段。从可配置 XML 文件中提取字段值，然后将其存储在预定义的常数中。

  该表显示可用的预定义常数：

  常数	描述
  <CDTT>	当前日期和时间
  <STDT>	包含通用标准时间信息的当前日期
  <CSTI>	包含通用标准时间信息的当前时间
  <USID>	当前用户 ID
  <DIVI>	当前分部
  <PRTF>	当前打印机程序
  <PGNM>	当前开始程序
  <RLAY>	(MNS210/B) 报表布局
  <RPLY>	(CMS025/B) 报表布局
  <LITX>	开始程序中的报告文本
  <PFDS>	(CMS005/E) 打印机文件描述
  <XMLT>	(CMS006/E) 变型
  <XMDS>	(CMS004/B) 描述
  <DODV>	打印机程序分部

• 描述

  用作 (CMS009) 中的内部描述，并且从不包含在 XML 文件中。

• 要素名称

  要在 XML 文件中使用的要素名称，此内容只能针对格式为 3-“开放”的 XML 结构进行更改。请参阅下文以了解用于格式 1 和 2 的标准。

• 标签

  标签包含在 XML 文件中。特性“标签”（在 F 屏幕上定义）包含翻译为正确语言的标签（基于用户、客户或供应商）。

  注意

  对于分组的部分（在 CMS007/E 中指定），特性“标签”将移动到分组部分级别，并且未在 F 屏幕上按要素进行定义。

  这些方法用于决定标签的设置方式：

  • 备选项 1 - 不包含任何标签。
  • 备选项 2 - 将使用来自字段所在表中的标准 M3 消息 ID。翻译取自消息文件 MVXCON。
  • 备选项 3 - 可以指定替换 M3 消息 ID 和消息文件。如果未指定消息文件，则使用 MVXCON。
  • 备选项 4 - 可以指定替换文本。翻译使用“语言”按钮进行指定。替换文本的长度可以为 1 到 15 个字符。

    当语言按钮中未指定为打印机文件设置的语言时，使用复选框“回退到标准消息”。如果激活了该复选框，则“标准消息 ID”用作 XML 中字段、部分和变量的标签。如果复选框未激活，则字段、部分或变量的 XML 标签将没有标签。

  • 备选项 5 - 标签的文本取自另一个字段。通常在标签由输出功能动态设置时使用，例如会计维度 1-7。
• 列格式

  用于设置 Excel 输出 (CSV) 中的单元格格式。

  可以使用以下备选项设置列格式：

  • 备选项 0 - 无，单元格格式始终设置为“常规”。
  • 备选项 1 - 若字段的数据类型为“字符串”（请参阅 (CMS009/E)），则根据字段值，单元格格式将设置为“文本”。否则，单元格格式将设置为“常规”。
  • 备选项 2 - 文本，单元格格式将始终设置为“文本”。

  即使在“XML 结构。打开”(CMS006/E)中启用了“多行”，总是第一行确定整列的单元格格式。

  注意

  该功能仅在使用 Excel 模板时有效，因此必须为单个 CSV 在“XML 结构。打开”(CMS006/E)中以及为多个 CSV 在“XML 结构。打开部分”(CMS007/E)中指定工作表名。

• 借方/贷方代码

  指示借方/贷方代码信息是否应包含在 XML 文件中，并且仅在字段组。显示允许的字段 (CRS109/E) 上对字段信息代码等于 A01-“货币”的字段显示。

  如果选择字段“借方/贷方代码”作为特性，则“D-C”包含在 XML 文件中。如果 M3 BE 表有一个单独 D/C 代码字段，则使用该字段，否则将根据设置 - 总账 (CRS750/E) 上的金额和设置来设定 D/C 代码。该特性包含在 XML 文件中的先决条件是借方/贷方代码功能对 (CRS750/E) 上的分部有效。

• 隐藏零值

  仅对数据类型为“5 - 小数”的字段显示。

  为零的数字字段可以按照 0,00 或空白的格式包含在 XML 文件中。如果选择了字段“隐藏零值”，则以空白格式包含零，否则以 0,00 格式包含零。

• 特性（F 屏幕）

  F 屏幕用于定义要素的特性。对于每个要素，最多可以定义七项特性。

  特性 1 和 2 是保留特性并且无法编辑。

  • 特性 1：包含标签的值（有关详细信息，请参阅上文）。
  • 特性 2：包含借方/贷方代码的值（有关详细信息，请参阅上文）。

格式 1 - M3 标准文档

要素序号

用作 XML 文件中某部分内要素的顺序。该序号分为数组：

要素序列	备注
0001-3999	为交付的标准 XML 结构 (M3_STD_0x-0x) 中的预定义要素保留。您不能在此组中添加或删除元素
4001-6998	为交付的标准 XML 结构 (M3_STD_0x-0x) 中的预定义要素保留，在该结构中该表对于国家/地区配置组件为唯一。您不能在此组中添加或删除元素
7001-9998	可以添加、更改或删除要素。

要素名称

如果数据源设置为1-“字段”，则使用以下规则设置要素：

• 对于数据库字段，它设置为等于 6 位数据库字段的名称，例如 OAORNO 或 MMITNO。
• 对于虚拟字段，用 VF 替换 &，例如 VFCUCD 或 VFACAM
• 对于其他数据源，要素名称设置为 ZZxxxx，其中 xxxx 是每个数据源的预定义后缀。

XML 示例

包含三个要素的 XML 示例

<UIIVNO Label="Invoice no">201401561</UIIVNO>

<VFORNO Label="CO no">1000025077</VFORNO>

<OAWHLO Label="Warehouse">110</OAWHLO>

格式 2 - M3 标准文档

对于 M3 标准报表格式，要素以行和列格式构成。每列必须属于一行。在 (CMS009) 中，“起始”和“结束”要素表示一行，并且这些开始和结束要素之间的所有要素都属于该行。

• 要素序号

  用于对 XML 文件中的要素进行排序，并确定该要素属于哪一行。

  为每一行保留一系列序列号：

  要素序号	已保留
  0002-0999	为行 1 保留
  1002-1999	为行 2 保留
  …	…
  8002-8999	为行 9 保留

• 添加或删除行

  使用功能键 F21=“添加行”完成添加行，此操作将为下一个可用行创建一个开始和结束要素。使用功能键 F22 =“删除行”完成删除行，此操作将删除编号最大的行的开始要素、结束要素和之间的所有文本要素。

• 列号

  用于指示布局中字段的列号。在一行中，列号必须唯一。列号是要素名称的一部分。更改列号会自动更新要素名称。

• 字段长度

  用于指示布局中字段所需的空间。默认值取自表中的字段长度。

• 要素名称

  设置为“Cx”，其中“x”是列号（请参阅上面的“列号”）。

• 附加标签

  如果字段需要附加标签，则该标签通过指定 M3 消息 ID 和消息文件来定义。如果未指定消息文件，则使用 MVXCON。然后，将附加标签包含在翻译为正确语言的 XML 文件中（基于用户、客户或供应商）。

• 在作业运行级别禁用字段

  可能需要禁用特定字段，以便不包含在整个作业的 XML 文件中。例如，只有在使用增值税时才应包含字段“增值税代码”。

  此内容由参数“运行已禁用”控制。是否应禁用字段的决定基于部分类型 REPORT 中的虚拟字段。如果虚拟字段为 true（值 1），则认为该字段被禁用。

  参数“运行已禁用”的备选项：

  • 1 = 无禁用控制
  • 2 = 禁用控制 - 字段仍包含在 XML 文件中，但在禁用的情况下值设置为空白
  • 3 = 禁用控制并移除 - 在禁用的情况下，将从 XML 文件中移除字段

格式 3 - 开放

对于开放格式，不存在任何附加功能或其他限制。