2023-09-04 / Version Info
Table Of Contents
  1. Release Overview
  2. Details for Version 15.0.0
  3. Details for Version 15.0.1
  4. Plans for Future Changes

Release Overview

Date Release

  • Sun. Apr. 16th, 2023

Updating Date

Changes to be Noted

  • APIs to retrieve My Tasks/Offered are discontinued
  • $. In the Language settings, “入門版” (Introductory Edition) and “京都弁” (Kyoto dialect) will be discontinued
  • [Advanced Notice: April 2024] The script engine GraalJS (new name: GraalJS (Nashorn Compatible Mode)) will be discontinued
  • [Advanced Notice: April 2024] The format using the parameter activityId in the API that starts a process (/API/PE/ProcessInstance/start) will be discontinued
  • Check out the plans for changes in future versions [Plans of Future Changes] at the bottom of this page.

Details for Version 15.0.0

($. : Appended 2023-04-07, $$. : Appended 2023-04-14)

Changes of Functions for All Users

Workflow

Task Operation

  • Changed the interface for specifying the user to hand over to when you [Delegate] a Task (#8834)
  • Changed internal implementation such as thumbnail image creation process for File-type Data Items (#9057)
  • Enabled to [Cancel Acceptance] when there is no person in charge (candidate) to Operate the Task after [Cancel Acceptance] (#8963)
    • Changed so that it becomes an error Task after [Cancel Acceptance]
  • Fixed the following Bugs:

Process/Task Search

  • Fixed the following Bug:
    • When specifying a Numeric-type Data Item in a filter condition, the check details of the input value differ depending on the type of decimal point (comma or period) (#8995)
    • $$. In the search box in the header, it may not be possible to search properly depending on the search string

Open Chat

  • Changed internal implementation such as thumbnail image creation process for File-type Data Items (#8775)
  • $. An upper limit (128 characters) is now set for the Topic name (#9050)
    • If the topic exceeds the upper limit, an error will occur upon posting

Account Setting

  • $. In the Language setting, “入門版” (Introductory) and “京都弁” (Kyoto dialect) will be discontinued (#9091)
    • “入門版” (Introductory Edition) and “京都弁” (Kyoto dialect) will be migrated to “Japanese”

Changes of Functions for Workflow Designer

Create New App

  • App archives (qar files) exported from a workflow platform before version 11.13 (March 2020) can no longer be imported (#8865)

Data Item

  • Enhanced the input check for Numeric-type Data Items (#9008)
    • Double-byte numbers are now treated as errors
    • If there are two decimal points and the second one is at the end, now it is an error

Operator

  • You can now set Operator settings directly in the [Swimlane] property setting screen (#8847)
  • The number of display targets of [Show Candidates] is now limited (#8952)
    • Up to 10 user names and the total number of candidates are displayed

Update Data

  • The value of the scheduled deletion flag of User/Organization/Role can now be referenced(#8897)
    • SpEL expression example: q_quser?.isDeletedInFuture()
  • Only charset included in Content-Type can now be referred (#9034)
    • SpEL expression example: #q_file?.getCharset()
  • The ID of the Parent Process can now be referenced from the Child Process (#9004)
    • SpEL expression example: parentProcessInstanceId

Throwing Message Intermediate Event (email)

  • You can now check the Auto-processing log (process log) in the Operation History on the Process Details screen (#9041)
  • Fixed the following Bug:
    • When attaching a text file, the attachment may be corrupted (#9045)
      • Attachment encoding is now fixed to base64
      • The same applies when sending an email using Script Task (EmailService)

Message Start Event/Receive Task (Form)

  • Fixed the following Bug:
    • If [IP Address filtering] is set on the form, the submission completion page may not be displayed (#5277)
    • Some messages may not be displayed when [IP Address Filtering] is set on the target form (#9065)

Automatic processing Steps that cooperate with other cloud services/processing data

  • Changed specifications, internal implementations or fixed bugs in the following automated processing Steps (Service Tasks/Start Event)
    • Google Workspace
      • Google Drive
        • Google Drive: Upload File (#8905)
          • Changed error message when the User connected to Google Drive is deleted
        • Google Drive: Delete File / Folder (#8924)
          • Updated brief description
        • Google Drive: Search Folder (#8934)
          • Updated brief description
        • Google Drive: Create Shared Link (#8903)
          • Updated brief description
        • Google Drive: Delete Shared Link (#8904)
          • Updated brief description
        • $. Google Drive: Create Folder (“8885)
          • Updated brief description
      • Google Calendar
        • Google Calendar: Insert Event (#8945)
          • Updated brief description
        • Google Calendar: Move Event to another Calendar (#8944)
          • Updated brief description
        • Google Calendar: Delete Event (#8943)
          • Updated brief description
      • Google Sheets
        • Google Sheets: Download Choice Data (#9020)
          • Updated brief description
          • Changed date data to be retrieved as date text
            • Until Version 14.2, it was acquired as a numerical value
            • To match the specifications of [Google Sheets: Get Row]
        • Google Sheets: Add New Sheet (#9033)
          • Updated brief description
        • Google Sheet: Copy Sheet (#8920)
          • Updated brief description
        • Google Sheet: Delete Sheet (#8996)
          • Updated brief description
        • Google Sheets: Append New Row (#8937)
          • Updated brief description
        • Google Sheets: Append New Rows (Table type data) (#8983)
          • Updated brief description
        • Google Sheets: Get Row (#9027)
          • Updated brief description
        • Google Sheets: Update Row (#8921)
          • Updated brief description
        • Google Sheets: Create File (#9038)
          • Updated brief description
    • Microsoft 365
      • Excel
        • $. Microsoft 365 Excel: Insert New Row (#8982)
          • Updated brief description
          • Changed the internal implementation to make an API request using the sheet ID
            • Specify the sheet name on the setting screen (no change)
            • Addressed an issue where sheets with single-byte brackets in the sheet name could not be specified
      • OneDrive for Business
        • $. Microsoft 365 OneDrive for Business: Upload File (#9067)
          • Changed the Content-Type to be fixed to application/octet-stream when using PUT request for file upload
            • Addressed an issue where files with charset=Shift_JIS under 4MB could not be uploaded to OneDrive
        • $. Microsoft 365 OneDrive for Business: Copy File / Folder (#9068)
          • Addressed the issue where an error occurs during “copying”, by waiting for copy completion
            • (If the definition file is registered as “Add-on automatic step”, it will not work in the same way)
    • Box
      • Box: Delete Folder (#8901)
        • Updated brief description
      • Box: Delete Shared Link of Folder (#8902)
        • Updated brief description
      • Box: Download File as PDF/Text/Image (#9028)
        • It now waits for the completion of file creation so as not to cause an error for Creating files
          • $. (If the definition file is registered as “Add-on automatic step”, it will not work in the same way)

Service Task (Start Child Process)

  • Changed the name of the [Service Task (HTTP Request to Start Event)] to [Service Task (Start Child Process)] (#9000)
  • Expanded specifications to support: (#9042)
    • Can wait for a Child Process to complete (in a Parent Process)
      • Added an option [Wait for Started Child Process to finish]
      • When the Child Process ends normally, the value in the Child Process is obtained
      • If the Child Process abends, the Service Task (step) results in processing failure
    • Can obtain the value of the Child Process data (from the Parent Process)
      • Only the values of Data Items that are set on the Child process (Child App definition) side so that the Parent Process (Parent App) can refer to them can be obtained
    • (This realizes a function equivalent to “subprocess” in BPMN)
  • [Service Task (Start Child Process)] of the App itself is not displayed in the palette (#9030)

Message Start Event (HTTP/Webhook)

  • You can now debug execute on the [Message Start Event (HTTP)] (#5277)
    • Debugging Process starts when you make an HTTP request with the header Questetra-Debug: true
    • Unlike normal [Debug Execution], Profile cannot be specified
    • [Human Tasks] are allocated to the Last Editing User of the target App
  • When [Message Start Event (HTTP/Webhook)] is called from another Process to start a Process, the calling Process is managed as the Parent Process (#8977)
    • Parent Process ID is displayed instead of Starting User in the Process Details screen
    • Parent process ID is displayed only when the HTTP request is made from within the same workflow platform

Throwing Message Intermediate Event (HTTP)

  • Questetra-Debug header is sent when making an HTTP request from Debug Process (#8985)
    • For debug processes, the Questetra-Debug: true header is now included regardless of the destination
    • In conjunction with [Message Start Event (HTTP)] (#5277), a Debug Process will start (another) Debug Process
    • The same applies when sending HTTP with [Script Task] (HttpClient)
  • Questetra-Pid header is sent when making an HTTP request (#8988)
    • Questetra-Pid header will be included regardless of the destination
    • The value of the header is its own Process ID (numbers only)
    • The same applies when sending HTTP with [Script Task] (HttpClient)
  • Added Questetra-Debug and OpenAI-Organization to the allow list in [Custom HTTP Headers] (#8986) (#9074)
    • Questetra-Debug: Used when you want to start a normal Process that is not a debug Process from the debugging Process
  • In POST (request body), the charset is automatically completed only when “text/*” is specified for Content-Type (#9024)
  • Enhanced validation for specifying Content-Type (#9049)
  • Unify the internal implementation with one of the [Script Task] HTTP request (HttpClient) (#8979)
  • $. When “Save response to Data Item” was set, unified the processing that used to be different depending on the received response code and the Data-type of the save destination Data Item (#9117)
    • If there is no response body, it is standardized to “Save empty (attach an empty file for File-type)”

Script Task/Service Task (Add-on)

  • Changed the name (label) of the script engine “GraalJS” to “GraalJS (Nashorn Compatible Mode)” and newly added “GraalJS (Standard Mode)” (#8458)
    • In [Service Task (Add-on)], “GraalJS (Nashorn Compatible Mode)” is “engine-type=2” and “GraalJS (Standard Mode)” is “engine-type=3”
    • Changed the default value of engine-type from “Rhino (Deprecated) / engine-type=0” to “GraalJS (Standard Mode) / engine-type=3” in the [Service Task (Add-on)] definition file
    • “GraalJS (Nashorn Compatible Mode) / engine-type=2” is now deprecated
  • Property of User/Organization/Role with scheduled deletion flag are now accessible (#8897)
    • e.g. quserDao.findByEmail(‘SouthPole@questetra.com’).isDeletedInFuture()
  • When attaching a file to an email, Content-Type no longer includes a charset specific to Java (#9044)
    • The charset is omitted if it contains a Java-specific charset like text/plain; charset=x-UTF-16LE-BOM
    • In the processing when attaching a file with EmailMessageWrapper.addAttachment()
  • It now checks the Process state when re-executing the HTTP request (#8987)
    • When the workflow engine makes an HTTP request the request will not be made if the Process has been terminated/deleted
    • Made it the same as the implementation of [Throwing Message Intermediate Event (HTTP)]
  • Child Process can now access the Parent Process ID (#9004)
    • processInstance.getParentProcessInstanceId()
  • The Parent Process can now access data and the state of the Child Process (#8989)
    • When [Message Start Event (HTTP/Webhook)] is called within the same workflow platform, the target Process becomes a Child Process and the caller is managed as a Parent Process
    • The values of Data Items that have been set to be visible to the Parent Process in the App definition on the Child Process side and the state of the Child Process can be obtained from the Parent Process
  • Enabled to use the following methods in HTTP request (HttpClient) (#8990)
    • request.containsHeader(String): Returns true/false whether the header specified in the argument has already been set in the request
    • request.body(): make a PUT / POST / PATCH request without a request body (no Content-Type)
  • When making an HTTP request, the Questetra-Pid header is sent now (#8988)
  • When making an HTTP request from debug Process, the Questetra-Debug header is sent now (#8985)
  • Questetra-Debug and OpenAI-Organization can now be added to the HTTP header (#8986) (#9074)
  • Auto-completion of the charset part of Content-Type is done only with “text/*” (#9024)
  • Added a method (QfileView.getCharset()) to extract charset included in Content-Type (#9034)
    • Extract only the value of the charset parameter from the values obtained by getContentType()
  • Unified and strengthened the validation for specifying Content-Type in NewQfile / HttpClient / EmailService (#9035)
    • An error will occur if it is not in the “type/subtype” format, uses characters other than single-byte alphanumeric characters or symbols, or uses a charset that Java cannot interpret
  • The following configuration items can now be defined in the [Service Task (Add-on)] definition file
    • Support for configuration items that can be shown or hidden depending on the value of other configuration items (#9056)
      • Specify the depends-on attribute in the element
    • Multiple configuration items can be tabbed together (#9060)
      • Grouping required element <configs> with parent element <tab>
  • Changed the deprecated bearer() method of HttpClient so that (for now) it can continue to be used (#9077)
    • Since there are cases where the Authorization Bearer header is added in a manner that cannot be handled by [HTTP Authentication Settings]
  • Added a warning message to the Process log when the deprecated method of AddableDate is executed (#9078)

(*) App definition error along with update
　* Apps that are already running will continue to work (no run-time errors)
　* Errors must be fixed when you [Release] a new version of your App

Changes of Functions for System Administrator

  • You can now check (set a flag) for scheduled deletion in the User property (#8853)
    • Apps referencing Users scheduled for deletion will result in definition errors
    • You can change App settings before the User is actually deleted
  • Changed operation specifications of [Import User ] > [Synchronize with Google Workspace](#8930) (#8932)
    • For Users planning to be deleted, stop putting “(*)” in front of the User name and change to set a scheduled deletion flag
    • Exclude suspended users on the Google Workspace side from being added/updated, and schedule them for deletion
      • Until version 14.2, suspended users on the Google Workspace side were also subject to addition/update
      • On and after version 15.0, it will be treated the same as a “nonexistent” user on the Google Workspace side and will be deleted
  • On the confirmation screen of [Import User], even if the User name/email address is long, the table width will not be widened and it will be displayed wrapped (#8933)
  • Fixed the following Bug:
    • $. A system error occurs when trying to register a user with the same name as an existing user on Questera (with a different email address) using [Import] > [Synchronize with Google Workspace] (#8966)
      • Since Users with the same name cannot be registered on Questetra, it is now excluded from the list of candidates for addition
    • (Firefox) The component to select a User or an Organization does not show a strikethrough even when a User or an Organization to be deleted is selected (#8942)

Process Log

  • Changed the icon displayed when there is a detailed log in [Process Log] (#8913)
  • Change “ID” in the display column to “Log ID”(#9080)
  • “Only logs with warnings” can now be specified as a filter condition in log search(#9079)
  • A range of log IDs can now be specified as a filter in the log search (#9080)

Changes of Functions for Questetra REST API Developer

  • API for searching for Role membership now includes the value of the property that is scheduled to be deleted (deletedInFuture) in the response (#8869)
    • If either the target Role or User is scheduled to be deleted, the membership will also be scheduled to be deletion
  • Enabled to return a list of newly assigned Tasks in the Task’s [Reallocation] API (#8925)
  • API (/API/OR/ProcessInstance/view) for getting Process details now includes the node where the token stays (activeTokenNodeName) in the response (#9072)
  • Process/task search API now includes Parent Process ID property (parentProcessInstanceId) in response (#9006)
    • Only included in responses in JSON (not included in CSV)
  • Discontinued the following APIs (#8191)
    • Get My Tasks: /API/PE/Workitem/listAllocated
      • => use /API/OR/Workitem/list?reportId=ALLOCATED
    • Get Offered: /API/PE/Workitem/listOffered
      • => use /API/OR/Workitem/list?reportId=OFFERED
  • Changed the internal implementation of the following APIs
    • [Reallocation] of Task: /API/PIM/Workitem/reallocate (#8837)
    • [Accept] of Task: /API/PE/Workitem/batchAccept (#8970)
    • [Terminate] of Process: /API/OR/ProcessInstance/stop (#8838)
    • [Delete] of Process: /API/OR/ProcessInstance/delete (#8839)
    • Get the details of Prcess: /API/OR/ProcessInstance/view (#8948)
    • $$. Download File: /API/OR/ProcessInstance/File/download/ (#8949)
  • Fixed the following Bug:
    • In API (/API/OR/ProcessInstance/view) to get process details, the value of the starred property is false even if it is starred (#9071)

Non-functional Changes and Changes of External tool Functions

  • none

Details for Version 15.0.1

(Appended 2023-05-08)

Changes of Functions for All Users

Workflow

  • Fixed the following Bugs:
    • Downloading HTML files attached to File-type Data Items or Open Chat posts results in different data from the original (#9143)
      • HTML file： Files with a Content-Type of text/html
      • Bug in Version 15.0.0
    • The display of multi-line character strings is not wrapped in the Operating form or the Process Details screen (#9145)
      • Bug in the Version 15.0.0

Changes of Functions for Questetra REST API Developer

  • [Advanced Notice: April 2024] The format using the parameter activityId in the API that starts a Process (/API/PE/ProcessInstance/start) will be discontinued (#9149)

Non-functional Changes and Changes of External tool Functions

  • Added support for TLS 1.3 encryption (#7438)
  • Java 17 is now supported by updating the execution platform (Google App Engine) of the program responsible for starting the process from receiving email at the [Message Start Event (Email)]

Plans for Future Changes

We are planning to alter the following specifications and system platform in future versions.

Schedule for August 2023

  • In Process/Task search API, XML format search criteria (criteria parameter) will be discontinued (*postponed from April 2023)
    • Process search: /API/OR/ProcessInstance/list, listCsv, listCsvUtf16
    • Task search: /API/OR/Workitem/list, listCsv, listCsvUtf16
    • (Specifying search conditions in XML format has been deprecated in Version 13.3 (January 2022))

Schedule for April 2024

  • The script engine GraalJS (new name: GraalJS (Nashorn Compatible Mode)) will be discontinued in scripts of Script Tasks/Service Tasks (Add-on)
    • It will be forced transition to GraalJS (Standard Mode)
    • Due to the migration of the script engine, if the following methods/properties are used, the operation specifications will be changed (*postponed from April 2023)
      • String#equals() method
        • Please change to a code that uses “===” or “==”
        • The equals() is a method of java.lang.String. Avoid using methods derived from java.lang.String, as the String class tends to support JavaScript Strings
      • Error#message property
        • Change to a code that uses Error#toString()
        • java.lang.Throwable, the entity of the Error object, does not have a message property. Use the toString() method defined in both JavaScript Error and java.lang.Throwable
    • Script Engine GraalJS (Nashorn Compatible Mode) Discontinued (April 2024)
  • For scripts in Script Task/Service Task (Add-on), deprecated APIs (Java classes/methods) will be discontinued (*postponed from April 2023)
    • A warning message will be output in the Process log when a deprecated API is executed
    • You can check the target App and Process by searching for “Only logs with warnings” in [Process Log] (Version 15.0)
    • Reference: R2300: Java Classes available in Script Task
  • The format using the parameter activityId in the API that starts a Process (/API/PE/ProcessInstance/start) will be discontinued
%d bloggers like this: