Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 39 Next »

An overview of the features provided by yuuvis® Momentum client as reference implementation to demonstrate the usage of the developer libraries.

Table of Contents

Introduction

yuuvis® Momentum client as reference implementation is an Angular application that is structured in multiple components. Each of them implements a specific area of the client application using the functionality provided by the components of the developer libraries.

In the header area, you will find the yuuvis® Momentum bar with icons for the most frequently used features.

Main menu icon

Main menu

yuuvis icon

If you left-click the yuuvis® icon while pressing Ctrl, a new tab will open with another dashboard in your browser. If you left-click the yuuvis® icon in the hit list, folder, or object view, the dashboard will appear again.

Create icon

Create object

Search icon

Search (not displayed in case of the Dashboard view)

Settings menu icon

Settings menu

Dashboard

In the middle of the dashboard, you will find the multi-part search input field.

In the footer area, the objects that you recently created or edited are displayed in the form of a tile row. Click the Recently created or Recently edited buttons below the tile row to select which objects you want to view. If you click the More... button to the right of the objects listed in the footer area, the listed objects are displayed in a hit list.

Navigation by Keyboard

In addition, most of the commands can be activated (even without a mouse click) at any point of the user interface via the command palette interface by hitting Ctrl twice (Quick Access). If a string is entered there, all commands containing this string are filtered.
Example: An input of "si" lists among others both Create: Sick note, and Create: Document (classified).

Menus

Main Menu

You can access the main menu using the Main menu icon on the yuuvis® Momentum bar. You can access the following areas via the main menu:

  • Dashboard

  • Create object

  • In-tray

  • Inbox

  • My follow-ups

  • My processes
  • Settings

  • About

Object Actions Menu

Various actions are available for editing documents and folders via this menu, depending on the context and your permissions. It is available in different areas, such as in hit lists, in the folder view, and in the object view, via the Actions menu iconObject actions icon.
>> ActionMenuComponent

The suggested actions and processes always refer to the selected object(s). If you select several objects in an object list (such as in a hit list) and then click the Object actions icon in the area window of the object list, you can apply an action or a process to several objects.


Replace document file icon

Add as new version

Adds a document file to the marked object in a hit list or in a folder view. Adding a document file automatically creates a new document version.

Copy to clipboard icon

Copy to clipboard

Copies links from one or more selected objects to your operating system's clipboard.

Delete icon

Delete

Deletes the selected object. Deleted items cannot be restored.

Download document file icon

Download document file

Downloads the document file of one or more selected objects to the local file system in the original format.

Follow-up icon

Manage follow-up

Creates follow-ups for a selected object or opens the dialog for modifying, deleting or confirming follow-ups.

Move icon

Move

Exchange the parent folder of a document. It is also possible to unassign the current parent folder such that the document will not have any parent objects anymore.

Open in context icon

Open in the folder/Open

Opens the selected object’s parent folder view. The object view will be opened for document files without a parent folder.

Show references icon

Show references

Displays an overview of the objects that reference the selected object.

Versions icon

Show versions

Opens an overview of all versions of the selected object. You can select two versions in the version list to compare them side by side. The action is not offered if the selected object only has one version (see Object Versions).

Set as current version

This action is available when a Version View is displayed.

In an additional section MORE ACTIONS, plug-in actions can be available if configured by an administrator.
>> PluginConfigList Interface

Settings Menu

Configure the main settings of your yuuvis® Momentum client. Open the settings menu by clicking the Settings menu in the yuuvis® Momentum icon bar and select Settings from the dropdown menu. Alternatively, you can also open the settings menu via the Main menu.

The following information and configuration settings are available in the settings menu:

  • Language
    You can use the English and German buttons to control the language display of the general user interface elements and the object types, menus, fields, and catalogs specifically configured for your company.
  • Permissions
    The drop-down menu Roles indicates the roles that are assigned to the currently logged in user.
  • Layout
    Customize the design of the client layout to your personal preference.
    • Theme, Accent color and Dashboard background image
      Choose between a light and a dark design, set an accent color, and upload a background image. This setting is stored on your device, meaning you can work on different devices with different layouts.

    • Export, Import and Reset
      You can also use the layout settings for other clients by clicking the Export button. Similarly, you can transfer the layout settings from other clients to yours by clicking the Import button. Click the Reset button to delete all of your individual layout settings.

  • Configuration
    Edit Hit listsSearch filters and Cache.

