第三部分包括若干章,它们的内容阐述“协作管理器”模块中提供的每个组件。
- 导入
- 导出
- 协作区
- 队列
- Web Service
- 文档库
- 数据源
- 路由
- 生成的文件
为了集中地存储和管理产品信息,需要在 WebSphere Product Center 中创建一个主控目录。下列各节描述从各种来源收集数据以及将信息集合到组织好的目录结构所执行的每一个步骤。
- “导入控制台”概述
- 获取数据源
- 定义创建导入馈送所需的项
- 设置导入馈送
- 将输入文件装入到 WebSphere Product Center 中
导入是将数据从外部源输入到 WebSphere Product Center 的馈送。首先手工配置导入,然后可以根据安排或需要运行导入。WebSphere Product Center 允许从多个源导入多种类型数据(项、二进制文件、类别树和分类映射等等)以达到多种目的(更新、替换和删除)。
“导入控制台”是用来根据各种数据源创建目录的工具。导入控制台充当将所有数据导入 WebSphere Product Center 的交换台。在这里,可以查看、修改及创建正在馈送至 WebSphere Product Center 的数据。
要创建导入,用户需要定义和执行许多数据和文件馈送以馈送到 WebSphere Product Center 中。“导入控制台”将显示已创建的馈送的列表。
要访问“导入控制台”,请使用菜单路径协作管理器 > 导入 > 导入控制台。
图 7.1 - 导入控制台
定制控制台视图
可以将控制台定制为对列进行排序或隐藏。这些设置将被保存到用户的概要文件中。要定制“目录控制台”的视图,请执行下列操作。
1. 在“目录控制台”的右上角,单击配置按钮
。“配置表”将显示在一个弹出窗口中。
2. 要对列进行排序,请在“排序”列中进行选择。只能进行一项选择。
3. 要隐藏某个字段,请在“隐藏”列中进行选择。可以进行多项选择。
4. 在“其它选项”表中,将排序顺序设置为以升序或降序显示,并设置每页要显示的行数。
5. 要保存已定制的设置,请单击保存。“目录控制台”将采用新的定制设置进行显示。
对导入列表进行排序
- “导入控制台”中的导入可以按导入的“类型”或按导入的“名称”排序。单击“名称”或“类型”列标题名称以进行排序。
控制台列
下表列示“导入控制台”的每列。
类型
指示导入类型的图标,请参阅上一节“导入控制台图标”以获取导入类型列表
名称
导入的名称
检索到的文件
已检索到 WebSphere Product Center 文档库中的源文件的下拉选择列表
检索
执行手工装入以将数据源装入到 WebSphere Product Center 中
装入
将数据源上载到指定的目录中
语义
指示导入的类型是更新、替换还是删除。
源
所使用的源文件的名称
文件规范/导入脚本
所使用的文件规范或导入脚本的名称
映射
单击此图标以查看或编辑文件到目录映射
目录/类别树
用于导入的目录及目录树
ACG
用于导入的 ACG
在“导入控制台”中创建导入之前,准备导入时要执行几个步骤。此节描述了创建和安排导入之前的下列导入准备任务:
- 获取数据源
- 使数据可用
- 查看数据文件
- 创建必需的对象以设置导入
在可以将数据导入 WebSphere Product Center 中之前,源文件必须位于可访问的目录或 FTP 站点中。请查看数据文件以确保产品信息最准确,并确保使用下列其中一种可以导入 WebSphere Product Center 中的数据源格式:
- 字符定界
- 制表符定界
- 逗号分隔的值(CSV)
- 固定宽度
- XML
注意:在转到下一个步骤之前,源文件必须符合以上列表中提到的其中一种格式。
检查是否可以访问源数据文件以将它们导入 WebSphere Product Center 中。如果将要通过 FTP 来上载文件,则确保对 FTP 站点具有正确的许可权。根据需要,与适当的小组成员联系。
分析源数据文件并记录文件结构、字段和相关联属性。在下一个步骤中,需要使用此信息来构建文件规范。
在设置导入之前需要提供几个对象。在这些对象中,许多对象是可以在导入设置期间创建的,但预先完成这些任务更为方便。下列对象是设置导入的最低需求:
文件规范 要配置导入,文件规范是必需的。有关创建文件规范的信息,请参阅“数据模型管理器”一节。 主规范 为了配置 WebSphere Product Center 目录结构的格式,主规范是必需的。这可能包括层次结构的规范。有关创建主规范的信息,请参阅“数据模型管理器”一节。 规范映射 为了将数据正确地传递至正确的目录,需要将文件规范映射至正确的目录/层次结构。有关映射规范的信息,请参阅“数据模型管理器”一节。 使用主规范创建目录 一旦创建并映射了文件、目录和其它相关联的对象,下一个步骤就是创建目录。有关创建目录的更多信息,请参阅有关“产品管理器”的章节。
在按照“导入准备”一节的描述为导入设置项之后,请定义将外部文件信息填充到 WebSphere Product Center 目录中时采用的方式。导入馈送的定义是通过创建新的导入来完成的。
图 7.2 - 新建导入向导
创建新导入
使用菜单路径协作管理器 > 导入 > 新建导入或在“导入”控制台中单击新建。将显示“新建导入”向导。完成“创建导入”向导的每个步骤以创建导入。
1. 导入名
输入导入的名称并单击“下一步”按钮。
必须提供导入名以便与其它名称进行区别。不允许重名。选择的馈送名应该是易于理解的。
例如,名称“Item Attributes from Mainframe”或“Images for Catalog X”就是不错的名称。
2. 选择访问控制组
从“选择访问控制组”下拉菜单中选择“访问控制组”。如果不存在访问控制组,则通过单击“新建”按钮来创建一个访问控制组。
3. 选择数据导入类型
从下拉菜单中选择数据导入类型并单击“选择”按钮。可以选择下列值:
二进制馈送 目录中的每个项的二进制文件的馈送(即,图像、文档和 PDF)。 层次结构馈送 层次结构馈送包括一个用来对目录中的所有项进行组织以便于浏览的层次结构。 项馈送 项馈送包含基本的描述性信息,该信息描述了要在产品目录中查找的每个目录项。 项到类别映射馈送 项到类别映射馈送将目录中已存在的项映射至将要作为输入数据的一部分而上载的层次结构。此馈送也可以用来将包含新项和适当分类信息的文件直接上载到新目录中。每当添加任何新类别时,都将更新该层次结构。 4. 选择数据导入语义
选择导入馈送语义并单击“选择”按钮。
导入馈送语义指定输入文件如何影响目标目录中已包含的项。
更新 用输入文件中指定的项来更新目录中的项,并将那些项添加至仅存在于输入文件中的目录。 替换 使用输入文件的内容来替换当前目录的内容。 删除 从目录中删除在输入文件中指定的项。 5. 选择数据源
选择数据源名称并单击“选择”按钮。数据源定义要将哪个数据源导入 WebSphere Product Center 中。
在此步骤中,用户可以修改或创建新的数据源。要创建新的数据源,单击“新建”以编辑数据源,然后单击“编辑”按钮。
创建新数据源的步骤包括为数据源指定名称并选择数据源类型。数据源名称应该具有尽可能强的描述性。数据源类型包括下列选项:
- 通过 FTP 进行 WebSphere Product Center 检索
- 从文档库(包括 FTP)获取
- 通过 Web 浏览器上载
6. 选择字符集
下一个步骤是从“选择字符集”下拉菜单中选择输入文件的编码。选择与输入文件中使用的字符集相匹配的字符集。当输入文件包含不是字母表的 26 个字母及 10 个数字的字符时,这尤其重要。系统缺省字符集是“Cp1252:Windows Latin-1”。
注意:没有选择适当的字符集可能导致导入期间出现问题。
7. 选择文件规范
文件规范定义输入文件的属性和格式。从下拉菜单中选择现有文件规范或单击新建以创建新的文件规范。
8. 选择目录
目录定义数据将导入到 WebSphere Product Center 中的位置。选择现有目录或单击新建以创建新的目录。
9. 选择文件至目录映射
选择现有映射或单击新建以创建新的映射。要创建新的映射(或修改现有映射),使用下拉选择字段来使文件规范(左列)中的每个字段或目录(右列)中的字段相匹配。对于高级并置(字段并置和字符串处理等等),单击“表达式编辑器”按钮。
10. 选择目录导入脚本
缺省情况下,会总是生成简单目录导入脚本。选择缺省情况下生成的脚本或单击新建以创建新的导入脚本。
11. 选择核准人
创建导入馈送的最终步骤是选择核准人。这个可选步骤允许选择一个用户,在生成导入作业之前,该用户负责查看并核准该作业。选择启动馈送时应该通知哪些用户。
12. 返回至导入控制台
现在,已经配置了导入馈送,最后一个步骤是运行该导入作业以填充可以在 WebSphere Product Center 中管理的目录。
一旦定义了导入,就可以手工安排或设置为按需要运行导入。在运行导入之前,必须首先获取外部数据源文件。
将文件装入到文档库中
在“导入控制台”上,每个导入馈送都有两个“执行”按钮,其中一个位于“检索”列中,另一个位于“装入”列中。
要检索外部输入文件,请单击适当导入馈送的“检索”列中的“执行”按钮。检索到的列将显示“没有要馈送的文件”。在访存文件之后,选择的文件将出现在下拉菜单中。
文件一旦被访存,它就会被放到文档库中。文档库是移入或移出 WebSphere Product Center 的所有文件及数据的资源库。这为用户提供了在将文件实际上载到 WebSphere Product Center 之前预览所有文件的机会。
启动导入
“导入控制台”中的两个“执行”按钮中的第二个按钮将把访存的文件从文档库上载到指定的目录中。从“上载”列中,单击“执行”按钮。
可以配置警报以通过电子邮件或通过主页的“警报”模块来提供装入完成通知。如果已经指定了核准人,则可以通过用户的主页上的“警报”模块界面来核准或拒绝馈送。然后,可以通过“产品管理器”模块来管理产品信息。
修改导入
要修改导入,最好是删除旧导入并创建新导入。例如,没有办法选择新的文件规范。要使用另一个文件规范,请创建新导入并选择适当的文件规范。
删除导入
可以通过单击每个馈送的第一列中的“删除”按钮来删除该馈送。
注意:删除馈送的操作是不可逆的。将显示一个对话框来验证是否要删除导入馈送。
在将二进制文件导入 WebSphere Product Center 中之前,必须先对它们进行压缩。例如,要导入一组图像,将在源目录中创建一个 *.zip 文件。一旦检索到压缩文件,就将把该文件存储到 WebSphere Product Center 的文档库中并接着将其解压缩到文档库的 /public_html/ctg_files 目录中。二进制文件可以包括诸如 jpg、gif 或 pdf 之类的文件。
图 7.4 - 上载二进制馈送
创建二进制导入
下列步骤为二进制文件创建导入馈送。
使用菜单路径协作管理器 > 导入 > 导入控制台,将显示“导入控制台”。单击“新建”以访问“新建导入”向导。完成该向导的每个步骤。
1. 导入名 - 输入二进制馈送的名称。
2. 选择访问控制组 - 选择用于该馈送的访问控制组。
3. 选择导入类型 - 选择“二进制馈送”。
4. 选择导入语义 - 选择“更新”。
5. 选择数据源 - 为该二进制馈送选择数据源,或者创建新的数据源。
保留压缩归档中的路径:Y 或 N。
始终选择“否”。所有图像文件都存储在文档库中的“public_html/ctg_files”中。如果保留归档的路径,则将把图像解压缩到错误的目录中。
6. 输入文档库路径。
保留空的路径并单击“下一步”。将采用文档库路径,不需要输入路径。当应用程序将文件解压缩时,它将把所有图像都放到 ctg_files 目录中。
7. 选择要对文件名和路径执行的操作
接受缺省值两者都不 - 此选项适用于图像来自下游系统的情况。在本实例中,图像文件是大写的还是小写的并不是问题。
8. 选择核准人 - 如果有必要的话,选择负责核准该导入的用户。
这样就完成了创建导入馈送的操作。下一个步骤是将压缩文件上载到 WebSphere Product Center 中。
上载压缩文件
在定义了二进制馈送之后,下一个步骤是将压缩文件检索到 WebSphere Product Center 中。馈送应该在“检索文件”列中显示“没有要馈送的文件”。
1. 从“导入控制台”中,找到新创建的馈送并单击“检索”列中的“执行!”。
2. 单击“浏览”,选择压缩文件,然后单击“上载”。压缩文件的路径将显示在“文件”字段中。
3. 返回至“导入控制台”以查看文档库中的文件,从“协作管理器”菜单中选择“文档库”。
上载的所有文件都存储在组织的“feed_files”目录的子目录中,该子目录是根据导入馈送的名称命名的。
一旦将压缩文件上载到文档库,就会将其解压缩。
解压缩二进制文件
1. 在“导入控制台”中,单击“装入”列中的“执行!”。WebSphere Product Center 将把图像解压缩到 ctg_files 目录中。
2. 要检查装入过程的状态,请单击“检查更新状态”超链接。
在完成装入之后,“调度状态信息”将显示状态“运行完成”。单击文档库超链接以查看所有已解压缩的二进制文件。
可以将现有导入表从外部数据源导入 WebSphere Product Center 中。为查找表创建导入与使用“新建导入”向导创建任何其它导入相似。
创建查找表导入
从“导入控制台”中,单击新建。将显示“新建导入”向导。
1. 选择唯一的馈送名称。
2. 选择“访问控制组”。
3. 选择数据类型“项馈送”。
4. 选择相关的馈送语义、数据源和文件规范。
5. 从“选择目录”字段中,选择要导入的查找表。
6. 定义文件至查找表映射
7. 选择导入脚本。创建新的导入脚本(如果必要的话)。
8. 选择核准人(如果必要的话)。
9. 保存新的导入馈送。
10. 运行导入。
WebSphere Product Center 允许您创建为任何内部或外部目标进行定制的目录。可以自动将目录发布给客户、伙伴和印刷目录,也可以发布至企业 Web 站点。下列各节描述用来将产品信息分发或发布到任何目标的方法。
- 导出概述
- 为导出准备目录
- 创建导出
- 运行导出
- 管理导出
创建导出是为了将产品信息分发或发布给客户(内部或外部)。通过使用灵活的 WebSphere Product Center 体系结构,企业可以使用单个数据资源库来通过多个目录连接到多个市场。
通过使用 WebSphere Product Center 的“导出控制台”,执行下列任务:
- 以任何格式导出目录
- 以不同形式发布内容
- 发布内容的子集
- 将特定于目标的数据与标准信息合并
导出控制台列
类型
指示联合类型的图标,请参阅“导出控制台图标”一节。
名称
导出作业的名称。
目录项
要联合的目录和项组的名称。
版本
要联合的目录的版本。
映射
查看/编辑目录规范与目标规范之间的映射特征。
目标规范
目标规范的名称。
文件类型
所使用的目录导出脚本的名称以及参数值集合。
层次结构
所使用的层次结构的名称,单击以进行查看或编辑。
作业信息
有关联合作业的详细信息。查看作业的运行时、状态、警告以及生成的文件的列表。
核准
如果在联合之前需要进行核准,则此列中的状态显示为“已被接受”或“已被拒绝”。
警报
如果已经为联合配置了警报,则该警报将显示在此列中。
目标
联合的目标方式。
下列各节描述在可以为导出设置目录之前需要的项。尽管有些项可以通过设置导出的向导来执行,但最好还是将项预先准备好以简化设置过程。
目标规范
当在 WebSphere Product Center 中创建导出作业时,将需要目标规范以定义目标文件的确切需求。与文件规范或主规范相似,使用属性对目标规范的每个节点进行定义。在数据导出期间,目标规范将生成符合一组预定义需求的文件。
项选择
“数据模型管理器”的“导出”组件允许对目录进行基本选择,以选择一组要发送到特定目标的项。基本选择包括用于导出的目录、目录版本和层次结构。
目录到目标映射
目录到目标规范映射有一个方面与用于导入的文件到目录映射类似,即它向 WebSphere Product Center 指示应该如何传递目录中的字段。目录中的字段映射至目标文件中的字段。要成功地进行联合,必须执行此映射。
层次结构
按照“导入”一章中给出的说明,在 WebSphere Product Center 中,层次结构是与目录分开存储的。这使用户能够使用他们选择的层次结构来查看目录并最终地导出目录。
目标方式
一旦导出了目录,就可以将其发送到多个目标,以便进行核准和/或验证。联合的分发组件允许用户选择要将该目录发送到的目标。可以电子邮件(在电子邮件的正文中)或 FTP 形式发出目录。
当创建新的导出时,“创建新的导出”向导会完成用于设置导出的每个步骤,这有助于简化完成过程。
在向导的每个步骤中,都可使用下列功能按钮:
编辑
创建新的
选择
![]()
转到下一个步骤
返回至“导出控制台”
设置导出
使用菜单路径协作管理器 > 导出 > 新建导出或从“导出控制台”中单击新建按钮,将显示“目标上载”向导。完成该向导驱动的 GUI 的每个步骤。
1.导出名称 - 为该导出输入新名称并单击下一步。创建唯一且可以很方便地识别的名称。
2. 选择目标规范 - 此规范本身指示最终将要导出的数据的每个字段的格式、长度及必要性。如果有需要的话,用户可以单击适当的按钮以创建或编辑目标规范。
3. 选择目录 - 通过从“选择目录”下拉字段中选择任何先前已创建的目录来指定要导出的目录。通常,为导出选择的目录是面向特定客户的。即,它将只包括针对特定客户的信息。
此信息可以包括诸如定价、合同有效期和客户产品标识之类的数据。通过使用目录到目标规范映射,WebSphere Product Center 可以从主控目录或子目录中导出数据。
4. 选择版本 - 选择目录版本。用户不仅可以选择要导出的目录,还可以选择目录的版本。WebSphere Product Center 将自动保存已上载的和已修改的每个目录的每个版本。当运行馈送或导出时,WebSphere Product Center 也为目录创建新版本。例如,在将一些估计不会被发送至特定客户的项添加至目录时,此功能允许用户导出同一目录的旧版本。
- 最新版本 - 确保每次运行作业时,都导出最新产品信息(包括所有更新)。此选择是“动态的”。
- 任何其它版本 - 确保每次运行作业时,都导出同一特定目录版本。此选择是“静态的”。
5. 选择项组 - 对整个目录进行基本选择,以选择一组要发送到特定目标的项。基本选择包括用于联合的目录、目录版本和层次结构。可以通过“产品管理器”模块的“项选择”控制台来查看和创建项选择。选择示例可能只用来导出特定生产线。
6. 选择层次结构 - 此功能允许用户导出每个项在所选目录的其中一个层次结构中的分类。尽管选择层次结构本身会确定将要导出哪些类别,但这并不确保将类别本身与输出文件一起发送。必须将类别本身作为此导出的目录导出脚本的一部分包括在内。目录导出脚本要求配置授权用户,并且,除非已将输出文件写入目录导出脚本,否则它将不包括类别。
7. 选择联合类型 - 通过选择导出类型,WebSphere Product Center 为用户提供了一个选项,即选择是联合整个目录还是仅联合目录更新。这样,可以导出目录的变更内容。
- 一个版本中的所有项
- 两个特定版本之间的内容差别
- 自从上次联合以来的内容差别
- 一个版本中的项的所有图像和二进制文件
- 在两个特定版本之间更新了的图像和二进制文件
- 自从上次联合以来更新了的图像和二进制文件
如果选择“差别”导出类型,则选择目录的另一个版本以对照生成变更内容。差别类型包括:
- 全部
- 已添加
- 已删除
- 已修改
- 未更改
8. 选择目录到目标映射 - 选择现有映射或单击新建以创建新的映射。要创建新的映射(或修改现有映射),使用下拉字段来使目录(左列)中的每个字段与目标规范(右列)中的字段相匹配。
9. 选择字符集 - 选择字符集以选择输出文件的编码。当输出文件包含不是字母表的 26 个字母及 10 个数字的字符时,这尤其重要。
缺省编码为 Cp1252:Windows Latin-1。
10. 选择分发 - 设计分发的目的是允许向位于应用程序本身内部和外部的个人提供通知。分发与电子邮件别名类似。通过在 WebSphere Product Center 中构建这些类型的分发列表,就有可能联系到 WebSphere Product Center 外部的人员。如果有需要的话,可以创建新的分发方式。
11. 选择目录导出脚本 - 目录导出脚本是在导出期间使用的。在将存放在目录中的数据实际导出到输出文件之前,可以使用目录导出脚本来对这些数据执行高级快速操作。不会将导出时通过脚本编制引擎对内容所作的修改应用于目录,而仅仅是将它们作为一次性的内容修改应用于输出文件。
与导入类似,对外部目标文件进行的导出可以具有两种形式:目录中的字段以一对一的方式映射至外部目标文件,或者,在将目录中的字段导出到外部目标文件之前,需要对那些字段进行一些修改。
所有导出都要求使用脚本。与导入相反,在导出期间选择脚本是一个必需步骤。
12.选择核准人 - 允许选择一个用户,该用户负责复查导出作业以及该作业的执行时间。请从系统用户列表中进行选择并单击“选择”。
13. 返回至“联合控制台”
一旦完成了上述所有步骤,就会显示一个消息框,该消息框指示已将导出概要文件添加至“导出控制台”。单击该屏幕底部的后退箭头按钮以返回至“导出控制台”。导出作业现已设置完毕,并且已经为生成作好准备。
在配置导出作业之后,可以手工生成它,也可以通过调度程序自动生成它。如果该作业需要核准,则核准人必须接受该作业,然后才能生成它。
手工运行导出
要手工执行导出作业,请执行下列操作:
1. 使用菜单路径协作管理器 > 导出 > 导出控制台来查看所有导出作业的列表。
2. 查找要执行的导出作业。单击位于最左边的列中的复选框。
3. 单击执行按钮。如果已经设置了核准人,则将启动导出作业,但是,在文件得到授权之前,它不会被导出到目标位置。可以通过“数据模型管理器”模块中的“调度程序”的“作业控制台”来查看导出作业的状态。
验证导出进度
在运行导出时,单击绿色动画图标允许用户查看导出的进度。会显示进度条以指示完成导出的程序。要中止导出,单击导出左边的红色图标;将显示确认对话框。
当完成导出时,进度条将消失。会提供包括这样的详细信息的总结,例如,指向在导出期间创建的所有文件的超链接以及在导出期间发生的错误/警告。
查看输出
在生成导出之后,在将其发送至已定义的目标位置之前,将把它保存在文档库中。如果您愿意的话,可以查看和打印所生成的文件的结果。
查看导出结果
要查看输出结果,请执行下列操作:
1. 从“导出控制台”中,单击“作业信息”列中的“状态”按钮,将显示“调度状态信息”表。
2. 单击“返回值”列中的超链接,将显示带有已生成的文件的列表的“任务核准信息”界面。每个文件都是超链接的,当单击它们时,打开一个显示文件详细信息的新窗口。
查看导出文件
标准导出会生成一个名为“catalog.out”的文件。可以查看此文件并将它保存至本地或网络驱动器。
查看导出文件
- 要查看导出文件,从“导出结果”屏幕中单击“catalog.out”超链接,该文件将显示在新的浏览器窗口中。
核准输出
如果已经对导出作业指定了核准人,则在可以执行该作业之前,必须核准该作业。从核准人的“我的任务列表”中,单击“核准”列中的“等待核准”图标,将显示“任务核准信息”界面。请您“接受”或“拒绝”导出作业并提供原因。
查看和修改导出组件
从“导出控制台”屏幕中,用户能够查看和/或修改导出作业的几乎每个组件。用户能够查看目录将被发送到的客户的列表、目录到市场规范映射以及已安排的目录联合日期和时间。用户可以通过单击目录名来修改所导出的目录。
导出状态
要查看导出作业的状态,请单击“作业信息”列中的“调度”按钮,将显示“调度状态信息”。然后,单击“作业信息”列中的“查看详细信息”按钮。
一旦对目录执行了导出,用户就可以检查下列作业详细信息:
- 作业信息
- 时间表信息
- 运行时间
- 作业状态
- 返回值
查看导出状态
要查看导出作业的作业状态,执行以下操作:
- 从“导出控制台”中,单击“作业信息”列中的“调度”按钮。将显示“调度状态信息”表,该表显示了有关联合作业的详细信息。
删除导出
可以根据需要来创建和删除导出作业。
删除导出
要删除导出作业,执行下列操作:
1. 从“导出控制台”中,找到要删除的联合作业。单击位于最左边的列中的复选框。
2. 单击“删除”按钮,这将从控制台中删除该导出作业。
如果运行导入或导出时发生问题,则在作业总结中将显示指向错误或警告的超链接。
- 错误是关键的问题(例如,不存在主键或者不存在必需字段),它们会导致无法成功地处理项。
- 警告是不关键的问题(例如,字段太长),它们应该不会导致无法成功地处理项。
有时,作业无法完成运行并且显示的是错误而不是总结。请准确地记录发生这种问题的情况并记录错误消息,以便作出进一步的分析。
实现了新的队列功能部件以维护多种队列类型和多种消息传递协议。队列充当用于处理具有外部源/目标(包括 EAI 平台和 Web 服务器)的入站和出站消息的网关。
注意要了解有关设置“消息传递框架”的信息,请继续“实现消息传递框架”一节。
为了供您参考,定义了下列术语:
- 队列 - 一个 WebSphere Product Center 构造,它充当消息的接收和传输点。脚本支持每个“队列”。
- 消息 - 由 UCCnet、EAI 平台、数据池或其它消息源提供的 XML 文档。
借助全新的队列功能部件,可以将消息作为过程的一部分,在该过程中,当导入或导出作业时,可以将状态消息发送至所有需要对象。
访问队列控制台
使用菜单路径协作管理器 > 队列 > 队列控制台,将显示“队列控制台”。
查看队列详细信息
要查看队列的详细信息,请单击队列名,将显示“队列详细信息”屏幕。提供了下列信息:
- 队列名
- 描述
- 协议
- 脚本
查看队列中的消息
“队列控制台”具有一个名为“消息”的列,该列带有指向队列已接收的消息数目的超链接。通过单击消息数目,可以查看消息的内容。
在队列中搜索消息
1. 要在队列中搜索消息,请使用菜单路径“协作管理器”>“队列”>“消息控制台”。将显示“队列消息搜索”屏幕。
2. 为下列字段选择值
- 起始到达日期
- 结束到达日期
3. 单击“搜索”,结果将显示在下面的“队列消息”表中。
创建队列
1. 使用菜单路径“协作管理器”>“队列”>“新建队列”。
2. 输入必需的信息:
队列名:输入队列的名称
描述:输入队列的描述
协议:从将用来使外部源与队列相关的消息传递协议的列表中进行选择。
脚本:从预先编写的脚本的列表中进行选择(可以运行这些脚本以将消息传递至该队列或者从该队列传递消息)。目标/源的典型消息包括:
- 受工作流步骤中的输入或输入脚本支持的工作流协作区
- 受预处理、后处理或后保存脚本支持的目录
WebSphere Product Center 的消息传递框架的实现允许与以下目标 EAI 平台集成:
- IBM WBI
- SeeBeyond
- Tibco
- WebMethods
选择的平台应该为程序提供可靠的传输机制和一致的接口,以使那些程序能够跨不同的系统或平台相互通信。
WebSphere Product Center 的消息传递框架已设计成支持下列过程:
- 接收包含项集合的消息,包括在接收之后提供确认消息
- 发送包含项集合的消息,包括在传输之后接收确认消息
WebSphere Product Center 提供了对 XML 文档进行语法分析以及创建 XML 文档、将消息发送至 EAI 平台队列以及从 EAI 平台队列收集消息的能力。消息被定义为由外部源提供的 XML 文档。此功能完全可供 WebSphere Product Center 脚本编制引擎访问。为了能够在 WebSphere Product Center 与 EAI 平台适配器之间进行交互,有必要安装利用此功能的脚本。
WebSphere Product Center 支持队列,后者是一个充当消息传递接收点和传输点的构造。WebSphere Product Center 队列充当用于处理具有外部源/目标的入站和出站消息传递的网关,并且每个队列都受 WebSphere Product Center 脚本编制操作支持。
队列提供了下列功能:
允许设置消息传输协议以使外部消息源与队列相关,并提供了下列消息传输协议:
- MQ
- JMS 点到点
- JMS 发布和预订
- HTTP
- HTTP/S
运行脚本以将消息发送至队列或者从队列发送消息。典型的消息目标/源包括:
- 工作流协作区 - 受工作流步骤中的输入或输出脚本支持
- 目录 - 受预处理、后处理或后保存脚本支持
下面列表描述了消息传递功能的框架:
- 外部源将消息发送至 EAI 平台。根据外部源的不同,处理此操作的方式也会有所变化,并且此方式不会对 WebSphere Product Center 检索消息的方式产生影响。
- EAI 平台的设置应该包括入站和出站队列。此设置是由第三方完成的,为了检索和发送消息,WebSphere Product Center 所需了解的信息只有 WebSphere Product Center 将要访问的队列的标识。
- 在将文件放到 EAI 平台队列中时,在 WebSphere Product Center 上设置的相应队列能够通过受支持的协议(MQ、HTTP/s 或 JMS)来检索消息。
- 通过使用 WebSphere Product Center 脚本,将对消息体进行语法分析以获取消息类型、消息标识和消息源。将把此信息传递至为了包含所有消息而创建的目标 WebSphere Product Center 目录。
- 将使用一个工作流来跟踪在 D 中发生的事件,在成功地记录消息之后,一个事件触发“确认工作流”以将新记录从消息目录中检出到协作区设置中。
- “确认工作流”将确认消息发送至消息源以进行确认。完成此操作后,“确认工作流”将该消息重新检入到目录中。
为了使此过程能够发挥作用,必须构建消息传递框架。
构建消息传递框架
以下过程概述了集成 EAI 平台框架的建议方法。可以根据特定的需求来定制此过程。
接收消息
本节描述接收包含项集合的消息的过程,包括在接收该消息之后提供确认消息。以下两个过程(“设置”和“运行时”)支持接收消息的过程。对于大多数目的,此过程具有一般性和普遍的适用性。
设置
1. 业务流程技术分析员创建下列内容:
2. 业务流程技术分析员构建包含脚本的入站队列。脚本支持三项功能 - 接收消息、对消息体进行语法分析以及传递消息。
接收消息
脚本的消息接收部分支持以下功能:
- 通过受支持的协议(包括 MQ、HTTP/S 或 JMS)从源获取消息
- 对消息体进行语法分析以获取消息类型、消息标识及消息源
- 在消息目录中创建包含该消息类型、消息标识、发送方标识和日期时间的记录
- 对“确认工作流”触发事件。要了解“确认工作流”的功能,请参阅以下内容。
消息体语法分析
脚本的消息体语法分析部分支持以下功能:
- 以参数形式包括源到目标映射名和目标目录名
- 针对每个源到目标映射名和目标目录名,对消息体进行语法分析以填充项集合
消息传递
脚本的传递部分支持以下功能:
根据目标目录,对项集合添加/修改/删除项。
- 业务流程技术分析员设置用于发送接收确认消息的“确认工作流”。此工作流具有以下功能:
- 将新记录从消息目录检出到“确认工作流”中的一个步骤中的协作区中。
- “确认工作流”中的下一个步骤发送一条确认消息给消息源,该消息包含消息标识、发送方标识、日期时间以及消息源所需的任何必需命令(例如 Received)。
- “确认工作流”中的下一个步骤检入消息目录记录。
运行时
在正确地配置设置之后,应该会发生下列运行时事件。
1. 队列通过队列脚本的消息接收部分接收消息
2. 队列脚本的消息接收部分对消息体进行语法分析以获取消息类型、消息标识和发送方标识
3. 队列脚本的消息接收部分在消息目录中创建记录,该记录包含消息类型、消息标识、发送方标识和日期时间
4. 队列脚本的消息接收部分将新记录从消息目录检出到“确认工作流”中的一个步骤中的协作区中。
5. “确认工作流”中的下一个步骤发送一条确认消息给消息源,该消息包含消息标识、发送方标识、日期时间以及消息源所需的任何必需命令(例如 Received)。
6. “确认工作流”中的下一个步骤检入消息目录记录。
7. 消息脚本的消息体语法分析部分针对每个映射名和目标目录名来对消息体进行语法分析(使用下面叙述的新脚本操作来进行语法分析)以填充项集合。
8. 队列脚本的传递部分使用用于添加/修改/删除目录的现有脚本操作来根据目标目录对项集合添加/修改/删除项。
创建 WebSphere Product Center 入站/出站队列
WebSphere Product Center 入站和出站队列是使用“队列控制台”创建的。在创建任何队列之前,必须从“脚本控制台”中创建触发器脚本。触发器脚本将显示在“新建队列”屏幕的“触发器脚本路径”下拉字段中。
1. 在“队列控制台”中,单击新建。
2. 在“队列详细信息”屏幕中,输入队列名和描述;选择协议和触发器脚本路径。触发器脚本是在类型为“消息队列处理器”的“脚本控制台”中创建的。
3. 单击保存。
WebSphere Product Center 脚本操作提供了一种灵活的方法来编写 WebSphere Product Center 脚本应用程序,并且每个脚本操作的自变量有定义能力。本节中标识的下列脚本操作用来支持 WebSphere Product Center 通过使用 MQ 或 JMS 来支持的消息传递功能。这些方法允许从外部队列导入消息以及将消息导出到外部队列中。
注意:本节中列示的脚本编制操作会更改。要了解最新的脚本操作,请参阅“脚本沙箱”。
MQ 脚本编制操作
当创建脚本应用程序时,脚本操作 mqGetQueueMgr 将返回一个句柄给 MQQueueManager,借助该句柄,可以在调用 mqDisconnect 以释放该句柄之前执行多个 MQ 操作。
mqGetQueueMgr
- 原型:MQQueueManager mqGetQueueMgr(String hostname, String port, String channel, String queueMgrName)
- 描述:使用给定的属性来创建并返回新的 MQ 队列管理器。
mqDisconnect
- void MQQueueManager::mqDisconnect()
- 与给定的队列管理器断开连接。
mqSendTextMsg
- 原型:MQMessage MQQueueManager::mqSendTextMsg(String msgText, String queueName, String queueOpenOptions, String messagePutOptions)
- 描述:通过 queueName 发送在 String msgText 中提供的消息。返回 MQMessage
注意:如果尝试使用 mqSendReply 来发送对给定消息的回复,并且使用了 mqSendTextMsg,就会返回错误。要避免这种情况,请使用 mqSendTextMsgWithReply
mqSendTextMsgWithReply
- 原型:MQMessage MQQueueManager::mqSendTextMsgWithReply(String msgText, String queueName, String replyQueueName, String queueOpenOptions, String messagePutOptions)
- 描述:通过 queueName 发送在 String msgText 中提供的消息。指定了回复队列。返回 MQMessage 对象。
mqGetTextFromMsg
- 原型:String mqGetTextFromMsg(MQMessage mqMessage)
- 描述:返回一个字符串,该字符串包含 MQMessage 的整个内容,包括头。
mqGetReceivedMsg
- 原型:MQMessage MQQueueManager::mqGetReceivedMsg(String queueName, String queueOpenOptions, String messageGetOptions)
- 描述:从 queueName 接收消息。返回消息(作为 MQMessage)或空。
注意:检索消息时,将把它们从队列中除去。除非指定了消息标识,否则将获取队列中的第一条消息。
mqSendReply
- 原型:MQMessage MQQueueManager::mqSendReply(MQMessage receivedMsg, String msgText, String passedInQueueOpenOptions, String passedInMessagePutOptions)
- 描述:发送对给定消息的回复,并且不指示成功或失败。
mqSendReplyWithStatus
- 原型:MQMessage MQQueueManager::mqSendReplyWithStatus(MQMessage receivedMsg, String msgText, String status, String passedInQueueOpenOptions, String passedInMessagePutOptions)
- 描述:发送对给定消息的回复,并且设置反馈字段以指示给定的状态。状态必须为下列其中一项(大写或小写):SUCCESS、FAIL、VALCHANGE、VALDUPES、MULTIPLE_HITS、FAIL_RETRIEVE_BY_CONTENT、BO_DOES_NOT_EXIST、UNABLE_TO_LOGIN、APP_RESPONSE_TIMEOUT 和 NONE。
注意:只能使用一个状态值。
mqGetXMLMessageContent
- 原型:String mqGetXMLMessageContent(String orgXmlMsg)
- 描述:废弃位于输入字符串开头的任何垃圾以获取 XML 文档。更准确地说,行为如下所示:如果输入字符串具有 A+ B 格式,其中 B 是有效的 XML 文档,A 是任何(可能是空的)字符串,则此操作返回 B。否则,返回 NULL。
注意:使用此方法来对进入消息进行解析。
mqGetResponseToMsg
- 原型:MQMessage MQQueueManager::mqGetResponseToMsg(MQMessage outgoingMessage, String queueOptions, String messageOptions)
- 描述:从给定队列获取对给定消息的响应。
mqGetMessageDiagnostics
- 原型:String mqGetMessageDiagnostics(MQMessage message)
- 描述:返回一个字符串,该字符串包含关于给定消息的诊断信息。
mqGetMessageId
- 原型:String MQMessage::mqGetMessageId()
- 描述:将给定消息的标识作为包含十六进制数字的字符串返回。
mqGetReceivedMsgByMessageID
- 原型:MQMessage MQQueueManager::mqGetReceivedMsgByMessageID(String queueName, String messageId, String passedInQueueOpenOptions, String passedInMessageGetOptions)
- 描述:在给定队列中查找具有给定消息标识的消息。该标识是在包含十六进制数字的字符串 中传递的。如果在给定的队列中没有这样的消息,则返回 NULL。
JMS 脚本操作
当创建脚本应用程序时,脚本操作 jmsGetConnectionFactory 将返回一个句柄给 QueueConnectionFactory,借助该句柄,可以在调用 jmsDisconnect 以释放该句柄之前执行多个 JMS 操作。
jmsGetContext
- 原型:Context jmsGetContext(String url, String jndiFactory)
- 描述:创建 JMS 上下文。
jmsGetConnectionFactory
- 原型:QueueConnectionFactory Context::jmsGetConnectionFactory(String jmsFactory)
- 描述:创建并返回具有指定上下文的 jms 连接工厂。
jmsGetMQConnectionFactory
- 原型:QueueConnectionFactory jmsGetMQConnectionFactory(String mqQueueManager, String mqHostname, String mqChannel, Integer mqPort)
- 描述:创建并返回用于与 MQ 队列进行通信的 JMS 连接工厂。注意,不需要 Context 就可以获取 MQ 连接工厂,但是,需要 Context 才能连接至其它 JMS 队列。
jmsGetQueueByName
- 原型:javax.jms.Queue jmsGetQueueByName(Context ctx, String name)
- 描述:从给定的 JNDI 名称和 Context 返回 javax.jms.Queue 对象。
jmsGetQueueConnection
- 原型:QueueConnection QueueConnectionFactory::jmsGetQueueConnection()
- 描述:从给定的连接工厂返回 JMS 队列连接。
jmsGetQueueSession
- 原型:QueueSession QueueConnection::jmsGetQueueSession()
- 描述:从给定的连接工厂返回 JMS 队列连接。
jmsDisconnect
- 原型:void QueueSession::jmsDisconnect(QueueConnection qcon)
- 描述:与给定的队列管理器断开连接。
jmsCreateTextMsg
- 原型:Message QueueSession::jmsCreateTextMsg(String msgText)
- 描述:使用带有所提供的文本的 QueueSession 信息来创建新的 JMS TextMessage。
jmsSendMsg
- 原型:Message QueueSession::jmsSendMsg(Message msg, String queueName[, HashMap properties, Message messageToReplyTo])
- 描述:通过具有名称 queueName 的队列发送消息 MSG 并返回该 MSG,或者返回 NULL。如果提供了 MESSAGETOREPLYTO,则从中读取对队列和消息标识的回复。PROPERTIES 是从字符串键到字符串值的映射。有三个特殊键:“WPC_REPLY_TO_QUEUE”、“WPC_COPY_CORRELATION_ID_BYTES”和“WPC_COPY_CORRELATION_ID”。如果提供了 WPC_REPLY_TO_QUEUE,则它覆盖 QUEUENAME 或者所提供的 MESSAGETOREPLYTO 中的回复队列。MESSAGETOREPLYTO 中的回复队列覆盖 QUEUENAME。“WPC_COPY_CORRELATION_ID”和“WPC_COPY_CORRELATION_ID_BYTES”将 MESSAGETOREPLYTO 中的相关标识复制到 MSG。这两者都可以被提供。它们的值需为布尔值(与上面描述的字符串相反)。
jmsReceiveMsgFromQueue
- 原型:JMSMessage QueueSession::jmsReceiveMsgFromQueue(javax.jms.Queue queue, Integer timeout[, String messageSelector, JMSMessage messageToReceiveReplyFor])
- 描述:接收 JMS 消息。在 TIMEOUT 毫秒之后超时。如果 INBOUNDQUEUE 不为 NULL,则在该队列中进行查找。如果 INBOUNDQUEUE 为 NULL,并且 MESSAGETORECEIVEREPLYFOR 不为 NULL,则在 MESSAGETORECEIVEREPLYFOR 的 Reply-To 字段中定义的队列中进行查找。如果 INBOUNDQUEUE 为 NULL,并且 MESSAGETORECEIVEREPLYFOR 也为 NULL,则抛出 AustinException。我们现在知道哪个队列将被使用。如果 MESSAGESELECTOR 和 MESSAGETORECEIVEREPLYFOR 都为 NULL,则从该队列中选择第一条消息。否则,从满足由 MESSAGESELECTOR 和 MESSAGETORECEIVEREPLYFOR 定义的所有条件的队列(如果有的话)中选择第一条消息。如果 MESSAGETORECEIVEREPLYFOR 不为 NULL,则拒绝相关标识不等于 MESSAGETORECEIVEREPLYFOR 的消息标识的任何消息。如果 MESSAGESELECTOR 不为 NULL,则拒绝任何不满足 messageSelector 中定义的条件的消息。如果找不到适合的消息,则返回 NULL。
jmsGetTextFromMsg
- 原型:String Message::jmsGetTextFromMsg()
- 描述:返回一个字符串,该字符串包含 JMS 的整个内容,包括头。
jmsGetMessageID
- 原型:String Message::getJMSMessageID()
- 描述:返回包含 JMS 消息标识的字符串。
jmsGetMessageCorrelationID
- 原型:String Message::getJMSMessageCorrelationID()
- 描述:返回包含 JMS 消息的相关标识的字符串。
jmsGetMessageProperties
- 原型:HashMap Message::getJMSMessageProperties()
- 描述:返回从字符串属性名到那些优先级的字符串值的散列映射。
jmsSendMsgToQueue
- 原型:JMSMessage QueueSession::jmsSendMsgToQueue(JMSMessage msg, javax.jms.Queue outboundQueue [, HashMap properties, JMSMessage messageToReplyTo,])
- 描述:发送消息 MSG 并返回 MSG,或者返回 NULL。除非 OUTBOUNDQUEUE 为 NULL,否则将消息发送至由 OUTBOUNDQUEUE 指定的队列。如果 OUTBOUNDQUEUE 为 NULL,则将 MSG 发送至 MESSAGETOREPLYTO 的回复队列(如果提供了 MESSAGETOREPLYTO 的话)。如果 OUTBOUNDQUEUE 为 NULL 并且未提供 MESSAGETOREPLYTO,则抛出 AustinException。如果提供了 MESSAGETOREPLYTO,则从中读取消息标识。PROPERTIES 是从字符串键到字符串值的映射。有一个特殊的(非 JMS)键:WPC_INCOMING_REPLY_QUEUE。WPC_INCOMING_REPLY_QUEUE 指示一个 javax.jms.Queue 对象,外部应用程序应该将对此消息的回复发送至该对象。
jmsSetMessageText
- 原型:void Message::setJMSMessageText(String msgText)
- 描述:为 JMS TextMessage 设置所提供的文本。仅支持 JMS TextMessage 类型。
Web Service 控制台
Web Service 控制台使用户能够使用 SOAP_HTTP 来创建和管理 Web Service。用户可以编写 WSDL 脚本来定义服务并创建实现脚本来控制服务的执行方式。
Web Service 控制台列
Web Service 控制台包含下列各列。
名称 Web Service 的名称。单击名称以查看该 Web Service 的详细信息。 描述 用来描述 Web Service 的简要描述。 协议 目前,SOAP_HTTP 是唯一可用的协议。 事务数 该服务的事务数。单击数值以查看事务,或者删除“删除”按钮以从控制台中除去该 Web Service。 管理 Web Service
访问 Web Service 控制台
要访问 Web Service 控制台,请使用菜单路径协作管理器 > Web Service > Web Service 控制台。
创建新的 Web Service
使用菜单路径:协作管理器 > Web Service > 新建 Web Service。将显示“Web Service 详细信息”屏幕。
将适当的信息输入到下列字段中:
Web Service 名称 输入 Web Service 的名称。此名称将成为 SOAP 服务的 URL 的一部分。它一定不能包含任何空格。例如, Web Service 描述 输入 Web Service 的描述。 协议 用于 Web Service 的协议。当前,基于 HTTP 的 SOAP 是唯一受支持的协议。缺省值为“SOAP_HTTP”。 URL 提供可以访问该服务的 URL。在保存了该 Web Service 之后,会自动填充此字段。
WSDL URL 可以用来访问 Web Service 的 WSDL 的 URL。在保存了该 Web Service 之后,会自动填充此字段。 WSDL 输入此服务的 WSDL。WSDL 文档以 XML 格式描述了该服务的接口、URL 和协议。虽然必须手工输入此文档,但是我们下面提供了样本 WSDL 文档。必须输入有效 XML 以便成功保存该 Web Service。 实现脚本 输入实现此服务的 Trigo 脚本。在数组变量“soapParams”中提供了该服务的输入参数。该服务的返回值必须为字符串,并且可以写至“out”写程序变量。要返回 SOAP 故障,将故障代码写至“soapFaultCode”写程序变量,并将故障消息写至“soapFaultMsg”写程序变量。在下面提供了样本实现脚本。 存储请求? 如果选择此项,则 Trigo 将把所有输入请求的参数存储在文档库中。将可以从“事务控制台”中获取它们。 存储应答? 如果选择此项,Trigo 将把所有响应中的内容存储在文档库中。将可以从“事务控制台”中获取它们。 部署的 如果选择此项,则将部署服务。否则,此服务将不可用。 样本实现脚本和 WSDL 文档
样本实现脚本和 WSDL 文档的以下设计会检查输入 SOAP 请求的参数的数目。如果刚好有 4 个参数,则会返回列示这些参数的字符串。如果多于或少于 4 个参数,则会抛出 SOAP 故障。
实现脚本
nParams = soapParams.size();if (nParams != 4){
soapFaultCode.writeln("WRONG_NUM_PARAMS");
soapFaultMsg.writeln("Wrong number of parameters. This service requires 4. You have " + nParams + " parameters.");}
else{
out.writeln("Success.");
for (i = 0; i < nParams; i++)
{
out.writeln("Parameter " + (i + 1) + " is " + soapParams[i]);
}
}
WSDL
<?xml version="1.0" encoding="UTF-8"?><wsdl:definitions targetNamespace="http://my.trigo-instance.com/soap/services/CheckParams"xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:apachesoap="http://xml.apache.org/xml-soap"
xmlns:impl="http://my.trigo-instance.com/soap/services/CheckParams"
xmlns:intf="http://my.trigo-instance.com/soap/services/CheckParams"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<wsdl:message name="invokeRequest">
<wsdl:part name="param1" type="xsd:string"/>
<wsdl:part name="param2" type="xsd:string"/>
<wsdl:part name="param3" type="xsd:string"/>
<wsdl:part name="param4" type="xsd:string"/>
</wsdl:message>
<wsdl:message name="invokeResponse">
<wsdl:part name="invokeReturn" type="xsd:string"/>
</wsdl:message>
<wsdl:portType name="CheckParams">
<wsdl:operation name="invoke" parameterOrder="param1 param2 param3 param4">
<wsdl:input message="intf:invokeRequest" name="invokeRequest"/>
<wsdl:output message="intf:invokeResponse" name="invokeResponse"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="CheckParamsSoapBinding" type="intf:CheckParams">
<wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="invoke">
<wsdlsoap:operation soapAction=""/>
<wsdl:input name="invokeRequest">
<wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
namespace="http://DefaultNamespace"
use="encoded"/>
</wsdl:input>
<wsdl:output name="invokeResponse">
<wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
namespace="http://my.trigo-instance.com/soap/services/CheckParams"
use="encoded"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="CheckParamsService">
<wsdl:port binding="intf:CheckParamsSoapBinding"
name="CheckParams">
<wsdlsoap:address location="http://my.trigo-instance.com/soap/services/CheckParams"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>管理事务
访问事务控制台
要搜索所有 Web Service 事务,请使用菜单路径协作管理器 > Web Service > 事务控制台来查看“事务控制台”。
查看 Web Service 事务
1. 在“事务控制台”中,在“Web Service 事务”表中查看事务列表。
2. 单击响应或请求列中的“查看”按钮。事务详细信息将显示在一个新的浏览器窗口中。
搜索 Web Service 事务
1. 在“事务控制台”中,从“Web Service 事务搜索”表的起始到达日期和结束到达日期字段中选择日期范围。
2. 单击搜索按钮。所有事务结果都将显示在搜索表下面的“Web Service 事务”表中。
文档库是 WebSphere Product Center 中的一个区域,每个输入文件和每个输出文件都存储在此区域中。这包括导入、脚本、报告和规范文件。为了进行审计,还提供了搜索能力。
每个通过 WebSphere Product Center 的文件都被复制并存储到文档库中。因此,可以将文档库用作备份引擎。
文档库是一个结构,GUI 在其中提供指向存储在 Oracle 数据库中的文件的超链接。在本质上,那些超链接是指向文件位置的指针。
通过文档库,用户可以按照下列方式管理文件:
- 查看文件的内容及详细信息
- 控制对文件的访问
- 查看文档的审计日志
- 删除文件
图 10.1 文档库
访问文档库
以通过以下工具栏路径来访问文档库:协作管理器 > 文档库。
显示的文档库具有文件目录结构。单击任何文件夹/子文件夹以查看该目录中的文件。将显示完整的文档路径。
查看文档详细信息
文档库提供了有关每个文档的详细信息。这包括审计日志信息,该信息显示了什么人在什么时间访问了该文档。
- 要查看文档的详细信息,请单击“查看”图标。
查看文档内容
- 要查看文档的内容,请从文档详细信息表中单击“获得内容”超链接。文档的内容将显示在一个新窗口中。
控制对文档的访问
文档库允许控制对文档的访问。可以选择访问控制组(ACG),也可以创建新的 ACG。
1. 要控制哪个用户组可以访问文档,请单击文档名旁边的锁和钥匙按钮。将显示“文档库访问详细信息”表。
2. 如果已经创建了 ACG,则从下拉字段中选择 ACG。否则,单击“新建”以创建新的 ACG。可以控制用户组以创建、查看或删除文档。
3. 一旦选择了 ACG,就单击保存以保留该文档的控制设置。
删除文档
文档库允许通过文档库删除文件,单击文档名称旁边的“垃圾箱”图标以从文档库删除该文档。
注意!一旦删除了文件,就无法复原该文件!将显示一个对话框以确认删除。单击“取消”以取消删除操作。
数据源是一个 WebSphere Product Center 实体,它定义如何将数据导入 WebSphere Product Center 中。外部数据可以来自各种位置或数据库,您也可以通过许多不同的方法来访问这些数据。例如,您可能想从数据库、位于 FTP 服务器上的文件或者本地文件系统中的数据导入数据。在这些选项中,每一个选项都需要特定的配置参数才能访问数据。数据源对这些参数进行封装,并允许将它们作为单个命名实体来进行处理,以便一旦设置了源详细信息,就可以在整个产品中重用该信息。
创建数据源
要创建新的数据源,请从“数据源”控制台中单击“新建”按钮。(也可以使用编辑工具按钮来修改现有的数据源)。将显示“创建数据源”向导。完成该向导的每个步骤。
1. 数据源 - 输入数据源的名称。
选择数据源类型 - 创建新数据源的步骤包括为数据源指定名称。与导入相同,名称应该尽可能地具有说明性。例如:“通过浏览器上载”或“通过 FTP 检索”。在选择数据源类型之后,单击选择。
可能的数据源类型包括:
通过 FTP 进行 Websphere Product Center 检索
通过选择此选项,用户告诉 WebSphere Product Center 连接至指定的 FTP 服务器以检索要上载的数据文件。WebSphere Product Center 要求用户指定下列附加信息,以便它可以连接至 FTP 服务器并检索正确的文件:服务器地址和端口号、用户名和密码、文件名以及该文件所在的目录。从文档库(包括 FTP)获取
文档库是 WebSphere Product Center 的一个区域,它存储每个已被导入 WebSphere Product Center 中的或者已被 WebSphere Product Center 生成的用于导出的单个文档。因此,可以将文件从该文档库访存到馈送中。通过 Web 浏览器更新
此选项用来将文件手工导入 WebSphere Product Center 中:使用“浏览”功能来浏览并选择驻留在硬盘上或任何可访问的网络驱动器上的文件。3. 提供有关数据源的详细信息 - 提供的有关数据源的详细信息取决于在步骤 2 中所作的选择。
如果选择的数据源类型为 ... 必需的其它信息 通过 FTP 进行 Websphere Product Center 检索 为下列各项输入值:
- 服务器地址
- 服务器端口
- 用户名
- 密码
- 文件名
- 目录
从文档库(包括 FTP)获取 输入“Websphere Product Center 文档库”中的文档的完整路径 通过 Web 浏览器更新 不需要其它详细信息。 4. 在过盛“创建数据源”向导的每个步骤之后,返回至“数据控制台”。
编辑数据源
- 从“数据源”控制台中,找到要删除的数据源并单击“编辑”按钮。将显示“创建数据源”。根据需要,更改数据源配置。
删除数据源
- 从“数据源”控制台中,找到要删除的数据源并单击“删除”按钮。将从“数据源”控制台中除去该数据源。
设计分发的目的是允许向位于应用程序本身内部和外部的个人提供通知。分发与电子邮件别名类似。通过在 WebSphere Product Center 中构建这些类型的分发列表,就有可能联系到 WebSphere Product Center 外部的人员。
“路由控制台”显示所有存储在 WebSphere Product Center 中的先前已创建的分发。从这里,用户可以修改或删除任何当前分发以及创建新的分发或分发组。分发组仅仅是先前已构建的分发的有名组。
一旦导出了目录,就可以将其发送到多个目标,以便进行核准和/或验证。导出的分发组件允许用户选择要将该目录发送到的目标。可以以电子邮件(在电子邮件的正文中)或 FTP 形式发送目录。基本上,分发也称为目标方式。
创建新的分发
要创建新的分发,请执行下列操作:
- 单击协作管理器 > 路由 > 路由控制台,将显示“路由控制台”界面。
- 单击新的分发按钮。将显示“分发”向导。完成该向导的每个步骤。
1. 分发名称 - 为分发输入名称并单击下一步。
2. 选择分发类型 - 选择分发类型并单击下一步。选择下列其中一个选项:
- Ariba 目录上载
- 定制
- 电子邮件
- FTP
- 公布
3. 分发方式 - 如果有需要的话,根据选择的分发类型的不同,输入必需的信息。单击保存以存储分发设置。
创建路由组
- 单击协作管理器 > 路由 > 路由控制台,将显示“路由控制台”界面。
- 单击新建分发组按钮。将显示“分发组”表。完成该向导的每个步骤。
2. 在“组名”字段中输入分发的名称。
3. 从提供的分发列表中选择分发名并单击添加或除去以创建组。
4. 单击保存以存储分发组设置。新的组将显示在“路由控制台”中。
删除分发
- 要从“路由控制台”中删除分发或分发组,请单击分发或分发组旁边的“删除”按钮。