Dolibarr ERP CRM Wiki - User contributions [en]

モジュールによるインポート

2021-05-01T13:44:21Z

TinyTiger: added interlang links

[[en:Module_Imports_En]]
[[fr:Module_Imports]]
[[es:Módulo_Importaciones]]


[[Category:Admin]]
{{TemplateDocUser}}
{{TemplateModEN}}
{{BasculeDevUserJa|
name=Imports|
num=250|
devdoc=This page|
userdoc=This page}}

=はじめに=
既に手元にあるデータや累積データをDolibarrに一括インポートするにはいくつかの方法があります。このページでは内蔵されているインポートモジュールを使用する方法を説明します。
一括インポートについてのその他の方法については[[一括インポート]]のページで解説されています。

=インストール=
{{NoInstallModuleJa}}

= 設定 =
{{ActivationModuleJa}}
インポートまたはエクスポートするCSVファイルのセパレーターや文字コードを変更するには[[Setup Other]]のページも参照してください。

= 使用方法 =
既にあるデータをインポートする場合、インポートを成功させるには何度もトライしたりソースファイルを修正したりする必要が出てくると思われます。LibreOfficeやOpenOfficeを使用して、単一のスプレッドシート（.ods）を「構築」し、修正・変更のたびにCSVとして保存する作業を繰り返すことをお勧めします。なぜなら、マルチバイト（アクセント）テキスト文字列の文字セット処理やcsvの構造定義に関してはExcelよりもはるかに優れているからです。

ほとんどのフィールドは内容がロジカルですが、住所データにおける州/県のデータ（StateID）はそうではありません。
このフィールドは、州/県の名前（国と国の間で一意ではない場合があります。例："Florida"など）を使ってインポートすることはできず、テーブルllx_c_departements内のrowidの整数と一致させる必要があります。インポートチェックで強制的にrowidと一致させることを確実にするために、ファイルのフィールドの値の前に「id:」を付けてください。

州/県をrowidと一致させるには、SQLエディタを使ってテーブルをCSVとしてエクスポートした後、それをスプレッドシートのVLOOKUP関数機能で使用してrowidを返すという方法があります。
しかしVLOOKUPでは州名/県名が重複している場合、最初に一致した値しか返ってこないため、手動でのチェックが必要です。

レガシーデータの中には、Dolibarr上でまだ地域や州/県が追加されていない国も一部存在します。レガシーデータをインポートする前に、インストールファイルに含まれるmyqslクエリを参考にして、新しい地域や州/県を追加することができます。

インポートの手順
*ツールメニュー - 新規インポートに移動します。
*ステップ1: 定義済みのデータセットの中から、自分のデータに合うものを選びます。行末にあるボタンをクリックして選択します。
*ステップ2: CSVまたはExcel (.xlsx)のどちらかのファイル形式を、行末のボタンをクリックして選択します。注：入力可能なフィールド値に関する情報やヒントを含む空のサンプルファイルを「フィールドコンテンツ情報を含むテンプレートファイルをダウンロードする」からダウンロードすることができます。
*ステップ3: お使いのコンピュータからDolibarrのサーバにアップロードするファイルを参照して選択します。ファイルの転送が完了したら、行末のボタンをクリックして次のステップに進みます。
*ステップ4: ファイルのフィールドとデータセットのフィールドを合致させます。左の列はアップロードされたファイルにあるフィールドの一覧です。右の列はDolibarrで利用可能なフィールドの一覧です。左の列のフィールドは矢印アイコンを使いドラッグ＆ドロップすることで上下に移動でき、各ファイルのフィールドとDolibarr側のフィールドを正しく合わせることができます。入力ファイルのフィールドが無視されたりインポートされない場合は、「インポートされていないソースファイルのフィールド」の下に移動されます。
注：行末のクエスチョンマークにカーソルを合わせると、Dolibarrが想定するデータフォーマットや値の情報が表示されます。
マッピングが完了したら、今後使用するためにそれをプロファイルとして保存することができます。「次のステップ」をクリックして次に進みます。
*ステップ5: インポートシミュレーションを実行します。フィールドセパレータと区切り文字がファイルのレイアウトに合っているかどうかを確認します。ファイルに見出し行がある場合は、「制限範囲」を使用してこれらを除外する必要があります。
「インポートシミュレーションを実行する」をクリックして開始します。シミュレーションではフィールドの値がチェックされ、エラーレポートが表示されます。エラーがなければ「データのインポート」をクリックしてデータを挿入することができます。インポートされたデータは既存のデータに追加されます。
*すべてのデータは特定のインポートに関連する問題の解決を支援するために、インポートの日付に対応する「import_key」のフィールドを追加して、Dolibarrにインポートされます。SQLエディターを使えば、インポートされた行の中から該当する行を比較的簡単に見つけることができます。

= 使用例 =
{{ExamplesCaseJa
|name=UCMI01:
|situation=3000件以上の商品を記載したCSVファイルがあります。これをDolibarrにインポートしたいのですが。
|actions=メニューのツール -> インポートアシスタント -> 新規インポート
}} 