>> LayoutService

Hit List Configuration Menu

You can modify the hit list’s appearance and save it. You can configure a hit list for each individual object type as well as for mixed hit lists (hit lists with more than on object type). Run a search request for an object type and open the Settings icon Configuration menu in the hit list if you want to configure the appearance of the hit list for this object type. Follow the same steps to configure mixed hit lists.

You can save the following changes in the configuration menu:

  • the columns that are shown/hidden in a hit list,

  • the order in which columns are shown, and

  • the columns that are to be pinned or sorted.

Press Save button to store the changes, the Cancle button to discard the changes made or the Reset to default button to restore the original configuration.

Alte Version: If you click to change the sorting in a hit list, this adjustment is will applied when you open the hit list configuration menu and you will be asked if you want to save it. Clicking the Reset button in the hit list configuration menu will reload the hit list configuration of the object type that was saved originally.

The saved hit list configuration is applied to each new hit list of the configured object type.

>> ColumnConfigComponent

Filter Configuration Menu

The menu provides a graphical interface to configure your filters. It is accessible via the filter area in the hit list view or via the Settings menu. All users can configure user-defined filters that are only available to themselves.

Users with the role YUUVIS_MANAGE_SETTINGS can additionally configure default filters that are available for all users across the entire system (via the Settings menu).

The configuration menu consists of the following areas:

  • Header area
    • The header area displays the object types for which you configure a filter.
    • You can configure cross-context filters or filters limited to one object type.
  • Filter list
    • The filter list shows you the available default filters and the filters you have configured.
    • Custom-configured filters are highlighted in bold in the list.
    • The filter list is divided into the areas Custom filters, Enabled filters, and Deactivated filters.
  • Configuration area
    • The configuration area displays the configuration of the filter you have selected in the filter list.
    • This is where you can also configure your own filters.

You can create the following types of filters:

  • Object-specific filters
    • Only valid for a specific object type.
    • Only the filter fields of the corresponding object type are available in addition to the basic data filter fields.
  • Cross-context filters
    • Apply to several or all object types.
    • Different filter fields will appear depending on which object types are contained in the object list in which you open the filter configuration menu.

To keep the filter display in the filter area clear, you can activate and deactivate the default and saved filters. Deactivated filters will then no longer be displayed in the filter area. These settings apply to the filter areas of all object lists.

You can also delete filters you have created and saved. Default filters cannot be deleted.

>> SearchFilterFormComponent

Catalog Edit Menu

Catalogs are used to offer a selection list of predefined values for metadata fields in an object's Metadata aspect area.

You require the role YUUVIS_MANAGE_SETTINGS to be able to edit catalogs indicated by the Pencil icon Pencil icon in the client. If you click on this type of icon, the edit menu opens for the catalog in which the following features are available.

Add entry

You can create new catalog entries using the entry field in the header area of the edit menu.
Remove icon

Delete a catalog entry by clicking the remove icon. If you delete a catalog entry in the catalog edit menu, the catalog values cannot then be deleted in the metadata forms. Catalog values orphaned by deletion are marked red in the metadata form and by a red Remove icon.

 / 

This checkbox allows you to control whether a catalog entry is displayed in the metadata form or not.

Sort feature icon

If you click this icon, you can drag and drop the line of the catalog entry to where you want it to be in the list of catalog entries.

>> DynamicCatalogManagementComponent

Object Aspects

Objects contain various information that are displayed in units called object aspects. They are summarized in a form with a header area and multiple tabs containing the individual object aspects.

The header area contains a title and description (if available) and the following icons:

 ....

Visualizes the object type.

Refresh the object aspects.

Actions menu icon

Object action menu.

The layout of the object areas can be customized. If you have changed the number and the width of the aspect areas, these changes will be saved automatically when you switch views.

Split aspect icon

Split aspect. The view splits and several aspect areas are displayed next to each other. You can use the separator bar between the aspect areas to adjust the size of the displayed areas.
Undock

Only available for the Content aspect. Open the content preview in a separate browser window.

Close icon

The aspect area will revert back to normal.

The following object aspects are available.

>> YuvObjectDetailsModule

Summary aspect area

Displays the object properties (basic metadata, type metadata and tags) of an object, such as name, editor, number of versions, file size, etc. The information is divided into the areas Basic metadata, Type metadata, and Administrative information.

