Troubleshooting

Find the message you see, or describe the problem in a few words. Each entry gives the cause, the fix and who can fix it. Messages are quoted exactly as the apps show them.

Signing in and accounts

“Wrong email or password”Office and field log-in
Cause
The email or password does not match an account. Common reasons: a typo in the email, Caps Lock on, or the password was changed.
Fix
  1. Check the email is your work email, exactly as in your invitation.
  2. Use Forgot your password? to set a new password.
  3. If you never accepted your invitation, there is no password yet: ask for a new invitation link.
Who
You; otherwise an administrator.
“Too many login attempts — wait 15 minutes and try again”Log-in
Cause
Ten failed log-ins for one account (or many from one network) within 15 minutes. This protects accounts from password guessing.
Fix
Wait 15 minutes. Meanwhile, reset your password with Forgot your password? so the next try works. If it happens repeatedly without you, tell your administrator: someone may be trying to get in.
Who
You.
“Too many attempts — try again later”Forgot password, invitation links
Cause
Too many reset requests or link checks from your network in 15 minutes.
Fix
Wait 15 minutes. Check your email (including spam) for a link that has already arrived; only the newest link works.
Who
You.
“This account is not active” / “Account is not active” / “This account is disabled”Log-in, any page
Cause
An administrator disabled the account, or it is still Invited (no password set yet).
Fix
Ask an administrator. On Staff they can Enable access, or send a New invitation link to someone still Invited.
Who
Administrator (users.manage).
Invitation or reset email never arrivesEmail
Cause
Email is not configured (the server only prints mail to its log), the address is wrong, or the mail went to spam. The forgot-password screen says “Reset link issued … Ask your administrator for it” when email is off.
Fix
  1. Check spam / junk.
  2. Administrator: open the person on Staff and use New invitation link or Password reset link, then Copy and send it by WhatsApp or SMS.
  3. Administrator: check Messages › Delivery settings. “console · not sending” means email must be set up by the IT operator. The Outbox shows whether a mail was sent or failed.
Who
Administrator; IT operator for email settings.
“Your session has ended — please log in again” / “Session expired — please log in again”Office app
Cause
Office sessions last 12 hours. Sessions also end if the server’s secret key was changed, or the account was disabled.
Fix
Log in again. Anything you had saved is kept; a form you had not saved is lost, so save often on long forms.
Who
You.
“Password must be at least 8 characters” / “The two passwords do not match” / “Current password is wrong”Set password, My account
Fix
Use 8 characters or more, type the same password in both boxes, and on My account enter your current password first. If you forgot the current one, log out and use Forgot your password?.
Who
You.
“Your account is for the field survey app. Open it on your phone instead.”Office log-in
Cause
Your role allows only the field app: it has survey.field but not field.office (“Capture in the office app, within assigned areas”). The default Field Surveyor role has both.
Fix
Open the field app’s address on your phone. If you need the office app too, ask an administrator to add field.office to your role.
Who
You; administrator to change the role.

Access: “I can’t see it”

