Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Page Properties
hiddentrue
idPROGRESS

Product Version
Report Note
AssigneeInga

Resources & Remarks

  • 16 Jan 2020 - page created (Inga)
    ToDo - short term - the information of the endpoints should be available as a brief overview (similar to the core API overview endpoint tables). A link to the provided Swagger UI should point the system integrator as well as the administrator into that direction. Background - if you do not have the yuuvis® installed yet the Swagger UI won't be available (e.g. https://momentum23.enaioci.net/api-web/swagger-ui.html#/).

    Located in https://help.optimal-systems.com/yuuvis_develop/pages/viewpage.action?pageId=40141818 all available controller should be described somehow - including the information from the Jira issues's description (https://jira.optimal-systems.de/browse/DOKU-761)

    Note: for accessing the admin-controller special roles are needed for the Administrator. Similar behavior for the System Integrator - a special role needs to be assigned to be able to set up calls - check the rights for the other controller as well ...

  • For a quick try out without the need to install yuuvis® Momentum, consider our yuuvis® Ultimate SaaS (Software as a Service) offer. Keep in mind that you need to set up a (free) account.

    (error) LINK to the SWAGGER UI and back ...

Modification History

NameDateProduct VersionAction
Antje08 FEB 20212.4New page properties macro.


...

user-controller - manger user specific information
HTTP Method
as of product version
PurposeResponse FormatDescription

admin-controller (manage tenant resources)

GET
as of 2021 Summer
getCatalogNames - returns names of the all global and tenant catalogs.JSON/api/admin/dms/catalogs
GET
as of 2021 Summer
getCatalog - Returns a catalog by a name. Returns null if there is no catalog with this name.JSON/api/admin/dms/catalogs/{qname}
POST
as of 202
1 Summer
postCatalog - Safes a catalog.HTTP status code/api/admin/dms/catalogs/{qname}
PATCH
as of 2021 Summer
updateCatalog - Updates a catalog.JSON/api/admin/dms/catalogs/{qname}

GET
as of 2020 Autumn

getForm - retrieves form by object type (question)JSON

Returns not enriched form by type, situation and for specified tenant. Returns null, if there is no designed form model for the given type and situation.
/admin/form/{objecttype}

POST
as of 2020 Autumn

postForm - saves not enriched form (question)

JSON

Saves not enriched form.
/admin/form/{objecttype}

GET
as of 2020 Winter

getConfig - The request returns a admin configuration (question)JSON/api/admin/resources/config/{name}
POST
as of 2020 Winter
postConfig - This Request updates a tenant client configurationHTTP status code/api/admin/resources/config/{name}
GET
as of 2020 Autumn

getIcon - retrieves icon resource

SVG

This request returns an icon resource as SVG image.
/admin/icon/{path}

POST
as of 2020 Autumn

postIcon - updates the icon resource

SVGThis Request update icon for the specified path.
/admin/resources/icon/{path}
GET
as of 2020 Autumn

getLocalizedTextResources - retrieves text resources

JSONThis request retrieves localized text resources for the Accept-Language.
/admin/resources/text
POST
as of 2020 Autumn
postLocalizedTextResources - updates text resourcesJSONThis Request update localized text resources for the specified tenant and locale.
/admin/resources/text/{locale}
GET
as of 2020 Autumn

getSupportedLanguages - retrieves all languages

JSON

This request returns all supported languages for tenant resources.
/admin/resources/text/languages

bpm-controller (manage process instances)

GET
as of 2020 Autumn
getProcessInstances - retrieves process instancesJSONList of process instances
/bpm/process/instances
POST
as of 2020 Autumn
createProcessInstance - starts a process instanceJSONStart a process instance
/bpm/process/instances
DELETE
as of 2020 Autumn
delete dms object - deletes dms objectdelete dms object
/bpm/process/instances/{processInstanceId}
POST
as of 2020 Autumn
getTasks - retrieves a list of process instancesList of process instances
/bpm/tasks
GET
as of 2020 Autumn
taskActionsTasks actions

Tasks actions
/bpm/tasks/{taskId}

dms-controller (manage DMS objects)