If more than one version of a document exists, you can also click the highlighted version number to access the version view.

Metadata aspect area

The Metadata aspect area offers the option of editing the type metadata of the selected object, provided that you have the appropriate rights.

History aspect area

The History aspect area provides a view of the creation process as well as the editing and usage history of an object. It contains a chronological list of who, for example, made which changes to the content or type metadata of an object and when. The output (download and read) of an object is also logged in the aspect area. You can filter the events of the editing history, if needed. The entries in the history also contain links to the versions of the document. You can open the version view by clicking one of these links.

The entries in the history can be filtered by

  • limiting the date to a time period using the operators (>, <, =, -) or
  • specifying a type of action via the checkboxes. Clicking a group name will select all history entries of this group.

If a user should additionally get displayed in the history view if the object was just viewed (READ), the role YUUVIS_MANAGE_SETTINGS must be assigned to this user.

Content aspect area

The Content aspect area offers a content preview of the selected document. Different content previews are used depending on the file type of a document file. If no file-specific preview is used, the document rendered to a PDF by yuuvis® Momentum is displayed in the PDF content preview by default. If a PDF cannot be rendered, nothing is displayed in the content preview.

 Open supported formats...
FormatMime typeComment
Audiompeg, mp3, ogg, wavAudio files are played by the browser with HTML5 audio by default. All played files are streamed to avoid unnecessary data downloads.
E-mailsmessage/rfc822 (eml)emlfiles are analyzed by MailParser. Unsupported file types are offered for download.
Imagejpeg, gif, png, svg, bmp, icoCustom Angular application with Angular-X image viewer plug-in. Supported mime types are rendered by the browser in the default HTML tag img by default. Unsupported file types are offered for download.
JSONapplication/jsonCustom Angular application with ngx-json-viewer plug-in.
Markdownx-web-markdown, markdownCustom application with markdown-to-JSX plug-in and custom angular application with showdown plug-in.
Open Officeodt (texts), ods (tables), odp (presentations)Files are analyzed and rendered from https://webodf.org/. The ODFs are currently resolved as application/zip. The viewer also analyzes the mime types and reacts to the file extension that must be specified.
PDFapplication/pdfPDF.js - JavaScript-based PDF viewer from Mozilla. PDF.js support is also supported by the yuuvis® API
TextplainPlain text is rendered by the browser by default.
Videompeg, mp4, ogg, webmVideo files are played by the browser with HTML5 video by default. All played files are streamed to avoid unnecessary data downloads.
XMLxmlXML is rendered as text by the browser by default.

The Version View

If type metadata is modified or the document file is edited, replaced, moved, or deleted, then new versions of the object are created. The older versions are retained. All versions of an object can be managed in the version view.
>> VersionListComponent

There are a number of ways to open the version view:

  • Via the Object actions menu, if the selected document has more than one version

  • In the object area via the link on the version number in the Summary aspect area.

  • Via the links on the version numbers in the History aspect area.

The version view shows a list of all versions. Select a version to display its version-specific object information in Object aspect areas as described above. If two versions are selected in the list, you can compare them in the tabs Changes to metadata and Changes to content where you have a number of actions available for a visual comparison.

The slider in the center helps you find the differences. If you move your mouse over the slider, a drop-down menu will offer you more comparison options.

Slider icon

Drag the slider left and right to resize the images.

Slider icon
Displays both images instantly.

Slider icon

Layers both images on top of each other so that you can use the sliders to display one image and then the other.

Slider icon

Only displayed when both images are superimposed. Clicking the icon reverts the view back to normal.

An older version can be set as the current version. To do this, select the desired version with a single mouse click and set it as the current version in the object action menu with Versions iconSet as current version. Refresh the version status afterwards.

Creating Objects

You require the YUUVIS_CREATE_OBJECT role to be able to create objects.

You can create objects (folders and documents) in stages. This procedure is especially useful if you create a lot of objects in a short space of time that you do not want to complete until later.

>> ObjectCreateComponent

Creating Documents

The following options are available for you to create documents:

  • via the yuuvis® Momentum bar

  • via the Main menu

  • via drag and drop

The following information is relevant for any document creation.

Parent Folders