A menu, page, button or step is missingOffice app
Cause
Your role does not include the permission. The app hides what you cannot use, and an address for a page you cannot open takes you to the first page you can.
Fix
Check My account › Your access, and find the permission you need in Roles and permissions. Ask an administrator to change your role or the role’s permissions. Changes apply at your next click; no need to log out.
Who
Administrator (roles.manage / users.manage).
“Your role does not allow this action”Any action
Cause
The server refused the action for your role — usually because the role was changed while the page was open.
Fix
Reload the page (F5) to see what you can now do. If you should be allowed, ask an administrator.
Who
Administrator.
“Your role cannot record this step (…)”Compensation case
Cause
Each step needs its own permission, named in brackets. For example only Finance and Officers can approve, only Valuers and Officers can value.
Fix
Nothing is wrong: the person with that permission records the step. If you should, ask an administrator to add it to your role.
Who
The responsible role; administrator.
Numbers show as ••••6789 and there is no Reveal buttonClaimant, case
Cause
Account numbers, BVNs and ID numbers are masked for everyone. Only roles with claimants.reveal (by default Administrator, Compensation Officer, Finance) get the Reveal button.
Fix
Ask someone with that permission, or an administrator to grant it if your job needs it.
Who
Administrator.
“You cannot assign a role with more access than your own” / “Only an administrator can change an administrator account” / “You cannot change your own role” / “You cannot disable your own account”Staff
Cause
Safety rules: nobody can grant more than they have, and nobody can lock themselves out.
Fix
Ask another administrator to make the change.
Who
An Administrator.
“A user with this email already exists” / “This staff ID is already in use”Invite staff
Cause
Emails and staff IDs must be unique. The person may already be invited or disabled.
Fix
Search Staff for the email or staff ID. Use New invitation link or Enable access on the existing record instead of inviting again.
Who
Administrator.
“Enable the user first” / “User has not set a password yet — send a new invite link”Staff
Fix
A disabled person needs Enable access before a reset link. Someone still Invited needs a New invitation link, not a password reset.
Who
Administrator.
“N user(s) still have this role — move them to another role first” / “The Administrator role is locked…”Roles
Fix
Move the staff to another role (Staff › Edit) before deleting a role. The Administrator role cannot be edited or deleted; create a new role instead.
Who
Administrator.

Field app

“You are offline — connect to log in.”Field app log-in
Cause
The first log-in (and every log-in after logging out or 30 days) needs internet.
Fix
Move to where there is signal or Wi-Fi and log in. After that, surveys work offline.
Who
You.
“This app is for field surveyors. Use the main KADGIS site.”Field app log-in
Cause
The account’s role does not include the field app permission (office staff).
Fix
Office staff use the office app. A surveyor seeing this needs the Field Surveyor role from an administrator.
Who
Administrator.
“Another surveyor has unsent work on this phone. They must log in and sync first.”Field app log-in
Cause
The phone still holds surveys saved by a different surveyor that have not uploaded. Logging in as someone else would mix up their work.
Fix
The first surveyor logs in, waits until the bar shows no surveys waiting, then logs out. Then you can log in.
Who
The other surveyor.
“No surveys assigned yet” / a property I was told about is not on my listField app list
Cause
The phone has not synced since the office assigned it, or it was assigned to someone else.
Fix
Get signal and tap Sync. If it is still missing, ask the Compensation Officer to check the survey’s surveyor on the Surveys page.
Who
You; Compensation Officer.
Surveys stay “Waiting to sync” / “Could not reach the server. Your work is saved and will upload automatically.”Field app
Cause
No signal, very weak signal, or the server cannot be reached. The phone can show “Online” while the connection is too weak to upload photos.
Fix
  1. Leave the app open where the signal is better; it retries every minute and whenever you reopen it.
  2. Tap Sync on Wi-Fi.
  3. Do not clear the browser’s data or uninstall the browser — the saved surveys are stored there.
  4. If no phone can sync, the server may be down: tell the office.
Who
You; IT operator if the server is down.
“Please log in again to sync. Your saved work is kept.”Field app
Cause
Your 30-day session ended, your password was reset, or your account was changed.
Fix
Log in again with signal. The saved surveys then upload.
Who
You.
“Upload problem: …”Field app survey
Cause
The office refused the upload; the reason follows. Common ones: “Field is required”, “Survey is already submitted” or “Survey is already approved” (it was submitted from another phone, or the assignment changed), “Not your survey” (it was reassigned), “File is larger than 15 MB”.
Fix
Open the survey, fix what the message says and save again. If it is already submitted or no longer yours, tap Discard saved survey (twice) and tell the office.
Who
You; Compensation Officer for reassignments.
“Add at least one photo of the property.” / “Wait for the photos to finish preparing.”Field app survey
Fix
Add at least one photo with Take or add photo. If photos show “Preparing photo…”, wait a moment: they are being shrunk to upload faster. On a returned survey you must add at least one photo again.
Who
You.
“GPS failed: …” / “GPS is not available on this device” / GPS takes long or is inaccurateField app survey
Cause
Location permission was refused, location is turned off on the phone, the app is not on a secure (https) address, or there is no clear view of the sky. The app waits up to 30 seconds for a fix.
Fix
  1. Turn on Location in the phone’s settings, in high-accuracy mode.
  2. Allow location for the site: in Chrome tap the icon left of the address › Permissions › Location › Allow.
  3. Stand in the open, away from buildings and trees, and tap Capture GPS here again.
  4. If it never works on any phone, the IT operator must serve the field app over https.