{{ExamplesCaseJa
|name=UCMI02:
|situation=1000件の見込み顧客を記載したテキストファイルがあります。これをDolibarrにインポートしたいのですが。
|actions=メニューのツール -> インポートアシスタント ->
}}

モジュールによるインポート

2021-05-01T13:40:13Z

TinyTiger:

{{TemplateDocUser}}
{{TemplateModEN}}
{{BasculeDevUserJa|
name=Imports|
num=250|
devdoc=This page|
userdoc=This page}}

=はじめに=
既に手元にあるデータや累積データをDolibarrに一括インポートするにはいくつかの方法があります。このページでは内蔵されているインポートモジュールを使用する方法を説明します。
一括インポートについてのその他の方法については[[一括インポート]]のページで解説されています。

=インストール=
{{NoInstallModuleJa}}

= 設定 =
{{ActivationModuleJa}}
インポートまたはエクスポートするCSVファイルのセパレーターや文字コードを変更するには[[Setup Other]]のページも参照してください。

= 使用方法 =
既にあるデータをインポートする場合、インポートを成功させるには何度もトライしたりソースファイルを修正したりする必要が出てくると思われます。LibreOfficeやOpenOfficeを使用して、単一のスプレッドシート（.ods）を「構築」し、修正・変更のたびにCSVとして保存する作業を繰り返すことをお勧めします。なぜなら、マルチバイト（アクセント）テキスト文字列の文字セット処理やcsvの構造定義に関してはExcelよりもはるかに優れているからです。

ほとんどのフィールドは内容がロジカルですが、住所データにおける州/県のデータ（StateID）はそうではありません。
このフィールドは、州/県の名前（国と国の間で一意ではない場合があります。例："Florida"など）を使ってインポートすることはできず、テーブルllx_c_departements内のrowidの整数と一致させる必要があります。インポートチェックで強制的にrowidと一致させることを確実にするために、ファイルのフィールドの値の前に「id:」を付けてください。

州/県をrowidと一致させるには、SQLエディタを使ってテーブルをCSVとしてエクスポートした後、それをスプレッドシートのVLOOKUP関数機能で使用してrowidを返すという方法があります。
しかしVLOOKUPでは州名/県名が重複している場合、最初に一致した値しか返ってこないため、手動でのチェックが必要です。

レガシーデータの中には、Dolibarr上でまだ地域や州/県が追加されていない国も一部存在します。レガシーデータをインポートする前に、インストールファイルに含まれるmyqslクエリを参考にして、新しい地域や州/県を追加することができます。

インポートの手順
*ツールメニュー - 新規インポートに移動します。
*ステップ1: 定義済みのデータセットの中から、自分のデータに合うものを選びます。行末にあるボタンをクリックして選択します。
*ステップ2: CSVまたはExcel (.xlsx)のどちらかのファイル形式を、行末のボタンをクリックして選択します。注：入力可能なフィールド値に関する情報やヒントを含む空のサンプルファイルを「フィールドコンテンツ情報を含むテンプレートファイルをダウンロードする」からダウンロードすることができます。
*ステップ3: お使いのコンピュータからDolibarrのサーバにアップロードするファイルを参照して選択します。ファイルの転送が完了したら、行末のボタンをクリックして次のステップに進みます。
*ステップ4: ファイルのフィールドとデータセットのフィールドを合致させます。左の列はアップロードされたファイルにあるフィールドの一覧です。右の列はDolibarrで利用可能なフィールドの一覧です。左の列のフィールドは矢印アイコンを使いドラッグ＆ドロップすることで上下に移動でき、各ファイルのフィールドとDolibarr側のフィールドを正しく合わせることができます。入力ファイルのフィールドが無視されたりインポートされない場合は、「インポートされていないソースファイルのフィールド」の下に移動されます。
注：行末のクエスチョンマークにカーソルを合わせると、Dolibarrが想定するデータフォーマットや値の情報が表示されます。
マッピングが完了したら、今後使用するためにそれをプロファイルとして保存することができます。「次のステップ」をクリックして次に進みます。
*ステップ5: インポートシミュレーションを実行します。フィールドセパレータと区切り文字がファイルのレイアウトに合っているかどうかを確認します。ファイルに見出し行がある場合は、「制限範囲」を使用してこれらを除外する必要があります。
「インポートシミュレーションを実行する」をクリックして開始します。シミュレーションではフィールドの値がチェックされ、エラーレポートが表示されます。エラーがなければ「データのインポート」をクリックしてデータを挿入することができます。インポートされたデータは既存のデータに追加されます。
*すべてのデータは特定のインポートに関連する問題の解決を支援するために、インポートの日付に対応する「import_key」のフィールドを追加して、Dolibarrにインポートされます。SQLエディターを使えば、インポートされた行の中から該当する行を比較的簡単に見つけることができます。