If you want to create a document, the first thing you have to decide is if you want to define a folder as parent object. For this purpose, you first need to display the folder object you want to specify as parent for your new document. Once you have opened the right folder, you can create one or more documents as child objects in the folder via the yuuvis® Momentum bar or by dragging and dropping.

The new document will not have a parent object

  • if you did not open a folder before creation, for example, if you are on the dashboard, in hit lists, in a document's object view or
  • if you created it via the Main menu.

Document Object Types

You can find out which document object types are available for you in the object creation dialog. One of the basic properties of the document types is that they may or may not contain a binary content file.

A distinction is also made between the following object types, particularly with regard to the creation process:

  • Simple object types
    • Simple object types are the fastest way to create documents.
    • The object type is assigned when the object type is selected.
    • The main difference between the object types is that you do not get a preview of the uploaded file during the creation process.
  • Variable object type with fixed object type assignment
    • This object type offers you a preview of the uploaded file during the creation process.
    • This gives you the chance to check which file and object type you have selected again.
  • Variable object type with subsequent object type assignment
    • For this object type, you can assign the object type after the creation process.
    • In the first step of the creation process, only a small amount of general type metadata is entered and the document is created.
    • You can assign the final object type at a later point, depending on the configuration of the variable object type.

Artificial intelligence can be used to create documents with variable object types regardless of how your yuuvis® Momentum system and individual object types are configured. This will appear in a suggestion list during object type assignment. The AI used gives the suggested object types a weighting based on machine learning.
>> Artificial Intelligence Platform

Upload Status

If you upload files, this is indicated by the  Upload status icon in the yuuvis® Momentum bar. Click the icon to view the names and status of the files uploaded in a menu. A green tick behind an entry indicates that the upload process was successful. Click the Remove icon to remove entries from the list to get a better overview. The  Upload status icon will no longer be displayed once all of the entries have been removed from the list.

Cancelling the Creation Process

There are several ways to cancel the creation process:

  • Click Cancel during the creation process. In the form that opens you can:

    • delete the object (Remove object button). The incomplete object is permanently deleted. The files uploaded and/or type metadata entered up to that point will be lost.

    • place the file in the in-tray (Store in in-tray button) The incomplete object, including all type metadata entered and/or all files uploaded up to this point, is placed in the in-tray. You can continue and complete the creation process at a later time.

  • Click the yuuvis® logo in the yuuvis® Momentum bar, which is part of the main menu, or an entry in the settings menu during the creation process. Click OK on the form that opens to permanently delete the incomplete object. The files uploaded and/or type metadata entered up to that point will be lost.

Filing E-mails and Attachments

There are many ways and options available to file e-mails and e-mail attachments. You can file e-mails together with their attachments or file the e-mails and attachments separately. You can upload e-mails from the local file system or drag and drop.

You will need to keep a few things in mind when filing e-mails directly from an e-mail program via drag and drop. Whether or not drag-and-drop filing of e-mails from an e-mail program directly into the client is possible depends on the e-mail program and the browser you are using. For example, the drag-and-drop filing of e-mails from Microsoft Outlook is supported if the client is running in a Google Chrome browser. In this case, the e-mail is filed in yuuvis® Momentum in the same file format (*.msg) in which it is transferred from Microsoft Outlook. Filing an e-mail in the MSG file format has one distinct disadvantage in that the content preview will differ slightly from the filed e-mail.

If you are working with a different browser, say Firefox for example, and would like to file e-mails via drag and drop, then it is best to use the Outlook Add-In for Drag & Drop from OPTIMAL SYSTEMS. It enables drag-and-drop filing, ensuring that e-mails that are dropped onto the client are transferred as EML files so that the content preview generates a more accurate view of the filed e-mail. If you are interested in this add-in, please contact your partner at OPTIMAL SYSTEMS.

Save e-mail attachments in the local file system before uploading them to yuuvis® Momentum. The next steps required to file e-mail attachments from the local file system are similar to those used to create documents in the client. The use of drag and drop to file attachments stored in the local file system is also supported.

Creating Folders

Folders can be created via the yuuvis® Momentum bar as well as via the Main menu. You cannot create another folder in a folder.

You cannot change a folder’s type after it has been created. If you want to change the folder type again during creation, you can return to the object type selection by clicking in the breadcrumb trail in the header area of the form.

If you want to cancel the creation process and leave the form, click an icon on the yuuvis® Momentum bar.

Editing Objects

