Changelog 9.12

ERA-8577

The loop-count limit of workflows can be configured

As a system operator, I want to be able to configure the maximum number of loop executions in order to be able to prevent the faulty implemented processes from consuming all computing resources of the system (such as, creating endless loops that will never free the execution thread it is being executed on).

Acceptance criteria:

• core-service has a new property to configure the loop count limit for all processes

• once the loop count limit is reached, the process will be suspended

• if a process is suspended due to the loop-count limit and then continued, the loop instance counter is reset (actually, modulo loop-count-limit is applied to it) and the loop continues the execution until the condition for exiting from the loop is met, or until the loop-count-limit is reached again.

• property can have positive value (that defines the limit), or -1 that turns off the limitation

• the default value of the property is 1000

ERA-9502

Improve log configuration to prevent storage medium from filling up

To prevent the storage medium from filling up, logging should be configured by default so that it automatically deletes old files as soon as a certain limit has been reached.

Current behavior in other components:

core-service: maximum 10 files (100 MB per file)
service-manager: maximum 3 GB (100 MB per file)

Hints:

configuration won't be changed with an update but only with uninstalling and reinstalling designer

Final solution:

The maximum amount of archived files was set to 10.
The maximum size of a file was set to 100 MB.

TUK-2935

It is possible to sign a document file advanced with DocuSign and Adobe and qualified with DocuSign

As a user, I want to be able sign a document file advanced and qualified as well if this capability is enabled in the DocuSign account of my company.

Acceptance criteria:

• When a user requests signatures the client and the abstract object type 'yuvsigning' exists in the schema, the new ../signing/info endpoint is called to get the set signature types that can be offered for signing.

• In the dialog 'Request signature' the 'Signature type'/'Signaturtyp' is offered if an 'advanced' or 'qualified' one is configured for a platform. The default is 'simple'. The selected type is remembered and used as default the next time.

  • If the signature type is offered it is sent with the signing request.

    • Info: to be read from the new endpoint ../signing/info for searching:
      the signature type can be selected from the existing catalog 'yuvsigtype'.

    • If 'advanced' is selected the new table field 'Phone' becomes required. The parameter and its value are sent with the signing call. 

      

      • The client requests signing with a signature type if available and selected otherwise without.

      • If the signing platform does not accept a given phone number the user is asked to enter a correct one.

    • The DocuSign envelope handles this signature type well: The provider for the advanced and qualified signature that is set for an account is involved in the signing process.

      • The envelope is sent with the specified signatureProviderName to the DocuSign Platform if the request signing is sent with the signature type 'advanced' or 'qualified'

      • The Signing-Service is responding to an error, if the administrator may have configured the signing types 'advanced' or 'qualified' for Adobe Sign so that the user could select one.

    • The signature type is always shown in the aspect 'Signature'

      • A given phone number is shown in the signers block.

    • In the form, the default values for email subject and message are shown. The fields are mandatory now.

Remark: Only the DocuSign advanced and qualified signing is supported for now. So the selection of the signature type is not shown for the signing platform Adobe Sign.

TUK-3140

The document file download selection, the Clipboard, and Send email can be fully controlled by keyboard

As a user, I want to be able to fully use the keyboard to download a file so that I do not have to touch the mouse.

Acceptance criteria:

• After pushing 'Enter' if the action 'Donlwod document file' is focused the sub-dialog is opened with the focus on 'Original'.

• It is possible to navigate between both actions and to call the focused one by pushing 'Enter'.

• Pushing tab is not leaving the dialog (only the action and buttons of the dialog are reached)

• A 'Cancel' button is offered that can be reached by keyboard control and that can be called by pushing 'Enter'. After this, the sub-dialog is closed.

• Clicking outside the action menu closes it.

TUK-3145

The backend sends necessary emails via OAuth2 authentication for Microsoft Office 365

As an administrator, I want that the core-service is able to send emails via OAuth authentication of the M365 exchange online service.

Background: Microsft does not allow to use the SMTP authentication in the near future.

Acceptance criteria:

• It is possible to configure the OAuth authentication in the management studio:

  • Instead of a checkbox a selection list is offered for 'SMTP Authorization':

    • 'None' / 'Keine' offers no fields

    • 'With basic authentication' offers the current fields

    • 'With Oauth2 authentication for Microsoft Office 365' offers these fields:

      • Tenant ID

      • Client ID 

      • Client Secret

  • The core-service is using this configuration when sending emails.

TUK-3264

It is possible to let the cleanup operation for the recycle bins run with forcing the deletion although an object is contained in a process file

As an administrator, I will be able to delete all objects in the recycle bin even if they are contained in a process file.

Acceptance criteria:

• It is possible to force the deletion operation for the recycle bin as it is possible in the delete objects operation. 

TUK-3273

The structure tree can be configured with monthhistogram and yearmonthhistogram

