高度なセットアップガイド

サポートされるベクターフォーマット

Currently, QFieldCloud supports GeoPackage and PostGIS layers for collaborative editing. Other formats supported by QGIS should also work but are not officially supported.

GeoPackagesを使う

QFieldユーザーによって収集されたデータを1つのファイルに集中させるシンプルなセットアップには、通常GeoPackagesを使用するのが最適です。

If you would like to set up a relation, it is recommended to add a UUID field and to use that as the primary or foreign key.

Note

Do not use the default 'fid' field for relations (as primary or foreign key). It will lead to errors over time.

ワークフローの例 (GeoPackage)

デスクトップの準備

1. 新しいプロジェクトを作成する。
2. Create GeoPackage layers, save it in the same folder than the QGIS project.
3. QFieldSync プラグインで GeoPackage を "Offline editing" に設定します。
4. プロジェクトをQFieldCloudにアップロードします。

フィールドマーク

1. Sign in to QFieldCloud and download the project to your device.
2. Collect and edit some data and upload the changes.

Desktop

1. Using QFieldSync, download the updated files (the GeoPackage file should have changed).

Warning

This workflow does not support changing the GeoPackage on the desktop, as being file-based, the whole GeoPackage will be replaced. This means that data can only be digitized using QFieldCloud.

PostGIS

Using PostGIS layers is a good choice if your data should directly be editable for multiple users through QFieldCloud when they sync their work without any further steps.

It requires your database to be publicly accessible, and credentials must be saved unencrypted in the QGIS project. Please be aware of the security implications of such requirements, and remember to have backups.

ワークフローの例 (PostGIS)

デスクトップの準備

1. 新しいプロジェクトを作成する。
2. PostGISレイヤーを追加し、認証情報をプロジェクトに保存してください。
3. PostGISデータベース接続がパブリックアクセス可能であることを確認してください（パブリックIPまたはドメイン名、127.0.0.1またはlocalhostでは動作しません）。
4. QFieldSync プロジェクト設定で、QField ユーザーがフィールドで信頼できるインターネット接続を使用しない場合、またはデータベースへの直接アクセスを使用する場合は、GeoPackage をオフライン編集に設定します。
5. プロジェクトをQFieldクラウドにアップロードします。

フィールドマーク

1. Signin to QFieldCloud and download the project.
2. データを収集する（オフライン編集を使用している場合は、オフィスに戻ってから変更をアップロードする）。

Desktop

1. All changes should be directly visible inside the PostGIS database.

Note

When using direct database access, QFieldCloud will directly edit data in the PostGIS database. This will only work with a reliable internet connection in the field, but has the advantage that all data is directly visible to all users and allows to use any PostGIS specific setup (triggers, generated fields, etc).

Note

When using offline editing, QField will work on a local copy of the database in a GeoPackage, which will be synced by QFieldCloud to the original database once synchronized by the user. This is the best choice if the connection in the field is not reliable Changes will only be visible to users once the synchronization via QFieldCloud has been applied on the different devices. As a local copy is created, advanced PostGIS operations (like triggers) will not be available on QField. Just like for regular GeoPackages, if relationships are defined, it is recommended to use a UUID field instead of the fid as the primary key to avoid conflicts if multiple users create data at the same time.

QFieldCloud技術参考情報でさらに情報を見つけられるでしょう。

Enabling automatic pushing of changes to QFieldCloud

With this functionality, users and managers of QFieldCloud projects can enforce automatic pushing of pending changes to QField devices in the field, as well as specify the interval in between automated pushes. The functionality is activated through a project setting, allowing remote activation.

デスクトップの準備

1. プロジェクト設定へのアクセス： QFieldSyncプラグインが提供するプロジェクト設定ダイアログのQFieldパネルに移動します。

2. 自動プッシュを有効にする： 保留中の変更を「次の間隔で自動的にプッシュする」オプションを切り替え、希望の間隔を設定します。

QFieldSyncでの自動プッシュ

QFieldでの自動プッシュ

Note

Benefits:

• Real-Time Updates: Ensures prompt synchronization of field data with the QFieldCloud project.
• Streamlined Workflow: Minimizes manual intervention and ensures surveyors do not need to worry about synchronization, helping them focus on data quality.

Considerations:

• Network Stability: Ensure stable internet connectivity for auto-push functionality.
• Battery Optimization: Implement strategies to mitigate battery consumption on QField devices during prolonged fieldwork.

Create a project in an organization

組織におけるプロジェクトの作り方：

オプション1：ローカルプロジェクトを組織QFieldCloudプロジェクトに直接変換します：

1. Follow the steps configure your cloud project, until you get to the "Project details".

2. プロジェクトの所有者を自分の組織に変更する。

   