You require the YUUVIS_CREATE_OBJECT role to be able to edit objects.

In-tray - Assigning Final Object Types

Variable object types are the starting point for this. For these object types, you can assign incomplete objects to the object type after the creation process. In the first step of the creation process, only a small amount of general type metadata is captured and the object is created. You can assign the final object type at a later point, depending on the configuration of the variable object type.

All incomplete objects are listed in the Main menu in the in-tray. If you select an object in the list of incomplete objects in the in-tray, the object aspects will be displayed. You can see which additional options are available for the selected object by the buttons displayed in the Metadata aspect area:

  • Assign object type button: You can assign a final object type to the object.

  • Extend button: You can extend and reduce the type metadata of the object.

If the Assign object type button is displayed in the Metadata aspect area, then you can assign an object type to the object. You can only assign an object type to an object once and this cannot be changed. After you have assigned an object type to an incomplete object, the Assign object type button will no longer be displayed and the object will be removed from the list of incomplete objects.

Adding or Replacing Binary Content Files

You can replace binary content files assigned to document objects with a new file, for example if a copy of the file was modified outside of yuuvis® Momentum and you would like to overwrite the file in yuuvis® Momentum with the new version. To do this, you have to upload the new file from the operating system to yuuvis® Momentum and add it to the document object as a new version.

The following options are available for you to add document files:

  • Use the Add as new version function in the Object actions men.

  • Drag and drop.

If you want to add the binary content file of another object, then you will need to first download this file to your local file system using the object actions menu before you can add it to another object as a binary content file again.

Editing Metadata

Entries for type metadata are made and maintained via fields in metadata forms. You can enter type metadata both during and after object creation in the Metadata aspect area. Variable object types also have the property that you can extend or reduce the metadata forms at any time. When an object is created, the object type is determined and the metadata form is filled out.

For documents, the Metadata aspect is displayed in hit lists and folder views (if a folder is specified as parent object), for example, if you have selected the corresponding document.

For folders, you can also show the Metadata aspect area in hit lists if you have selected the corresponding folder. In the folder view, you must click the folder name in the header of the structure area to display the Metadata aspect area.

Metadata Form Fields

The form fields are configured by the administrator. Notices are shown if entries in fields and references between fields do not match these specifications.

Only integers from -231 to 231-1 (i.e., from -2,147,483,648 to 2,147,483,647) may be entered in the metadata form. Entries that fall outside this range will cause rounding or other errors.

Catalog fields

Catalog entry. Selection from a suggestion list after one character has been entered or via the catalog. For hierarchical catalogs with entries in layers, the administrator configures whether the entries for all layers are accepted or only the entry for the lowest layer. Free inputs are not accepted.

If a Pencil icon Pencil icon is displayed, you can open it in the catalog edit menu.

Catalog values marked in red are catalog values that can no longer be assigned to a catalog entry due to adjustments made to the catalog. Click on the red Remove icon Remove icon to delete it.

Checkboxes

Checkboxes have either the status 'active' or 'not active'. On an administrative level, the additional status 'neutral' can also be integrated.

Switches

Alternative visualization of checkboxes with an intuitive representation of the 'neutral' value, i. e. null.

= false      = null    = true

Date fields

Date. Free input or via the Calendar icon Calendar icon.

The format of the date varies based on the user’s language settings. If you click in a date field, the date format to be entered will be displayed.

German: DD.MM.YYYY

English: MM/DD/YYYY

E-mail fields

E-mail addresses must be entered in full and contain the  at character. Placeholders and so on are not supported. E-mail addresses are not case sensitive. To enter multiple e-mail addresses, press Enter to confirm your entry.

Sample entry: employee@optimal-systems.de.

Click the E-mail icon E-mail icon to create an e-mail with this address in the local e-mail application.

ID fields

User or group. Selection from a suggestion list after two characters have been entered.

Free inputs are not accepted.

Mandatory fieldsMandatory fields must be completed, which is why they are indicated by an asterisk.
Numerical fieldsDigits. The maximum number of digits and decimal places is defined.
Tables

Entry via a dialog. New rows are added at the bottom. Double-clicking a row opens the dialog for editing or deleting the row. The content of metadata tables can be exported as a *.CSV file.

Telephone fields

To enter multiple telephone numbers, press Enter to confirm your entry.

URL fields

