Language:

The Free and Open Productivity Suite
Apache OpenOffice 4.1.4 released

Developer's Guide

API

SDK

Tips 'n' Tricks

Miscellaneous


:: com :: sun :: star :: setup ::

service ProductRegistration
Description
provides a mechanism for registering the product.

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.

Since
OOo 1.1.2

Included Services - Summary
::com::sun::star::task::JobExecutor

allows to trigger certain events. (details)

Exported Interfaces - Summary
::com::sun::star::task::XJob

allows the registration request to be scheduled automatically. (details)

Included Services - Details
::com::sun::star::task::JobExecutor
Description
allows to trigger certain events.

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.

Exported Interfaces - Details
::com::sun::star::task::XJob
Description
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.


 
Top of Page

Apache Software Foundation

Copyright & License | Privacy | Contact Us | Donate | Thanks

Apache and the Apache feather logo are trademarks of The Apache Software Foundation. OpenOffice, OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.