開発者手引き

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search


This page is main index of documents relating to developer documentation. For user documentation see here.


開発組織とツール

This chapter contains global information that must be read before starting any development on Dolibarr.

  1. Organization of project
  2. To be known before starting to develop
  3. Environment and development tools
  4. Dependencies and external libraries
  5. Get or update sources of a development version

コーディング規約とベストプラクティス

  1. Prerequisites
  2. Language and development rules (PHP, SQL, HTML)
  3. List of tables
  4. Tree structure of files and classes are available in the doxygen generated documentation

モジュールリスト

標準ビジネスモデルの技術文書は、それぞれのモジュール開発者の文書ページ (documentation pages) にある. 関心に応じて適切なページを選ぶとよい:

GUI 向けの新 モジュール/アドオン を作るには

この項では、Dolibarr のユーザインタフェースを変更する新規モジュールの開発方法を述べる. 該当するのは、スクリーン、テーマ、データ、保有するCSSスタイルシート 、ソースコード、またはそれらのすべて.

スクリプト開発はこの項には含まれない (これは次章で述べる).

自分のモジュールを開発するには、モジュール開発 チュートリアルを確認すること.

バッチまたはコマンドラインスクリプトを作るには

この章では、Dolibarr でタスクを実行するためのコマンドラインスクリプト開発方法について説明する (read, update data...).

グラフィカルユーザーインターフェイス(GUI)への変更作成は、本章には含まれない。これについては、前章を参照.

cronスクリプトや外部ソースからデータを取り込むためのコマンドライン インポートツールなど、スクリプトを開発するには、スクリプト開発 (Script development) ページをご覧ください.

Dolibarr の技術的要素 (Technical components)

ツリー構造 (Tree structure)

現バージョンのファイルのパス階層は、 doxygen generated documentation ("javadoc" 文書に類似) から把握できる.

新規モジュールによる新規ファイルの追加で使用するパスは、新規モジュール開発の文書 (Module development 参照) で定義される.

ストレージ準備 (Setup storage)

Dolibarr 設定パラメータは3か所存在する.

  • Dolibarr 技術的設定パラメータ (認証モード, データベースログインとファイル向けストレージ領域) が定義される設定ファイルは1つだけ: /conf/conf.php .
さらに詳細は Configuration file を参照.
さらに詳細は Constants ページを参照.

ビジネスオブジェクト (Business objects)

参照 ビジネスオブジェクト

メニューシステム (Menu system)

参照 Menus system

タブシステム (Tabs system)

参照 Tabs system

スキンシステム (Skins system)

参照 Skins

ウィジェットシステム (Widget system)

参照 Widget system

認証システム (Authentication system)

参照 Authentication

許可システム (Permission system)

参照 Permissions

翻訳システム (Translation system)

参照 Translation system

エラー管理 (Error management)

参照 Error reporting

キャンバスシステム (Canvas system)

Canvasは、レコード(商品、取引先、連絡先など)を作成、更新、閲覧するための画面を置き換える開発者向けの機能. 例えば、取引先の新規作成に使用する入力フォームやその編集フォームを置き換えたり、閲覧テンプレートを置き換えたりすることがでる.

参照 Canvas development

トリガーシステム (Triggers system)

トリガーは、Dolibarrの "ビジネスイベント" (請求書の作成、ユーザーの削除、取引先の更新など) に付随して、パーソナライズされたコードを実行するための開発機能で、ビジネスイベントに対してのみ有効. 他のコンテキストでコードをパーソナライズするには、代わりにフックシステム (Hooks system) の章を参照.

トリガーの使用に関して、参照 this page.

フックシステム (Hooks system)

参照 Hooks system

変数置換システム (Variable substitution system)

参照 Variable substitution system

ウェブサービス (Web services)

Dolibarr はいくつかのサービスを提供するように設定可能.

参照 Module Web Services API REST (developer)

注: Module Web Services API SOAP (developer) は非推奨.

ファイル/書類 ストレージ管理 (Files/Documents storage management)

参照 Generated documents

番号付けモジュール (Numbering modules)

For アプリケーションで作成された各エンティティに対して、Dolibarrは参照を割り当てる.どのような用途にも参照を適応できるように、Dolibarrはモジュールを使って参照生成ルールを定義する.いくつかの標準モジュールが提供されてる.あるモジュールは汎用的で、ナンバリングマスクの定義に使用される(x文字の番号、接頭辞の有無、日付の有無、など)。しかし、提供されているモジュールがニーズを満たさない場合もある.この場合、カスタム番号モジュールを開発する必要がある.

詳しくは, Create numbering module を参照.

文書テンプレートと文書生成 (Document templates and documents generation)

テンプレートからの文書生成に関して、 Create a PDF document templateCreate an ODT document template に更なる説明がある.

エクストラフィールド (Extrafields)

参照 Extrafields

オンライン決済システム (Online payment system)

参照 Online payment system

他内部機能 (Other internal function)

自前コードで利用できる多くの内部ライブラリがある.functions.lib.php、functions2.lib.php、admin.lib.phpに多くの汎用関数が見つかる. htdocs/core/lib/*.lib ファイルにある関数はどれでも使用可.

Dolibarrのバージョン番号に基づく要件を指定するには

例えば、Dolibarrバージョンの3.5以上を前提条件にするには、 admin.lib.php にある versioncompare と versiondolibarrarray を使用する:

if (versioncompare(versiondolibarrarray(), array(3,5,0)) > 0)
{
 ...
}

大量 エクスポート/インポート (Mass exports/imports)

他のアプリとのインタフェースやリンク (Interfaces and links with other applications)

Integrate Dolibarr to automation platforms:

FAQ

すべての FAQs は FAQ インデックスページ FAQ EN から利用可能