Two main functionalities are covered by this service:
Triggering Online Registration
If, by any user interface of your choice, the user tells she wants to register
their product copy, ProductRegistration is the service of your choice.
Executing Registration Requests
ProductRegistration allows to remind your users to register, using a dialog with various
choices.
The string argument of XJobExecutor::trigger is
used to determine the type of the event. Currently supported events are:
RegistrationRequired
Determines that the registration is required to be executed.
This is usually triggered by some user interaction, for instance upon choosing a menu item
called Registration.
allows the registration request to be scheduled automatically.
There are processes which allow to schedule events and jobs, for instance there
can be configuration settings scheduling which operations are to be executed upon an program
startup. Such processes usually require the jobs to be executed to support the
::com::sun::star::task::XJob interface.
That's why this service supports the ::com::sun::star::task::XJob, too.
Calling the XJob::execute method results in displaying a
dialog which asks the user to register. This is done once per session, means you need to restart the
process which called this.
At the moment, there is no specification about how to use the arguments given in the
XJob::execute method, but this may change in future versions of the service
descriptions, so to keep your implementation compatible, you should not use these arguments.
