Registro

Protocolos de levantamento

Um protocolo define o que um registro deve conter: quais campos aparecem no formulário de observação, quais deles são obrigatórios, as unidades e as listas de valores, e o que conta como uma observação completa. Todo registro de um projeto é feito sob um protocolo, que também determina o formulário exibido a quem registra.

O que um protocolo controla

O protocolo define a estrutura que o registro produz. Alterar o protocolo altera o formulário junto, e é por isso que Formulários e campos personalizados e esta página tratam de assuntos relacionados. A página de formulários trata do layout e dos controles no nível do campo; esta página trata do protocolo que determina, antes de mais nada, quais campos existem.

O que o protocolo define	Efeito sobre o registro
Campos apresentados	O conjunto de campos de dados que aparecem no formulário de observação. Campos não incluídos no protocolo não aparecem e não podem ser preenchidos.
Campos obrigatórios	Quais campos precisam ser preenchidos antes que o registro possa ser salvo. A validação ocorre no momento da digitação, não na exportação.
Unidades e listas de valores	As unidades associadas aos campos numéricos (metros, graus, contagens) e as opções fixas exibidas nos campos de escolha. Elas são fixas por protocolo, de modo que todos os registros de um projeto usam o mesmo vocabulário.
Agrupamento de registros	How 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.

Seletor de visita mostrando as visitas disponíveis e um botão Prosseguir sem visita — **Solicitação de visita**Quando você inicia um registro, o aplicativo oferece as visitas disponíveis no protocolo atual, além da opção de registrar sem visita.

Formulário de entrada de observação com os campos definidos pelo protocolo ativo — **Formulário de observação**Os campos exibidos aqui, e quais deles são obrigatórios, são definidos pelo protocolo atribuído ao projeto.

Os protocolos incluídos

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 de protocolos mostrando os sete protocolos incluídos no aplicativo — **Lista de protocolos**Os sete protocolos incluídos. Abra esta lista no dispositivo para ler a descrição e a estrutura de campos de cada um.

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.

Escolhendo o protocolo de um projeto

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.

Open Menu → Projects and tap the project.
In the Survey protocol section tap Assign a protocol (or Change if one is assigned).
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.
The observation form reflects the new protocol from the next record onward. Remove keeps your data and the core fields.

Um protocolo por projeto. Um projeto é definido por um único protocolo, porque misturar duas estruturas de campos diferentes em um mesmo conjunto de dados dificulta a análise. Se o seu trabalho realmente exige dois métodos distintos, crie dois projetos e exporte-os juntos.

Editando um protocolo

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.

Escrevendo o seu próprio

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.

Mantenha os protocolos tão simples quanto o método exigir. Um protocolo com muitos campos obrigatórios torna o registro em campo mais lento; um protocolo sem nenhum campo obrigatório produz um conjunto de dados que pode estar incompleto de maneiras que só serão descobertas depois.

Validação

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.

Um valor ausente pode ser preenchido enquanto você ainda está no local. Depois que a exportação é gerada, meses mais tarde, não pode mais. A validação custa alguns segundos por registro e evita lacunas que não podem ser preenchidas depois.

Os campos que não são marcados como obrigatórios podem ficar em branco. Eles aparecem nas exportações como células vazias, em vez de causar um erro.

Mudando de protocolo no meio da temporada

Você pode trocar o protocolo atribuído a um projeto durante a temporada. Os registros existentes mantêm os valores com que foram inseridos; eles não são revalidados em relação ao novo protocolo. Apenas os novos registros, inseridos depois da mudança, seguem o conjunto de campos e as regras de campos obrigatórios do novo protocolo.

Se o novo protocolo incluir campos que o antigo não tinha, os registros existentes terão esses campos em branco nas exportações. Se o novo protocolo omitir campos que o antigo tinha, os valores desses campos continuam no banco de dados, mas não aparecerão no formulário dos novos registros.

Documente a mudança. Anote a data em que o protocolo mudou, seja na descrição do projeto, seja em um arquivo separado de anotações de campo. Uma análise que reúne registros de antes e de depois da mudança precisa levar em conta as diferentes estruturas de campos.

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 → Projects → Import) 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.

Formulários e campos personalizados Navegando pelos seus dados