Matterial API Objects
Documentation of matterial API objects and their properties.
Activity
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented |
|---|---|---|---|---|
| id | Number | No/No | ||
| commentText | String | No/No | ||
| contentStyle | String | No/No | ||
| createTimeInSeconds | Number | No/No | ||
| dataSourceDisplayName | String | No/No | ||
| dataSourceId | Number | No/No | ||
| documentFollowedByAdditionalProperty | Boolean | No/No | ||
| documentFollowedByCategory | Boolean | No/No | ||
| documentFollowedDirectly | Boolean | No/No | ||
| documentId | Number | No/No | ||
| documentLanguageVersionId | Number | No/No | ||
| documentLanguageVersionLanguageKey | String | No/No | ||
| documentLanguageVersionTitle | String | No/No | ||
| documentLanguageVersionVersion | Number | No/No | ||
| languageKey | String | No/No | ||
| messageType | String | No/No | ||
| notificationStatus | Number | No/No | ||
| personAccountId | Number | No/No | ||
| personAccountLogin | String | No/No | ||
| personFirstName | String | No/No | ||
| personLastName | String | No/No | ||
| receiverAcountId | Number | No/No | ||
| receiverEmail | String | No/No | ||
| receiverFirstName | String | No/No | ||
| receiverLastName | String | No/No | ||
| receiverLogin | String | No/No | ||
| taskAssignee | String | No/No | ||
| taskDescription | String | No/No | ||
| taskDueDate | String | No/No | ||
| taskId | Number | No/No | ||
| taskSnap | Boolean | No/No | ||
| taskStatus | String | No/No | ||
| jsonType | String | No/No |
AdditionalProperty
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| id | Number | No/No | ||||
| The identifier of the object. | ||||||
| name | String | 1/255 | Yes/Yes | |||
| description | String | 0/4000 | Yes/Yes | |||
| following | Boolean | No/No | ||||
| Indicates, if the current user follows the additional property in the specified language. Requires the parameter “loadFollowingLanguageKey” when loading the additional property. | ||||||
| propertyType | Number | No/No | ||||
| The type of the additional property. | ||||||
| validBeginInSeconds | Number | No/No | ||||
| Unix time stamp in seconds when the additional property will be valid. | ||||||
| validEndInSeconds | Number | No/No | ||||
| Unix time stamp in seconds when the additional property will not be valid anymore. | ||||||
| jsonType | String | No/No | ||||
Address
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented |
|---|---|---|---|---|
| id | Number | No/No | ||
| city | String | 0/255 | No/No | |
| country | String | 0/255 | No/No | |
| houseNumber | String | 0/255 | No/No | |
| postalCode | String | 0/255 | No/No | |
| street | String | 0/255 | No/No | |
| jsonType | String | No/No | ||
| imported | Boolean | No/No |
Aggregation
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| buckets | Map<String, Number> | No/No | ||||
| Buckets-map containing the aggregated results. key: value of indexField, value: hits | ||||||
| indexField | String | No/No | ||||
| The index field that was aggregated. | ||||||
Attachment
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented |
|---|---|---|---|---|
| id | Number | No/No | ||
| name | String | No/No | ||
| status | Number | No/No | ||
| mimeType | String | No/No | ||
| casId | String | No/No | ||
| casIdImgLarge | String | No/No | ||
| casIdImgSmall | String | No/No | ||
| casIdPdf | String | No/No | ||
| casIdThumbnail | String | No/No | ||
| createTimeInSeconds | Number | No/No | ||
| displayName | String | No/No | ||
| fileSize | Number | No/No | ||
| fileSizeImgLarge | Number | No/No | ||
| fileSizeImgSmall | Number | No/No | ||
| fileSizePdf | Number | No/No | ||
| fileSizeThumbnail | Number | No/No |
BatchActionAdditionalData
The BatchActionAdditionalData is the class that is used to execute batch actions on documents. Each property of the class can contain elements that the batch process can update.
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| additionalProperties | Array<AdditionalProperties> | No/No | ||||
| The list of additional properties a document should get. | ||||||
| archivedBeginInSecondsRequest | Number | No/No | ||||
| The start time stamp (Unix Time Stamp) when the document will be archived. | ||||||
| categoryIds | Array<Number> | No/No | ||||
| The list of category ids the document should be assigned to. | ||||||
Category
The category class is used to manage document categories. Categories can be assigned to documents and persons can follow categories.
Implemented since version: 1.0
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| id | Number | No/No | ||||
| The identifier of the object. | ||||||
| name | String | 1/255 | Yes/Yes | |||
| The name of the category. | ||||||
| description | String | 0/4000 | Yes/No | |||
| The description of the category. | ||||||
| typeId | String | Yes/Yes | ||||
| The id of the category type to which this category belongs to | ||||||
| typePersonal | Boolean | No/No | ||||
| True, if the category type, to which this category belongs to, is a personal category type. | ||||||
| following | Boolean | No/No | ||||
| Indicates, if the current user follows the category in the specified language. Requires the parameter “loadFollowingLanguageKey” when loading the category. | ||||||
| usageCount | Number | No/No | ||||
| Number, how many times the category is used. Requires the “loadUsage” parameter when loading the category. | ||||||
| quick | Boolean | No/No | ||||
| A quick category is currently only represented by the “Mark as favourite” (the little star) in the user interface. | ||||||
| jsonType | String | No/No | ||||
| casId | String | No/No | ||||
| casIdThumbnail | String | No/No | ||||
| fileSize | Number | No/No | ||||
| fileSizeThumbnail | Number | No/No | ||||
CategoryType
The category type class is used to manage categories types. Category types are used to group categories together.
Implemented since version: 1.0
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| id | Number | No/No | ||||
| The identifier of the object. | ||||||
| name | String | 1/255 | Yes/Yes | |||
| The name of the category type. | ||||||
| description | String | 0/4000 | Yes/No | |||
| The description of the category type. | ||||||
| quick | Boolean | No/No | ||||
| Note: Currently, the system only supports one quick category type and it is handled by the system and cannot be updated or removed. | ||||||
| A quick category type is a special category type. | ||||||
| personal | Boolean | No/No | ||||
Client
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| id | Number | No/No | ||||
| The identifier of the object. | ||||||
| name | String | 1/255 | Yes/Yes | |||
| The name of the Client. | ||||||
| clientPreferences | PreferenceMapContainer | No/No | ||||
| A PreferenceMapContainer containing all the preferences of a client. | ||||||
| skinColourButton | String | Yes/No | ||||
| This property defines the button color. | ||||||
| skinColourLabel | String | Yes/No | ||||
| This property defines the label color. | ||||||
| skinColourNotification | String | Yes/No | ||||
| This property defines the Notification color. | ||||||
| jsonType | String | No/No | ||||
| casId | String | No/No | ||||
| casIdImgLarge | String | No/No | ||||
| casIdImgSmall | String | No/No | ||||
| casIdThumbnail | String | No/No | ||||
| fileSize | Number | No/No | ||||
| fileSizeImgLarge | Number | No/No | ||||
| fileSizeImgSmall | Number | No/No | ||||
| fileSizeThumbnail | Number | No/No | ||||
Comment
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| id | Number | No/No | ||||
| The identifier of the object. | ||||||
| text | String | 0/4000 | Yes/No | |||
| The text of the comment. | ||||||
| documentLanguageVersionId | Number | Yes/Yes | ||||
| The documentLanguageVersionId of the document to which the comment is linked to. | ||||||
| person | Person | No/No | ||||
| The person who created the comment. | ||||||
| documentId | Number | No/No | ||||
| The documentId of the document to which the comment is linked to. | ||||||
| mentionedAccountIds | Array<Number> | No/No | ||||
| documentLanguageVersionLanguageKey | String | No/No | ||||
| documentLanguageVersionTitle | String | No/No | ||||
| documentLanguageVersionVersion | Number | No/No | ||||
| createTimeInSeconds | Number | No/No | ||||
| textHtml | String | No/No | ||||
| jsonType | String | No/No | ||||
CommunicationData
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented |
|---|---|---|---|---|
| id | Number | No/No | ||
| description | String | No/No | ||
| jsonType | String | No/No | ||
| usedForNotification | Boolean | No/No | ||
| value | String | No/No | ||
| entityTypeId | CommunicationEntityType | No/No | ||
| imported | Boolean | No/No |
ContactImage
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| id | Number | No/No | ||||
| Internal id of the object. | ||||||
| name | String | 1/255 | No/No | |||
| Name of the contact image. | ||||||
| jsonType | String | No/No | ||||
| casId | String | No/No | ||||
| casIdThumbnail | String | No/No | ||||
| fileSize | Number | No/No | ||||
| fileSizeThumbnail | Number | No/No | ||||
| createTimeInSeconds | Number | No/No | ||||
| mimeType | String | No/No | ||||
| externalImgUrl | String | No/No | ||||
| internal | Boolean | No/No | ||||
| active | Boolean | No/No | ||||
| external | Boolean | No/No | ||||
| gravatar | Boolean | No/No | ||||
| Boolean | No/No | |||||
| cobot | Boolean | No/No | ||||
| reference | Object | No/No | ||||
Credential
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| id | Number | No/No | ||||
| The identifier of the object. | ||||||
| login | String | 1/255 | Yes/No | |||
| Note: If login is not set, subscriptionEmail will be used instead. | ||||||
| The user’s login. | ||||||
| password | String | 1/255 | Yes/No | |||
| Note: The password is RequiredOnCreate if updatePassword==true. | ||||||
| The user’s password. | ||||||
| subscriptionEmail | String | 3/255 | Yes/Yes | |||
| The user’s email address. | ||||||
| updatePassword | Boolean | 3/255 | Yes/No | |||
| Note: If true, no invitation email will be sent. | ||||||
| Update the user’s password. | ||||||
| dataSources | Array<Instance> | No/No | ||||
| The list of data sources this credential has access to. | ||||||
CredentialWithInvitationText
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| id | Number | No/No | ||||
| The identifier of the object. | ||||||
| invitationText | Number | 1/4000 | Yes/No | |||
| The invitation text used. This is used when a person is invited. | ||||||
| login | String | 1/255 | Yes/No | |||
| Note: If login is not set, subscriptionEmail will be used instead. | ||||||
| The user’s login. | ||||||
| password | String | 1/255 | Yes/No | |||
| Note: The password is RequiredOnCreate if updatePassword==true. | ||||||
| The user’s password. | ||||||
| subscriptionEmail | String | 3/255 | Yes/Yes | |||
| The user’s email address. | ||||||
| updatePassword | Boolean | 3/255 | Yes/No | |||
| Note: If true, no invitation email will be sent. | ||||||
| Update the user’s password. | ||||||
| dataSources | Array<Instance> | No/No | ||||
| The list of data sources this credential has access to. | ||||||
Document
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| id | Number | No/No | ||||
| Internal id of the object. | ||||||
| languageVersionId | Number | No/No | ||||
| Internal unique id of the language version. This id identifies the document uniquely in the system. | ||||||
| languageVersionTitle | String | Yes/Yes | ||||
| The title of the document language version. This title is the one visible as document title in the Browser UI. | ||||||
| languageVersionAbstract | String | Yes/No | ||||
| The abstract (description) of the document. | ||||||
| languageVersionLanguageKey | String | Yes/No | ||||
| The language key in two-string format (en, de, it, fr, etc.) | ||||||
| validBeginInSeconds | Number | Yes/No | ||||
| Unix Time Stamp in seconds until when the document will start to be valid (if “valid” is true). | ||||||
| validEndInSeconds | Number | Yes/No | ||||
| Unix Time Stamp in seconds until when the document will end to be valid (if “valid” is true). | ||||||
| valid | Boolean | Yes/No | ||||
| If true, “validBeginInSeconds” and “validEndInSeconds” will be checked for validity of the document. | ||||||
| landscape | Boolean | Yes/No | ||||
| If true, the document will be displayed in landscape mode. | ||||||
| additionalProperties | Array<AdditionalProperties> | Yes/No | ||||
| languageVersionLanguageId | Number | No/No | ||||
| Id of the language of the document. | ||||||
| archived | Boolean | Yes/No | ||||
| True if the document is archived. | ||||||
| archivedBeginInSeconds | Number | Yes/No | ||||
| Unix Time Stamp from when on the document will be archived (if “archived” is true). | ||||||
| attachments | Array<Document> | Yes/No | ||||
| categories | Array<Category> | Yes/No | ||||
| comments | Array<Comment> | No/No | ||||
| createTimeInSeconds | Number | No/No | ||||
| Unix Time Stamp when the document was created. | ||||||
| documentAttachments | Array<Attachment> | No/No | ||||
| editorType | Number | Yes/No | ||||
| Type of editor used to create the document. | ||||||
| followers | Array<Person> | No/No | ||||
| Persons following the document | ||||||
| languageAttachments | Array<Attachment> | No/No | ||||
| Attachments of the language defined when loading the document. | ||||||
| languageVersionCasId | String | No/No | ||||
| Internal id of the CAS (Content Addressable Storage) | ||||||
| languageVersionCasIdPdf | String | No/No | ||||
| Internal id of the CAS (Content Addressable Storage) of the auto-generated PDF file. | ||||||
| languageVersionCasIdThumbnail | String | No/No | ||||
| Internal id of the CAS (Content Addressable Storage) of the auto-generated thumbnail file. | ||||||
| languageVersionCreateTimeInSeconds | Number | No/No | ||||
| Unix Time Stamp when the document language version was created. | ||||||
| languageVersionCurrentlyInProcessing | Boolean | No/No | ||||
| If true, this document is the newest language version of the document. | ||||||
| languageVersionFileSize | Number | No/No | ||||
| The size in bytes of the documents text (main file)html or markdown). | ||||||
| languageVersionFileSizePdf | Number | No/No | ||||
| The size in bytes of the auto-generated pdf file. | ||||||
| languageVersionFileSizeThumbnail | Number | No/No | ||||
| The size in bytes of the auto-generated thumbnail file. | ||||||
| languageVersionReady | Boolean | No/No | ||||
| If true, this language version cannot be changed anymore. | ||||||
| languageVersionReviewed | Boolean | No/No | ||||
| If true, this language version is reviewed. | ||||||
| languageVersionStatus | Number | No/No | ||||
| Bit mask of the status. | ||||||
| markedAsHelpfulBy | Array<Person> | No/No | ||||
| relatedDocumentIds | Array<Number> | Yes/No | ||||
| removed | Boolean | Yes/No | ||||
| If true, the document is in the trash. | ||||||
| firstReadTimesInSeconds | Map<Number, Number> | No/No | ||||
| A key-value list containing the first read time stamps in seconds (Unix Time Stamp). The key of the map is the account id. | ||||||
| lastReadTimesInSeconds | Map<Number, Number> | No/No | ||||
| A key-value list containing the last read time stamps in seconds (Unix Time Stamp). The key of the map is the account id. | ||||||
| lastWriteTimesInSeconds | Map<Number, Number> | No/No | ||||
| A key-value list containing the last write time stamps in seconds (Unix Time Stamp). The key of the map is the account id. | ||||||
| languageVersionValidBeginInSeconds | Number | No/No | ||||
| Unix Time Stamp in seconds when the document language version will be valid. | ||||||
| languageVersionValidEndInSeconds | Number | No/No | ||||
| Unix Time Stamp in seconds when the document language version will be invalid. | ||||||
| removeTimeInSeconds | Number | No/No | ||||
| Unix Time Stamp in seconds when the document was removed. | ||||||
| reviewUntilInSeconds | Number | Yes/No | ||||
| Unix Time Stamp in seconds until when the document should be reviewed (but currently unused). | ||||||
| responsibles | Array<Person> | Yes/No | ||||
| Person(s) responsible for the document. | ||||||
| roleRelationType | Number | No/No | ||||
| Can be set to Read=1 oder EDIT=2 depending on the permission of the current user. | ||||||
| roleRights | Array<RoleRight> | Yes/No | ||||
| The list of role rights to this document. This defines who has READ or EDIT permissions to the document. | ||||||
| reviewRight | Boolean | No/No | ||||
| If true, the document can be reviewed by the current user. | ||||||
| languageVersionReviewRequested | Boolean | No/No | ||||
| If true, a review is requested for this language version. | ||||||
| snap | Boolean | No/No | ||||
| If true, the document is a snap (Knowledge Flash). | ||||||
| template | Boolean | No/No | ||||
| If true, the document is a template. | ||||||
| bio | Boolean | No/No | ||||
| If true, the document is a person’s biography. | ||||||
| successorId | Boolean | Yes/No | ||||
| The successor id of this document (currently not used). | ||||||
| sumRating | Number | No/No | ||||
| Rating of the document. | ||||||
| extensionValues | Array<ExtensionValue> | No/No | ||||
| Note: Extension values are currently not supported by the standard web UI (v.2.3) | ||||||
| List of extension values. | ||||||
| languageVersionCustomVersionString | String | Yes/No | 2.5.0 | |||
| The custom definable version number of the document. | ||||||
| readConfirmationTimesInSeconds | Map<Number, Number> | No/No | 2.5.0 | |||
Map with key: accountId and value: the confirmation time in seconds of that account |
||||||
| roleRelationReadConfirmationRequested | Boolean | No/No | 2.5.0 | |||
| At least one of my roles are requested for reading confirmation.` | ||||||
| readConfirmationActive | Boolean | No/No | 2.5.0 | |||
At least one of the related roles are set with readConfirmationRequested=true (overall) |
||||||
| languageVersionCasMd5 | String | No/No | ||||
| languageVersionLastChangeInSeconds | Number | No/No | ||||
| languageVersionMimeType | String | No/No | ||||
| languageVersionVersion | Number | No/No | ||||
| mentionedInCommentUnread | Boolean | No/No | ||||
| jsonType | String | No/No | ||||
DocumentChangeLog
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| id | Number | No/No | ||||
| languageVersionCustomVersionString | String | No/No | 2.5.0 | |||
| The version comment of the related document (language-version). | ||||||
| languageVersionVersionComment | String | No/No | 2.5.0 | |||
| The custom version number of the related document (language-version). | ||||||
| dlvVersionComment | Boolean | No/No | 2.5.0 | |||
true, if version comment was changed. |
||||||
| dlvCustomVersionString | Boolean | No/No | 2.5.0 | |||
true, if custom version string was changed. |
||||||
| jsonType | String | No/No | ||||
| action | Number | No/No | ||||
| changeDateInSeconds | Number | No/No | ||||
| dlvAbstract | Boolean | No/No | ||||
| dlvAttachment | Boolean | No/No | ||||
| dlvExtensionValue | Boolean | No/No | ||||
| dlvMainFile | Boolean | No/No | ||||
| dlvPublished | Boolean | No/No | ||||
| dlvReviewRequestDeclined | Boolean | No/No | ||||
| dlvReviewRequested | Boolean | No/No | ||||
| dlvReviewRequestGranted | Boolean | No/No | ||||
| dlvReviewUnrequested | Boolean | No/No | ||||
| dlvTitle | Boolean | No/No | ||||
| dlvValidBegin | Boolean | No/No | ||||
| dlvValidEnd | Boolean | No/No | ||||
| docAdditionalProperty | Boolean | No/No | ||||
| docArchivedBegin | Boolean | No/No | ||||
| docArchivedFalse | Boolean | No/No | ||||
| docArchivedTrue | Boolean | No/No | ||||
| docCategory | Boolean | No/No | ||||
| docLandscapeFalse | Boolean | No/No | ||||
| docLandscapeTrue | Boolean | No/No | ||||
| docLanguageRemoved | Boolean | No/No | ||||
| docPermission | Boolean | No/No | ||||
| docResponsible | Boolean | No/No | ||||
| docReviewUntil | Boolean | No/No | ||||
| docTrashedFalse | Boolean | No/No | ||||
| docTrashedTrue | Boolean | No/No | ||||
| documentId | Number | No/No | ||||
| docValidBegin | Boolean | No/No | ||||
| docValidEnd | Boolean | No/No | ||||
| docValidFalse | Boolean | No/No | ||||
| docValidTrue | Boolean | No/No | ||||
| docVersionRemoved | Boolean | No/No | ||||
| languageVersionId | Number | No/No | ||||
| languageVersionLanguageId | Number | No/No | ||||
| languageVersionLanguageKey | String | No/No | ||||
| languageVersionVersion | Number | No/No | ||||
| person | Person | No/No | ||||
DocumentChangeLogMap
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| map | Map<Number, DocumentChangeLogs> | No/No | ||||
| The document change log map. The key of the map is the start of each day in seconds (Unix Time Stamp). | ||||||
| totalHits | Number | No/No | ||||
| The number of hits. | ||||||
DocumentChangeLogs
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented |
|---|---|---|---|---|
| documentChangeLog | Array<DocumentChangeLog> | No/No |
DocumentClipBoardEntry
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented |
|---|---|---|---|---|
| id | Number | No/No | ||
| languageVersionLanguageId | Number | No/No |
DocumentDuplicate
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented |
|---|---|---|---|---|
| documents | Array<Document> | No/No | ||
| tempFileDescriptors | Array<TempFileDescriptor> | No/No | ||
| originId | Number | No/No | ||
| targetId | Number | No/No | ||
| contextToken | String | No/No |
DocumentForPdfConversion
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| lastAuthor | String | No/No | 2.5.0 | |||
| The last author of the document (version). | ||||||
| publishingDate | String | No/No | 2.5.0 | |||
| The publishing date (formatted string) of the document (version). | ||||||
| reviewer | String | No/No | 2.5.0 | |||
| The reviewer of the document (version). | ||||||
| showLastAuthor | String | No/No | 2.5.0 | |||
| Hint for the pdf generation to show the last author. | ||||||
| showVersion | String | No/No | 2.5.0 | |||
| Hint for the pdf generation to show the version. | ||||||
| showPublishingDate | String | No/No | 2.5.0 | |||
| Hint for the pdf generation to show the publishing date. | ||||||
| showReviewer | String | No/No | 2.5.0 | |||
| Hint for the pdf generation to show the reviewer. | ||||||
| document | Document | No/No | ||||
| mainFile | String | No/No | ||||
DocumentLock
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| id | Number | No/No | ||||
| Internal id of the object. | ||||||
| documentId | Number | No/No | ||||
| lockedByMyself | Boolean | No/No | ||||
| lockedForMe | Boolean | No/No | ||||
| lockTimestampInSeconds | Number | No/No | ||||
| person | Person | No/No | ||||
| previousAccountId | Number | No/No | ||||
| sessionId | String | No/No | ||||
ExtensionValue
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented |
|---|---|---|---|---|
| id | Number | No/No | ||
| jsonType | String | No/No | ||
| key | String | No/No | ||
| type | Number | No/No | ||
| value | Object | No/No |
Highlight
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented |
|---|---|---|---|---|
| fragments | Array<String> | No/No | ||
| indexField | String | No/No |
Instance
The Instance class represents the a set of data of a matterial environment related to an instance owner. The term used in the matterial SaaS environment is Instance whereas in some areas of the API the term DataSource is used. A user can be linked to multiple Instances.
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| id | Number | No/No | ||||
| The identifier of the object. | ||||||
| name | String | 1/255 | Yes/Yes | |||
| The name of the data source. | ||||||
| displayName | String | 0/255 | Yes/No | |||
| The display name of the data source. | ||||||
| active | String | Yes/No | ||||
| Indicates if the data source is active | ||||||
| reference | String | No/No | ||||
| jsonType | String | No/No | ||||
Language
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| id | Number | No/No | ||||
| name | String | No/No | ||||
| The name of the language. | ||||||
| The identifier of the object. | ||||||
| active | String | Yes/No | ||||
| True, if the language is active. | ||||||
| i18nKey | String | No/No | ||||
| The i18n key of the language. | ||||||
| prio | Number | No/No | ||||
| Priority of the language. | ||||||
LoginData
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| pwdSetEnabled | Boolean | No/No | 2.5.0 | |||
If true you are allowed to change your password without knowing the old one (For example after login with MagicLink). |
||||||
| sessionId | String | No/No | ||||
| The current session id. | ||||||
| externallyAuthenticated | Boolean | No/No | ||||
| Is true, if the user was authenticated with en external service (OAuth, LDAP, etc). | ||||||
| currentDataSource | String | No/No | ||||
| The current instance. | ||||||
| favouriteDataSource | String | No/No | ||||
| The favourite instance. | ||||||
| permissions | String | No/No | ||||
| The current user’s permissions. | ||||||
| person | Person | No/No | ||||
| This property represents the current logged in person. | ||||||
| client | String | No/No | ||||
| The current user’s client. | ||||||
| availableLanguages | Array<Language> | No/No | ||||
| availableDataSources | Array<Instance> | No/No | ||||
| All instances the current logged in user has access to. | ||||||
| accountSettings | Map<String, object> | No/No | ||||
| A key-value list with all account settings. | ||||||
| clientPreferences | Map<String, object> | No/No | ||||
| A key-value list with all client preferences. | ||||||
MtrVersion
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented |
|---|---|---|---|---|
| buildNumber | String | No/No | ||
| commit | String | No/No | ||
| info | String | No/No | ||
| major | Number | No/No | ||
| minor | Number | No/No | ||
| moduleName | String | No/No | ||
| patch | Number | No/No | ||
| scmBranch | String | No/No | ||
| timestamp | String | No/No | ||
| timeStampInMillis | Number | No/No |
PasswordContainer
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented |
|---|---|---|---|---|
| passwordCurrent | String | No/No | ||
| passwordNew | String | No/No | ||
| passwordNew2 | String | No/No |
PreferenceMapContainer
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| preferenceDescriptions | Map<String, object> | No/No | ||||
| A key-value list containing the preference descriptions. The key is the same as in Preferences | ||||||
| preferences | Map<String, object> | No/No | ||||
| A key-value list containing the preferences. The key is the same as in PreferenceDescriptions. | ||||||
Permissions
The permissions class is used for Persons an roles.
Implemented since version: 1.0
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| administrateAll | Boolean | Yes/No | ||||
| Administrate all areas of the application. | ||||||
| editPerson | Boolean | Yes/No | ||||
| Edit persons. | ||||||
| editDocument | Boolean | Yes/No | ||||
| Create and edit documents. | ||||||
| editDocumentTemplate | Boolean | Yes/No | ||||
| Create and edit document templates. | ||||||
| editRole | Boolean | Yes/No | ||||
| Create and edit roles and groups. | ||||||
| editCategory | Boolean | Yes/No | ||||
| Create and edit categories. | ||||||
| editTask | Boolean | Yes/No | ||||
| Create and edit tasks. | ||||||
| comment | Boolean | Yes/No | ||||
| Create and edit my comments. | ||||||
| viewArchive | Boolean | Yes/No | ||||
| View archived documents | ||||||
| viewStatistic | Boolean | Yes/No | ||||
| Not used yet. | ||||||
| showTrash | Boolean | Yes/No | ||||
| Show the Administrator’s trash showing trashed documents of all users. | ||||||
| editGallery | Boolean | Yes/No | ||||
| Not used yet. | ||||||
| immediateReview | Boolean | Yes/No | ||||
| Ability to save and review a document in one step. | ||||||
| publishUnreviewed | Boolean | Yes/No | ||||
| Can publish documents immediately without having to request a review. | ||||||
| editAdditionalProperty | Boolean | Yes/No | ||||
| Create and edit additional properties. | ||||||
| editGlobalSavedSearch | Boolean | Yes/No | ||||
| Create and edit global saved searches. | ||||||
| createSnap | Boolean | Yes/No | ||||
| Create a Knowledge Flash (a Snap). | ||||||
| bitmask | Number | No/No | ||||
Person
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| accountId | Number | No/No | ||||
| The unique account id. | ||||||
| contactId | Number | No/No | ||||
| The unique contact id. | ||||||
| accountLogin | String | 1/255 | No/Yes | |||
| The account login (typically the email address). | ||||||
| contactImage | ContactImage | No/No | ||||
| The contact image of the person. | ||||||
| firstName | String | 0/255 | Yes/No | |||
| First name | ||||||
| lastName | String | 0/255 | Yes/No | |||
| Last name | ||||||
| gender | Number | Yes/No | ||||
| Gender. | ||||||
| addresses | Array<Address> | Yes/No | ||||
| Addresses of the person. | ||||||
| birthdayInSeconds | Number | Yes/No | ||||
| Unix Time Stamp of the birthday. | ||||||
| position | String | Yes/No | ||||
| Position | ||||||
| communicationData | Array<CommunicationData> | Yes/No | ||||
| List of Communication data like email, telephone, etc. | ||||||
| contactImages | Array<ContactImage> | Yes/No | ||||
| accountCreateTimeInSeconds | Number | No/No | ||||
| Unix Time Stamp in seconds when the person was created. | ||||||
| accountLastLoginInSeconds | Number | No/No | ||||
| Unix Time Stamp in seconds of the last login. | ||||||
| bioDocument | Document | No/No | ||||
| The biography document. | ||||||
| clients | Array<Client> | No/No | ||||
| The list of clients this person is related to. | ||||||
| rolesContent | Array<Role> | No/No | ||||
| rolesFunctional | Array<Role> | No/No | ||||
| rolesReview | Array<Role> | No/No | ||||
| demo | Boolean | No/No | ||||
| instanceOwner | Boolean | No/No | ||||
| permissions | Permissions | No/No | ||||
| rolePersonal | Role | No/No | ||||
| systemAccount | Boolean | No/No | ||||
| jsonType | String | No/No | ||||
Role
The role class is used to manage roles. There are four different types of roles: Functional, WorkGroup, Personal and ReviewGroup.
Implemented since version: 1.0
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| id | Number | No/No | ||||
| name | String | 1/255 | Yes/Yes | |||
| The name of the role. | ||||||
| description | String | 0/4000 | Yes/No | |||
| The description of the role. | ||||||
| The identifier of the object. | ||||||
| entityTypeId | Permissions | Yes/Yes | ||||
| Note: The system handles WorkGroups, PersonalRoles, ReviewGroups and FunctionalRoles as roles. | ||||||
| The type of role to create. | ||||||
| permissions | Permissions | Yes/No | ||||
| The permissions of the role. | ||||||
| initiallyAssignedToAccount | Boolean | Yes/No | ||||
| If true, the role will automatically be assigned to a new account. | ||||||
| initiallyAssignedTypeToDocument | Boolean | Yes/No | ||||
| If true, the role will automatically be assigned to a new document. | ||||||
| personalRolePerson | Person | Yes/No | ||||
| If the role is of type PersonalRole, this property is set with the person. | ||||||
| jsonType | String | No/No | ||||
| bitmask | Number | No/No | ||||
| clientId | Number | No/No | ||||
| notRemovable | Boolean | No/No | ||||
RoleRight
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| role | Role | No/No | ||||
| The role this role right belongs to. | ||||||
| type | Number | No/No | ||||
| Type of the role right: READ=1, EDIT=2 | ||||||
| readConfirmationRequested | Boolean | Yes/No | 2.5.0 | |||
true if the reading confirmation for this role and the related document is enabled. |
||||||
| jsonType | String | No/No | ||||
SavedSearch
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| id | Number | No/No | ||||
| name | String | Yes/No | ||||
| The name of the saved search. | ||||||
| Id of the object. | ||||||
| dashboardPrio | Number | Yes/No | ||||
| If > 0 then the saved search will be displayed on the dashboard. The actual dashboard priority can be set using the prio function | ||||||
| dashboardStyle | DashboardStyles | Yes/No | ||||
| The style of the dashboard: List=0, ListDark=1, ListLight=2, Columns=3, ColumnsDark=4, ColumnsLight=5, Grid=6, GridDark=7, GridLight=8 | ||||||
| params | Array<SavedSearchParameter> | Yes/No | ||||
| The search parameters. This is a Key-Value list where each item specifies a query parameter key and its value of the search to be executed. See Document Search for details | ||||||
| roleIds | Array<Number> | Yes/No | ||||
| Set the ids of the roles. The permission EDIT_GLOBAL_SAVED_SEARCH is required to set the roleIds | ||||||
| personal | Boolean | No/No | ||||
SavedSearchParameter
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented |
|---|---|---|---|---|
| id | Number | No/No | ||
| key | String | No/No | ||
| value | String | No/No |
SearchAutocompleteSuggest
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented |
|---|---|---|---|---|
| label | String | No/No | ||
| object | Object | No/No | ||
| value | String | No/No |
MtrTask
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| id | Number | No/No | ||||
| The identifier of the object. | ||||||
| description | String | 1/255 | Yes/Yes | |||
| The description of the task. | ||||||
| assignedRole | Role | Yes/Yes | ||||
| Note: This can be either a person or a group role. | ||||||
| The role assigned to the task. | ||||||
| documentId | Number | Yes/No | ||||
| Note: A task can be created without being assigned to a document but the general approach is to always assign a document to a task. Make sure, the correct documentLanguageVersionId is set. | ||||||
| The document assigned to the task. | ||||||
| documentLanguageVersionId | Number | Yes/No | ||||
| Note: When a task is assigned to a document, it has to be assigned to a specific language version. The documentLanguageVersionId must belong to the documentId specified. | ||||||
| The document language version assigned to the task. | ||||||
| taskStatusId | Number | Yes/Yes | ||||
| The id of the task status. | ||||||
| snap | Boolean | Yes/No | ||||
| True if the task was created by a Snap document (Knowledge Flash). | ||||||
| acceptedAccount | Person | Yes/No | ||||
| The person which accepts the task. Accepting a task moves the task to the reponsibility of the person. | ||||||
| dueDateInSeconds | Number | No/No | ||||
| The due date of the task in secoonds (Unix Time Stamp). | ||||||
| jsonType | String | No/No | ||||
| authorAccount | Person | No/No | ||||
| resubmissionTimePeriod | Number | Yes/No | 2.5.0 | |||
| The interval for the resubmission task (in days or months). | ||||||
| resubmissionTimeUnit | Number | Yes/No | 2.5.0 | |||
The unit: 0 days, 1 months. |
||||||
| resubmissionDateInSeconds | Number | Yes/No | 2.5.0 | |||
The next due date for a recurring task. First date could be set manually. All further dates are automatically calculated on action resubmit. |
||||||
| creationDateInSeconds | Number | No/No | ||||
| documentLanguageVersionLanguageKey | String | No/No | ||||
| documentLanguageVersionTitle | String | No/No | ||||
| documentLanguageVersionVersion | Number | No/No | ||||
MtrTaskStatus
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented | ||
|---|---|---|---|---|---|---|
| name | String | 0/255 | No/No | |||
| The name of the object. | ||||||
| id | Number | No/No | ||||
| The identifier of the object. | ||||||
| description | String | 0/255 | No/No | |||
| The description of the object. | ||||||
TempFileDescriptor
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented |
|---|---|---|---|---|
| contextToken | String | No/No | ||
| displayName | String | No/No | ||
| fileName | String | No/No | ||
| fileSize | Number | No/No | ||
| fileToken | String | No/No | ||
| fileType | String | No/No | ||
| languageKey | String | No/No | ||
| mimeType | String | No/No | ||
| tempFileName | String | No/No |
TrackingItem
| Property | Data type | Min/Max | Updateable / Required on create | Version implemented |
|---|---|---|---|---|
| id | Number | No/No | ||
| actionId | String | No/No | ||
| actionType | String | No/No | ||
| appContext | String | No/No | ||
| appInstance | String | No/No | ||
| appType | String | No/No | ||
| changeLog | String | No/No | ||
| creationDateInSeconds | Number | No/No | ||
| objectId | Number | No/No | ||
| objectRef | String | No/No | ||
| sessionId | String | No/No | ||
| userId | Number | No/No | ||
| jsonType | String | No/No |