= 使用例 =
{{ExamplesCaseJa
|name=UCMI01:
|situation=3000件以上の商品を記載したCSVファイルがあります。これをDolibarrにインポートしたいのですが。
|actions=メニューのツール -> インポートアシスタント -> 新規インポート
}} 

{{ExamplesCaseJa
|name=UCMI02:
|situation=1000件の見込み顧客を記載したテキストファイルがあります。これをDolibarrにインポートしたいのですが。
|actions=メニューのツール -> インポートアシスタント -> 新規インポート
}} 

Template:ActivationModuleJa

2021-05-01T13:37:39Z

TinyTiger: retranslate into more natural Japanese

モジュールを使用するには、まず最初にメニューオプションの '''ホーム -> セットアップ -> モジュール/アプリケーション''' にアクセスし、管理者アカウントでモジュールを有効化して下さい。

一覧からモジュールのタブを選択し、 "'''有効化(Activate)'''" をクリック。

これでモジュールが有効化されました。

歯車アイコン[[File:Cog circle.svg|30x30px]]がモジュールの行末に表示されている場合は、クリックするとそのモジュール専用の設定ページににアクセスできます。

モジュールによるインポート

2021-05-01T13:27:03Z

TinyTiger: Created page with "{{TemplateDocUser}} {{TemplateModEN}} {{BasculeDevUserJa| name=Imports| num=250| devdoc=This page| userdoc=This page}} =はじめに= 既に手元にあるデータや累積..."

Template:ExamplesCaseJa

2021-05-01T13:25:49Z

TinyTiger: translated from Template:ExamplesCaseEn

<div>
{| align="left" border="0" width="100%" cellpadding="2" cellspacing="0" class="dolbox"
! colspan="2" style="background-color: #e9e9ef" align="left"|'''{{{name}}}'''
|-
| valign="top" nowrap="nowrap" width="100px"| '''状況''' || align="left" | {{{状況}}}
|-
| valign="top" nowrap="nowrap"| '''操作''' || align="left" | {{{操作}}}
|}
</div>

Template:BasculeDevUserJa

2021-05-01T13:20:39Z

TinyTiger: translated from Template:BasculeDevUser

<div>
{| align="right" border="0" width="340px" cellpadding="2" cellspacing="0" class="dolbox"
! colspan="2" style="background-color: #e9e9ef" |'''{{{name}}}'''
|-
| valign="top" nowrap="nowrap"| モジュールNo. || align="center" nowrap="nowrap"| {{{num}}}
|-
| valign="top" nowrap="nowrap"| モジュールのユーザー向けドキュメント || align="center" nowrap="nowrap"| {{{userdoc}}}
|-
| valign="top" nowrap="nowrap"| モジュールの開発者向けドキュメント || align="center" nowrap="nowrap"| {{{devdoc}}}
|}
</div>

アジアの言語（中国語、日本語、韓国語）の扱いに関するよくある質問

2021-04-11T01:40:25Z

TinyTiger: Pertially translated from English page

アジアの言語（中国語、日本語、韓国語）の扱いに関するよくある質問



[[en:FAQ_Manage_asiatic_languages_(Chinese,_Japanese,_Korean)]]
[[fr:FAQ_Gestion_des_langues_asiatiques_(Chinois,_Japonais,_Correen)]]
[[es:FAQ_Gestion_de_idiomas_asiaticos_(Chino,_Japones,_Coreano)]]


Dolibarr 3.0以降ではシステム全体、そしてPDF作成時にもUTF-8を使用しています。つまり、そのままアジアの言語を扱うことができるということです。
しかし中国語で請求書を作成した場合（Dolibarrで中国語を選択した後、または多言語オプションを有効にした場合にPDF作成に中国語を選択した後）、作成されたPDFに全く文字が表示されないことが起こり得ます。

これはDolibarrの問題ではなく、使用しているPDFリーダー側の問題です。PDFリーダーもしくはOSが単純にその言語をサポートしていない、または言語を表示するのに必要なフォントを備えていないということが原因です。

これを確認するには、作成されたPDFをGoogleドキュメントにインポートしてみて下さい。もしアジア言語の文字が表示されれば、上記の原因で間違いないということです。

この問題を解決するには、次のような方法があります。

= Windowsの場合 =
以下のバージョンのWindowsにのみ使用できる方法です。
*Windows Vista Integral
*Windows Vista エンタープライズ
Windows Updateを起動し、中国語パックを選択

*Windows XP Pro
http://windows.microsoft.com/en-US/windows/downloads/languages-xp　から中国語パックをインストールする

その後、Windowsセットアップで希望の言語を選択する必要があります。

= Ubuntu・Linuxの場合 =
{{ToComplete}}

一括インポート

2021-04-11T01:00:54Z

TinyTiger: added interlang links

[[en:Mass_imports]]
[[es:Importaciones]]
[[fr:Imports_de_masse]]
[[zh:批量导入]]


Dolibarrの新規インストール後はデータベースが空になっています。
データを手動で入力する代わりに既にあるデータ（仕入れ先、顧客、製品など）をインポートすることが一般的には必要です。
データのインポートについてはいくつか使用できる方法があります。
次の章ではこの方法について情報を提示します。
データのエクスポートについては[[Module_Exports_En|モジュールによるエクスポート]]のページで解説しています。