Who
You; IT operator for https.
The camera does not openField app survey
Fix
Allow the browser to use the camera (phone Settings › Apps › Chrome › Permissions › Camera). You can also take photos with the phone’s camera app first and then pick them with Take or add photo.
Who
You.
“Needed before saving: …” / “Needed: …”Field capture
Cause
A property needs a property type, at least one GPS point (or a boundary) and at least one photo before it can be saved. A claimant needs a full name, a phone or NIN, and a photo.
Fix
Add what the message names. Everything else can be finished later, or by the office.
Who
You.
“Connect to download this project the first time”Field capture
Fix
A project must be downloaded to the phone once, with signal. After that it opens offline. Download the projects you will need before going to site.
Who
You.
“Weak GPS (±N m). Stand in the open and add the corner again if you can.” / “No GPS fix yet — move to open sky and try again”Field capture boundary
Fix
Move away from buildings and trees, keep still, and tap Add corner here again, then remove the weak corner. If GPS will not work, use Type a corner. Corners weaker than ±10 m raise a Weak GPS fixes flag in the office.
Who
You.
A photo shows “… — remove and retake”Field capture photos
Cause
The office could not accept the photo, for example because the file was unreadable.
Fix
Remove the photo and take it again, then save. It uploads on the next sync.
Who
You.
“This property was also changed in the office since you last synced …” / “Changed in office”Field capture
Fix
Nothing to do on the phone: your changes are sent to the office, which decides between the two versions on Conflicts.
Who
Compensation Officer.
The field app looks old or a new feature is missingField app
Cause
The phone keeps a copy of the app for offline use and refreshes it when opened online.
Fix
Open the app while online, close it completely, and open it again. IT operator: bump VERSION in web/survey/sw.js with every change to the field app.
Who
You; IT operator.
“N survey(s) not uploaded yet — they stay on this phone. Tap Log out again to confirm.”Field app log-out
Fix
Better to sync first. If you do log out, the surveys stay on the phone and upload after you log in again on the same phone.
Who
You.

Uploads and documents

“File is larger than 15 MB”Attach document, photos
Fix
Reduce the file: scan at 150–200 dpi in black and white or greyscale, save as PDF, or take the photo at a lower resolution. Split very long documents.
Who
You.
“File type not allowed: … Use JPG, PNG, WEBP or PDF.” / “Use a JPG, PNG or WEBP photo”Attach document, photos
Fix
Save Word documents as PDF; convert HEIC photos (iPhone) to JPG, or set the iPhone camera to “Most Compatible” (Settings › Camera › Formats). Profile and claimant photos must be images.
Who
You.
“File is missing from storage” / a photo or document will not openEvidence
Cause
The record exists but the file cannot be found in storage — for example after a storage change, a failed restore, or a problem with the S3 bucket.
Fix
Administrator: Delivery settings › Check connections tests the storage. IT operator: check the bucket or UPLOAD_DIR and restore the file from backup. Otherwise attach the document again.
Who
IT operator.

Claimant details and checks

