` or `` element and at least one `` element in one of the [sections](../../reference/glossary/section.md) (it can be any kind of fragment). ## Usage context | Element category | structure | | --- | --- | | PSML level | portable | | Permitted content | ``, ``, ``, `

`, `,` | | Permitted parent | *none* | | HTML equivalent | `` | | OpenXML equivalent | `` | ## Attributes This element includes the following attributes: | Name | Type | Required | Description | | --- | --- | --- | --- | | [date](element-document.md) | [xs:dateTime](../datatypes/xml_schema_datatypes.md) | no | The date of the latest change on the document | | [edit](element-document.md) | [boolean](../datatypes/pageseeder_datatypes.md) | no | Whether or not this document is editable | | [id](element-document.md) | `xs:long` | no | The URI ID of the document – the same value as the `id` attribute on the [\ element](element-uri.md). | | [level](element-document.md) | [document-level](../datatypes/pageseeder_datatypes.md) | yes | The level of the PSML | | [lockstructure](element-document.md) | `boolean` | no | Flag to disallow structural changes | | [position](element-document.md) | `xs:integer` | no | The position (instance number) of the document in the publication | | [publicationid](element-document.md) | [publication-id](../datatypes/pageseeder_datatypes.md) | no | The publication ID for this document instance | | [schemaversion](element-document.md) | `xs:string` | no | The version of the PSML schema | | [status](element-document.md) | `xs:string` | no | The status of the document version | | [type](element-document.md) | [document-type](../datatypes/pageseeder_datatypes.md) | no | The PSML document type | | [version](element-document.md) | `xs:string` | no | The version of the document, the name of the version, `original` or `current` | ### `@date` The date of the latest change on the document in ISO 8601 date time format (including the time zone). *INFORMATIONAL - ignored by upload.* For example: 2014-01-17T17:53:41+10:00. It could be the date of the last edit or the date of the last version created or the creation date of the document. ### `@edit` A boolean flag to indicate whether the document can be edited in the user interface or not. Non editable documents can only be modified as a whole through the API or by upload. The default is `true`. ### `@id` The [URI ID](../../reference/glossary/uri_id.md) of the [document](../../reference/glossary/document.md). *INFORMATIONAL - ignored by upload.* > **Note:** The URI ID is specific to a PageSeeder instance and is used mostly for traceability or to allow PageSeeder to identify the document more quickly. ### `@level` Unlike the integer values of heading level or levels of indent, in this context the `@level` attribute indicates the nature of the PSML in the document. Allowable values are the following: - `metadata` – is the same as the portable format except it doesn’t include the content. - `portable` `–` as the name implies, `portable` documents have been expressed in such a way that they can be round-tripped through external apps or moved from one PageSeeder server to another without loss of fidelity. - `processed` – when exporting a document collection to act as input to a conventional publishing app, such as InDesign, a lot of downstream processing can be avoided if values like document references and paragraph numbers are resolved by PageSeeder prior to export. This is the role of the `processed` format. The default value for the `@level` attribute is `portable`. ### `@lockstructure` A boolean flag indicating whether the structure of the document is locked. When the structure is locked, sections and fragments cannot be moved, deleted or inserted. Editing, however, might be permitted if the edit flag allows it. The default is `false` so that moving, inserting and deleting fragments is permitted. ### `@position` The position (instance number) of the document in the publication. Document content can be included multiple times in a publication. Introduced in v0.12 of the PSML schema in PageSeeder v5.96. *INFORMATIONAL - ignored by upload. Only occurs in processed level PSML.* ### `@publicationid` The publication ID for this document instance. Introduced in v0.12 of the PSML schema in PageSeeder v5.96. *INFORMATIONAL - ignored by upload. Only occurs in processed level PSML.* ### `@schemaversion` An informational attribute to indicate what version of the PSML schema this document validates. *INFORMATIONAL - ignored by upload.* This can be used to select an appropriate processor. Beta versions of PSML start with “0.”, so '0.7' is actually 'Beta 7'. ### `@status` The [status](../../reference/glossary/status.md) of this document. *INFORMATIONAL - ignored by upload.* ### `@type` The [document type](../../reference/glossary/document_type.md). Overrides ``/`@documenttype` on upload. It can only contain alphanumeric characters and underscores. It must match the following regular expression: ```lang-regex ^[a-zA-Z0-9_]*$ ``` The document type is also specified on the `` element when the PSML document includes metadata. When the `` element is present, its `@documenttype` attribute must match this attribute. ### `@version` The name of the [version](../../reference/glossary/version.md) of this document when there is one. *INFORMATIONAL - ignored by upload.* If the document is the original, that is, before any edits or versions were made, the `@version` attribute has the value `original`. If the document is the current document and does not correspond to a particular version, the `@version` attribute has the value `current`. ## Examples ### Default document The following example is a complete sample default document without any metadata. ```lang-xml

``` ## Schema ### XML Schema ```lang-xml ``` ### Relax Schema ```lang-relax element document { attribute level { "portable" | "metadata" | "processed" }, attribute type { document-type }?, attribute date { xs:dateTime }, attribute edit { xs:boolean }?, attribute id { xs:long }, attribute lockstructure { xs:boolean }?, attribute version { text }, attribute status { text }, attribute schemaversion { text }, element documentinfo?, element fragmentinfo?, element metadata?, (element section | element toc | element fragments)+ } ``` ## Compatibility This element was introduced in the first draft of PSML and is well-supported from PageSeeder 5.1.