= Dolibarrインポートモジュールを使用する =
データのインポートにおいてはDolibarr[[Module_Imports_En|モジュールインポート]]を使用するのがお勧めの方法です。
ウィザードがあり、データのインポートを順を追って案内してくれます。
[[Module_Imports_En|モジュールインポート]]のページで更に多くの情報を閲覧できます。
元々内蔵されているモジュールでは対応できないインポート方法の場合、以下の代替案も使用可能です。

= OpenOfficeを使用する =
OpenOfficeを使用すればMysql Dolibarrのようなデータベースにテーブルのコンテンツを挿入することができます。
この方法についてのチュートリアルはこちら：[[Import data with OpenOffice]]

= 独自のインポートスクリプトの開発 =
{{ToComplete}}

Mass imports - Migrate my Data To Dolibarr

2021-04-10T09:09:42Z

TinyTiger: added interlang links (JA)

[[fr:Imports_de_masse]]
[[es:Importaciones]]
[[zh:批量导入]]
[[ja:一括インポート]]


[[Category:Admin_en]]
[[Category:ImportsEn]]
{{TemplateDocDevEn}}

Following a new installation of Dolibarr, the database is empty. It is a common requirement to import existing data (suppliers, customers, products etc.) instead of entering the data manually.
There are several possible methods of importing data. The following chapters provide information about this.
Information about exporting data is described on the page [[Module Exports En|Module Exports]].

= [[File:Art.png]] Using the Dolibarr Import Module=
The recommended method for importing data is to use the Dolibarr [[Module Imports En|Module Imports]]. You will find a wizard that will guide you step by step in importing your data. You'll find more information on the page [[Module Imports En|Module Imports]].

For import scenarios not covered by the built-in module, the following alternatives are also possible.

= [[File:OpenOffice.png]] Using OpenOffice =
You can use OpenOffice, which is able to insert the contents of a table into a database such as Mysql Dolibarr. Here is a tutorial on this method: [[Import data with OpenOffice]]

= [[File:Outils.png]] Developing your own import script =

== Import third parties and contacts ==
We must differentiate a third party from a physical contact (person).
The third party information contains all the details pertaining to billing (whether companies, private individuals or associations).
Third party details are compulsory whereas physical contact details are optional.
Contacts are just a directory of physical persons/addresses related to the third party.
In the case of a third party that is a company, there may be several additional physical contacts.
In the case of an individual, there will be only one physical contact which would be identical to the third party.

The import of the third parties inserts rows in the table [[Table llx_societe]]. Ensure that the mandatory fields contain data.

* Name: Must contain the name of the company
* Client: Must contain 1 if third party is a client, 2 if prospect, 0 otherwise.
* Supplier: Must contain 1 if its a supplier, 0 otherwise

The import of physical contacts inserts rows in the table [[Table llx_socpeople]]. Ensure that the mandatory fields contain data.

* Name: Must contain the surname of the contact
* Firstname: Must contain the first name of the contact
* fk_soc: Must contain the id of the third party from table [[Table llx_societe]].

== Import invoices ==
To complete...

== Import products ==
To complete...

== Put into practice ==
Page [[Script development]] explains how to create your own Dolibarr script.

== Some tutorials / examples submitted by the community ==
Some scripts examples are available into Dolibarr snapshot distribution in directory '''/dev/examples'''.

Other examples are provided by contributors:
* [[Importing customers automatically]]
* ...

ホームページ

2021-04-10T08:54:31Z

TinyTiger: retranslate into more natural Japanese

[[en:Home]]
[[fr:Accueil]]
[[es:Portada]]
[[de:Hauptseite]]
[[el:Αρχική]]
[[pt:Página Principal]]
[[zh:简体中文官方文档]]

{{DISPLAYTITLE:Easy to use Open-Source software for business}}
<center>
[[File:Dolibarr logo.png|180px|link=]]

'''Be free to manage your company, freelancer or foundation activity'''
</center>

このWikiには、Dolibarr ERP/CRMに関するすべてのドキュメント（ユーザー向け、開発者向け、翻訳者向けのドキュメント）とリソースが含まれています。ダウンロードは、Dolibarrプロジェクトのウェブポータル（https://www.dolibarr.org）から可能です。

{{Info}}{{InfoJa}}

=[[File:art.png|link=]] Dolibarrプロジェクト=