“This NIN is already registered to CL-… (…)” / “NIN must be 11 digits”Claimant form, import, field app
Cause
A NIN is 11 digits and belongs to only one claimant.
Fix
Check the number. If it really is the same person, link the existing claimant instead of registering a new one. If two records are the same person, decide the duplicate on Conflicts (Merge).
Who
Compensation Officer.
“Account number must be 10 digits (NUBAN)” / “BVN must be 11 digits” / “Email address is not valid”Claimant form, import
Fix
Enter digits only, with no spaces or dashes. If a number lost its leading zero in Excel, see Keeping leading zeros.
Who
Compensation Officer.
Name mismatchIdentity & bank checks
Cause
The name returned by the bank or NIMC shares fewer than 60% of its parts with the claimant’s name, or the BVN does not belong to the account.
Fix
  1. Compare the returned name (shown under the result) with the ID document.
  2. If the claimant’s name was misspelt, correct it and Check again. Titles such as Alhaji, Hajiya, Mallam, Mr, Mrs, Dr and Chief are ignored.
  3. If the account belongs to someone else, get the claimant’s own account details.
  4. Do not approve payment until it is resolved.
Who
Compensation Officer or Finance (claimants.verify).
“Add the bank name and account number first” / “The BVN is checked against the bank account — add the bank details first” / “Add the claimant’s NIN first” / “Add the BVN first”Identity & bank checks
Fix
Edit the claimant and fill in what is named. The NIN check uses the claimant’s NIN field.
Who
Compensation Officer.
“Account not found at this bank” / “No record found for this NIN”Identity & bank checks
Cause
The number does not exist at the chosen bank, or the bank is wrong. In test mode, account numbers starting 000 and NINs ending 0000 always give this result.
Fix
Check the bank and number against the claimant’s bank document and try again.
Who
Compensation Officer.
“Monnify keys are not configured” / “The provider could not be reached” / “Bank "…" was not found in the provider's bank list”Identity & bank checks
Cause
The live checks are switched on but the keys are missing, the provider is down or slow (checks wait 20–30 seconds), or the bank name could not be matched to the provider’s list.
Fix
Try again later. IT operator: check MONNIFY_API_KEY, MONNIFY_SECRET_KEY and MONNIFY_BASE_URL, and the server’s internet access. For an unknown bank, report the bank name so it can be mapped.
Who
IT operator.
Results say “test mode”Identity & bank checks
Cause
The checks are using the built-in mock, not Monnify. The results are not real.
Fix
IT operator: set BANK_PROVIDER=monnify and IDENTITY_PROVIDER=monnify with the Monnify keys. Run the checks again afterwards.
Who
IT operator.
“Account changed since”Bank check
Cause
The account number was edited after the last bank check, so the result no longer applies.
Fix
Click Check again on the bank account (and BVN) check.
Who
Compensation Officer or Finance.
“Claimant cannot change while a compensation is open for this property”Property
Fix
The claimant of a property with an open case is fixed. If the wrong person was linked, cancel the case (with the reason), change the claimant, and open a new case.
Who
Compensation Officer.

Properties and locations

