Troubleshooting & FAQ
This section provides solutions to common issues and answers to frequently asked questions about using the Netgrif Platform.
Common Deployment Issues
Problem: Application status is "failed"
Cause:
- Invalid or missing
manifest.xml - Invalid paths in process or import sections
- Assignment errors during deployment
Solution:
- Validate manifest formatting
- Ensure referenced files exist and paths are correct
- Re-upload and reassign nodes
Problem: No tasks appear after starting a case
Cause:
- No initial transition available to current user role
- Transition conditions are not met
Solution:
- Check roles and field visibility settings
- Confirm transition has role assigned and is reachable
Problem: User can’t see a field or button
Cause:
- Visibility condition is not met
- Role restriction is hiding the field
Solution:
- Review expressions in the Builder
- Check role assignments and form logic
Problem: Case or process not starting
Cause:
- Process not deployed
- Wrong node assignment
- Backend error
Solution:
- Check Admin App > Applications
- Ensure correct deployment and node mapping
- Monitor logs for error trace
FAQ
Can I update a deployed application?
No partial updates. You need to repackage the entire application and redeploy.
Where are applications stored?
They are stored in the server's file system, usually under /storage/uploads/package-{AppId}.
Can I test an application before full deployment?
Yes. Assign to a test node and verify behavior before assigning to live nodes.
Can I rollback a failed deployment?
Not automatically. You must upload and deploy a known working version manually.
What is the difference between process and case?
A process is a template or blueprint. A case is a live instance of that template.