# Part 1 · Input Fields

## 1.1 Adding a value to a list (Service)

**Who** · `Service` · the platform's owner, outside any lens.

**Where** · **Input Fields** › the list › **Add a value**. Only an open list has the button (1.6).

**Before you start** · The words people will see. The code is made from the English label and never changes, so spell
it the way you mean it.

**The steps**
1. Type the label. Add a line of description if it helps.
2. Fill what the list asks of each value: an ID kind's **Pattern**, an upload type's **Largest file**.
3. Press **Add a value**. It goes to the end of the list, offered at once.

**What the record shows** · The audit log keeps the new value (`lookup_value.created`), named "Tutelora support".

**Who is told** · Nobody; every picker that reads the list offers it from the next page.

**What can go wrong**
- *"The label field is required."* English is always needed; other languages fall back to it.

## 1.2 Changing a value's words, pattern or place (Service)

**Who** · `Service`.

**Where** · **Input Fields** › the list › the pen beside the value.

**Before you start** · Nothing.

**The steps**
1. Change the label or the description. With more than one language switched on, pick the language above the label
   first; a language left empty shows the English words.
2. Change the pattern, the largest file or whatever else the list asks.
3. Type its **Place** (1 is first); the others keep their order around it.
4. Press **Save changes**.

**What the record shows** · The audit log keeps the words, metadata and place before and after.

**Who is told** · Nobody. Records that hold the value show the new words at once, because they store only the code.

**What can go wrong**
- *The code can't be changed.* Records store it; a new code is a new value (1.1), and the old one retired (1.3).
- *A pattern refuses numbers that are right.* `#` is a digit, `A` a letter, anything else a separator that may be
  typed or left out: `GHA-#########-#` accepts `GHA-723145678-3` and `gha7231456783`.

## 1.3 Retiring a value, and offering it again (Service)

**Who** · `Service`.

**Where** · **Input Fields** › the list › the toggle beside the value (or **Offered for new records** on its page).

**Before you start** · Nothing. The page says how many records hold it.

**The steps**
1. Press the toggle. The row dims and says it is retired.
2. To offer it again, press the toggle once more.

**What the record shows** · The audit log keeps the switch.

**Who is told** · Nobody. New records can't choose it; old records keep it and still show its words.

**What can go wrong**
- *There's no toggle.* The list is a system list, or the app relies on the value (1.6).

## 1.4 Deleting a value nobody holds (Service)

**Who** · `Service`.

**Where** · **Input Fields** › an open list › the bin beside the value.

**Before you start** · No record may hold it: the bin is drawn only then ("Not on any record yet").

**The steps**
1. Press the bin and confirm.

**What the record shows** · The audit log keeps the value as it was.

**Who is told** · Nobody.

**What can go wrong**
- *There's no bin.* A record holds it: retire it instead (1.3), so the record keeps its words.

## 1.5 Giving a person an ID

**Who** · `Admin` · someone whose role may add or change people.

**Where** · **People** › **Add a person**, or a person › the pen.

**Before you start** · The number, and which kind it is.

**The steps**
1. Choose the **ID kind**. The number box shows the kind's pattern, if it has one.
2. Type the **ID number** however it is written; spaces, dashes and capitals don't matter.
3. Save. To take the ID away, choose **None**.

**What the record shows** · The number is kept one way (capitals, letters and digits only), and shown masked on the
person's page (`GHA•••••••783`). Each workspace sees and changes only the ID it recorded.

**Who is told** · Nobody.

**What can go wrong**
- *"A National ID number looks like …"* The number doesn't fit the kind's pattern.
- *Adding someone opened a person who was already there.* The number names someone already on the platform: they join
  this workspace as themselves, never twice.
- *"Another person already has that number."* On a person's page, a number held by someone else is refused: check it.

## 1.6 Why a list has no "Add a value", or a value no toggle

**Who** · `Service`.

**Where** · **Input Fields** › the list. The line under the title names its kind.

**What it means**
- *System* (languages, mail events, sign-in events, log retention): the app acts on every value, so each is locked on.
  Change the words and order only; a new value comes with the code that uses it.
- *Reference* (currencies): it follows a standard, so values are switched on and off, never added or deleted.
- *Open* (ID kinds, upload types): yours. A value may still be locked by the code; it then has no toggle and no bin.

**What can go wrong**
- *A list I need isn't here.* Lists come with the code that reads them (the catalogue), so a new list is a change to the
  app, not to this page.