“Reference number already exists” / “A record with this value already exists”Property, project
Fix
Property reference numbers and project codes are unique across the whole system. Search for it — the record may already be registered — or choose another.
Who
Compensation Officer.
“Ward does not belong to the selected LGA” / “Area does not belong to the selected ward”Property form, import
Fix
Choose the LGA first, then the ward, then the area. In an import, check the names are spelled as on the Locations page. A missing ward or area must be added by an administrator.
Who
Compensation Officer; administrator to add places.
“Draw or upload the project boundary before making the project active” / “A project can only become Active once its boundary is set” / “An active project needs its boundary — set it back to planning first”Project, import
Fix
Create the project as Planning, set its boundary on the project’s Map tab, then make it Active. To remove the boundary of an active project, set it back to Planning first.
Who
Compensation Officer.
“The last map scan failed: …” / “No map data server could be reached …” / “The project area … is larger than the scan limit …”Project › Map
Cause
The map scan reads OpenStreetMap data from an outside server, which can be busy or unreachable. Very large projects are refused.
Fix
The scan is retried on its own. Later, click Run again on the Map tab, or an administrator can retry it on Background jobs. For the area limit, the IT operator can raise SCAN_MAX_AREA_KM2 or set another OVERPASS_URL.
Who
Compensation Officer; administrator; IT operator.
“AI suggestions are switched off” / “The AI budget is used up today” / “… no usable answer” / “… the model declined”AI suggestions
Cause
AI is off on the server or for that feature, a cap was reached, or every model in the feature’s list failed or answered in the wrong shape (wrong answers are never shown).
Fix
Work on without it — AI only suggests. An administrator checks Administration › AI: the switches, the caps, a test call for each provider, and the Calls list for the error.
Who
Anyone; administrator to fix.
“You have no area assigned in … — ask your supervisor” / “… is outside your assigned areas — the office can change it” / a project missing from Field captureField app
Cause
Field agents work in the sub-boundaries assigned to them (plus 200 m). A project with none of their areas is not listed; a property outside them that someone else registered is changed in the office.
Fix
The office assigns the area: its file › Field team › Assign an agent (or the agent’s staff file › Field areas). The next sync brings it. A supervisor can be given field.all_projects.
Who
Compensation Officer (assigning); administrator (roles).
“The line must cross the area from one side to the other” / “Nothing would be left of the area” / “Choose two or more areas to merge”Map Studio
Fix
To split, start the line outside the selected area and end it outside on the other side. A hole must not cover the whole area. To merge, Shift-click at least two areas first.
Who
Compensation Officer.
“Change 3: …” when publishing / “The drawing tools are not available”Map Studio
Cause
Publishing checks every change first; the numbered one has a problem (often an outline that crosses itself), so nothing was saved. The drawing tools load from the server the first time the Studio opens.
Fix
Undo back to before that change, or select the area and fix its corners, then publish again. If the tools did not load, reload the page; it needs subboundaries.manage to draw at all.
Who
Compensation Officer.
“No ref no attribute (refNo, ref, ref_no or name)” / “No property with ref no …”Import boundaries
Fix
Each outline in the file needs the property’s reference number in an attribute called refNo, ref, ref_no or name (in KML, the placemark name), spelt as in the register. Outlines with problems are skipped; the rest can still be imported.
Who
Compensation Officer.
“"…" is retired — pick another item” / “Pick a specific kind under "…"”Property items, import
Fix
Only active items with nothing under them can be put on a property: pick the exact kind (for example Mango › Mature, not Mango). An administrator can restore a retired item under Dictionaries.
Who
Compensation Officer; administrator.
“This item is used by the system itself and cannot be retired”Dictionaries
Fix
Items with a padlock are locked. Rename them instead if the wording is wrong.
Who
Administrator.
“Location is in use and cannot be deleted” / “This location already exists”Locations
Fix
A place used by a property or project cannot be deleted; rename it instead if the name is wrong. Names must be unique within their parent.
Who
Administrator.

Surveys

“Choose an active field surveyor” / the surveyor list is emptyAssign survey
Cause
Only active staff whose role includes the field app permission are listed. Administrators are never listed.
Fix
Ask an administrator to invite the surveyor with the Field Surveyor role; they appear once they have set their password.
Who
Administrator.
“0 surveys assigned · N skipped (already surveyed or in progress)” / “Pick properties, or a project / LGA / ward / area to assign” / “Choose at least a project or an LGA”Assign survey
Cause
Properties with an open or approved survey are always skipped, so nothing is surveyed twice. Assigning by location needs at least a project or an LGA.
Fix
Check the properties’ stages. To move a survey to a different surveyor, open it, Withdraw assignment, then assign again.
Who
Compensation Officer.
“Link a claimant to the property before approving” / “Give a reason so the surveyor knows what to correct” / “Only submitted surveys can be reviewed”Survey review
Fix
Link the claimant on the property first; write a note when returning a survey; only Submitted surveys can be approved or returned (reload the page if someone else just reviewed it).
Who
Compensation Officer.
“Only surveys that have not been submitted can be unassigned”Survey
Fix
Once submitted, review the survey instead: return it for correction, or approve it.
Who
Compensation Officer.

Compensation cases

