EarthCape Dokumentacja

Rejestracja

Protokoły badań

Protokół określa, co musi zawierać rekord: które pola pojawiają się na formularzu obserwacji, które z nich są wymagane, jakie są jednostki i listy wartości oraz co uznaje się za kompletną obserwację. Każdy rekord w projekcie powstaje według jednego protokołu, który wyznacza również formularz pokazywany osobie rejestrującej.

Co określa protokół

Protokół definiuje strukturę, która powstaje w wyniku rejestracji. Zmiana protokołu zmienia wraz z nim formularz, dlatego rozdział Formularze i pola niestandardowe oraz ta strona dotyczą pokrewnych zagadnień. Strona o formularzach opisuje układ i ustawienia poszczególnych pól; ta strona opisuje protokół, który decyduje o tym, jakie pola w ogóle istnieją.

Co definiuje protokółWpływ na rejestrację
Prezentowane polaZestaw pól danych pojawiających się na formularzu obserwacji. Pola nieujęte w protokole nie pojawiają się i nie można ich wypełnić.
Pola wymaganeKtóre pola muszą zostać wypełnione, zanim rekord będzie mógł zostać zapisany. Walidacja działa przy wprowadzaniu, a nie przy eksporcie.
Jednostki i listy wartościJednostki przypisane do pól liczbowych (metry, stopnie, liczebności) oraz stałe opcje pokazywane w polach wyboru. Są one ustalone dla każdego protokołu, dzięki czemu wszystkie rekordy w projekcie korzystają z tego samego słownictwa.
Grupowanie rekordówHow observations are grouped: into survey visits, or left ungrouped as incidental records. The grouping structure determines what the visit prompt shows when you start recording.
Wybór wizyty z dostępnymi wizytami i przyciskiem Kontynuuj bez wizyty
Pytanie o wizytęPrzy rozpoczynaniu rekordu aplikacja proponuje wizyty dostępne w bieżącym protokole oraz opcję zapisu bez wizyty.
Formularz wprowadzania obserwacji z polami określonymi przez aktywny protokół
Formularz obserwacjiPokazane tu pola oraz to, które z nich są wymagane, wynikają z protokołu przypisanego do projektu.

Protokoły w zestawie

Seven survey protocols ship with the app: Casual / incidental, Site visit, Timed area search and Walking transect under "Other", and Vegetation — Braun-Blanquet, Vegetation — % cover and Vegetation — Drude relevé under "Vegetation". The project created on first run uses Casual / incidental. A project you create later has no protocol until you assign one; until then new records use the casual protocol's core fields.

Lista protokołów z siedmioma protokołami dostarczanymi z aplikacją
Lista protokołówSiedem protokołów w zestawie. Aby zapoznać się z opisem i strukturą pól każdego z nich, należy otworzyć tę listę na urządzeniu.

The list on the device is the best place to read each protocol: it shows the full description, the fields it includes and their settings. Open Menu → Protocols and tap a protocol to open it; the Information tab shows its description and settings, the Form builder and Custom fields tabs show its fields.

Wybór protokołu dla projektu

One project records under one protocol. Your first project starts with Casual / incidental; later projects start with no protocol and use core fields only. Assign the protocol when you know your method, before records are entered.

  1. Open Menu → Projects and tap the project.
  2. In the Survey protocol section tap Assign a protocol (or Change if one is assigned).
  3. Choose the protocol in the Choose a survey protocol list and tap Done. Assigning copies the protocol's full template — forms and custom fields — into the project.
  4. The observation form reflects the new protocol from the next record onward. Remove keeps your data and the core fields.

Jeden protokół na projekt. Projekt jest zdefiniowany przez pojedynczy protokół, ponieważ mieszanie dwóch różnych struktur pól w jednym zbiorze danych utrudnia analizę. Jeśli praca rzeczywiście wymaga dwóch odrębnych metod, należy utworzyć dwa projekty i wyeksportować je razem.

Edycja protokołu

The seven built-in protocols are read-only. To adapt one, open it in Menu → Protocols and tap Clone; the copy is a custom protocol you can rename and edit. The practical case is a method close to a standard one that adds two or three measurements: clone, rename, add the fields. That way you keep the structure you know and only change what is different about your method.

Editing a protocol does not alter records already entered. Those records retain the field values they were given at the time. Projects that already use the protocol keep their copy until you tap Push to assigned projects in the Protocols Studio; from then on new records in those projects use the updated definition. To change the layout for one project only, use Customize on the project form instead.

Naming your edited protocol. Give it a name that distinguishes it from the original so that anyone reading the exported data can identify which definition was in use. The protocol code travels with every export.

Pisanie własnego protokołu

The Protocols Studio (Menu → Protocols) is where custom protocols are created — tap New protocol and choose From scratch or Clone existing. A protocol has a name, code, description, group, required fields, effort thresholds and vocabulary sets, plus its own forms and custom fields on the Form builder and Custom fields tabs. The field-level work — captions, data types and whether a field appears in list views — is covered in Forms and custom fields.

Protokoły powinny być tak proste, jak wymaga tego metoda. Protokół z wieloma polami wymaganymi spowalnia rejestrację w terenie; protokół bez pól wymaganych daje zbiór danych, którego braki mogą wyjść na jaw dopiero później.

Walidacja

Required fields are enforced when the record is entered, not discovered at export. Fields the protocol marks required are enforced when the record is saved: the form lists the missing ones and does not save until they are filled.

Brakującą wartość można uzupełnić, będąc jeszcze na stanowisku. Gdy eksport powstaje kilka miesięcy później, nie jest to już możliwe. Walidacja kosztuje kilka sekund na rekord i zapobiega lukom, których nie da się później wypełnić.

Pola nieoznaczone jako wymagane można pozostawić puste. W eksportach pojawią się jako puste komórki, zamiast powodować błąd.

Zmiana protokołu w trakcie sezonu

Protokół przypisany do projektu można zmienić w trakcie sezonu. Istniejące rekordy zachowują wartości, z którymi zostały wprowadzone; nie są ponownie sprawdzane względem nowego protokołu. Zestawowi pól nowego protokołu i jego regułom pól wymaganych podlegają wyłącznie nowe rekordy, wprowadzone po zmianie.

Jeśli nowy protokół zawiera pola, których nie miał poprzedni, w eksportach pola te pozostaną puste dla istniejących rekordów. Jeśli nowy protokół pomija pola obecne w poprzednim, wartości tych pól są zachowywane w bazie danych, ale nie pojawią się w formularzu nowych rekordów.

Zmianę należy udokumentować. Datę zmiany protokołu należy odnotować w opisie projektu albo w osobnym pliku notatek terenowych. Analiza łącząca rekordy sprzed i po zmianie musi uwzględniać różne struktury pól.

Udostępnianie protokołu

Protocol and form configuration travel together in the project setup file. Open the project, tap Share, and send the .ecsurvey file to each device; importing it (Menu → ProjectsImport) gives that device the same protocol, forms and custom fields. Every recorder on the study then sees an identical form and records under the same required-field rules. Exporting the project to Google Drive also publishes the setup, which other devices receive with Download from Drive + merge…. See Forms and custom fields and Google Drive collaboration.