为窗口小部件和其他指定场景添加定制字符串

在执行某些 IBM® Connections 任务时,可以添加定制字符串或修改现有的字符串。

开始之前

要添加定制字符串时必须使用 wsadmin 客户端。 请参阅启动 wsadmin 客户端以获取详细信息。
IBM Connections 提供了外部捆绑包装入器,用于向“个人档案”、“社区”和“主页”添加和更新字符串。 仅当执行下列任务时,才能使用此过程:
  • 向个人档案添加定制扩展属性
  • 定制“个人档案”名片
  • 向“社区”、“个人档案”和“主页”添加定制窗口小部件
  • 配置电子名片导出应用程序
  • 将“主页”中的选项卡重命名
  • 向“社区”添加定制主题
可以用“定制产品字符串”中所概述的过程为其他任务添加定制字符串。

关于此任务

要为列出的任务添加定制字符串,请创建包含这些定制字符串的捆绑包并将其保存在安装时创建的 customization_dir/strings 目录中。 然后,请在 LotusConnections-config.xml 文件中注册该文件。 为了提高性能,请将所有资源字符串包括在单一捆绑包中。

有关完整示例,请参阅创建简单的个人档案数据模型和模板定制

过程

  1. customization_dir/strings 目录中创建一个包含所要添加的字符串的属性文件。
    • 要指定缺省属性文件的名称,请使用以下语法:
      resource_bundle_name.properties_file_name
    • 要在多种语言中指定定制字符串,请使用以下语法对捆绑包名称追加下划线并随后指定相应的语言代码:

      resource_bundle_name_language_code.properties_file_name

    例如,如果字符串捆绑包名为 com.example.resources,那么可以在 strings 目录中创建一个类似于以下的文件:
    customization_dir/strings/com.example.resources.properties
    此文件包含用于缺省语言环境的字符串。 不存在适用于用户语言环境的特定捆绑包时,将使用这个缺省属性文件中的标签。

    要包括英文版的字符串,可以创建以下文件:
    <customization_dir>/strings/com.example.resources_en.properties

    并且,要包括斯洛伐克语版本的字符串,可以包括以下文件:
    customization_dir/strings/com.example.resources_sk.properties

    以下样本字符串包含在 properties 文件中。
    label.vcard.encoding.cp943c=Japanese Encoding
  2. LotusConnections-config.xml 文件中注册捆绑包:
    1. 打开命令窗口并启动 wsadmin 命令行工具,如启动 wsadmin 客户端主题中所述。
    2. 输入以下命令,以访问 IBM Connections 配置文件:
      execfile("$WAS_HOME/profiles/DMGR/config/bin_lc_admin/connectionsConfig.py")
    3. 输入以下命令,以检出 IBM Connections 配置文件:
      LCConfigService.checkOutConfig(working_directory, cell_name)
      其中:
      • working_directory 是复制“配置 XML 和 XSD 文件”的临时目标工作目录。 对这些文件进行更改时,文件将保留在此工作目录中。
      • cell_name 是 IBM Connections 应用程序所在 IBM WebSphere® Application Server 单元的名称。 此参数是必需的。 此参数也区分大小写,因此输入时务必小心。
      例如:
      LCConfigService.checkOutConfig("/temp", "foo01Cell01")
    4. 在刚刚将 IBM Connections 配置文件检出到的临时目录中,使用文本编辑器打开 LotusConnections-config.xml 文件。
    5. 在 <resources> 元素块中添加以下代码行,以便注册该捆绑包:
      <widgetBundle prefix=bundle_prefix name=bundle_name />
      其中:
      • bundle_prefix 是用于标识此捆绑包的全局唯一名称。 这是一个字符串值。 捆绑包前缀用于唯一地限定每个捆绑包中的键的作用域。 此前缀必须跨所有已注册的窗口小部件捆绑包保持唯一。

        此捆绑包前缀映射到您在定义定制资源属性或窗口小部件时指定的捆绑包标识引用。有关定义定制资源属性的更多信息,请参阅启用“个人档案”的定制扩展属性。有关定义定制窗口小部件的信息,请参阅为“社区”启用定制窗口小部件或者为“个人档案”启用定制窗口小部件

      • bundle_name 是 Java 包名。此参数采用字符串值。您对捆绑包进行命名时,该捆绑包名称中的元素必须与您在步骤 1 中创建的属性文件的文件名相对应。

        例如,如果 strings 定制目录包含文件 com.example.resources.propertiescom.example.resources_en.propertiescom.example.resources_sk.properties,那么捆绑包的名称将是 com.example.resources

      以下样本代码用于注册 com.example.resources 捆绑包:
      <resources>
      
        <!--  Example:  The attribute 'prefix' must be globally unique as it identifies the bundle when used in IBM Connections.  -->
      
        <widgetBundle prefix="example" name="com.example.resources"/>
      
      </resources>
    6. 保存对 LotusConnections-config.xml 文件所作的更改。
    7. 要检入更新后的文件,请使用以下命令:
      LCConfigService.checkInConfig()
    8. 要退出 wsadmin 客户端,请在提示符处输入 exit

下一步做什么

完成本过程后,即可在其他配置设置或 JavaScript 代码中使用这些标签。 例如,可以在“个人档案”中定制名片时使用这些字符串为定制扩展属性添加标签,也可以在向“个人档案”、“社区”和“主页”添加窗口小部件时使用这些字符串来提供窗口小部件标题和描述。 另外,还可以使用这些字符串将“主页”中的更新窗口小部件管理选项卡重命名。

注意,对属性、可编辑属性或定制扩展属性指定外部标签时,这些标签将仅应用于配置对象所表示的用户界面元素。 例如,如果将定制标签应用至名片 <attribute> 元素,标签不会自动应用至高级搜索页面布局中的相同元素。

有关如何将标签配置逐个应用于每个用户界面元素的信息,请参阅为窗口小部件和其他指定场景添加定制字符串