Resources and support
- 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 [email protected].
The source code for the PE version is made available to PE customers on demand.
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 need it for a project we are currently working on.
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.
You can help by:
- 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 protected].
Your support is greatly appreciated!
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.