GET
as of 2020 Autumn
getMetadata - retrieves dms object's metadataJSONReturns a dms object metadata.
/dms/{id}
DELETE
as of 2020 Autumn
delete dms object - deletes dms objectdelete dms object
/dms/{id}
GET
as of 2020 Autumn
getContent - returns dms object's contentReturns a dms object content.
/dms/{id}/content
GET
as of 2020 Autumn
getAllVersions - retrieves a dms object with all versionsReturns a dms object dms object with all versions.
/dms/{id}/versions
GET
as of 2020 Autumn
getMetadata - retrieves dms object's metadata of a specific versionJSONReturns a dms object metadata for specific version.
/dms/{id}/versions/{version}
POST
as of 2020 Autumn
create - creates a dms objectJSONcreate dms object
/dms/create
GET
as of 2020 Autumn
getForm - retrieves form by object typeJSONReturns a form by type and a situation. A default form will be created, if there is no designed form model for the given type and situation.
/dms/form/{objecttype}
POST
as of 2020 Autumn
searchrequests objectsJSONrequests objects
/dms/search
PATCH
as of 2020 Autumn
updateupdates dms objectJSONupdate dms object
/dms/update/{id}
POST
as of 2020 Autumn
update content of dms object

update content of dms object
/dms/update/{id}/content

resource-controller (retrieve resources)

GET
as of 2020 Autumn
getIcon - retrieves icon resource

This request returns an icon resource as SVG image.
/resources/icon/{path}

GET
as of 2020 Autumn
getLocalizedTextResources - retrieves text resourcesThis request retrieves localized text resources for the Accept-Language.
/resources/text

system-controller (manage global resources)

GET
as of 2020 Autumn

getForm - retrieves form by object typeJSON

Returns not enriched form by a global type, situation and for specified tenant. Returns null, if there is no designed form model for the given type and situation.
/system/form/{objecttype}

POST
as of 2020 Autumn

postForm - saves not enriched form

JSON

Saves not enriched form.
/system/form/{objecttype}

GET
as of 2020 Autumn

getIcon - retrieves icon resource

SVG

This request returns an icon resource as SVG image.
/system/icon/{path}

POST
as of 2020 Autumn

postIcon - updates the icon resource

SVGThis Request update icon for the specified path.
/system/resources/icon/{path}
GET
as of 2020 Autumn

getLocalizedTextResources - retrieves text resources

JSONThis request retrieves localized text resources for the Accept-Language.
/system/resources/text
POST
as of 2020 Autumn
postLocalizedTextResources - updates text resourcesJSONThis Request update localized text resources for the specified tenant and locale.
/system/resources/text/{locale}
GET
as of 2020 Autumn

getSupportedLanguages - retrieves all languages

JSON

This request returns all supported languages for global resources.
/system/resources/text/languages

GET
as of 2020 Autumn
getUserInfo - retrieves the user information by userIdJSONThis Request retrieves the user information of the requested user.
/user/{userId}/info
GET
as of 2020 Autumn
getResultListConfiguration - retrieves result list configurationJSONReturns a result list configuration by type. (question) Inga - result list = hit list (question)
/user/config/result/{type}
POST
as of 2020 Autumn
saveResultListConfiguration - saves a result list configuration for a user
Saves a result list configuration for the user by type.
/user/config/result/{type}
GET
as of 2020 Autumn
getGlobalSettings - retrieves the global settings by section nameJSONThis request retrieves the global settings with the section name.
/user/globalsettings/{section}
POST
as of 2020 Autumn
saveGlobalSettings - saves global setting for a section
Saves a global settings by a section.
/user/globalsettings/{section}
GET
as of 2020 Autumn
getGeneralSettings - retrieves the general settings of the userJSONThis request retrieves the general settings of the requested user.
/user/settings
POST
as of 2020 Autumn
saveGeneralSettings - saves the general setting for the user
Saves a general settings for the user.
/user/settings
GET
as of 2020 Autumn
getSettings - retrieves the settings of requested userJSONThis request retrieves the settings of the requested user in user matching the section name. (question) Inga: verstehe ich nicht - Lesen der Konfigurationsdaten kann für den angemeldeten Benutzer und Sektion erfolgen (question)
/user/settings/{section}
POST
as of 2020 Autumn
saveSettings - saves user setting by section
Saves a settings for the user by a section. (question) Speichern der Konfigurationsdaten für den angemeldeten Benutzer pro Sektion im JSON-Format (question)
/user/settings/{section}
GET
as of 2020 Autumn
getUsers - retrieves user matching the search stringJSONThis Request retrieves all users matching the search string.
/user/users
GET
as of 2020 Autumn
whoAmI - retrieves current user's infoJSONThis request retrieves the user information of the current logged in user. (question) Das Lesen von Benutzernamen und E-Mail etc.  (question)
/user/whoami