“Not ready for a compensation case” / “This case cannot open yet: …”Open case
Cause
A case only opens when the property data and the claimant data are 100% complete (including a verified bank account), the claimant link is approved, no conflict is open on the property or claimant, and the property has no blocking spatial flag. An approved survey is no longer needed.
Fix
The dialog lists each problem with a Fix link: fill in what is missing (or use Fill the gaps), run the bank check, decide the conflict on Conflicts, or fix or accept the flag on Spatial flags.
Who
Compensation Officer.
“The land is already covered by COMP-… — use a separate scope (buildings, trees and crops) or a supplementary case” / “… chosen items are already in another case” / “Nothing left to pay for in this scope …”Open case
Cause
The land can be in only one live case (Whole property or Land only), and each item in only one live case.
Fix
Choose another scope (Buildings and structures, Economic trees and crops), untick items already in another case, or open a Supplementary case and choose the case it adds to. Cancelling a case frees its land and items.
Who
Compensation Officer.
“Give the reason for the adjustment” / “N lines have no value” / the worksheet is read onlyCase › Valuation
Fix
Every adjustment needs a reason. Every line needs a figure before Valuated: type ₦0 for a line worth nothing, or use Use guide rates for empty lines. The worksheet can be changed by roles with comp.valuate while the case is Pending valuation or Valuated; after approval only with comp.correct (the case goes back to Valuated); never once a cheque is issued — open a supplementary case instead.
Who
Valuer; Compensation Officer.
“Choose cases of the same type at the same step” / “N moved on · N not: …”Move on to the next step
Fix
Filter the register by type and status before ticking. Cases that did not move are named in the message with the reason; open them one by one.
Who
Whoever records the step.
“… is required to mark as "…"” / “Approved amount must be greater than zero”Case step
Fix
Fill in every figure the step asks for. Amounts are in naira, without commas.
Who
Whoever records the step.
“Already on hold” / “Only disputed compensations can be resumed” / “This compensation is cancelled” / “This compensation is already complete” / “Cannot advance while disputed (on hold)”Case
Cause
The case changed since you opened it, or the action does not fit its status.
Fix
Close and reopen the case to see its current status and minutes. Resolve a dispute before advancing.
Who
Compensation Officer (comp.hold).
A figure was recorded wronglyCase
Fix
Correct values changes recorded figures and notes without changing the step; the minute names the fields that were corrected. Steps cannot be undone; if a step should not have happened, dispute the case and explain in the note.
Who
Compensation Officer (comp.correct).

Messages and delivery

“None of the chosen claimants has a phone or email for this channel” / many “no contact”New message
Cause
Claimants without a valid Nigerian mobile number are skipped for SMS; those without an email are skipped for email.
Fix
Use SMS + Email, or add contact details: #/claimants?contact=none lists claimants with neither.
Who
Compensation Officer.
“SMS messages are limited to 640 characters” / “Email needs a subject” / “Write the message” / “Choose SMS, Email or both”New message
Fix
Shorten SMS text (the counter shows characters and SMS parts; placeholders such as {name} grow when filled in). Add a subject for email.
Who
You.
Deliveries “Failed” / “Invalid phone number: …” / “Termii error (HTTP …)”Message recipients
Cause
The SMS or email provider refused the message: a bad number, the provider’s balance or sender ID, the DND route, or a mail server problem. The reason is in the Problem column of the message’s Recipients tab.
Fix
Correct the claimant’s details if needed, then open the message and click Retry failed. Administrator: send a test from Delivery settings. IT operator: check the Termii account, sender ID and TERMII_CHANNEL (dnd reaches numbers on Do-Not-Disturb).
Who
Compensation Officer; IT operator for the provider.
Messages show “Sent” but nobody receives themMessages
Cause
Email or SMS is in console mode: messages are only printed in the server log. Delivery settings shows “console · not sending”.
Fix
IT operator: configure SMTP and Termii. Then resend the message.
Who
IT operator.
“The outbox viewer is turned off (OUTBOX_VIEWER_ENABLED)”Messages › Outbox
Fix
IT operator: set OUTBOX_VIEWER_ENABLED=true and restart, if your organisation wants administrators to read sent mail.
Who
IT operator.

Import and export