3. Click on "Create" to start the conversion and synchronization. When finish you will see the project is in your Organization in QFieldCloud.

   

備考

この機能を使用するには、QField Sync 4.6以降が必要です。

オプション2：組織へ直接アップロードする：

1. 組織を選択する。

   

2. 組織に入ったら、「プロジェクトを作成」をクリックする。

   

3. 「空の新規プロジェクトを作成」を選択する。

   

4. 新しいプロジェクトは概要で見ることができます。

   

5. QGISのQFieldSyncで、新しいプロジェクトが表示されるので、「選択されたクラウドプロジェクトを編集」をクリックします。

   

6. プロジェクトを保存するフォルダを選択します。

   

7. 選択したフォルダに、すでに作業済みのプロジェクトを貼り付けるか、新規プロジェクトを保存することができます。

   

8. フォルダにプロジェクトが格納されたら、それを同期することができます。

   

9. 最後に、変更をクラウドにプッシュします。

   

10. ファイルが組織プロジェクトに存在することを確認できます。

    

オプション3：自分のアカウントから組織にプロジェクトを移動する：

1. If you already have a project in QFieldCloud (refer to configure your cloud project). In the project, click on "Settings" and select "Transfer ownership of this project" to choose the desired Organization for the transfer.

   

2. A pop-up window will appear to confirm the transfer. To proceed, you will need to type the requested text and click "Transfer project".

   

Activate email notifications for QFieldCloud changes

1. アカウントの設定にアクセスします。
2. Navigate to the Notifications section. Here, you can customize the frequency of notifications you wish to receive at the email address registered with your account.

通知されるイベントは以下の通り: - ユーザーが作成された - 組織が作成された - 組織が削除された - 組織のメンバーが追加された - 組織のメンバーが削除された - チームが作成された - チームが削除された - チームにメンバーが追加された - チームのメンバーが削除された - プロジェクトが作成された - プロジェクトが削除された - プロジェクトのメンバーが追加された - プロジェクトのメンバーが削除された

You will receive notifications for events in which you are not the actor. These notifications are specifically for events that are initiated by other members of your organization or collaborators on your projects.

"Optimized Packager"でプロジェクトを強化する

We recommend using the new "Optimized Packager" over the deprecated "QGIS Core Offline Editing" for all your projects. Set the packager under "Packaging Offliner" in the "Settings" tab of your project.

The "Optimized Packager" supports consolidating filtered layers of same datasource into a single offline layer, respecting distinct symbology but also using less storage. Here is an example to illustrate this feature:

Example Configuration:

• レイヤー 1.1:
• データソース: layers.gpkg
• テーブル: layer1

• フィルタ: id % 2 = 1

• レイヤー 1.2:

• データソース: layers.gpkg
• テーブル: layer1
• フィルタ: id % 2 = 0

Result:

新しいオフライナーの場合 - 一つのレイヤーはlayer1 からのデータと特定のフィルタを組み合わせてオフラインのGeoPackageで生成されます。

古い（QGIS）オフライナーの場合： - 2つの別々のレイヤーが作成され、それぞれがフィルタリングされたデータセットを表します： - レイヤ 1: id % 2 = 1でフィルタされます - レイヤ2: id % 2 = 0でフィルタされます

備考

この設定は、QFieldCloudの各プロジェクトの設定ページで行う必要があります。

On-Demand Attachment Downloads

For projects with many attachment files, you can enable on-demand downloading in QField. This is useful for saving storage space on field devices and reducing data transfer over limited network connections.

To enable this feature:

1. Navigate to your project on the QFieldCloud web platform.
2. Open the project's Settings tab.
3. Enable the On demand attachment files download option.

Note

This feature can be activated during project creation or enabled at any time for existing projects.

Connect to a custom QFieldCloud server in QField and QFieldSync

QFieldとQFieldSyncは、デフォルトでapp.qfield.cloudのQFieldCloudサービスに接続します。

QFieldとQFieldSyncが接続するデフォルトのQFieldCloudサーバを変更できます：

1. QField または QFieldSync でログイン画面を開きます。
2. Nyukiアイコン（青いハチのQFieldCloudロゴ）をダブルタップします。
3. この操作により、希望するQFieldCloudサーバーアドレスを入力するフィールドが表示されます。
4. 指定されたフィールドに、希望するサーバーの詳細を入力します。 (このフィールドを空にすると、app.qfield.cloudにあるデフォルトのQFieldCloudサーバに接続されます。)

Revealing server in QField Sync

Revealing server in QField

Note

It's important to note that QFieldSync does not support the same cloud project in multiple QGIS profiles. As a recommendation use a single QGIS profile for your QFieldCloud projects to avoid synchronization issues.