Cloud Storage Solutions v.19

同期を正しく動かすには、Odoo 設定ファイルに適切な timeout を設定してください。LIMIT_TIME_CPU、LIMIT_TIME_REAL、LIMIT_TIME_REAL_CRON は 900 秒より大きくしてください。

Odoo.sh ではタイムアウトが事前定義され設定できないため、これは行わないでください。

アプリが前提とするcronジョブの頻度も変更しないでください。「[Cloud Storage] Prepare Cloud Folders」「[Cloud Storage] Run / Prepare sync queue」。これらのジョブは15分ごとに実行するよう設定され、その頻度は中断やデータ損失を避けるアルゴリズムで使われます。しばらく同期を止めたい場合は、特定のcloud clientを一時停止してください。

ツールは外部ライブラリ 'sortedcontainers' に依存します。Odoo サーバーへ次のコマンドでインストールしてください:

Python 依存関係

ツールは外部ライブラリ 'microsoftgraph' に依存します。Odoo サーバーへ次のコマンドでインストールしてください:

設定とログイン

1. オプション 'OneDrive / SharePoint Sync' をオンにします (cloud Storage > Configuration > Configuration)。オプションのアドオン OneDrive / SharePoint Odoo Integration が必要です
2. Odoo に接続したい OneDrive / SharePoint に対し、Microsoft ユーザーに完全な管理者権限があることを確認してください。このユーザーは権限付与だけに必要で、ユーザーデータは Odoo に保持されず、その後も使われることはありません。また、使用する Microsoft メールアドレスにリダイレクトがないことも確認してください（ドメイン名を設定しても、主アドレスが @outlook.com、@office365 などの Microsoft ドメインのまま、という場合によく起きます）。
3. Azure Portal へ: https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
4. 「New registration」をクリック
5. Introduce a new name for the application and assign the redirect URI as [YOURODOOSITENAME]/one_drive_token (e.g. https://odootools.com/one_drive_token). As the supported account types choose 'Accounts in any organizational directory (Any Azure ID directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)'.
6. Certificates & secrets に進み、'New Client Secret' をクリックします。secret の値をどこかに保存してください
7. Odoo Cloud Storage > 設定 > Cloud Clients に進み「Create」を押します
   • 参照には全ユーザーに分かる名前を入力
   • Cloud client として、使用中のソフトウェアに応じて 'OneDrive' または 'SharePoint' を選択します
   • Root folder 名には、同期フォルダ全体の親 OneDrive directory になるタイトルを入力します。例: 'Odoo' または 'OdooERP'
   • 「Application Client ID」を「App client ID」にコピー
   • シークレット値を「App client secret」フィールドにコピー
   • 以前生成したリダイレクト URL を挿入
   • SharePoint を使う場合:
     • SharePoint サイトに進み、新しいドキュメントライブラリ（ドライブ）を用意します。既存のもの、例: 'Documents' でも構いません。Odoo フォルダはその後そこに置かれ、別のライブラリへ移すことはできません
     • SharePoint の URL は https://[URL]/ 形式です。末尾の「/」は必須で、サイト名は含めません。例: https://odootools.sharepoint.com/
     • SharePoint サイトは root（最上位の SharePoint サイト）、my_site_name（その場合は sites/my_site_name とみなされる）、または sites/my_site_name（「sites」の代わりに「teams」など）のいずれかです。先頭と末尾に「/」を付けないでください。例: sites/odootools
     • Documents Library は SharePoint で作成したものを使用
8. 'Confirm' を押します。Odoo が Microsoft のログインページへリダイレクトします。システムで確認し、すべての条件に同意し、求められた権限をすべて付与してください
9. ログイン後、OneDrive は Odoo に戻します。OneDrive - Odoo 同期の準備ができました
10. 新しく作成した cloud client を、その OneDrive または SharePoint インスタンス と同期するフォルダルールおよび/または手動フォルダに適用します
11. 同期のスケジュールジョブが開始されるのを待ちます。テスト専用: Cloud Storage > 設定 > 設定 > ボタン「Launch sync」から統合を手動で起動します。

あわせて見る 設定ビデオ

1. オプション 'Google Drive Sync' をオンにします (cloud Storage > Configuration > Configuration)。オプションのアドオン Google Drive Odoo Integration が必要です
2. URL から Google Cloud Console へ https://console.cloud.google.com
3. プロジェクトを選択または作成
4. プロジェクトを選ぶと、コンソールが Google Auth Platform を開きます。'Get Started' を押します
5. アプリ情報を追加
   • アプリ名には適当なものを選択
   • ユーザーサポートメールには自分のアドレスを選択
   • 'Next' を押します
6. オーディエンスは 'External' を選び 'Next' を押します。注: このアプリは自社の Odoo 接続にだけ使います
7. 連絡先として Google または Google Workspace のメールアドレスを入力し、'Next' を押します
8. Google API Services User Data Policy に同意し、'Continue' を押してから 'Create' を押します
9. 「Clients」に進み、「Create client」を押します
   • アプリケーションの種類として「Web application」を選択
   • 名前には適当なものを選択
   • 承認済みリダイレクト URI として、[YOURODOOSITENAME]/google_drive_token 形式のリンクを追加します（例: https://odootools.com/google_drive_token）。
   • 'Create' を押します
   • 「Client ID」と「Client secret」をコピーして安全に保管してください。Client secret は一度しか表示されません
10. このプロジェクトで Google Drive API を有効にします。上部の検索ボックスに 'Google Drive API' と入力し、見つかった製品を開いて 'Enable' を押します
11. 「Audience」に進み、メールアドレスをテストユーザーとして追加
12. アプリを公開してください。しないとテスト状態のままで、トークンは 7 日ごとに期限切れになります
    • 'Branding' を開き、アプリケーションのホームページとプライバシーポリシーのリンク（例: Odoo ウェブサイトへのリンク）を入力します。それらのリンクのドメインを authorized domains に追加します
    • 「Audience」を開き、「Publish app」を押します
    • アプリのロゴをアップロードしないでください。実際には不要な、長く複雑な Google 確認プロセスが始まります
13. Odoo Cloud Storage > 設定 > Cloud Clients に進み「Create」を押します
    • 参照には全ユーザーに分かる名前を入力
    • Cloud クライアントとして「Google Drive」を選択
    • Root folder 名には、同期フォルダ全体の親 Google Drive directory になるタイトルを入力します。例: 'Odoo' または 'OdooERP'
    • 手順9の「Client ID」を「App client ID」フィールドにコピー
    • 手順9の「Client secret」を「App client secret」フィールドにコピー
    • 手順 9 で入力したリダイレクト URL を挿入
    • チームドライブを使う場合は関連ボックスをオンにします。本当にチームドライブを使っていることを確認してください。Google Drive の左サイドバーに項目 'Team Drives' があるはずです。この機能はビジネスおよび enterprise 料金でのみ利用できます
    • オプション 'Team Drive' が有効なら、その名前を入力します。Google Drive で見えるものと完全に同じである必要があります。ユーザーがすべての Google ドライブに対する完全な権限を持つことを確認してください（通常はチーム Google Drive を設定する同一ユーザーです）。
14. 'Confirm' を押します。Odoo が Google ログインページへリダイレクトします。システムで確認し、すべての条件に同意し、求められた権限をすべて付与してください
15. ログイン後、Google は Odoo に戻します。Google Drive - Odoo 同期の準備ができました
16. 新しく作成した cloud client を、その Google Drive と同期するフォルダルールおよび/または手動フォルダに適用します
17. 同期のスケジュールジョブが開始されるのを待ちます。テスト専用: Cloud Storage > 設定 > 設定 > ボタン「Launch sync」から統合を手動で起動します。

あわせて見る 設定ビデオ、注意: 動画の Google console 部分は古くなっています。上記の手順に従ってください

1. オプション 'Amazon S3 Sync' をオンにします（Cloud Storage > 設定 > 設定）。オプションアドオン Amazon S3 Odoo Integration が必要です
2. Amazon S3コンソールを開きます: https://console.aws.amazon.com/s3/
3. 新しいバケットを作成するか、既存のものを選びます。正確なバケット名をコピーし、Odoo の項目「Bucket」に入れてください
4. バケットの詳細を開き、AWS Region をコピーします。Odoo の項目 'Region' に入れます（例: eu-west-1 または us-east-1）
5. AWS IAMコンソールを開きます: https://console.aws.amazon.com/iam/
6. 新しい IAM ユーザーを作成するか、既存の技術ユーザーを選びます。このユーザーは選択したバケット内のオブジェクトを一覧、読取、作成、書込、コピー、削除する全権限を持つ必要があります。全権限の管理者を選ぶか、新しいポリシーを作成できます（下記参照）
7. IAM ユーザーフォームでタブ 'Security credentials' を開き、'Create access key' を押します
8. ページ 'Access key best practices & alternatives' で Application running outside AWS を選びます。Odoo サーバーが AWS 外、Odoo.sh、自前サーバー、または他ホストからアクセスキーで S3 に接続する場合の正しい選択肢です。Odoo が AWS EC2 インスタンス上なら Application running on an AWS compute service を選べますが、Odoo にコピーされる項目は同じです
9. 'Next' を押します。次の手順で任意で Odoo S3 Sync などの説明タグを入力し、'Create access key' を押します
10. 最後の AWS ページで Access key または Access key ID を Odoo の項目 'Access Key' にコピーします
11. Secret access key を Odoo の項目「Secret Key」にコピーします。重要: AWS はシークレットキーを一度しか表示しないため、ウィンドウを閉じる前に保存してください
12. AWS S3 ではなく S3 互換プロバイダを使う場合、その管理画面からエンドポイント URL をコピーし、Odoo の 'Amazon S3 endpoint URL' に入れます。例: MinIO はよく https://minio.example.com や http://localhost:9000、LocalStack は通常 http://localhost:4566
13. Odoo Cloud Storage > Configuration > Cloud Clients に進み、'Create' を押します
14. 参照には、全ユーザーに分かる名前を入力してください
15. Cloud クライアントとして「Amazon S3」を選択
16. Root folder 名には、同期フォルダ全体の親 S3 prefix になるタイトルを入力します。例: 'Odoo' または 'OdooERP'
17. 項目 'Bucket'、'Region'、'Access Key'、'Secret Key' を入力し、必要なら 'Amazon S3 endpoint URL' とアドレッシングスタイルも指定します
18. Odoo が一時的な presigned URL と公開バケット/CDN URL のどちらを使うかを選びます。非公開バケットでは presigned URL を有効のまま、有効期間を秒で設定します
19. 'Confirm' を押します。Odoo が bucket アクセスを確認し、ルートフォルダ接頭辞を作成または検証します。Amazon S3 - Odoo 同期の準備ができました
20. 新しく作成した cloud client を、その Amazon S3 バケット と同期するフォルダルールおよび/または手動フォルダに適用します
21. 同期のスケジュールジョブが開始されるのを待ちます。テスト専用: Cloud Storage > 設定 > 設定 > ボタン「Launch sync」から統合を手動で起動します。

役立つAWSドキュメント: S3バケットの作成: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html、IAM アクセスキーの管理: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

バケットポリシーの例

設定とログイン

1. オプション 'onwCloud / Nextcloud Sync' をオンにします (cloud Storage > Configuration > Configuration)。オプションのアドオン ownCloud / Nextcloud Odoo Integration が必要です
2. Odoo Cloud Storage > 設定 > Cloud Clients に進み「Create」を押します
3. 参照には全ユーザーに分かる名前を入力
4. Cloud client として、使用中のソフトウェアに応じて 'Nextcloud' または 'ownCloud' を選択します
5. Root folder 名には、同期フォルダ全体の親 directory になるタイトルを入力します。例: 'Odoo' または 'OdooERP'
6. ownCloud / Nextcloud の完全な URL を入力
7. ルートディレクトリ内のファイルとフォルダを読み取り・作成・書き込み・削除する完全な権限を持つ ownCloud / Nextcloud ユーザーを選びます
8. このユーザーのログインとパスワードを「ログイン」と「パスワード」フィールドに入力
9. 公開 URL と内部 URL のどちらを適用するか選びます（下記参照）
10. '確認' を押します。Odoo 同期の準備ができました
11. 新しく作成した cloud client を、その Nextcloud または ownCloud インスタンス と同期するフォルダルールおよび/または手動フォルダに適用します
12. 同期のスケジュールジョブが開始されるのを待ちます。テスト専用: Cloud Storage > 設定 > 設定 > ボタン「Launch sync」から統合を手動で起動します。

内部および公開 URL

既定ではOdooからownCloud / Nextcloudへのリンクは内部用で、許可されたユーザーのみアクセスできます。任意でリンクを公開できます（設定「Use Public URLs」）。するとURLは「共有」され、誰でも直接リンクで項目にアクセスします。

共有（公開）URLを使う場合は注意してください。外部ユーザーにリンクが知られることは稀でも、一部のユーザー操作の結果として利用可能になるわずかな可能性があります。また、共有リンクの生成は速くなく、同期が遅くなることがあります。

あわせて見る 設定ビデオ

1. オプション 'NAS Sync' をオンにします (Cloud Storage > Configuration > Configuration)。オプションのアドオン NAS Odoo Integration が必要です
2. NAS の WebDAV エンドポイントを準備します:
   • Synology: DSM で WebDAV Server をインストールして有効にし、可能な場合は HTTPS を選びます
   • QNAP: 対象の共有フォルダで WebDAV を有効にし、可能な限り HTTPS を使います
   • TrueNAS CORE: WebDAV サービスを有効にします。TrueNAS SCALE: 新しい SCALE ではネイティブ WebDAV が削除されたため、WebDAV アプリをインストールして設定します
   • 汎用 WebDAV: PROPFIND、MKCOL、PUT、GET、MOVE、DELETE が利用できることを確認してください
3. Odoo がローカル NAS ネットワーク外でホストされている場合は、WebDAV エンドポイントを安全に到達可能にしてください。有効な TLS 証明書付きリバースプロキシ、WireGuard・Tailscale・Cloudflare Tunnel などの VPN/セキュアトンネル、または Synology QuickConnect・QNAP myQNAPcloud などのベンダーリレーを優先します。管理者画面を Internet に公開しないでください
4. 対象の共有フォルダ内だけに読み取り・作成・書き込み・移動・削除の全権限を持つ専用 NAS ユーザーを作成します。管理者アカウントは使わないでください
5. Odoo Cloud Storage > Configuration > Cloud Clients に進み、'Create' を押します
6. 参照には、全ユーザーに分かる名前を入力してください
7. Cloud クライアントとして「Synology NAS」「QNAP NAS」「TrueNAS」または「WebDAV NAS」を選択
8. Root folder 名には、同期フォルダ全体の親 NAS directory になるタイトルを入力します。例: 'Odoo' または 'OdooERP'
9. 完全な WebDAV URL、ログイン、パスワードを入力します。既存の共有やディレクトリ内に Odoo がルートフォルダを作る場合は、任意でベースパスを指定します
10. 公開 HTTPS エンドポイントでは「Verify SSL」をオンのままにします。自己署名証明書の信頼できる非公開エンドポイントでのみオフにしてください
11. NAS ファイルを生の WebDAV URL ではなくベンダーのファイルステーション URL で開く場合は、任意でブラウザのベース URL を指定します
12. 'Confirm' を押します。Odoo が WebDAV 接続を確認し、ルートディレクトリを作成または検索します。NAS - Odoo 同期の準備ができました
13. 新しく作成した cloud client を、その NAS ストレージ と同期するフォルダルールおよび/または手動フォルダに適用します
14. 同期のスケジュールジョブが開始されるのを待ちます。テスト専用: Cloud Storage > 設定 > 設定 > ボタン「Launch sync」から統合を手動で起動します。

NAS 事前設定

NAS は通常、ローカルネットワーク経由でファイルを公開します。Odoo サーバーがそのネットワーク外にある場合、WebDAV エンドポイントは安全な経路で Odoo から到達できる必要があります。推奨は有効な HTTPS 証明書付きリバースプロキシ、WireGuard、Tailscale、Cloudflare Tunnel などの VPN／セキュアトンネル、または Synology QuickConnect や QNAP myQNAPcloud などのベンダーリレーです。単なるポート転送は可能ですが、最も優先度の低い選択肢として扱うべきです。

共有フォルダ 1 つに対し、読み取り・作成・更新・移動・削除の最小権限だけを持つ専用 NAS ユーザーを使います。 管理者アカウントは避けてください。公開エンドポイントは常に HTTPS と有効な TLS 証明書を使います。コネクタには 信頼できる自己署名証明書向けの "Verify SSL" オプションがありますが、通常は有効のままにしてください。

1. オプション 'Box Sync' をオンにします（cloud Storage > 設定 > 設定）。オプションアドオン Box Odoo Integration が必要です
2. Box開発者アカウントを作成または開き、Box Developer Consoleへ移動: https://app.box.com/developers/console
3. Custom App を作成し、認証方式に OAuth 2.0 (Authorization Code Grant) を選びます
4. Add the redirect URI as [YOURODOOSITENAME]/box_token (e.g. https://faotools.com/box_token). A valid SSL certificate (https) is required
5. アプリにファイルとフォルダの読み書きアクセスを付与します。無関係な権限は割り当てないでください
6. Odoo Cloud Storage > Configuration > Cloud Clients に進み、'Create' を押します
   • 参照には、全ユーザーに分かる名前を入力してください
   • Cloud クライアントとして「Box」を選択
   • Root folder 名には、同期フォルダ全体の親 Box directory になるタイトルを入力します。例: 'Odoo' または 'OdooERP'
   • Box Client IDを「Client ID」フィールドにコピー
   • Box Client Secretを「Client Secret」フィールドにコピー
   • 以前生成したリダイレクト URL を挿入
7. 'Confirm' を押します。Odoo が Box のログインページへリダイレクトします。システムで確認し、すべての条件に同意し、求められた権限をすべて付与してください
8. ログイン後、Box は Odoo に戻します。Box - Odoo 同期の準備ができました
9. 新しく作成した cloud client を、その Box アカウント と同期するフォルダルールおよび/または手動フォルダに適用します
10. 同期のスケジュールジョブが開始されるのを待ちます。テスト専用: Cloud Storage > 設定 > 設定 > ボタン「Launch sync」から統合を手動で起動します。

Python 依存関係

ツールは外部ライブラリ 'dropbox' に依存します。Odoo サーバーへ次のコマンドでインストールしてください:

設定とログイン

1. オプション 'Dropbox Sync' をオンにします（cloud Storage > 設定 > 設定）。オプションアドオン Dropbox Odoo Integration が必要です
2. Dropboxアプリコンソールを開きます: https://www.dropbox.com/developers/apps/create 新しいアプリを作成するには
3. API を「Scoped access」として選択
4. アクセスの種類として「Full Dropbox」を選択
5. アプリに適切な名前を選び、「Create app」ボタンを押します
6. Add the redirect URI as [YOURODOOSITENAME]/dropbox_token (e.g. https://faotools.com/dropbox_token). A valid SSL certificate (https) is required
7. アプリに権限を付与します: 'Account Info (Read)', 'Files and folders Metadata (Write)', 'Files Content (Write)', 'Collaboration (Write)'。チーム DropBox では 'Team Data Members'、'Members (Read)' も割り当てます。他の権限は割り当てないでください。
8. アプリを送信
9. Odoo Cloud Storage > 設定 > Cloud Clients に進み「Create」を押します
   • 参照には全ユーザーに分かる名前を入力
   • Cloud クライアントとして「Dropbox」を選択
   • Root folder 名には、同期フォルダ全体の親 Google Drive directory になるタイトルを入力します。例: 'Odoo' または 'OdooERP'
   • 「App key」を「App key」にコピー
   • 「App Secret」を「App secret」フィールドにコピー
   • 以前生成したリダイレクト URL を挿入
   • Dropbox チームドライブを使う場合
     • 関連ボックスをオン
     • Dropbox ユーザーのメールを設定します。このユーザーフォルダ内に Odoo 関連の項目がすべて作成され、その後に他のユーザーと共有されます。このユーザーの下ですべてのファイルとフォルダが作成・変更・移動・削除されます
10. 'Confirm' を押します。Odoo が Dropbox のログインページへリダイレクトします。システムで確認し、すべての条件に同意し、求められた権限をすべて付与してください
11. ログイン後、Dropbox は Odoo に戻します。Dropbox - Odoo 同期の準備ができました
12. 新しく作成した cloud client を、その Dropbox インスタンス と同期するフォルダルールおよび/または手動フォルダに適用します
13. 同期のスケジュールジョブが開始されるのを待ちます。テスト専用: Cloud Storage > 設定 > 設定 > ボタン「Launch sync」から統合を手動で起動します。

Dropbox URL

Dropbox には既存のファイルとフォルダのリンクを生成する独自の方法があります。内部 URL や非公開 URL という概念はありません。代わりに各 Dropbox 項目はいわゆる共有 URL を受け取れます。共有リンクは公開かチーム限定です。後者は Dropbox business アカウントでのみ使えます。

このツールは共有リンクの仕組みに依拠します。つまり各添付リンクは公開（すべての個人 Dropbox アカウント）かチーム限定（すべてのビジネス Dropbox アカウント）です。

完全に安全とは限らないとされることがあります。サイト URL は外部ユーザーにはほとんど知られませんが、操作の結果として露出するわずかな可能性があります。また共有リンク生成は速くなく、同期を遅くすることがあります。そのため共有 URL をオフにする機能があります。

オンにすると、Odoo 内のすべての Dropbox URL は https://www.dropbox.com/home/Odoo/[PATH] 形式になります。多くの場合こうしたリンクは動きません。Odoo から Dropbox のファイル/フォルダを開く必要があるときは、設定 'No links to Dropbox from Odoo' に注意してください。

あわせて見る 設定ビデオ

1. 稼働中の MinIO サーバーを準備します
2. MinIOコンソールを開く
3. 新しいバケットを作成するか、既存のものを選びます。正確なバケット名をコピーし、Odoo の項目「Bucket」に入れてください
4. Odoo 用のアクセス資格情報を作成します。MinIO では、選択したバケット内のオブジェクトを一覧・読み取り・作成・書き込み・コピー・削除できる access key / secret key の組、またはサービスアカウントを使います
5. MinIO の Access Key を Odoo の項目「Access Key」にコピーします
6. MinIO の Secret Key を Odoo の項目「Secret Key」にコピーします。重要: MinIO が一度しか表示しない場合は、MinIO ページを閉じる前にシークレットを保存してください
7. MinIO S3 API エンドポイント URL を Odoo の項目「Amazon S3 endpoint URL」にコピーします。例: ローカルサーバーは通常 http://localhost:9000、本番サーバーは https://minio.example.com を使うことがあります
8. Odoo Cloud Storage > Configuration > Cloud Clients に進み、'Create' を押します
9. 参照には、全ユーザーに分かる名前を入力してください
10. Cloud クライアントとして「MinIO」を選択
11. Root folder 名には、同期フォルダ全体の親 MinIO object prefix になるタイトルを入力します。例: 'Odoo' または 'OdooERP'
12. 'Bucket'、'Access Key'、'Secret Key'、'Amazon S3 endpoint URL' を入力します。'Region' は MinIO では任意で、空の場合 Odoo は S3 互換署名に us-east-1 を使います
13. アドレス指定スタイルはPath-styleのままにしてください。MinIO エンドポイント、特に MinIO ホストがバケット固有の DNS 名を提供しない場合に推奨されます
14. Odoo が直接の公開 MinIO URL を使うかを選びます。バケット、プレフィックス、リバースプロキシ、CDN が公開読取可能なときだけ「Use Public URLs」を有効にしてください。非公開の MinIO バケットでは無効のままにします
15. 'Confirm' を押します。Odoo が bucket アクセスを確認し、ルートフォルダ接頭辞を作成または検証します。MinIO - Odoo 同期の準備ができました
16. 新しく作成した cloud client を、その MinIO バケット と同期するフォルダルールおよび/または手動フォルダに適用します
17. 同期のスケジュールジョブが開始されるのを待ちます。テスト専用: Cloud Storage > 設定 > 設定 > ボタン「Launch sync」から統合を手動で起動します。

役立つMinIOドキュメント: IDとアクセス管理: https://min.io/docs/minio/linux/administration/identity-access-management.html、MinIO Server の参照: https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.