As a user, I will be supported by an aggregation of the month of the year as it is for the year itself so that I can drill down.

As an administrator, I will be able to configure the structure tree with the methods 'monthhistogram' as well as with 'yearmonthhistogram' so that the user can drill down the months as he is supported for the years yet.

Acceptance criteria:

• The methods 'monthhistogram' and 'yearmonthhistogram' can be used for a field type date and datetime in the structure tree configuration within the designer.

  • For the method 'monthhistogram' configuration, the client offers to drill down the months which are represented with 01 ... 12

  • For the methods 'yearmonthhistogram' configuration, the client offers to drill down the year and months which are represented with e.g. 2020-01 ... 2023-12

  • The modifier MONTH is introduced so a condition can be configured like this:
    "condition": "modified(YEAR)=2016 AND modified(MONTH)=08"

• This feature is documented here: https://yuuvisdevelop.atlassian.net/wiki/spaces/onpremise/pages/319620140/Structure+Service+API+-+Folder+Structure 

TUK-3286

The documentation can be opened by click on the '?' symbol in the appbar

As a user, I want to be supported by fewer clicks to open the user documentation.

Acceptance criteria: 

• A symbol with a '?' is shown beside the profil image. A click on it opens the user documentation in the language that is chosen.

• The main menu item is removed.

• The general section in the 'Application action' offers 'User documentation' as action.

TUK-3300

It is possible to get an info about the supported signature types

As a programmer, I want to be able to get the supported signature types so that I can offer them to the users.

Acceptance criteria:

• There is a new signing service GET endpoint ../signing/info that returns the supported signature types and the default values for the email subject and body and other parameters which are configured in the file signing-yml:

  • the 'platform' with value

  • The 'supportedPlatforms' with the list ["docusign","adobesign"]

  • the 'maxsigners' with value

  • The default 'emailsubject'

  • The default 'emailmessage'

  • the 'signatureTypesEnabled' with these values (all are optional so the list can be empty) depending on the configuration in the signing-prod-yml file as documented here:
    https://yuuvisdevelop.atlassian.net/wiki/spaces/onpremise/pages/447184897/General+Configurations+for+Signing 

  • "signatureTypesEnabled": [ "simple", "advanced", "qualified" ]

TUK-3301

The auth/info Gateway endpoint is listing the session timeout and the agent keeps the session open with the help of this info

As the system responsible, I want the agent to prevent a session timeout on server-side so that a problematic disconnection with the Outlook and Microsoft Office Add-in can be avoided.

Acceptance criteria:

• the auth/info endpoint of the agent is listing the timeout

• the agent is resolving this timeout and pings 20% earlier than timeout (call to state endpoint check via devmode)

TUK-3343

It is possible to get the status of the Signing-Service

As an administration, I will be able to check whether my authentication configuration for a DocuSign account is well without requesting a signature for a first document file.
As an administrator, I want to be able to get the names of the configured signing providers for that DocuSign account so that I can configure the advanced and qualified signature types if needed.

Acceptance criteria:

• There is a new signing service endpoint ../signing/status that returns the signing configurations

  • which are configured in the file signing-yml:

    • the 'platform' with value

    • The 'supportedPlatforms' with the list ["docusign,adobesign"]

    • the 'maxsigners' with value

    • The default 'emailsubject'

    • The default 'emailmessage'

    • the 'signatureTypes' with values 'simple', 'advanced', 'qualified'

    • The accountName with which the Signing-Service is connected

    • The list of available signatureProviderName requested from 

    • If the configuration in the signing-prod.yml differs from DocuSign roviders info is given.

    • If the signing platform could not be accessed a specific error message is responded.

TUK-3368

The footer of the dashboard can be collapsed and expanded

As a user, I want to be able to collapse the dashboard footer so that I can use the complete screen.

Acceptance criteria:

• An icon for collapsing the footer is offered on the right hand-side. After clicking on it the footer is removed and the icon changes to bring the footer back. After clicking on it the footer is back and the icon for collapsing the footer as well.

  • The setting is saved in the user settings.

• The footer is shown as less prominent.

• Hovering over the icon

  • the cursor is changing to a hand

  • a tool tip is shown: 'Hide dashboard configuration'/'Dashboard-Konfiguration ausblenden' / 'Show dashboard configuration'/'Dashboard-Konfiguration anzeigen'

TUK-3420

For a configured cache, information about the usage in a medium is shown

As an administrator, I want to be supported with a piece of information for a configured cache that shows its usage in a medium so that I may know that I have to assign it.

Acceptance criteria:

• In the header of a set configuration section information shows the media that uses this cache or that no media is using it.

TUK-3431

The synchronize storage operation offers options to handle metadata xml files

As an administrator, I want the synchronization storage operation to offer the following options so that current issues are avoided.

Acceptance criteria:

• If the metadata.xml file is missing after the synchronization it is re-created

• create them generally

• remove them generally