FAQ - Resources and Support
- How can I get support for Orbeon Forms?
- How can I subscribe to the Orbeon Forms forum?
- Where do I find the source code?
- Where do I find the source code for a particular release of Orbeon Forms?
- When are you going to fix/implement my favorite issue/feature?
- How do I report an issue?
- Where are the Orbeon Forms forum archives?
- How can I support Orbeon Forms?
- Is there a list of known issues?
- Is there a wiki?
- What's going on with development?
How can I get support for Orbeon Forms?
- You can get support from the Orbeon Forms community on the Orbeon Forms forum which is the hub of the Orbeon Forms community, and this is the best place to ask questions, share your experience, or post issues and requests for enhancements.
- Orbeon can provide professional support for your company. Orbeon has two types of plans: Orbeon Forms PE subscriptions are the most appropriate when your application is in production, while Dev Support plans also covers issues during development, feature enhancements, and training. For more information contact Orbeon at firstname.lastname@example.org.
How can I subscribe to the Orbeon Forms forum?
Where do I find the source code?
The source code for the CE version is on GitHub. See: Orbeon Source Code Repository.
The source code for the PE version is made available to PE customers on demand.
Where do I find the source code for a particular release of Orbeon Forms?
When are you going to fix/implement my favorite issue/feature?
Usually an issue gets fixed or a feature gets implemented in Orbeon Forms when:
- The bug has been reported by a support customer and has been evaluated as high priority.
- It is very easy to implement, so we just implement it along the way to make everybody happy.
- We have put it on our roadmap and scheduled it because we think it is a crucial feature for Orbeon Forms.
- We need it for a project we are currently working on.
- Somebody sponsors it.
- Somebody sends a patch or pull request for it.
For a list of open issues and RFEs (Requests For Enhancements), see the issue tracker.
How do I report an issue?
The key to effectively reporting an issue is to post in the Orbeon Forms forum a message with:
- A reproducible test case, attached to your message
- How to run this test case
- What is the behavior you observe when you run the test case
- What is the behavior you expect
But why a reproducible test case? The alternative is to describe the issue in plain English with maybe the help of code snippets. The problem with this approach is that it requires of people who will be helping you on the Orbeon Forms forum to understand the context of your problem, which might be trivial to you, but can be hard to grasp quickly for someone else.
You can provide two types of test cases:
- An XHTML+XForms file that runs in Form Runner or in the XForms sandbox - This is the preferred way of submitting a test case. Most problems with XForms can be shown in one single XHTML+XForms file. If you need the XForms to call a service with an
<xf:submission>, you can simulate this by placing an XML file that contains the response from that service on a public web site, and changing the
<xf:submission>to point to that file. If you don't have a server of your own that you can use for this, a free hosting service will work. With Form Builder, you can open the form source with "Edit Source" and copy the form definition from the editor.
- An application - An Orbeon Forms application is stored under
resources/apps. Assuming you have your application under
resources/apps/foo, it can be accessed by going to
http://localhost:8080/ops/foo/. If you can't create a test case that runs in the XForms sandbox, create a simple standalone application under directory foo, zip the content of that directory, and attach it to your email in the Orbeon Forms forum as
In both cases:
- Make your test case as simple as possible. Remember that people who will be helping you in the forum often don't have much time, and you are more likely to receive feedback that is useful if your test case only contains the minimum amount of code required to reproduce the issue.
- Keep your post focused on a single issue. If there are more issues you would like to report, post them in separate threads, or post the first one and wait to get that one resolved before you post the next one in another thread.
Where are the Orbeon Forms forum archives?
How can I support Orbeon Forms?
You can help by:
- Subscribing to the discussion forum, and helping other people in community.
- Contributing to the open source effort. If you have a feature in mind and think it would benefit Orbeon Forms, you can implement it and contribute it. The best place to get started is to discuss your idea on the Orbeon Forms forum.
- Get a PE subscription or a Dev Support plan with Orbeon. If Orbeon Forms is what it is today, it is in great part thanks to companies who have financially supported Orbeon, allowing Orbeon developers to be paid to work on Orbeon Forms and make it a better product. For more, contact Orbeon at email@example.com.
Your support is greatly appreciated!
Is there a list of known issues?
Yes, on GitHub.
In general, we recommend you do not add bugs or RFEs in the tracker yourself, as we may miss them, and you may introduce duplicates. Please discuss bugs or issues on the Orbeon Forms forum first.
Is there a wiki?
Yes, in fact we have two (which we plan to unify):
Feel free to add or make changes to the contents there. You can do so after creating a user (anonymous changes are not allowed). But please be considerate. You may want to discuss changes on the forum first.
What's going on with development?
We regularly publish a status message like this one in the forum.
See also our roadmap.