*[[JA_What_Dolibarr_Does|Dolibarrとは？]] - [[JA_FAQ_Who_uses_Dolibarr|Dolibarrのユーザは誰?]]
*[[Dolibarr Project|資料、経緯、プロジェクト組織]]
*[[Dolibarr foundation|Dolibarr 基金]]
*[https://www.dolibarr.org/onlinedemo オンラインデモ]
*[https://www.dolibarr.org/downloads/ ダウンロード]

=[[File:File_Doc_user.png|link=]] 利用者文書=

*[[User_documentation_JA|利用者手引き]]
*[[User FAQ|利用者FAQ]]
*[[Screenshots|スクリーンショット]]
*[[Dolibarr help and support|ヘルプとサポートセンター]] (コミュニティフォーラム、有償サポート等)
*[https://courses.dolibarr.org Doribarrアカデミー] (the platform to learn Dolibarr)
*[[Security informations|セキュリティ情報]]

=[[File:File_Doc_dev.png|link=]] 開発者文書=

*[[JA Developer documentation|開発者手引き]]
*[[JA Developer FAQ|開発者FAQ]]
*[[JA Dolibarr Project|資料、経緯、プロジェクト組織]]

=[[File:File_Doc_trans.png|link=]] 翻訳者文書=

*[[Translator documentation|翻訳者手引き]]

=[[File:File_Doc_tester.png|link=]] テスター文書=

*[[JA Tester documentation|テスター手引き]]

Mass imports - Migrate my Data To Dolibarr

2021-04-10T08:31:12Z

TinyTiger: Undo revision 50341 by TinyTiger (talk)

[[fr:Imports_de_masse]]
[[es:Importaciones]]
[[zh:批量导入]]


[[Category:Admin_en]]
[[Category:ImportsEn]]
{{TemplateDocDevEn}}

Following a new installation of Dolibarr, the database is empty. It is a common requirement to import existing data (suppliers, customers, products etc.) instead of entering the data manually.
There are several possible methods of importing data. The following chapters provide information about this.
Information about exporting data is described on the page [[Module Exports En|Module Exports]].

= [[File:Art.png]] Using the Dolibarr Import Module=
The recommended method for importing data is to use the Dolibarr [[Module Imports En|Module Imports]]. You will find a wizard that will guide you step by step in importing your data. You'll find more information on the page [[Module Imports En|Module Imports]].

For import scenarios not covered by the built-in module, the following alternatives are also possible.

= [[File:OpenOffice.png]] Using OpenOffice =
You can use OpenOffice, which is able to insert the contents of a table into a database such as Mysql Dolibarr. Here is a tutorial on this method: [[Import data with OpenOffice]]

= [[File:Outils.png]] Developing your own import script =

== Import third parties and contacts ==
We must differentiate a third party from a physical contact (person).
The third party information contains all the details pertaining to billing (whether companies, private individuals or associations).
Third party details are compulsory whereas physical contact details are optional.
Contacts are just a directory of physical persons/addresses related to the third party.
In the case of a third party that is a company, there may be several additional physical contacts.
In the case of an individual, there will be only one physical contact which would be identical to the third party.

The import of the third parties inserts rows in the table [[Table llx_societe]]. Ensure that the mandatory fields contain data.

* Name: Must contain the name of the company
* Client: Must contain 1 if third party is a client, 2 if prospect, 0 otherwise.
* Supplier: Must contain 1 if its a supplier, 0 otherwise

The import of physical contacts inserts rows in the table [[Table llx_socpeople]]. Ensure that the mandatory fields contain data.

* Name: Must contain the surname of the contact
* Firstname: Must contain the first name of the contact
* fk_soc: Must contain the id of the third party from table [[Table llx_societe]].

== Import invoices ==
To complete...

== Import products ==
To complete...

== Put into practice ==
Page [[Script development]] explains how to create your own Dolibarr script.

== Some tutorials / examples submitted by the community ==
Some scripts examples are available into Dolibarr snapshot distribution in directory '''/dev/examples'''.

Other examples are provided by contributors:
* [[Importing customers automatically]]
* ...

Mass imports - Migrate my Data To Dolibarr

2021-04-10T08:22:52Z

TinyTiger: added interlang links (JP)

[[fr:Imports_de_masse]]
[[es:Importaciones]]
[[zh:批量导入]]
[[jp:一括インポート]]


[[Category:Admin_en]]
[[Category:ImportsEn]]
{{TemplateDocDevEn}}

Following a new installation of Dolibarr, the database is empty. It is a common requirement to import existing data (suppliers, customers, products etc.) instead of entering the data manually.
There are several possible methods of importing data. The following chapters provide information about this.
Information about exporting data is described on the page [[Module Exports En|Module Exports]].

= [[File:Art.png]] Using the Dolibarr Import Module=
The recommended method for importing data is to use the Dolibarr [[Module Imports En|Module Imports]]. You will find a wizard that will guide you step by step in importing your data. You'll find more information on the page [[Module Imports En|Module Imports]].

For import scenarios not covered by the built-in module, the following alternatives are also possible.

= [[File:OpenOffice.png]] Using OpenOffice =
You can use OpenOffice, which is able to insert the contents of a table into a database such as Mysql Dolibarr. Here is a tutorial on this method: [[Import data with OpenOffice]]

= [[File:Outils.png]] Developing your own import script =

== Import third parties and contacts ==
We must differentiate a third party from a physical contact (person).
The third party information contains all the details pertaining to billing (whether companies, private individuals or associations).
Third party details are compulsory whereas physical contact details are optional.
Contacts are just a directory of physical persons/addresses related to the third party.
In the case of a third party that is a company, there may be several additional physical contacts.
In the case of an individual, there will be only one physical contact which would be identical to the third party.

The import of the third parties inserts rows in the table [[Table llx_societe]]. Ensure that the mandatory fields contain data.

* Name: Must contain the name of the company
* Client: Must contain 1 if third party is a client, 2 if prospect, 0 otherwise.
* Supplier: Must contain 1 if its a supplier, 0 otherwise

The import of physical contacts inserts rows in the table [[Table llx_socpeople]]. Ensure that the mandatory fields contain data.

* Name: Must contain the surname of the contact
* Firstname: Must contain the first name of the contact
* fk_soc: Must contain the id of the third party from table [[Table llx_societe]].

== Import invoices ==
To complete...

== Import products ==
To complete...

== Put into practice ==
Page [[Script development]] explains how to create your own Dolibarr script.

== Some tutorials / examples submitted by the community ==
Some scripts examples are available into Dolibarr snapshot distribution in directory '''/dev/examples'''.

Other examples are provided by contributors:
* [[Importing customers automatically]]
* ...

一括インポート

2021-04-10T08:18:37Z

TinyTiger: Pertially translated from English page

Dolibarrの新規インストール後はデータベースが空になっています。
データを手動で入力する代わりに既にあるデータ（仕入れ先、顧客、製品など）をインポートすることが一般的には必要です。
データのインポートについてはいくつか使用できる方法があります。
次の章ではこの方法について情報を提示します。
データのエクスポートについては[[Module_Exports_En|モジュールによるエクスポート]]のページで解説しています。

= Dolibarrインポートモジュールを使用する =
データのインポートにおいてはDolibarr[[Module_Imports_En|モジュールインポート]]を使用するのがお勧めの方法です。
ウィザードがあり、データのインポートを順を追って案内してくれます。
[[Module_Imports_En|モジュールインポート]]のページで更に多くの情報を閲覧できます。
元々内蔵されているモジュールでは対応できないインポート方法の場合、以下の代替案も使用可能です。

= OpenOfficeを使用する =
OpenOfficeを使用すればMysql Dolibarrのようなデータベースにテーブルのコンテンツを挿入することができます。
この方法についてのチュートリアルはこちら：[[Import data with OpenOffice]]

= 独自のインポートスクリプトの開発 =
{{ToComplete}}

Template:ToComplete

2021-04-10T08:05:00Z

TinyTiger: added Japanese

[[Category:Page waiting to complete]]

<table cellspacing="0" cellpadding="2" style="border: 1px solid #AAAAAA; background: #DCCC66;"><tr><td>
{{flag_en}} Page waiting to complete. To complete, create an account, go back and clic on "Modify".<br>
{{flag_fr}} Page en attente d'être complété. Pour compléter, créez un compte, revenez et cliquez sur "Modifier".<br>
{{flag_sp}} Página a completar. Para completarla, cree una cuenta, vuelva a la página y haga clic en "editar"<br>
{{flag_de}} Seite wartet auf Vervollständigung. Um zu helfen, erstelle ein Konto, gehe zurück und klicke auf "Bearbeiten".<br>
{{flag_cn}} 待完成，欲帮助完成，注册帐号，点击“编辑"<br>
{{flag_jp}} ページは未完成の状態です。完成させるにはアカウントを作成し、ページに戻って「編集」をクリックして下さい。<br>
</td></tr></table>

Translator documentation

2021-04-07T06:58:52Z

TinyTiger: restore Korean to English

[[fr:Documentation_traducteur]]
[[es:Documentación_traductores]]
[[de:Dokumentation_Uebersetzung]]
[[zh:翻译文档]]


<seo metak="translation, documentation, translator, localize, localization, i18n, l18n, internationalization, language" />

=[[File:Language.png]] Translate Dolibarr Application into your language=

Dolibarr language files are already translated in several languages.
English is the default and always complete. Other languages depend on contributions. This tutorial can help you complete a translation for a language not yet available or somehow incorrect.
Dolibarr can be translated by three different means:

#Manually using Transifex (Official and recommended method).
#Manually editing language files
#Completely automatic: autotranslator

==Manual Translation using Transifex online service (recommended)==

Transifex is a web application that provides an online platform for translation projects. It includes teams and discussion tools, translation memory, glossary, proofreading and a lot of other features.
It is quite easy to use and all translations can be uploaded and downloaded through the web interface or using their TX client from a terminal.
Transifex is an open source project and the "community edition" can be freely downloaded and installed, but we will use the online hosted service.

===Using the web interface (for translators)===
If you want to help to translate Dolibarr in your own language, check the project's page at https://www.transifex.com/dolibarr-association/dolibarr/

You can then register an account and request joining the project team for the language(s) you're targeting. A manager will have to accept your request, so please be patient.

Once accepted, you can start translating right away.

For more information, please check Transifex "Getting Started" introduction at http://docs.transifex.com/introduction/translators/ and the web editor tutorial at http://docs.transifex.com/tutorials/txeditor/

''' Note about en_US '''

The web interface can not be used to translate the en_US language which is source.

Any change for en_US language must be done in Dolibarr source code and submitted using a Pull Request on our GitHub repository.

===Using TX command line client (for Dolibarr [[:Category:Yoda]] team)===
This describes how to use Transifex from the command line. However, this is reserved to Dolibarr admin users to synchronize Transifex with Dolibarr main sources.

More information can also be found on the [http://docs.transifex.com/developer/client/ Transifex Official documentation]

====TX Client configuration====
First install TX Client.
With Debian/Ubuntu/Mint:
<syntaxhighlight lang="bash">
apt-get install python-pip
pip install transifex-client
</syntaxhighlight>
Then you have to initialize your TX environment. This is done by running '''tx init''' into dolibarr project root directory.
<syntaxhighlight lang="bash">
cd git/dolibarr
tx init
</syntaxhighlight>
Accept to overwrite config file. Keep default value for Transifex instance, then enter your Transifex login and password.

After this, a .transifexrc has been created into your HOME dir and a generic config file has been created as '''.tx/config''' in project's root.
So your directory's contents will look like that:
<code><pre>
.
|-- build
|-- build.xml
|-- ChangeLog
|-- COPYING
|-- COPYRIGHT
|-- dev
|-- doc
|-- .gitignore
|-- htdocs
|-- INSTALL
|-- pom.xml
|-- quickbuild.xml
|-- README
|-- README-FR
|-- README.md
|-- robots.txt
|-- scripts
|-- test
`-- .tx
</pre></code>

The current config file can be downloaded from https://github.com/Dolibarr/dolibarr/tree/develop/.tx , put it into .tx directory, overwriting the one created by '''tx init'''

This project configuration file is used to store the project’s details and the file-to-resource mappings.

That is a sample of what the config file contains:

<syntaxhighlight lang="ini">
[main]
host = https://www.transifex.com
lang_map = uz: uz_UZ

[dolibarr.admin]
file_filter = htdocs/langs/<lang>/admin.lang
source_file = htdocs/langs/en_US/admin.lang
source_lang = en_US
type = MOZILLAPROPERTIES
</syntaxhighlight>

Here is an explanation of the sections and options used in the config file:

<nowiki>[main] section</nowiki>

In this section, we have project-wide options, such as the default transifex host for all projects. These can be overridden by each resource, in case it is needed.

<nowiki>[dolibarr.resource]</nowiki>

source_lang: this is the source language of the resource.<br />
source_file: this points to the source file directly.<br />
file_filter: here we hold the expression used to identify translation files under the specific project. ''not mandatory''<br />
trans.<lang>: this is used for translation files that don’t follow a common naming schema and the file expression cannot be used to track them. ''not mandatory''<br />
host: in case the project doesn’t use the default Transifex server as specified in the [main] section, it can override it using this option. ''not mandatory''<br />

====TX Client use====
Some useful information on '''tx''' commands.

'''tx status'''

Show status of translations

'''tx push'''

Used to push changes from your computer to Transifex server<br>
Additional options for the tx push command are:
<code><pre>
-h - Shows the help screen for the command
-l <lang> - Specify which translations you want to push (defaults to all)
-r <resource> - Specify the resource for which you want to push the translations (defaults to all)
-f - Push source files without checking modification times
--skip - Don't stop on errors. Useful when pushing many files concurrently.
-s - Push the source file to the server
-t - Push the translation files to the server
--no-interactive - Don't require user input when forcing a push</pre></code>

'''tx pull'''

Used to pull changes from Transifex server to your computer<br />
Additional options for the tx pull command are:
<code><pre>
-h - Shows the help screen for the command
-l <lang> - Specify which translations you want to pull (defaults to all)
-r <resource> - Specify the resource for which you want to pull the translations (defaults to all)
-a - Fetch all translation files from the server (even new ones)
-s - Force the fetching of the source file (default: False)
-f - Force download of translations files
--skip - Don't stop on errors. Useful when pushing many files concurrently.
--disable-overwrite - By default Transifex will fetch new translations files and replace existing ones. Use this flag if you want to disable this feature.
--minimum_perc=VALUE - Specify the minimum acceptable percentage of a translation in order to download it.</pre></code>

'''Examples'''

To pull translation files, you can use:

<syntaxhighlight lang="bash">
tx -d pull -l it_IT # Get italian language only
tx -d pull -a # Get all languages
</syntaxhighlight>

To push source files, just type:

<syntaxhighlight lang="bash">
tx -d push -t -l it_IT [-r dolibarr.file] # To push only a specific translation file
tx -d push -s # To push source file
</syntaxhighlight>

===Other questions on transifex process===
This is short questions and answers you may also ask about transifex translation process:

1) Is the sync on a regular time interval?

No. It is done where there is enough translation submitted. It is also done on a beta branch just before creating the final release package.

2) Are all the translations synced to git or only the reviewed translations? Do I need to review before sync is done?

When a Sync is done, transifex files overwrites files into git, but only if there is at least on record modified for the file.
You don't have to make a review before sync is done. Making review is above all to know which lines were manually reviewed and which one was initially translated using a robot.

3) In which Dolibarr releases will translations be available? Are transifex translations also synced to maintenance releases?

Sync is always done on develop and/or beta.
So transifex changes appear in all version whose branch is created after the transifex change (a sync is always done before creating a new branch). Once a branch is created, the new changes into transifex will be available only for the next branch. The reason for this is that we do not manage branch/versions on transifex (not yet).

==Manual Translation (not recommended)==

To translate Dolibarr into another language, go to the langs directory and create a folder/directory named with the code language to translate (follow the existing format, for example en_US, en_GB, es_ES, de_DE, etc...). Then copy the files from an existing language directory (for example en_US/main.lang, en_GB/bills.lang), into the new language directory that you have just created.

These files have the format of key/value pairs in each line like the followings:

<syntaxhighlight lang="ini">
Code1 = translate phrase 1
Code2 = translate phrase 2
...
Coden = translate phrase n
</syntaxhighlight>

Translate the phrases (the value portion of the key/value pairs) on the right side of the "=" as seen above, the code (the key portion) on the left side of "=" should remain unchanged. It is possible to translate the files one by one, without bringing them all at once. If a file has not been translated into the new language, Dolibarr uses English.

To have a localised (translated) string into the PHP code, all you have to do is load the language file and use the method to get the translated value, like this:

<syntaxhighlight lang="PHP">
$langs->load("myfile"); // or use $langs->load("myfile@mymodule") if myfile.lang is inside directory htdocs/mymodule/langs/xx_XX

print $langs->trans("CodeX")
</syntaxhighlight>

An entry type;

<syntaxhighlight lang="ini">
CodeX = phrase X
</syntaxhighlight>

must be present or added to the myfile.lang file.

==Automatic Translation with autotranslator.php tool==

*Translator OS: All
*Tool: '''autotranslator.php''' provided with Dolibarr in directory '''dev/translation'''.

This method is recommended when starting translation for a language not already initialized. If there is already a translation available but you need to add a missing key or correct errors, try to use method using Transifex (see later).

To make or update all files of a language code, just run the script:
<syntaxhighlight lang="bash">
php autotranslator.php lang_code_source lang_code_target GOOGLEAPIKEY
</syntaxhighlight>
For example :
<syntaxhighlight lang="bash">
php autotranslator.php en_US pt_PT GOOGLEAPIKEY
</syntaxhighlight>
to translate into Portuguese (pt_PT) using English (en_US) files.

All nonexisting files will be created, all existing files will be updated.
The tool use [http://translate.google.com Google translation] service to find the translation value of a string, so a working Internet connection is required from station running the script. Also, a GOOGLEAPIKEY is required and Google charges a fee for using this service (20 euros / 1 000 000 of translated chars).
Your PHP must also have permissions to write into '''htdocs/langs''' directory and must have curl functions available.

=[[File:Language.png]] Distribute or include your translation into core source=

Once you start translating, it's a smart decision to share it, so it can be included in the official code of Dolibarr.
If you keep it for you, others will not be able to improve it when new terms are added or previous terms are modified, and you will still have to manage the translation on your own.

If you translated through the Transifex system, there's nothing to be done. Your translation will be included in the next version of Dolibarr. No additional work! In technical terms, the translation will be exported from Transifex and imported into Dolibarr by our developers, at least once every month.

If, however, you translated directly in Dolibarr files, then you will first have to transfer those translations to Transifex before they can be included. So, really, you should start translating into Transifex.
If you send us your translation through a Pull Request on Github, sadly, it will be overwritten by the next import from Transifex, so it would be very short-lived.

Note:

The reference language is en_US and is always complete. You can find it in the htdocs/langs/en_US/ folder. All other language files are likely to be slightly or highly incomplete, depending on the language.

If you are developing a new module, you are likely going to need the addition of new language variables. This is done exclusively through the update of the en_US language (htdocs/langs/en_US/ folder). Just modify these files to add the variable you need and send the resulting folder as part of your Pull Request. Refer to the developer documentation to learn how to contribute code (you will need an account on {{TemplateUrlSCM}}.

=[[File:Language.png]] Translate documentation on wiki=
The wiki is written in 3 languages: English, French, and Spanish.
If you want to enhance documentation on one of these languages, all you have to do is to create an account on this wiki.
Then, you can edit existing pages to correct a bad translation or translate pages waiting for translation [[:Category:Page_waiting_for_translation]].

<br />

===How to translate an existing page ?===

====Create a new page for the translated version.====
Start by creating a new page for the translated version. To do this, you can access an non existant URL : for example [[Translator documentation|<code>https://wiki.dolibarr.org/index.php/Ma_nouvelle_page_en_français</code>]]

The chosen title for the translated version of the page should be the translation of the title of the original English page.