Hyppää sisältöön

Projektit

Projects are the main data containers on QField and QFieldCloud. Users can create any number of projects. Projects must contain a single .qgs/.qgz QGIS file, and may in addition contain any combination of geospatial files -- GeoPackages, Shapefiles, TIFs -- or data files such as photos, PDFs etc. Files cannot be shared between projects, unless localized layers are used.

QFieldCloud projects have a name and an owner. The owner of a project is a QFieldCloud user or an organization. No two projects can use the same pair owner_name and project_name.

Projects can be marked as either public or private. Private projects are accessible only to users added to a project as project collaborators. Public projects are visible to, and can be downloaded by, any QFieldCloud user.

Projektin luominen

A project can be created in multiple ways:

  • via QFieldCloud web interface;
  • via QFieldSync in QGIS;
  • via QFieldCloud-SDK;

Tiedostot

Files are the skeleton on which QFieldCloud projects work. To make a QFieldCloud project alive users need to upload at least a single QGIS project file in the .qgs or .qgz file formats. All geospatial files must be uploaded using the same relative paths as on one's computer. If external SVG or raster symbology is used, users must upload the corresponding files too.

Note

QFieldCloud does not support projects stored in a GeoPackage (.gpkg) files (but users can still use GeoPackage files to store datasets for their projects).

Tyypillinen QGIS-tiedoston tiedostorakenne saattaa näyttää tältä:

project
├── data
│   ├── basemap.tif
│   ├── bees.gpkg
│   └── fields.gpkg
├── symbology
│   ├── icon.svg
│   └── line-pattern.png
├── DCIM
│   ├── bees-20220404121212.jpg
│   ├── bees-20220405040506.jpg
│   └── fields-20220405040607.jpg
├── project.qgs
├── project_attachments.zip
└── project.qml

The files in a QGIS project can be in one of the following groups by their purpose:

  • QGIS project file - a .qgs or .qgz project file.
  • QGIS sidecar files - the utility files to the QGIS project file, such as *_attachments.zip or other sidecar files.
  • Data source files - all your vector and raster data, such as .gpkg, .tif, .mbtiles or other data source files.
  • Attachments - all your additional project data, such as .jpg, .pdf or other files.
  • QField plugins - all your QField plugins, usually .qml files.

Tiedostoversiot

QFieldCloud uses file versioning. This allows users to restore to a previous version of any modified file. Files and file versions can be found under the Files section of one's projects. Subscriptions plans allow a different number of versions per file. See the qfield.cloud pricing page for further details.

Deleting old file versions

To ensure that only relevant file versions are kept, and to reduce the amount of storage needed by accounts, users can delete obsolete file versions. One can manually delete file versions from the project's File section.

To delete file versions in QFieldCloud, follow these steps:

  1. Go to the "Files" section of your project.Project files
  2. Locate the layer for which you want to delete versions.Layer selected
  3. Click on the three dots next to the layer name.Clickable option
  4. You will see a list of versions for that specific layer.List of files versions
  5. Identify the version you want to delete and click on the red trash bin icon next to it.Thrash icon
  6. Confirm the deletion when prompted, if you want to delete all versions before a specific version, you can do it activating the option "Also delete n version(s) older than the selected version.".Deleting files versions
  7. After deleting a pop up message will appear with the success and the list of versions will show just the versions that was not selected for deletion.List of versions after deleting 2 versions before

Yhteistyökumppanit

A project collaborator is QFieldCloud user invited to contribute to a project. A single project may have multiple collaborators. Collaborators with roles owner or admin can add more users as collaborators. Projects owned by an organization allow adding teams as collaborators. Read more about collaborator roles.

Muutokset

Changes made on vector layers and uploaded to QFieldCloud from a QField device will appear here. A change stores the difference between attributes or geometries before and after the upload.

Changes register which method was used for uploading; it can be one of:

  • luonti - uusi ominaisuus on luotu.
  • poisto - olemassa oleva ominaisuus on poistettu.
  • paikkaus - olemassa olevaa ominaisuutta on muokattu.

Features that have been created and later deleted without being pushed to QFieldCloud do not appear in project changes.

Note

Changes to online vector layers (PostGIS, WFS) that do not have "Offline editing" cloud layer action do not generate a change, but instead modify the original data source directly.

Note

QGIS:ssä tehdyt vektoritasojen muutokset eivät näy tässä.

Työt

Lue lisää projektin töistä.

Salaukset

Secrets are settings that are securely stored in encrypted way. Project jobs automatically have access to their secrets. Once added, a secret may be removed, but not edited.

On olemassa kahdenlaisia salauksia:

  • Environment variables - Environment variables will be available to QGIS while your project's jobs are running.
  • pgservice-yhteys - PostgreSQL/PostGIS-yhteys, joka on määritetty .pg_service.conf-määritystiedostossa. Jos käytät useita palvelumääritelmiä, sinun tulee lisätä useita salauksia kullekin niistä.

Asetukset

Project settings are available only to project owners and collaborators with "admin" roles. Settings should be handled carefully as users can modify sensitive project settings and perform unrecoverable actions.

  • Muuta projektin näkyvyys julkiseksi.
  • Vaihda projektin omistaja.
  • Poista projekti pysyvästi.
  • jne

Warning

Actions issued from a project' settings page can lead to data loss!