All guides
Admin

Finance

Read or manage the records shown by this feature.

Step-by-step guide

Before you start

Use an administrator account for this feature.

Open this feature

Open /admin/finance/analytics on your application domain, or use the matching item in the application menu.

Steps

Save expense / Add expense

  1. Open /admin/finance/expenses on your own application domain.
  2. Complete these fields in that form: Description, Amount, Currency, Category, Date, Notes. Their choices and limits are listed below.
  3. Select Save expense / Add expense. The exact label can change between creating and editing a record.
  4. If validation fails, correct the named field and submit again. After success, reopen the same record and compare the saved values.
Field shown in the formWhat to enterExample / note
DescriptionRequired. No more than 255 characters.A short description of this test record.
AmountRequired. Enter a number.Use the value required by the task; no example is assumed.
CurrencyRequired. Choose USD. No more than 10 characters.Choose a displayed option; the available labels are listed above.
CategoryRequired. No more than 100 characters.Use the value required by the task; no example is assumed.
DateRequired.Use the value required by the task; no example is assumed.
NotesOptional, unless this form asks for it. No more than 4000 characters.Use the value required by the task; no example is assumed.

Fields shown in the interface

Only fields traced to this role’s handler and its own view are listed. The application can show separate create/edit forms; do not fill every row on one screen.

Form 1 — fields shown in the interface
FieldWhat to enter or choose
DescriptionRequired. No more than 255 characters.
AmountRequired. Enter a number.
CurrencyRequired. Choose USD. No more than 10 characters.
CategoryRequired. No more than 100 characters.
DateRequired.
NotesOptional, unless this form asks for it. No more than 4000 characters.

Check the result

After a source-checked procedure, verify the same record in the same workspace. Check saved values, visible state and access with the intended test account. An external payment/message/provider action needs its own result check.

Problems and validation

ProblemNext step
A field rejects the valueCheck its named error, the form’s visible choices and the relevant limit. Do not substitute internal numeric codes for the displayed options.
The control is missingCheck role, plan, enabled app and current record state. Do not grant administrator access merely to complete a User task.
The saved result is unexpectedReopen the same record and verify its owner/workspace before repeating the action.

Technical reference

Role-scoped source references

Pinned commit: 37d44a1727216f5c492205024b323aa522730ebc

Source-only route information
MethodSource-default route
GET/admin/finance/analytics
GET/admin/finance/expenses