- Created by Robert Reiner, last modified on 23. Jul 2020
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 16 Current »
projectdoc Toolbox
In addition to the properties specified in the document properties table, projectdoc provides additional properties drawn from Confluence or metadata.
- Audience
- Type
Artificial properties are derived properties added to documents and therefore made available to users for displaying and adding constraints for queries.
Use the Display All Document Properties Macro to list all properties of a document.
Properties in different Representations
A property may provide its value in different representations.
The basic concept it that the pure text representation of a property has the same name as the property, but puts a dollar sign ($) at the end. In case the value has a canonical representation, then the name is extended by the paragraph sign (§).
The projectdoc Toolbox provides different representations for dates and URLs (uniform resource locators).
Dates
If a document property value is a date using the time element (create with two slashes '//') then the projectdoc Toolbox will provide a standard rendered value in pure text ('$' version) and a normalized representation of the date ('§' version). The normalized representation can be used to order the elements by the date.
Example for the artificial property "Last Modification Date".
| Property | Value |
|---|---|
| Last Modification Date |
|
| Last Modification Date$ | 30 Aug 2019 |
| Last Modification Date§ | 20190830 |
Uniform Resource Locators
For each HTML link with an absolute URL the projectdoc Toolbox provides the names of the link labels ('$' version) and the list of URLs from the HTML href attribute ('§' version).
Since 4.0 and 4.5
This feature is available since the projectdoc Toolbox version 4.0.
Since version 4.5 more URL representations of artificial properties are supported.
A URL is considered to be absolute if it includes the scheme (e.g. http://).
Example for a property with a reference to an external site.
| Property | Value |
|---|---|
| Homepage | |
| Homepage$ | smartics |
| Homepage§ | https://www.smartics.eu/ |
Users
The creator's and last modifier's login name is rendered by Creator and Last Modifier.
Adding a '$' renders the full name.
Since 4.0
The full name property is provided since version 4.0.
Overriding Artificial Properties
To put full control over the naming of properties into the hands of the users, it is possible to override artificial properties by adding a property with the same name to the projectdoc document.
Since 4.6
This feature is supported since version 4.6.
You cannot override encoded property names, like the text (suffix '$') and normalized (suffix '§') properties.
Full control over Domain Vocabulary
The artificial property URL points to the current page as an artificial property.
This would make it impossible for users to design a doctype with the property URL.
List of Artificial Properties
The following properties are provided by the projectdoc Toolbox to projectdoc documents per default.
| Name | Short Description | Type |
|---|---|---|
| AncestorIds | The list of document IDs, starting from the root page, excluding the ID of this page. | |
| AncestorNames | The list of document names, starting from the root page, excluding the name of this page. | |
| AncestorTypeIds | The list of parent document IDs, starting from the hierarchy's root document. | |
| AncestorTypeNames | The list of parent document names, starting from the hierarchy's root document. | |
| Auto ID | The automatically generated identifier for a document. The services needs to be configured per doctype with a space property. | |
| Creation Date | The date the document has been created. The value is created by Confluence. | |
| Creation Time | The hour of day of the date the document has been created. The value is created by Confluence. | |
| Creator | The name of the user who created the document. This value is generated by Confluence. | |
| Delegate Document Doctype | The type of the document this document delegates to. | |
| Delegate Document Name | The name of the document this document delegates to. | |
| Delegate Document Page Link | The page link to the document this document delegates to. | |
| Delegate Document Page Reference | The page reference (space-key.page-title) of the document this document delegates to. | |
| DirectAncestorId | The internal Confluence page identifier of the page's parent. | |
| DirectAncestorTitle | The title of the parent document. | |
| Doctype Homepage | Provides a link to the document's type homepage. | |
| DocumentPropertyRefs | Tracks direct property references a document is defining. | |
| Index Key | The key to the lookup the document within its context. The index key is typically the first character of the name. It may be defined by the author as a document property to override the default. | |
| Last Modification Date | The date the document had been modified lately. The date is generated by Confluence. | |
| Last Modification Time | The time of day of the date the document had been modified lately. The date is generated by Confluence. | |
| Last Modifier | The name of the user who added the last modifications to the document. The value is generated by Confluence. | |
| Last Version Comment | The last comment added by the last modifier for the Confluence page. | |
| Last Version Number with Comment | The last version Number that actually has a comment. | |
| Page ID | The unique identifier of the page. This is the page ID provided by Confluence. | |
| Page Key | Unique reference of a page within a Confluence site. | |
| projectdoc Anchor IDs in Document Part References | Lists identifiers used by macros of a projectdoc document to identify anchored content on other documents. | projectdoc Metadata Property Reference |
| projectdoc Anchor Link Documents | Provides access to documents with body links to anchors in this or other documents. | Artificial Property |
| projectdoc Anchor Links | Provides access to body links to anchors in this or other documents. | Artificial Property |
| projectdoc CSS Class References | Lists all used CSS classes of a given projectdoc document that are mentioned as parameters of projectdoc macros. | projectdoc Metadata Property Reference |
| projectdoc Display in Property Name References | Lists the names of all properties that are referenced by a given projectdoc document via display property macros. | projectdoc Metadata Property Reference |
| projectdoc Document Name References | Lists the names of all documents that are referenced by a given projectdoc document. | projectdoc Metadata Property Reference |
| projectdoc Dynamic Link Titles | Lists the titles of all pages targeted by dynamic links. | projectdoc Metadata Property Reference |
| projectdoc IDs for Document Part References | Lists identifiers used by macros of a projectdoc document to identify content on other documents. | projectdoc Metadata Property Reference |
| projectdoc IDs for Document Parts | Lists all used part identifier of a given projectdoc document. | projectdoc Metadata Property Definition |
| projectdoc Macro Parameter Name References | Lists the names of all macro parameters that are referenced by a given projectdoc document. | projectdoc Metadata Property Reference |
| projectdoc Macro Parameter Name References in Remote Control | Lists macro parameter names used in the context of remote controls. | projectdoc Metadata Property Reference |
| projectdoc Macro Parameter Names | Lists the parameter names of all macros on a projectdoc document. | projectdoc Metadata Property Definition |
| projectdoc Property Control Name References | Lists the control names used by properties of a projectdoc document. | projectdoc Metadata Property Reference |
| projectdoc Property Control Value References | Lists the control values used by properties of a projectdoc document. | projectdoc Metadata Property Reference |
| projectdoc Property Name References | Lists the names of all properties that are referenced by a given projectdoc document. | projectdoc Metadata Property Reference |
| projectdoc Property Names | Lists the names of all properties, excluding projectdoc metadata properties, of a projectdoc document. | projectdoc Metadata Property Definition |
| projectdoc Property Value References | Lists all values for matching property values. Includes only literal values, not property name references. | projectdoc Metadata Literal |
| projectdoc Property Values | Lists the values of all properties, excluding projectdoc metadata properties, of a projectdoc document. | projectdoc Metadata Property Definition |
| projectdoc Select in Property Name References | Lists the names of all properties that are referenced by Select parameters in a projectdoc document. | projectdoc Metadata Property Reference |
| projectdoc Sort By in Property Name References | Lists the names of all properties that are referenced by a given projectdoc document in Sort By parameters. | projectdoc Metadata Property Reference |
| projectdoc Tags for Document Parts | Lists all used part identifier classes or tags of a given projectdoc document. | projectdoc Metadata Property Definition |
| projectdoc Tags in Document Part References | Lists tags used by macros of a projectdoc document to identify content on other documents. | projectdoc Metadata Property Reference |
| projectdoc Tokens in Document Part References | Lists identifiers and tags used by macros of a projectdoc document to identify content on other documents. | projectdoc Metadata Property Reference |
| projectdoc Transclusion IDs in Document Part References | Lists identifiers used by macros of a projectdoc document to identify transcluded content on other documents. | projectdoc Metadata Property Reference |
| projectdoc Transclusion Tags in Document Part References | Lists tags used by macros of a projectdoc document to identify transcluded content on other documents. | projectdoc Metadata Property Reference |
| projectdoc Value References in Remote Control | Lists all values of remote controls that are not mapped to a property name by a macro parameter name. | projectdoc Metadata Property Reference |
| projectdoc Where in Property Name References | Lists the names of all properties that are referenced by Where parameters in a projectdoc document. | projectdoc Metadata Property Reference |
| Relative URL | Provides a relative URL to the projectdoc document. | |
| RootPathPageIds | List of page identifiers from the current page's parent page to the root page in the space. | Artificial Property |
| Space Key | The key of the space the document is part of. | |
| Space Title | The title of the space the document is part of. | |
| Tiny URL | Provides a short URL to the projectdoc document. | |
| Title | The title of the Confluence page. | |
| TranscludedDocumentTitles | Tracks direct transclusions a document is defining. | |
| URL | Provides the absolute URL to the projectdoc document. | |
| Version Comment | The comment added by the last modifier for the last version of the Confluence page. If there is no comment, the property is not set. | |
| Version Number | The last version number of the Confluence page. | |
| VersionHistory | The list of document names, starting from the root page, including the name of this page. | |
| Wiki Type | The type of the confluence entity. This is usually 'page'. |
- No labels