Addresses in URL fields must begin with the protocol information, e.g., http://, https://. Web addresses must be entered in full. Placeholders and so on are not supported. Web addresses are not case sensitive. To enter multiple web addresses, press Enter to confirm your entry.

Sample entry: http://www.optimal-systems.de.

The URL can be opened in the browser by clicking the www icon www icon.

Tables in Metadata Forms

The following customization options and functions are available for tables in metadata forms:

  • Sort by column: If you click the header of a column, the table will be sorted by the contents of the column. Clicking the header again undoes the sorting. Tables in metadata forms can only be sorted by the content of a column.
  • Optimal column width: If you click the right column separator of a column, the column will be adjusted to the optimal width.
  • Edit table row: The table will be opened in a new form with an input area in full view to make editing easier. The row that is clicked is also highlighted in the opened form. The values of the row you have clicked are already entered in the form for editing or for adding a new row.
  • Align table columns: All columns in the table will be adjusted to the optimal width.
  • Open table: The table will be opened in a new form in full view to make editing easier. If you select a row in the opened form, the input area for editing the row is also displayed.
  • Export spreadsheet data to CSV file: The table will be exported in CSV file format.
    • Text fields are in output in quotation marks (e.g., "abc").

    • Date and time fields are output in ISO format 8601.

    • Decimal numbers are formatted in the language the user has specified.

    • Values from reference fields are output as object IDs.

    • Values from users are output as user IDs.

    • Boolean values are output as FALSE and TRUE or empty/NULL.

  • Insert new row: The table will be opened in a new form with an input area in full view to make editing easier.

Prepopulated Metadata Fields

Certain fields in the metadata forms may already be prepopulated when objects are created. The administrator defines which fields are prepopulated. These fields are specially indicated in the metadata forms when objects are created. Manually entered data has priority, i.e., it overwrites automatically imported data in case of conflict. There is a distinction made between two types of prepopulated metadata fields:

  • Object type-specific prepopulated data
    Metadata fields that are yielded by the object type’s configuration can be prepopulated depending on the object type. This can be prepopulated data from free text inputs, catalogs, scripts, or additional components. Metadata fields that are prepopulated by the object type definition are indicated by a df during the creation process.

  • Extracted prepopulated data
    Specific data from the metadata of the files (such as title, creation date, author, etc.) may be automatically extracted and written to the metadata, depending on the configuration of your yuuvis® Momentum system, when uploading files. Object type-specific prepopulated data will be overwritten during this process. Metadata fields that extract index data from the metadata of uploaded files are indicated by an ex during the creation process.

Object-specific and extracted prepopulated data is transferred as follows:

  • If both a default value and an extraction are defined for a field, then the data for the extraction (if this is available) is transferred during the creation of an object in yuuvis® Momentum client; otherwise the default value is transferred to the metadata form.

  • No extracted data will be shown in the metadata fields indicated as such for files to be filed as a batch. If you enter information in these fields, it will overwrite all extracted data. If you do not enter anything in these fields, all of the extracted data (if this is available) will be transferred; if this is not available, the default value will be transferred to the metadata form.

  • If the document file is later replaced, the extraction will be repeated. Existing data in fields configured for a mapping will be replaced or – if no new value is found – removed.

References

In metadata forms, the metadata of another object can be transferred into certain fields, which are known as reference fields. These fields reference the ID of certain objects and therefore are retained even if the referenced object is renamed or moved. The administrator configures reference fields, and they are set up for several values as multi-fields.

References that have been set up are displayed both in hit lists and in the Summary and Metadata aspect areas. They are indicated in hit lists and in the aspect areas with a Reference icon Reference icon. Click the icon to quickly open the referenced objects. If you hold down the Ctrl key while clicking, the location of the referenced object will be displayed in a new tab.

You can create and remove references in the Metadata aspect area.

If a referencing object is located in a folder, you can jump to the filing location of the referenced object by double-clicking the list entry. If the clicked object is located in the main directory, the object view of the referencing object will open.

If a user does not have any rights to a referencing object, this will also not be displayed for this user. If a user has read access to a referencing object, but not to the folder in which the object was filed, then the user is only offered the object view for the object.

Searching

You can start search requests on any page. The search dialog is available for this purpose on the dashboard and in the yuuvis® Momentum bar. Following options are available and can also be combined:

A drop-down menu to the left of the search input field to limit your search to selected object types.
Search term

