💡 Troubleshooting & FAQ Level: Beginner ⏱️ Estimated: 8 Minutes Module: TROUBLESHOOTING

Field Technical Troubleshooting Guide and FAQ

Quick fixes for common issues: missing verification emails, failed photo uploads, session timeouts, empty diagrams, and demo data isolation.

Target Roles: All Users & Prospective Surveyors
Log In to Track Learning Progress
📋 Prerequisites Before Starting
No specific prerequisites.

Frequently Encountered Issues & Solutions

1. Verification Email Not Arriving in Inbox

  • Symptom: After registration, the verification message does not appear in Inbox.
  • Cause: Message filtered to Spam/Junk or email server delivery delay.
  • Solution: Check your Spam / Promotions folder. If still not received after 5 minutes, log into your account and click Resend Verification Email on the notification banner.

2. Observation Photo Upload Fails

  • Symptom: Error message displays when uploading Form 2 photos.
  • Cause: File exceeds 5MB limit, format is non-image (e.g., SVG/PDF), or network dropped during transmission.
  • Solution: Adjust smartphone camera resolution or export to standard JPEG/PNG under 4MB before re-uploading.

3. Account Remains in Pending Approval Status

  • Symptom: Cannot access survey forms and held at /account-status.
  • Cause: Account is in pending status awaiting identity verification by Super Admin.
  • Solution: Contact your enumerator team lead to verify your official registration email.

4. Sankey Diagram or Dashboard Shows Empty State

  • Symptom: Sankey diagram shows no flow ribbons.
  • Cause: Selected farm has no plastic items with valid kg/year weight conversions.
  • Solution: Ensure plastic items with valid quantities are saved in Form 1, or toggle the Demo Data filter to view sample simulations.

5. Differentiating Demo Data from Real Surveys

  • Note: Records with identifiers like DEMO-01, Kebun PPII, and DEMO-01-DRAIN represent built-in workbook training data.
  • Demo records display a prominent [🔬 DEMO MODE] badge and are segregated from official research surveys.

6. When to Contact System Administrators

Contact IT support when:

  • Account is locked after repeated failed login attempts.
  • Persistent HTTP 500 server errors occur.
  • Role elevation from surveyor to reviewer is required.

Security Notice: When reporting issues, only provide your account email and relevant survey codes. NEVER send your password.

🎯 Expected Results
Users can resolve common operational issues independently before requesting technical support.
⚠️ Common Pitfalls & Troubleshooting
Submitting screenshots containing passwords or sensitive information when requesting support.
🔒 Security & Data Privacy Notice
When contacting administrators, NEVER include account passwords, session tokens, or .env files.

💬 Was this Guide Helpful?

Your feedback helps us continuously improve technical APRA survey instructions.

← Back to Tutorial Center
Current Category

💡 Troubleshooting & FAQ

Field technical troubleshooting guide, network connectivity, validation failures, and self-service solutions.

View all guides in this category →
🔬 Using Demo Data? Simulated data (such as DEMO-01) is provided out-of-the-box for independent training. You can freely test without affecting real survey records.