“The file is missing the column(s): …” / “The first row must hold the column headings” / “The file has headings but no rows”Import
Fix
Start from the downloaded template and keep its first row of headings. Do not add title rows above them.
Who
You.
“Use an Excel (.xlsx) or CSV file” / file too largeImport
Fix
Save as .xlsx or .csv (not .xls or .ods). Split files over 5,000 rows or 5 MB.
Who
You.
“Fix the errors in the file first — nothing was imported” / “N rows have problems”Import
Cause
At least one row is invalid: unknown project code, LGA, ward or area; a wrong type; a number in the wrong format; a duplicate (“Also on row N of this file”).
Fix
Fix each listed row (row numbers match the spreadsheet), then Choose another file and check again. Import wards and areas before the properties that use them.
Who
You.
Account numbers, BVNs or phone numbers lost their leading 0Import / export in Excel
Fix
Use the Excel template and format those columns as Text before typing or pasting. Do not open a CSV in Excel and save it again.
Who
You.
“N rows match — narrow the filters to 50000 or fewer”Export
Fix
Export in parts, for example one project or LGA at a time.
Who
You.
“Column "…" is not used and was ignored”Import
Fix
Only a warning. If the column holds something the import should read, click Choose the columns and say what it is.
Who
You.
“Not found in the file yet: …” (the import asks which column is which)Import
Cause
The file’s headings are not the template’s (for example a bank’s or another office’s own spreadsheet).
Fix
For each column of the file, choose what it holds, or “not imported”, then Check file again.
Who
You.
“₦… differs from the approved ₦…” / “… already has cheque …”Import payments
Cause
The amount the bank paid is not the case’s approved amount, or the case already has a different cheque recorded.
Fix
Check the case with Finance before paying. A wrong approved amount or cheque number is corrected on the case (needs the correction permission); then import the file again.
Who
Finance, with the approver.
“… is in a compensation case and cannot change here”Import property items
Cause
The item was valued in a live or completed case, so its quantity is fixed for that case.
Fix
Leave the row as it is recorded, or remove it from the file. A real change goes through the case (cancel and reopen, or a supplementary case).
Who
The officer, with the valuer.
The export dialog’s Download button stays offExport
Cause
Nothing matches the filters, no column is ticked, or more rows match than one file (50,000) or one print view (2,000) can hold. The dialog says which under the columns.
Fix
Change the filters in the dialog until the count is in range, tick a column, or choose ticked rows only.
Who
You.

Connection and server

“Cannot reach the server. Check your connection and try again.”Office app
Cause
Your internet dropped, or the server is down or restarting.
Fix
Check other websites work, then try again. If nobody can reach the system, call the IT operator: /api/health/ready shows whether the database and storage are up.
Who
You; IT operator.
“Something went wrong on the server”Any
Cause
An unexpected error. Nothing was saved by the action that failed.
Fix
Try once more. If it repeats, report it with the time, the page address and what you clicked. IT operator: the server log has the error at that time.
Who
IT operator.
“Record not found” / “Could not open this record”Any file
Cause
The link points at a record that does not exist, or was deleted (for example a withdrawn survey assignment).
Fix
Search for the record in its register.
Who
You.
The app is slow, or a large import failsAny
Fix
Use filters rather than paging through everything; import in smaller files. IT operator: check server memory (about 1 GB is comfortable) and the database.
Who
IT operator.

Administrator diagnostic checklist

When several people report a problem, check in this order:

  1. Is the server up? Open /api/health/ready on the office address. It should show "database":"ok" and "storage":"ok".
  2. Are email, SMS and storage connected? Messages › Delivery settings › Check connections, then send yourself a test email and SMS.
  3. Did a particular message go out? Messages › Outbox, filtered by kind and status.
  4. What happened to a record? Its Minutes tab.
  5. Is it the person’s role? Open them on Staff and read What this role can do.
  6. Still unclear? Ask the IT operator to look at the server log at the time of the problem.

Still stuck?

Contact your administrator or the KADGIS ICT unit, and include:

Never send passwords, full account numbers or BVNs in a support request.