Full-text search for terms that you think might occur in the objects you are looking for. Searches the contents of document files as well as the string fields within metadata of objects. Especially, number and date fields are not taken into account in the full-text search.

Expand the search conditions. Search for specific properties of objects, such as
  • Basic metadata (creator, editor, created on, version, file size/type, etc.)

  • Type metadata (title, description, subject, first/last name, etc.)

  • Tags (status of an object within a technical process)

The Filter area in the Hit List view uses predefined filters. In addition, in the filter in the yuuvis® Momentum bar the search criteria can be changed. These settings are not saved and are only available for the current session.

Search icon

Run the search request.

The search links all search terms on search forms and all limitations on object properties and object types with AND by default. If you are using multiple object types in the search, they are linked in the search by OR. In the search dialog, you can change the logical operator of multiple search terms or criteria to OR and/or create nested searches.

>> QuickSearchComponent

Hit List View

The results of a search will be displayed in a hit list of all objects that were found. The hit list view is divided into the areas described below. You can sort, filter, and configure the hit list. Search results are sorted lexicographically. This means that sorting is case-sensitive and special characters are accounted for. Depending on the configuration, the hit list will contain several columns with basic metadata, type metadata, tags, such as type, title, description, editor, etc. The view of a hit list always corresponds to the hit list configuration of the selected object type.

>> SearchResultPanelComponent

Header area

Settings icon

Hit list configuration Menu. You can add or remove columns via the Hit list configuration menu in the header of the hit list.

Refresh the hit list.

Actions menu icon

Object actions menu. If multiple objects are selected, the action will be applied to all of them.

Hit list area

Hit list

The hit list presents the results of a search request in a table per default. It contains several columns containing basic metadata, type metadata, and tags with information such as object type, title, description, editors, etc.

The appearance of this table can vastly differ, depending on the search, configuration of object types, or configuration of the hit list. This means that the view of a hit list always corresponds to the hit list configuration of the object type currently selected in the hit list.

Using your mouse, you can make the following changes directly in a hit list:

  • Adjust column widths by moving the column divider or by double-clicking the column divider (creates the optimal column width). The change of column width will also affect other hit lists, provided that you use the same columns there, too. If you have changed column widths, these changes will be saved automatically when you switch views. In addition, these settings apply to all users who use the browser.
  • Adjust column sorting:
    • You can sort the hit list by a column by clicking its header. Clicking the column header repeatedly will change the sort direction or undo it.
    • You can sort a hit list by several columns by holding the Ctrl key. Numbers and small arrows in the column headers indicate the sort order.
    • Columns with labels (for example, columns with user names) cannot be sorted.
    • If you have sorted a hit list by clicking the column headers and then open the hit list configuration menu, this sorting will be transferred to the hit list configuration menu and can be saved there.

If you select an object in the hit list, the object aspects will be displayed on the right-hand side of the screen. You can open the folder view, or the object view if a document does not have a parent folder, by double-clicking an entry on the hit list.

Selecting and Focusing

We distinguish between selected and focused elements:

  • Selected elements:

    • The row of selected elements is highlighted.

    • Multiple rows can be selected.

  • Focused elements: 

    • Only one element out of all selected elements can be focused.
    • The icon is highlighted again at the beginning of the row.
    • For focused elements, the object aspects are displayed in the object area.

You can use the mouse to select further elements by additionally holding down the Ctrl button or the Shift key while clicking these elements. If you hold down the Shift key when clicking the mouse, all the rows between the row you have clicked and the row with the most recent focusing are selected, but the focus remains on the first row. If you hold down the Ctrl key when clicking the mouse, the row you have clicked is highlighted in addition to the existing selections. The focus still remains on the first row. When you position the cursor on another selected row and click the right mouse button, this row is focused.

Click the mouse on the selected row while holding down the Ctrl key to remove the selection again.

Copying

The copy to clipboard operation is supported in all grids (result list, metadata table) and can be done in the following ways:

Key combinationSelection
Ctrl+Csingle cell
Ctrl+Alt+Csingle cell and the corresponding column header
Ctrl+Shift+Cselected rows
Ctrl+Shift+Alt+Cselected rows and all column headers

Highlighting for several seconds in dark blue indicates that the selection has been copied to the clipboard. This is the default setting, which the administrator can adjust accordingly.

