个性化定制iTop数据模型配置属性

1. 定制化步骤

1.1 首先安装iTop系统实例

安装iTop应用系统并初始化数据。

iTop应用系统

1.2 安装iTop toolkit工具

在iTop官方网站下载iTopDataModelToolkit工具，解压后将toolkit文件夹上传到itop应用系统的根目录下。

安装ToolKit

1.3 通过模块创建向导工具创建空白模块

通过模块创建向导创建空白模块。

Create Empty Module

表单信息如下：

Module Name -- 模块名称 -- 唯一名称，"itop-"与"combodo-"为保留字段

Module Label -- 在模块安装过程中显示

Module Version -- 模块版本

Category -- 类别

Dependencies -- 需要添加和修改依赖的itop模块名称

Create Empty Module 2

最后，点击“Generate”按键生成相关的压缩包文档。

1.4 将空白模块复制到iTop的extensions文件夹下

将生成的压缩包上传至itop系统的extensions目录下；

上传生成的模块

修改<iTOP目录>/conf/production/config-itop.php的文件权限；

说明：如果未修改config-itop.php的文件权限，在执行下一步操作的过程会出现错误。

chmod -R 755 /app/conf/production/config-itop.php

修改配置文件权限

访问http://<itop_server_ip>:<port>/setup/执行模块安装配置

开始itop的配置过程

选择“Upgrade and existing iTop instance”, 点"Next>>>“ 继续下一步操作。

更新iTop配置

直到选择"Extentions“步骤时，将刚添加的模块勾选上，如下图所示。

安装extensions扩展插件

继续下一步操作，直至完成更新过程。

完成itop应用系统更新过程

1.5 在extensions下修改模块信息，然后使用toolkit工具检查更新

在上一个步骤中，我们完成了itop系统的修改，接下来打开刚才自定义的datamodel.sczq-server-system.xml文件，修改内部的配置项信息。

<?xml version="1.0" encoding="UTF-8"?>
<itop_design xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.0">
  <classes>
    <class id="Server">
      <fields>
        <field id="hdd" xsi:type="AttributeString" _delta="define">
          <sql>hdd</sql>
          <defalut_value/>
          <is_null_allowed>true</is_null_allowed>
        </field>
        <field id="raid" xsi:type="AttributeString" _delta="define">
          <sql>raid</sql>
          <defalut_value/>
          <is_null_allowed>true</is_null_allowed>
        </field>
        <field id="system_name" xsi:type="AttributeString" _delta="define">
          <sql>system_name</sql>
          <defalut_value/>
          <is_null_allowed>true</is_null_allowed>
        </field>
        <field id="system_code" xsi:type="AttributeString" _delta="define">
          <sql>system_code</sql>
          <defalut_value/>
          <is_null_allowed>true</is_null_allowed>
        </field>
      </fields>
    </class>
  </classes>
</itop_design>

同时，在datamodels\2.x\itop-config-mgmt\datamodel.itop-config-mgmt.xml中找到需要增加属性的配置项信息，并添加其相关的属性性显示位置。如下所示：

<presentation>
    <details>
    <items>
        ... ...
        <item id="col:col1">
            <rank>120</rank>
            <items>
                <item id="fieldset:Server:baseinfo">
                  <rank>10</rank>
                  <items>
                    ... ...
                    <item id="system_name">
                      <rank>80</rank>
                    </item>
                    <item id="system_code">
                      <rank>90</rank>
                    </item>
                  </items>
                </item>
                <item id="fieldset:Server:moreinfo">
                  <rank>20</rank>
                  <items>
                    ... ...
                    <item id="hdd">
                      <rank>71</rank>
                    </item>
                    <item id="raid">
                      <rank>72</rank>
                    </item>
                    ... ...
                  </items>
                </item>
            </items>
        </item>
    </items>
    </details>
</presentation>

将修改完的配置文件信息上传到iTop系统中的目录下。
验证配置文件是否正确，并执行相应的更新。
访问http://<itop_server_ip>:<port>/toolkit/, iTop系统工具自动验证数据模型的正确性。如果出现Ok, no problem detected的提示，则表明刚才修改的配置文件没有问题，否则需要重新修改配置文件。

验证数据模型的正确性
添加配置项的中文字典

注意：如果我们需要将所添加的配置项用中文显示，需要将en.dict.XXXXX.php另存为一份名为zh.dict.XXXXX.php的文件，并确保其文件编码为UTF-8编码，否则会出现中文乱码。

添加配置项的中文名称显示，如下：

vi zh.dict.XXXXX.php

<?php
/**
 * Localized data
 *
 * @copyright   Copyright (C) 2013 XXXXX
 * @license     http://opensource.org/licenses/AGPL-3.0
 */

Dict::Add('ZH CN', 'Chinese', '简体中文', array(
    // Dictionary entries go here
    'Class:Server/Attribute:hdd' => '硬盘',
    'Class:Server/Attribute:raid' => 'Raid',
    'Class:Server/Attribute:system_name' => '所属系统',
    'Class:Server/Attribute:system_code' => '系统代码',
));
?>

查看配置项中文名称

更新iTop系统，在iTop update选项卡中点击"update iTop Code And Database!"或者”update iTop Code“按钮进行系统更新。

更新iTop系统代码

最后，我们完成了所有的配置项属性添加操作，在iTop系统中的配置管理中我们将看到新增的配置项属性信息。

查看新增的配置项信息