自定义 IDM 集成工作流

您可以使用“IDM 文档工作流表单”上的高级功能以及应用程序事件系统 (AES) 后台任务来自定义预定义的工作流或添加新的文档工作流。

在某些情况下，您可能需要编辑或添加文档工作流：

  • 您的用户希望根据采购单合同编号查找采购单，您希望将其添加为搜索和检索 Document Management 中文档的特性。您可以将工作流的参考 IDO 中存在的任何值添加为特性。
  • 您的“采购单报告”表单具有包含新字段的个性化，且您希望用户能够对该字段进行过筛选。个性化报告表单仍使用标准后台任务名称。在这种情况下，您可以将新 IDM 特性的特性名称附加到标准工作流记录上的 IDOPropertyList。
  • 您的开票单据已使用非标准后台任务名称进行自定义。您希望在工作流中使用该后台任务，而不是标准名称。
  • 您希望为另一个不在当前预定义工作流列表中的报告后台任务添加工作流。

使用此流程：

  1. 打开“IDM 文档工作流”表单
  2. 创建一个新的工作流记录。（如果仅将特性添加到现有工作流，或者仅将后台任务名称更改为自定义任务名称，则只需复制现有工作流记录并清除现有记录的“活动”字段。）
  3. 单击“高级”查看高级设置字段。

    这些字段中的信息定义了应用程序事件系统 (AES) 用于从后台任务参数中提取值的元数据。值通过 API 传递给 Document Management。

  4. 根据工作流的需要指定此信息：
    注意：有关如何使用其中某些字段的示例，请参阅“IDM 文档工作流示例”。
    显示
    选择要在表单上显示的部分的选项：
    • “关键文本”值解析为可由其他关键文本变量引用的 AES 事件变量。最多可以将 15 个值或公式定义为关键文本。您可以一次显示 5 个值。
    • “完成文本”值解析为可由其他完成文本变量引用的 AES 事件变量。最多可以将 15 个值或公式定义为完成文本。您可以一次显示 5 个值。
    • “IDO”值用于定义查找的数据源 (vIdoName)，该数据源用于在“vIdoPropertyList”中设置 Document Management 特性值并在“vIdoFilter”中进行筛选。
    • “文档”值用于定义文档在 Document Management 中的存储方式：Document Management 文档类型、实体类型以及用于此文档的说明。

      必须在 Document Management 中定义匹配的文档类型、实体类型和说明。

    vKeyText (01-15)
    选择要显示的关键文本字段集 (01-05, 06-10, 11-15)。显示字段时，根据需要在每个字段中定义类似 AES 的函数。AES 评估在第一个字段中定义的函数或一系列函数，并将值放在称为 KeyText01 的事件变量中。如果第二个字段中有一个函数，则评估该函数，并将其值放在称为 KeyText02 的事件变量中，依此类推。
    vFinishText (01-15)
    选择要显示的完成文本值集 (01-05, 06-10, 11-15)。显示字段时，定义要参考的 AES 事件变量。如果文档中存在特定值，且您不希望将文档发送到 AES，则可以使用完成文本。在这些情况下，该过程已完成或中止。
    vFinishExpression1, vFinishOperator, and vFinishExpression2
    如果条件的计算结果为“真”，则可以使用完成文本值以“完成”或“中止”AES 事件。例如，如果定义 FinishText01 以提取特定值，如果 FinishText01 = “REPRINT”，您可以在将内容添加到 Document Management 之前指示 AES 中止。

    如果文字用于任何一个完成表达式变量，则它们必须用双引号括起来，以便 AES 正确解释它们的值。

    运算符通常采用等式运算符的形式，例如=、> =或<>。

    vIDOName
    指定包含要作为特性值提供的信息的 IDO 的名称。
    vIDOFilter
    指定为与C# string.format()类似的 AES 函数，以在 IDO 上创建筛选器。筛选器在 IDO 中查找特定记录。
    vIDOPropertyList
    指定属于 vIdoName 中列出的 IDO 的 IDO 属性列表。排除子集合，任何 IDO 属性名称都有效，包括 UET 属性。
    注意：您在“vExtDocName”中指定的 Document Management 文档类型必须包含与此列表中 IDO 特性的名称完全匹配的特性。这允许使用 IDO 属性值标记 Document Management 文档以进行筛选。
    vExtDoc 名称
    指定用于存储提交文档的 Document Management 文档类型。如果这是新文档类型，则还必须将其添加到 Document Management 中。
    vExtMsgEntity
    指定在 SyteLine 表单中的 JSON 消息中广播的实体类型，其中此类文档应从“相关信息”上下文应用程序获得。
    vExtDocDescription
    指定创建包含 KeyText 变量值的有意义文档说明的 AES 函数。
  5. 保存更改。
  6. 如果要为当前不在工作流列表中的报告设置文档流，则可能希望在显示某些相关的 SyteLine 表单时，在“相关信息”上下文应用程序中提供该文档。（例如，您可能希望“Chargebacks”表单在“相关信息”窗格中显示特定项目的 CS_SalesInvoice 文档。）确定哪些 SyteLine 表单应包含文档，然后确保正确设置这些表单的 Web 容器消息。StdObjectSelectCurrentCompleted 表单事件处理程序必须传递实体类型，且至少有一个与文档类型相关的键值（在我们的“Chargebacks”示例中，InvNum）。
  7. 如果您的自定义向 Document Management 发送新类型的报告或文档，请在 Document Management 中执行以下步骤：
    • 在 Document Management 中设置一个与工作流中指定的“vExtDocName”值匹配的新文档类型。
    • 设置新文档类型的特性。您必须总是包括“科目实体”、“实体类型”、“货位”和“说明”特性。您可以添加特定于此文档类型的其他特性。这些特性必须与该文档类型的 SyteLine 文档工作流中指定的 IDO 特性完全匹配。
    • 为新文档类型设置“访问控制列表 (ACL)”。
    • 为新文档类型设置“业务上下文模型 (BCM)”，其将 SyteLine 表单传递的上下文信息映射到相关信息上下文应用程序期望为此文档类型查看的变量。

    有关这些步骤的详细信息，请参见Infor Operating Service 管理指南。

  8. 如果您的自定义修改了其中一个预定义文档以发送其他元数据，请在 Document Management 应用程序中为 ACL 中的文档类型设置任何新特性。这可确保 Document Management 和相关信息上下文应用程序中的用户可用新的元数据值。您还必须将新特性 ID 添加到 IDOPropertyList。
  9. 在 SyteLine 中，再次打开 Document Management 文档工作流表单，然后选择新的或修改的后台任务记录。单击“活动”激活工作流。
  10. 在 SyteLine 中，生成您为其添加或修改工作流的文档。验证 Document Management 和相关信息上下文应用程序中的文档是否可用。
相关主题