The number of hits is shown in the footer of the hit list. In the footer of the hit list, you can also choose between the display layouts, scroll through the hit list or go to the start or end.

Table icon

Choose table layout.

Gallery icon

Choose gallery layout.

List icon

Choose list layout.

/

Display previous/next page of the hit list.

/

Display first/last page of the hit list.

Filter area

In the filter area, you can control the display of the objects shown in a hit list. You can limit the number of objects shown in the hit list by using filters. You will find the filters in the filter area next to the object lists. It may be that the filter area next to an object list is collapsed. Click the Double chevron icon Double chevron icon to expand the filter area.

In the filter area, you can use both default filters that are available to every user throughout the system and your own filters that you have configured yourself via the filter configuration menu. How many filters are available and which ones depends on the object types that are displayed in an object list.

You enable a filter by clicking a checkbox. The numbers in front of the checkboxes indicate how many documents in the hit list match the specific selection criterion.

You can expand and collapse the list of filters by clicking the Minus icon Minus icon or the Plus icon Plus icon. In the footer of the filter area, you can choose between different display formats for the filter display. You can expand and collapse the filter area by clicking the Double chevron icon. These layout settings in the filter area are saved when you exit the view. The next time you open the same view, the layout settings saved when you exited the view will be displayed again.

Object area

The object area is displayed to the right of the hit list area when you select an element in the hit list. It shows all object aspects of the object that was selected in the hit list. If you click the element in the hit list again while holding down the Ctrl key, the object area will be hidden again.

Business Process Management

There are three specific views that allow users to handle processes:

  • The My follow-ups view lists all active follow-up processes that you created via the object action menu.
  • The Inbox view lists all user tasks that are intended for the authenticated user, such as reminder tasks of follow-up processes that have reached their follow-up date. All tasks of processes the currently logged-in user is assigned to are listed as well.
  • The My processes view lists all processes except follow-ups started by the logged-in user.

>> YuvBpmModule

Follow-up Processes

Those processes can be created for both folder and document objects. They act as processing reminders, for example. You can only create one follow-up for each object via the object action menu. Once you have created a follow-up, it will be displayed in the My follow-ups area provided via the main menu until the time specified for the follow-up. Here you can edit or delete all active follow-ups (i.e., follow-ups for which time has not yet expired).

When the specified time of a follow-up is reached, the object to be followed up is also displayed in the Inbox hit list provided via the main menu. By confirming the follow-up, you can remove expired follow-ups from both the inbox and the My follow-ups area.

Other Processes

If an admistrator configures further types of business processes in addition to the follow-up processes, they can be started for individual objects via the object action under MORE ACTIONS. All active processes started by yourself are listed in My processes.

Inbox

Each process contains tasks that are created on the basis of at least one particular document and have to be solved by the users. The responsible users retrieve their tasks from their Inbox. More attachments can be added to the task in the Inbox during the process. They are displayed for every task in the right window in the Attachments tab. The document highlighted in the accent color is always the focused attachment. The first attachment cannot be deleted with "X" .

Alt: Each process contains tasks that have to be resolved by users. Responsible users retrieve their tasks in their Inbox.

The view of the inbox can be changed using the icon for Table View and the the icon List View at the bottom right. In the Table View the following columns are displayed: Type, Task, Subject, Received on and Due on. In the Type column, the  icon symbolizes a Task and the  icon symbolizes a Follow up. By clicking on the header of the corresponding column, the sorting direction can be selected. By drag & drop the position of the column can be moved within the table. A red marked entry in the Due on column indicates that this task is overdue.

In the List view Type, Subject and,  one under the other in one column, Task and Received on are displayed. Sorting of the content or repositioning of the columns is not possible.

By clicking on a task, a window opens on the right side, in which the task can be edited. After editing, the task can be acknowledged according to the status of Task. For entries with the status Task, the options Delegate, Forward or Finish are available. For entries with the status Task overview the options Delegate or Confirm are available. For entries with the status Review only the option Confirm is available.


Read on

Custom Client Build with Libraries

Documentation of the client core and framework libraries, as usable for custom client development. Keep reading

Connection of BPM Engine 

Use the BPM Engine for process and task management within your client. Keep reading

Integration of AI Functionalities 

Use the features of the Artificial Intelligence Platform to offer object type predictions during object creation processes in your client application. Keep reading


















  • No labels