PHP を使用して SuiteCRM のカスタム モジュールを開発する方法

PHP を使用して SuiteCRM のカスタム モジュールを開発する方法

SuiteCRM はオープンソースのエンタープライズ レベルの CRM システムであり、豊富な機能と柔軟な拡張メカニズムを提供し、実際のニーズに応じてカスタマイズおよび開発できます。この記事では、PHP を使用して SuiteCRM のカスタム モジュールを開発する方法を紹介し、参考用のコード サンプルを提供します。

1. 準備

開始する前に、SuiteCRM システムがインストールされていて、開発およびカスタマイズの権限があることを確認する必要があります。同時に、この記事のコード例を理解して適用できるようにするには、PHP プログラミングの基本的な知識も知っておく必要があります。

2. モジュールの作成

まず、SuiteCRM のカスタマイズと開発用に新しいモジュールを作成する必要があります。 SuiteCRM のディレクトリ構造では、モジュールのルート ディレクトリとして、custom/modules ディレクトリに新しいフォルダを作成できます。たとえば、CustomModule という名前のモジュールを作成するには、custom/modules ディレクトリに CustomModule フォルダーを作成します。

CustomModule フォルダーに、次のファイルとフォルダーを作成する必要があります。

• CustomModule.php: CustomModule モジュールの基本情報と動作を定義します。
• 言語フォルダー: 国際化とローカリゼーションのためのモジュール関連の言語ファイルを保存します。
• metadata フォルダー: データベース テーブル構造、フィールド定義などを含むモジュールのメタデータ情報が保存されます。

3. モジュールの定義

CustomModule.php ファイルでは、CustomModule モジュールの基本情報と動作を定義する必要があります。以下に例を示します。

<?php
if (!defined('sugarEntry') || !sugarEntry) die('Not A Valid Entry Point');

class CustomModule extends SugarBean
{
    // 模块名称
    public $module_name = 'CustomModule';
    // 数据表名称
    public $table_name = 'custom_module';
    // 模块别名
    public $object_name = 'CustomModule';
    // 主键字段名称
    public $object_field = 'id';
    
    /**
     * 构造函数
     */
    public function __construct()
    {
        parent::__construct();
    }
    
    /**
     * 验证字段
     */
    public function bean_implements($interface)
    {
        switch ($interface) {
            case 'ACL': return true;
        }
        
        return false;
    }
}

この例では、モジュールの基本情報と動作は、SugarBean クラスから継承する CustomModule クラスを定義することによって実装されます。実際のニーズに応じて、対応するプロパティとメソッドを変更する必要があることに注意してください。

4. フィールドの定義

メタデータ フォルダーに、CustomModule モジュールのフィールドを定義するための新しいファイルcustom_module.php を作成できます。以下に例を示します。

<?php
$dictionary['CustomModule'] = array(
    'table' => 'custom_module',
    'fields' => array(
        array(
            'name' => 'id',
            'type' => 'id',
            'required' => true,
            'len' => 36,
        ),
        array(
            'name' => 'name',
            'type' => 'varchar',
            'len' => 255,
            'required' => true,
        ),
        // 定义其他字段...
    ),
    'indices' => array(
        array(
            'name' => 'custom_module_pk',
            'type' => 'primary',
            'fields' => array('id'),
        ),
    ),
);

この例では、フィールドの属性と構造は、フィールドの名前、タイプ、長さ、必須かどうかなどを含む辞書配列を定義することによって記述されます。実際のニーズに応じて、対応する定義を変更する必要があることに注意してください。

5. データベース操作の実行

SuiteCRM では、事前定義された関数とクラスを使用して、追加、削除、変更などのデータベース操作を実行できます。よく使用される例を次に示します。

• Query data:

$query = new SugarQuery();
$query->from(BeanFactory::getBean('CustomModule'));
$query->select(array('id', 'name'));
$query->where()->equals('name', 'John Doe');
$result = $query->execute();

• Create data:

$customModule = BeanFactory::newBean('CustomModule');
$customModule->name = 'John Doe';
$customModule->save();

• Update data :

$customModule = BeanFactory::getBean('CustomModule', '12345678-1234-1234-1234-1234567890ab');
$customModule->name = 'Jane Doe';
$customModule->save();

• Delete data:

$customModule = BeanFactory::getBean('CustomModule', '12345678-1234-1234-1234-1234567890ab');
$customModule->mark_deleted('12345678-1234-1234-1234-1234567890ab');

上記のサンプル コードは、SugarQuery クラスと BeanFactory クラスを通じてデータベース操作を実行する方法を示しています。実際のニーズに応じて、対応する操作を変更する必要があることに注意してください。

概要

上記の手順により、PHP を使用して SuiteCRM のカスタム モジュールを開発できます。まず、モジュールのファイルとフォルダーを作成し、モジュールの基本情報と動作を定義する必要があります。その後、フィールドを定義してモジュールの構造とプロパティを記述することができます。最後に、データベース操作は、事前定義された関数とクラスを通じて実行できます。

もちろん、SuiteCRM での開発とカスタマイズはこれをはるかに超えており、より複雑な機能やビジネス ロジックも実装できます。この記事が、PHP をより効果的に使用して SuiteCRM 用にカスタマイズされたモジュールを開発するのに役立つ基本的なガイダンスとリファレンスを提供できれば幸いです。

以上がPHP を使用して SuiteCRM のカスタム モジュールを開発する方法の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。