数据完整性检查

<class id="Change" _delta="must_exist">
  <event_listeners>
    <event_listener id="evtCheckToWrite" _delta="define">
      <!-- 事件 ID 不需要与函数名相同，但保持一致更方便 -->
      <event>EVENT_DB_CHECK_TO_WRITE</event>
      <rank>10</rank>
      <!-- 回调必须是现有类方法的名称，名称可自定义 -->
      <callback>evtCheckToWrite</callback>
    </event_listener>
  </event_listeners>
</class>

public function evtCheckToWrite(Combodo\iTop\Service\Events\EventData $oEventData)
{
    // 防御性编程：确保 'end_date' 和 'start_date' 未被其他扩展移除
    // 比较前先转换为秒更安全
    if (MetaModel::IsValidAttCode(get_class($this), 'start_date') 
     && MetaModel::IsValidAttCode(get_class($this), 'end_date')
     && (AttributeDateTime::GetAsUnixSeconds($this->Get('start_date')) 
       > AttributeDateTime::GetAsUnixSeconds($this->Get('end_date'))))
    {
       $this->AddCheckIssue(Dict::Format('Class:Error:EndDateMustBeGreaterThanStartDate'));
    }
}

<class id="Server" _delta="must_exist">
  <event_listeners>
    <event_listener id="evtCheckToWrite" _delta="define">
      <event>EVENT_DB_CHECK_TO_WRITE</event>
      <rank>10</rank>
      <callback>evtCheckToWrite</callback>
    </event_listener>
  </event_listeners>
</class>

public function evtCheckToWrite(Combodo\iTop\Service\Events\EventData $oEventData)
{
    // 防御性编程：确保 'status' 是当前类上的有效字段
    // 枚举值返回的是 code 而非 label，因此测试 code
    if (MetaModel::IsValidAttCode(get_class($this), 'status')
    && ($this->Get('status') == 'production'))
    {
        // AttributeExternalKey 永远不会为 NULL，空值用 0 表示
        if (MetaModel::IsValidAttCode(get_class($this), 'location_id')
        && ($this->Get('location_id') == 0))
        {
            // 'Server:Error:LocationMandatoryInProduction' 必须在字典中声明
            $this->AddCheckIssue(Dict::Format('Server:Error:LocationMandatoryInProduction'));
        }
    }
}

$this->AddCheckIssue('Location is mandatory for all Servers in production');

<entry id="Server:Error:LocationMandatoryInProduction" _delta="define">
  <![CDATA['Location is mandatory for all Servers in production']]>
</entry>

public function evtCheckToWrite(Combodo\iTop\Service\Events\EventData $oEventData)
{
    // 检查 FunctionalCI 名称是否必须唯一
    $aChanges = $this->ListChanges();
    // 检查 name 字段是否被设置或修改
    if (array_key_exists('name', $aChanges))
    {
      $sNewName = $aChanges['name'];
      // 检索所有具有该新名称的 FunctionalCI，忽略某些子类
      $oSearch = DBObjectSearch::FromOQL_AllData("
         SELECT FunctionalCI WHERE name = :newFCI 
         AND finalclass NOT IN ('DBServer','Middleware','OtherSoftware','WebServer',
            'PCSoftware','MiddlewareInstance','DatabaseSchema','ApplicationSolution')
      ");
      $oSet = new DBObjectSet($oSearch, array(), array('newFCI' => $sNewName));
      // 如果至少有一个 FunctionalCI 匹配
      if ($oSet->Count() > 0)
      {
         // 阻止写入数据库
         $this->AddCheckIssue(Dict::Format('Class:FunctionalCI:FCINameMustBeUnique', $oSet->Count(), $sNewName));
      }
   }
}

<entry id="Class:FunctionalCI:FCINameMustBeUnique" _delta="define">
  <![CDATA['Functional CI name are expected to be unique, there are already %1$s using the name %2$s']]>
</entry>

public function evtCheckToWrite(Combodo\iTop\Service\Events\EventData $oEventData)
{
    // 检查当前变更是否应有关联的 CI
    if (is_subclass_of($this,'Change'))
    {
        $oSet = $this->Get('functionalcis_list');
        if ($oSet->Count() == 0)
        {
             $this->AddCheckIssue(Dict::S('Class:Change/Error:AtLeastOneCiIsNeeded'));
        }
    }
}

<class id="Ticket">
  <fields>
    <field id="functionalcis_list">
      <with_php_constrains _delta="define">true</with_php_constrains>
    </field>
  </fields>
</class>

public function evtCheckToWrite(Combodo\iTop\Service\Events\EventData $oEventData)
{
    // 检查 profile_list 是否被修改，避免不必要的加载
    $aChanges = $this->ListChanges();
    if (array_key_exists('profile_list', $aChanges))
    {
        $oSet = $this->Get('profile_list');
        if ($oSet->Count() == 0)
        {
             $this->AddCheckIssue(Dict::S('Class:User/Error:AtLeastOneProfileIsNeeded'));
        }
    }
}

public function evtCheckToWrite(Combodo\iTop\Service\Events\EventData $oEventData)
{
    if ($this->IsNew() // 是否尝试创建新对象
    && !(UserRights::HasProfile('Configuration Manager')) // 用户没有 "Configuration Manager" 角色
    {
        $this->AddCheckIssue(Dict::S('Class:FunctionalCI/Error:CreationDenied'));
    }
}