Description of XML Elements

From Apache OpenOffice Wiki
< Documentation‎ | DevGuide
Revision as of 11:41, 13 November 2007 by Jl (Talk | contribs)

Jump to: navigation, search




Element /description

<description> is the root element of the description.xml.


Attributes of <description>
Attribute Description
xmlns The default namespace of element description and all children must be defined as

http://openoffice.org/extensions/description/2006

xmlns:dep The namespace for dependency information must also be defined as

http://openoffice.org/extensions/description/2006

xmlns:xlink The xlink namespace must be defined as

http://www.w3.org/1999/xlink

other namespace definitions Other namespaces can be added as necessary


Element /description/identifier


Attributes of <identifier>
Attribute Description
value Required. The extension identifier.

Further documentation is available at Documentation/DevGuide/Extensions/Extension Identifiers.


Element /description/version


Attributes of <version>
Attribute Description
value Required. A textual representation of the extension version.

Further documentation is available at Documentation/DevGuide/Extensions/Extension Versions.


Element /description/registration

The registration element currently only contains the <simple-license> element. If the <registration> element exists, then it must have a child element.


Element /description/registration/simple-license

Parent: <registration>

The element contains the <license-text> elements, determines if all user must agree to the license, or just the person who installs it, and determines a default <license-text> element. The mechanism for determining a "default" has changed in OOo 2.4. See Documentation/DevGuide/Extensions/Localized XML Elements for details.

If the <simple-license> element exists, then it must have at least one child element.


Attributes of <simple-license>
Attribute Description
accept-by Required.Value is either “user” or “admin”. “user” means that every user has to agree to the license. That is, the extension can only be installed as user extension but not as shared extension. If it has the value “admin” then it can be deployed as shared extension as well. In that case only the person who installs it has to agree to the license. Individual users will not be asked to accept the license. They can use the extension right away. In case the value is “user” and the extension is being installed as user extension then the user must always agree to the license.
default-license-id Required. Since OOo 2.4 this attribute is obsolete. Determines what <license-text> is used if no <license-text> element has a lang attribute whose value matches the locals of OpenOffice.org. There must always be exactly one <license-text> element with a license-id attribute whose value matches that of the default-license-id. The type is xsd:IDREF.
suppress-on-update Optional. When the attribute is not provided then the value “false” is assumed. The value true indicates that the license for this extension will not be displayed during installation when the same extension (same id but probably different version) is already installed. This applies for the automatic update as well as for manually installing an extension. The version of the already installed extension does not matter. Suppressing the license can be useful during the online update, because otherwise the update operation could be interrupted by many license dialogs.

Further documentation is available at Documentation/DevGuide/Extensions/Simple License.


Element /description/registration/simple-license/license-text

The element contains information about where to find the file containing the license text, which language it uses, and if this element is the “default” <license-text>. The mechanism for determining a "default" has changed in OOo 2.4. See Documentation/DevGuide/Extensions/Localized XML Elements for details.


Attributes of <license-text>
Attribute Description
xlink:href Required. The value is a relative URL to the file which contains the license text. The base URL is the URL of the root directory of the extension. That is, if the extension has been unzipped, then the resulting directory is the root directory.
lang Required. A language identifier according to RFC 3066. See also Documentation/DevGuide/Extensions/Localized XML Elements.
license-id Optional. Since OOo 2.4 this attribute is obsolete. One license-text element must have this attribute and the value must match the value of the default-license-id attribute of the <simple-license> element. The type is xsd:ID.


Element /description/dependencies

Further documentation is available at Documentation/DevGuide/Extensions/Dependencies.


Element /description/dependencies/OpenOffice.org-minimal-version


Attributes of <OpenOffice.org-minimal-version>
Attribute Description
xmlns:dep The namespace for dependency information (inherited from <description>) must be defined as

http://openoffice.org/extensions/description/2006

dep:name Required. The string “OpenOffice.org value” (where value is the value of the attribute value).
dep:OpenOffice.org-minimal-version Optional. This attribute should never be used with this element.
value Required. The required underlying OpenOffice.org version (“2.1”, “2.2”, etc.), starting with OpenOffice.org 2.1.


Element /description/update-information

<update-information> must have at least one <src> child element. The second, third, etc. element are regarded as fallback, that is, the elements provide URLs to mirrors. The Extension Manager will try to get update information by using a URL and only use a different URL if an error occurred. That is, if for example the first URL references an atom feed that does not contain any references at all, but is a valid feed, then the Extension Manager assumes that there are no update information available. Then URLs from other <src> elements are not examined. Therefore the update information referenced by every URL must be identical.

Further documentation is available at Documentation/DevGuide/Extensions/Online Update of Extensions.

Element /description/update-information/src


Attributes of <src>
Attribute Description
xlink:href Required. The value is a URL which provides the update information directly or an atom feed which in turn references the update information. The URL can point directly to a file or it may invoke code, such as a servlet, cgi, etc, that returns the atom feed or the update information.


Element /description/publisher

<publisher> must have at least one <name> child element. The children of this element provide a localized publisher name together with a URL.

Currently this element and its children are not used by the Extension Manager.

Element /description/publisher/name

The text value of this element is the publisher name.


Attributes of <name>
Attribute Description
xlink:href Required. The value is a URL to the web site of the publisher of the extension.
lang Required. A language identifier according to RFC 3066. See also Documentation/DevGuide/Extensions/Localized XML Elements.

Element /description/release-notes

<release-notes> must have at least one <src> child element. The children provide URLs to localized release-notes.

Currently this element and its children are not used by the Extension Manager.


Element /description/release-notes/src

The element contains a URL to the release notes.


Attributes of <src>
Attribute Description
xlink:href Required. The value is a URL to the release notes of the extension.
lang Required. A language identifier according to RFC 3066. See also Documentation/DevGuide/Extensions/Localized XML Elements.

Element /description/display-name

<display-name> must have at least one <name> child element. The children of this element provide a localized display name. The name will be used in the GUI instead of the file name.


Element /description/display-name/name

The text value of this element is the display name of the extension. The string length must be greater then null and must not only contain white space characters.


Attributes of <name>
Attribute Description
lang Required. A language identifier according to RFC 3066. See also Documentation/DevGuide/Extensions/Localized XML Elements.


Content on this page is licensed under the Public Documentation License (PDL).
Personal tools