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.
No problem matches. Try fewer words, or see Still stuck?
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
- Check the email is your work email, exactly as in your invitation.
- Use Forgot your password? to set a new password.
- 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).
“Link not valid” — “This link is invalid or has expired”Invitation and password reset links
- Cause
- The link was already used, has expired (invitations: 7 days; self-service reset: 1 hour; reset from an administrator: 24 hours), or a newer link replaced it.
- Fix
- For a reset, use Forgot your password? again and open the newest email. For an invitation, ask an administrator for a New invitation link. Copy the whole link: email apps sometimes break long links.
- Who
- You, or an administrator.
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
- Check spam / junk.
- Administrator: open the person on Staff and use New invitation link or Password reset link, then Copy and send it by WhatsApp or SMS.
- 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.fieldbut notfield.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.officeto your role. - Who
- You; administrator to change the role.
Access: “I can’t see it”
“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
- Leave the app open where the signal is better; it retries every minute and whenever you reopen it.
- Tap Sync on Wi-Fi.
- Do not clear the browser’s data or uninstall the browser — the saved surveys are stored there.
- 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
- Turn on Location in the phone’s settings, in high-accuracy mode.
- Allow location for the site: in Chrome tap the icon left of the address › Permissions › Location › Allow.
- Stand in the open, away from buildings and trees, and tap Capture GPS here again.
- 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
VERSIONinweb/survey/sw.jswith 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_DIRand 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
- Compare the returned name (shown under the result) with the ID document.
- 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.
- If the account belongs to someone else, get the claimant’s own account details.
- 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
000and NINs ending0000always 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_KEYandMONNIFY_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=monnifyandIDENTITY_PROVIDER=monnifywith 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_KM2or set anotherOVERPASS_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_noorname(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.valuatewhile the case is Pending valuation or Valuated; after approval only withcomp.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=nonelists 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(dndreaches 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=trueand 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/readyshows 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:
- Is the server up? Open
/api/health/readyon the office address. It should show"database":"ok"and"storage":"ok". - Are email, SMS and storage connected? Messages › Delivery settings › Check connections, then send yourself a test email and SMS.
- Did a particular message go out? Messages › Outbox, filtered by kind and status.
- What happened to a record? Its Minutes tab.
- Is it the person’s role? Open them on Staff and read What this role can do.
- 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:
- your name and staff ID;
- the exact message (a screenshot is best);
- the page address from the browser bar — it identifies the exact record and view;
- the time it happened, and what you clicked just before;
- for the field app: the phone model, and whether it was online.
Never send passwords, full account numbers or BVNs in a support request.