从IBM InfoPrint Designer应用程序迁移
IBM在V5R1中发布了InfoPrint Designer,以提供用于增强IBM i上假脱机文件输出的工具。 有很多理由考虑迁移InfoPrint Designer应用程序。 首先,InfoPrint Designer旨在在Windows上运行,但仅在Windows XP之前受支持。 其次,InfoPrint Designer基于高级功能表示(AFP)架构的子集,该架构在解决当今所需的更复杂,可变的设计方面非常有限。 第三,企业与客户沟通的方式发生了巨大变化,包括这些沟通所需的渠道范围(即印刷,网络,电子邮件,文本和社交媒体)。 最后,使用InfoPrint Designer的客户通常拥有许多应用程序。 通常将它们全部转换的工作量很大。
DocPath Boulder Suite为这种转换提供了一种简单而无缝的途径,从而可以使用先进且完全现代化的客户交流平台,该平台将继续向前发展:
- 最新的架构和技术-(即Java™,HTML5,CCS)
- 单一,一致,直观的用户界面以及完全图形化的工作流程
- 广泛的语言支持,包括在同一文档中使用多种语言的能力
- 广泛支持输入数据:XML,标签模式,文本,FCFC,可变和固定记录模式
- 广泛支持打印格式:PCL,PostScript,AFP,EPL,ZPL,TEC,PDF,QMF和RTF。
- 广泛支持发行渠道:印刷,电子邮件,传真和网络
- 集成主要档案系统(即Documentum,FileNet等)
- 与关键的ERP系统集成(即SAP,JD Edwards,Scala)
- 本机IBM i实施
InfoPrint Designer –它做什么
InfoPrint Designer(产品编号5733–ID1)是IBM i许可的程序产品,用于将现有的行模式SNA字符串(SCS)输出重新设计为全页模式AFP。 它最初于2001年与操作系统的版本5 Release 1一起发布,由以下三个组件组成:
- 用于设计叠加图(电子表格)的叠加图编辑器
- 用于图像设计的图像编辑器 (IBM i页面段)
- 布局编辑器,用于数据的实际设计和放置以及其他页面元素(覆盖,图像和条形码)的放置
InfoPrint Designer是基于Windows的,但确实使用Windows的IBM i Access从输出队列中检索目标SCS假脱机文件,以用于布局设计以及将所有设计的组件资源上载到IBM i平台进行生产。
使用图1,您可以看到IBM i上的应用程序如何使用打印机文件定义将输出传递到SCS假脱机文件。 将SCS假脱机文件传输到InfoPrint Designer Windows平台,用作设计过程的样本数据。 InfoPrint Designer应用程序被组织到项目中,这些项目读取该样本数据以及图像和字体到设计用户界面。
图1. InfoPrint Designer工作流程
在Windows上使用InfoPrint Designer图形界面时,在后台,InfoPrint Designer使用页面定义和表单定义资源对象(它们是AFP体系结构的元素)定义页面的格式。 下载样本SCS输出文件进行设计。 完整的资源(包括图像,覆盖图和可选的字体)被上载到IBM i。 将设计的输出投入生产仅涉及在应用程序打印机文件中指定创建的页面和表单定义名称。 然后,操作系统将生成AFP或PCL,具体取决于在打印机文件中选择的选项。
尽管此过程已在IBM i上很好地集成,但是仍然存在问题,如我们所介绍的。 这是DocPath Boulder Suite派上用场的地方。 通过直接将现有InfoPrint Designer应用程序迁移到DocPath格式,它直接解决了转换问题。 这使InfoPrint Designer客户能够无缝迁移到DocPath生态系统,并且产生的输出基本上相同。 然后,在时间和资源允许的情况下,可以将DocPath的高级设计功能按优先级顺序应用到每个输出应用程序上,从而实现最新,最动态,最先进和多渠道的客户通信。
本文中的以下信息将指导您完成迁移过程。
DocPath Boulder Suite简介
图2. InfoPrint Designer和DocPath工作流的比较
Boulder Suite是DocPath组件套件,可用于替换InfoPrint Designer项目。 图2显示了两个:InfoPrint Designer和DocPath Boulder Suite工作流程。
图3. InfoPrint Designer示意图
InfoPrint Designer流程(如图3所示)涉及以下高级步骤:
- 假脱机输入将被发送以进行打印,但是现在格式化是由在InfoPrint Designer Windows界面中设计的打印机文件中指定的页面和表单定义指导的。
- 输出到高级功能演示数据流到输出队列
- 可以使用IBM Print Services Facility™(PSF)将AFP数据流打印到智能演示数据流(IPDS)打印机。
- 还可以使用主机打印转换将AFP数据流转换为PCL
- 可以使用InfoPrint Server将AFP数据流转换为PDF
当DocPath代替InfoPrint Designer时,将发生以下工作流程,如图4所示:
图4. DocPath生产工作流程
- 原始的InfoPrint Designer项目将转换为DocPath Builder项目。
- 该项目位于表格文件夹中的集成文件系统上。
- 假脱机输入将被发送以进行打印。
- 输入由DocPath生成引擎处理。
- DocPath生成引擎使用了在DocPath Builder中设计的项目,并将其放置在forms文件夹中。
- 可以同时生成多种输出格式。
- 可以在DocPath生成引擎的控制下打印,存档和通过电子邮件发送输出。
Boulder Suite由以下三个独立的组件组成:
- 第一个是DocPath Builder,它是一个基于Windows .Net的应用程序,提供了导入现有InfoPrint Designer项目,设计表单模板的功能,并允许您充分利用Boulder Suite功能。
- 第二个组件是DocPath文档生成引擎。 一个基于Java的应用程序,负责通过将表单模板与数据合并并应用所需的逻辑来创建文档。 DocPath文档生成引擎是一个多任务和可扩展的软件应用程序,可确保您具有所需的处理能力来应对客户产量的任何增长。
- 第三个组件是D-Forms,这是一个完全本机的IBM i应用程序,它提供用户界面来从IBM i平台设置,监视和与DocPath文档生成引擎进行通信。 可以通过D-Forms定义所有过程定义(规则)。
DocPath Builder概述
DocPath Builder是Boulder Suite的设计和转换工具,用于将InfoPrint Designer项目转换为DocPath格式。 导入InfoPrint Designer项目后,DocPath Builder将显示新迁移项目如何产生其输出的数据映射,模板设计和图形流(称为JobFlow)。 使用Builder,您可以保留当前的输出格式或对其进行更改以产生其他输出格式,例如PDF和电子邮件。
项目完成后,您可以编译项目并将其上载到IBM i。 Builder附带了一个实用程序,使上传到IBM的过程很简单。
DocPath文档生成引擎概述
DocPath文档生成引擎是负责数据处理以及文档生成,存储和分发的引擎。 为了确保在任何生产系统上均具有最佳性能,该引擎已完全用Java开发。 Java提供了广泛的优势,特别是对于大型企业。 基于客户端/服务器体系结构,文档生成引擎提供了与大型系统的良好连接性,互操作性以及对硬件资源的灵活高效利用。 该引擎既可以在操作系统级别也可以在Java虚拟机级别运行。 这意味着DocPath解决方案可以轻松地与运行在特定OS上的旧版应用程序以及基于Java的新程序同时集成。
文档生成引擎包含各种DocPath模块和组件,本文稍后将对此进行描述。 图5显示了文档生成引擎如何驻留在应用程序服务器环境中以及如何以各种方式与不同的应用程序平台进行通信。
图5. DocPath IBM i示意图
显示了文档生成引擎,其中包含许多由作业启动器控制的组件。 该过程在Java Application Server中运行,并接受基于TCP / IP或HTTP的数据。 这可以由应用程序提供,但是在大多数情况下,由DocPath HTTP客户端应用程序提供,该应用程序由D-Forms使用SENDTOJL( 发送至作业启动器 )命令执行。
将数据文件与要使用的项目一起发送到作业启动器后,作业启动器将根据项目中的作业流使用处理作业所需的组件来处理该文件。 项目数据被提取到数据模式中,并分成单独的事务。 这样可以通过其余过程并发处理数据。 其中包括从数据库收集其他信息,执行计算以及生成文档组成。 可以同时生成多种输出格式。 输出目的地和输出类型也由作业流程控制。 它可以写入打印机,文件,电子邮件,也可以发送回调用应用程序。
D-表单概述
D-Forms是Boulder Suite的自动化工具。 它是IBM i上的本机工具,并提供了用于自动化功能的全套命令。
图6. DocPath D-Forms主菜单
D-Forms根据用户定义的标准监视某些假脱机文件的输出队列。 当将符合要求的假脱机文件放置在受监视的队列中时,将运行一系列用户定义的命令来调用文档生成引擎以及其他IBM i命令来生成所需的结果。 命令的这种集合称为规则 。
最多可以使用三个级别的选择标准来处理假脱机文件:
- 输入文件监视器级别
根据以下三种方法之一监视假脱机文件:
- 已安排(一天中的时间或其他间隔)
- 计时器(每x秒数)
- 数据队列(后台处理的文件将立即处理)
然后根据所需的文件名,表单类型和用户数据信息对假脱机文件进行测试。
- 规则监控器级别
然后对照每个规则定义的必需条件测试满足监视器条件的假脱机文件,这些文件链接到该规则名称以进行处理或被忽略。 - 命令级
链接到规则名称的假脱机文件由指定的命令列表处理。 可以基于IF语句来调节命令。
通常,需要一个命令来与文档生成引擎接口。 这是SENDTOJL命令,用于将假脱机文件的内容发送到文档生成引擎。 然后,文档生成引擎将处理假脱机文件,并将输出生成到指定位置。
这提供了对过程以及生产端产生输出所需的组件的描述。 下一节将介绍如何转换对象并将其投入生产。
转换InfoPrint项目并上传
图7. DocPath Workbench主菜单
DocPath Builder能够通过将页面和表单定义对象转换为DocPath Builder项目格式(.idf)来转换InfoPrint Designer项目的格式。 转换项目的过程很简单,您只需访问属于该项目的文件即可成功转换它们。
在此示例中,InfoPrint Designer随附的示例发票被转换。
- 在“欢迎使用”屏幕上,从“打开最近的项目”部分中选择要转换的项目,或单击“文件转换InfoPrint项目”。
图8.从菜单转换InfoPrint项目
显示项目转换向导。
图9.转换目录路径
- 在转换向导中,为相应的文本字段中的页面段和覆盖生成语言(OGL)文件指定正确的路径。
图10.设置资源路径
- 然后选择项目的InfoPrint Designer文件和页面定义(PFA)格式。
图11.选择InfoPrint项目文件
- 选择这些文件后,即可命名该项目。 默认情况下,原始InfoPrint Designer项目的名称显示在“项目名称”字段中,但是您可以将其更改为您选择的任何名称。 这将是带有.idf扩展名的DocPath Builder项目的名称。
图12.为项目命名
- 单击“ 开始对话”以转换项目。
转换项目后,您将返回到Builder主页。 转换后的项目的名称将在“定义”图标的右侧,并将是您为该项目选择的名称。
图13. Builder显示了转换后的项目组件
所有其他选项(例如分页)也将显示,因为转换还会将它们创建为项目中所有其他区域的默认选项,以便几乎可以运行。
- 单击设计以在此处打开DocPath设计器和表单,您可以根据需要查看和更改转换后的项目。
图14. DocPath Designer用户界面
已创建转换后的项目模板,该模板包含三个设计对象,一个页面称为PAGE_1,一个文档段称为P1,以及一个子集,该子集是DocSegments的逻辑组,称为IPSection。
- PAGE_1是空白页,在页面顶部带有锚点。 由于所有实际页面布局都已转换为DocSegments,因此锚点显示了DocSegment出现的位置。 该页面应该是空白的,因为它就像要在其上绘制表单的动态图块的空白画布一样。
图15. DocPath Designer页面锚定
- P1 DocSegment包含模板的所有数据,因为这是一页纸的形式。 所有字段都将在转换中显示,您可以轻松地修改模板的外观,以包括更新的徽标或修改字体。
图16.迁移的发票示例
- 模板的设计完成后,您可以使用图形JobFlow界面来设置将要生成的输出类型和输出目标。 默认情况下,作业流指向AFP数据流并打印输出。
作业流程是项目中发生的情况的图形表示。 它指定输入的类型,如何处理输出以及要产生的输出类型以及该输出的目的地。 您还可以具有一些逻辑,以便输出根据触发器的不同方向流动。
图17.图形化工作流程
图17说明了最简单的作业流程工作流程。 定义了输出和目标打印机,作业就可以投入生产了。
但是,您可以通过多种方式增强此工作流程。 图18显示了附加输出到PDF,以及集成文件系统的输出“通道”。
图18.将作业流程添加到输出PDF
- 通过选择路径和所需的名称来设置输出PDF的名称。 这可以通过使用图19所示的图标属性来完成。名称可以由变量组成,例如数据,日期和时间以及计数器。 在这种情况下,双击文件存档器,然后选择路径和基本名称Invoice.pdf。 在此示例中,我还包括了日期,因此,最终名称为/tmp/invoice{%DATE(yyyyMMdd)}.pdf 。
图19. Job Flow图标属性
- 双击“ InfoPrint Designer数据”图标以验证定义,尽管通常不需要触摸该定义。 在定义器中,转换向导已自动映射了原始设计中的所有字段。
现在就可以编译该项目,并将其发送给IBM i进行测试。
将项目部署到IBM i
可以通过三种方式将项目部署到IBM i。 标准方法是使用“ 编译并发送”选项。 或者,您可以将文件直接复制到集成文件系统或使用FTP。
可从DocPath Builder中的“ 文件”菜单访问“ 编译并发送”选项。 当单击Compile and Send时 ,将创建一个.ipf文件,然后使用连接对话框,您可以登录到IBM i,然后导出已编译的项目(请参阅图20)。
图20.导出对话框
导出文档后,它会出现在列表中,然后您可以通过单击“退出”关闭对话框。
DocPath Boulder Suite自动化
在IBM i上使用文档生成引擎和D-Forms
文档生成引擎利用称为D-Forms的IBM i本机组件来提供本机IBM i前端以及与基于Java的文档生成引擎组件的连接。
D-Forms允许您使用IBM i绿屏来设置监视器以监视输出队列,然后针对满足某些条件的那些队列中的假脱机文件输出运行规则。
D-Forms还使您可以运行本机IBM i命令以及所包含的许多其他功能,所有这些功能都旨在简化集成。
下一步是设置一个监视器并定义一个规则,该规则可以将数据发送到文档生成引擎,并告诉它将使用哪个项目与数据合并以产生必要的输出。
启动文档生成引擎
安装Boulder Suite时,文档生成引擎将安装在其自己的称为DPTools的实例中。
DPTools实例具有其自己的子系统,需要启动。 启动子系统后,文档生成引擎随之启动。
创建规则并进行监控
使用D-Forms主菜单中的选项30,您可以定义一个出站监视器来监视一个或多个出站。
- 在选项30中,按F6键创建新的监视器,然后输入监视器的名称。
图21.监视器定义
- 指定将使用的出队。 如果需要,您还可以监视多个排队。
图22. D-Output监视器定义
如果不存在排队,将提示您创建它。 如果您正在使用数据队列,也是如此。
- 可以为监视器设置其他选项,但是在大多数情况下,可以使用默认值。
图23.添加D-Output Manager监视器
- 创建监视器后,使用选项8启动它。
图24.启动监视器
处理假脱机文件的命令
接下来,您需要设置命令以自动处理假脱机文件。 为此,请使用D-Forms主菜单中的选项32。
在此示例中,将处理INVPRT出库中出现的,具有INV表单类型的发票假脱机文件。 通过以这种方式设置规则,您可以控制假脱机文件的处理方式。 在这种情况下,假脱机文件将被发送以进行文档生成引擎处理,因此规则中仅需要一个命令,即SENDTOJL( 发送到作业启动器 )。
- 从主菜单中选择选项32后,在规则屏幕上按F6键以添加新规则。 指定满足所需处理条件所需的所有选项都显示在规则屏幕上。
图25.添加规则
- 按Enter键显示规则列表。 使用选项6输入命令。
图26.选择规则
- 按F6输入新命令。 可以使用任何IBM i命令或D-Forms提供的许多实用程序之一。 在这种情况下,请输入SENDTOJL命令。
图27.添加SENDTOJL命令
- 使用一些特定的名称(例如项目名称)填写SENDTOJL命令的提示,然后使用一些可用的变量(例如NAM(作业名称))填写,以便假脱机文件的作业名称在以下情况下被替换自动化作业正在运行。
图28.将文件发送到作业启动器
配置命令后,它将在具有正确属性的传入假脱机文件触发规则执行时运行的命令列表中显示。
图29.要处理的命令列表
启动监视器后,此规则将处理来自INVPRT出库的任何假脱机文件(格式类型为INV)。
测试输出
要测试输出,请将假脱机文件放入具有就绪状态的输出队列中。 这将运行自动化过程,并将根据项目中指定的JobFlow产生输出。
测试项目设计
生成项目时,有两种测试类型。
- 首先,您可以使用在使用InfoPrint Designer数据定义在定义器中验证数据映射时下载的样本数据在DocPath Builder中预览文档。 这将运行文档生成引擎的本地副本,该副本将生成一个临时PDF文档供您查看。 这是验证项目设计而不在IBM i上运行的最简单方法。
- 其次,您可以在IBM i上使用SENDTOJL命令以交互方式在IBM i上测试设计。 它将作业提交到文档生成引擎并写入.ipf文件的作业流程中指定的结果。 这是在使用DFORMS规则为作业创建自动化步骤之前执行手动测试的方式。
图30.示例SENDTOJL命令
注意:您需要使用DFORMS,以便您的库列表正确无误,并且SENDTOJL命令可用。
博尔德套房:高级注意事项
DocPath Boulder Suite支持无缝迁移InfoPrint Designer应用程序。 迁移应用程序后,可以决定利用Boulder Suite中的高级功能。 当然,也可以使用Boulder Suite设计和部署新的应用程序。 请参阅第二篇DocPath DeveloperWorks功能“ 使用DocPath高级功能 ”以获取指导。
后续文章将涵盖以下主题:
- 数据映射器和基础设计接口
- 表格–完全动态的表格和页面溢出控制
- 表格–表格所有元素的条件控制–行,列,单元格
- 列表–具有页面溢出,排序和条件控制的数据驱动列表
- 图表– 2D和3D动态图表(饼图,条形图等),可控制所有元素
- 对象处理–锚定,调整大小,旋转
- 图像–以及动态调整大小
- 支持页面层–即,不同语言版本的不同层
- 业务规则–使用向导或脚本根据条件进行演示
- 空白-营销信息
Summary
本文讨论了将InfoPrint Designer应用程序迁移到DocPath Boulder Suite的过程。 迁移后,应用程序可以从本质上继续发挥作用。 或者,您可以利用高级DocPath平台,并在客户期望的所有渠道中创建复杂的动态通信。 此外,您当然也会使用DocPath来开发新的文档和客户沟通应用程序。
资源资源
- 了解有关DocPath Boulder Suite的信息 。
- 请参阅DocPath文档管理解决方案视频 。
- 请参阅IBM InfoPrint Designer迁移和替换:DocPath Boulder Suite 。
- 请参阅将IBM InfoPrint Designer项目转换为DocPath资源 。
- 请联系[email protected]以获取有关技术信息的查询,并联系[email protected]以获取与产品相关的信息。
翻译自: https://www.ibm.com/developerworks/ibmi/library/i-migrating-infoprint-designer-app/index.html