2023-08-13 Ver. 15.1 Added Auto-step to Generate PDF from HTML

Overview

Updating Date

• Workflow platform for Rapid Update
  • Version 15.1.0: September 10th, 2023
  • Version 15.1.1: [TBD] September 10th or 24th, 2023
• Workflow platform for Scheduled Update and Trial mode
  • Version 15.1.0: No updating
  • Version 15.1.1: [TBD] September 10th or Sep. 24th, 2023

Changes to be Noted

• In Process/Task search API, XML format search criteria (criteria parameter) are discontinued
• The APIs for searching Organization/Role affiliation without pagination are now deprecated
• If GraalJS (Nashorn Compatible Mode) is used for the script engine, an App Definition Error will occur
  • No impact on the running Apps
  • When releasing a new version of the App, please fix the errors and then press [Release]
  • GraalJS (Nashorn Compatible Mode) will be discontinued in April 2024
• Check out the plans for changes in future versions [Plans of Future Changes] at the bottom of this page.

---

Details for Version 15.1.0

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

Changes of Functions for All Users

Workflow

Process Start/Task Operation/Process Details

• Extended the format for thumbnail image generation in File-type Data Items/Open Chat attachments (#9083)
  • Supports WebP/SVG/TIFF/AVIF in addition to JPEG/PNG/GIF
• $$. When importing a TSV file for Process [Bulk Start], an error message will be displayed if the number of records exceeds 100 (#9259)
• Upgraded jQuery to 3.6.4 from 3.6.0 (#9139)

Process/Task search (list)

• Changed so that the name of the file downloaded by [Download All] in the saved list in [Others] becomes the list name (#9124)
  • Half-width symbols in the list name may be converted to other characters when saving (depends on browser and OS)
• Changed CSV download process to call Questetra REST API in order to standardize the specification (#9120)

Heatmaps/Chart etc.

• In [Chart], the contents of “Filter” and “Settings” are now displayed at the top of the chart
• Fixed the following Bug:
  • When displaying line graphs aggregated yearly/monthly in [Chart], the X-axis scale is not displayed correctly when there are two dates on the X-axis (#9159)
  • In [Chart], when User-type Data Item is specified in [First Unit], aggregated values may not be correct (#9177)
    • Aggregated values of a User whose User name was changed in the middle of the aggregation target period are not correct values
    • There is no problem if the Process Start User is specified in the [First unit], or if User-type Data Item is specified in the [Second unit] (it will be aggregated normally)

Open Chat

• Improved index creation processing for searches when booting workflow platform (#9178, #9205)
• Fixed the following Bug:
  • Some [Topics] associated with posts may not become links (#9179)
    • Posting messages with multiple topics in which one topic prefix matches another causes this problem

Account Settings

• Specialize the content of the [Login history] display to the login/logout history in the web UI (#9157)
  • Exclude access by basic authentication and add forced logout by simultaneous login

Changes of Functions for Workflow Designer

Create New App

• App ID can now be specified when using [New App] or [New App from Archive] buttons (#7230)
  • Any number that has never been used before can be specified
  • You cannot recreate the existing App with a different ID and assign the number given so far to the new App
  • If not specified, a number will be assigned automatically
  • [Copy as New App] is not applicable (automatic numbering only)
  • If you operate it well, you can unify the App ID in multiple workflow platforms, such as the production environment and development environment
• When using [New App from Archive], it is now possible to change the App ID referenced in the App definition (#9176)
  • It is possible to reassign (specify) the App ID in the same way as Users/Organizations/Roles
  • As of Ver. 15.1, it is only child Apps that are the target of the [Service Task (Start Child Process)]
• $. Improve performance by improving internal processing such as [Release] and [Delete] of Apps (#9277)
• $$. Regarding “Snapshot” displayed in the versions list on the app details screen, only the first snapshot of the day will be saved if it is more than 2 days old (#9278)
• Fixed the following Bug:
  • Long consecutive alphanumeric characters do not wrap and exceed the display frame in [Summary] and [Memo for App Administrator] on the App details screen (#9184)

Debug

• It is now possible to use [Debug only this node] for an [XOR/OR Gateway] (#8777)
• Notification emails on debug Processes now include “(Debug)” in email subject (#9087)
  • Easier to identify notification emails from the debug Process

Operator

• $. If a user supposed to be in charge of a Task that will occur in the future is deleted, it is now that the Task will be an Error Task (a Task with no assignee) when it is created (#9263).
  • Up to version 15.0, the Task was forcibly assigned to another User (taken over) when the User supposed to be in charge of operating it was deleted
  • On and after Version 15.1, Tasks will not be forcibly assigned to other Users, so when a Task occurs, it will be an Error Task

Workflow Diagram

• $$. In editing a workflow diagram, when deleting a Step icon (node) that has a single input/output flow, it is now the previous Step (node) to be directly connected to subsequent Steps (#9040)
  • Up to Version 15.0, the input flow/output flow was deleted along with the Step icon, and the workflow was interrupted

Terminate End Event

• Processes can now be abended (#9055)
  • You can now specify “successful　(normal end)” or “failure (abend)” when the process ends
  • Process status can now be set to “Terminated” in cases other than [Forced termination] by a User

Message Start Event (email)

• Changed the internal implementation (the use library) (#9138)

Timer Start: the number of choices

• Added the [Timer Start: the Number of choices] Step icon
  • The Process is automatically started for the number of choices of the specified Select-type Data Item (#9209)
  • Each choice is set as initial values in the specified Select-type Data Item
  • For example, if there is a Select-type Data Item with “customers” as its choice, a new Process can be started for each customer every month
  • The upper limit of the number of Processes to be automatically started is 100

Throwing Message Intermediate Event (email)

• Changed the URL format of the Process Details screen to the path parameter (#9152)
  • Screen for Desktop: /OR/ProcessInstance/#{processInstanceId}/view
  • Screen for Mobile: /SP/OR/ProcessInstance/#{processInstance}/view
  • If you access the URL with a format up to Version 15.0 (query parameter), you will be redirected to the new format URL
    • Redirect processing may be stopped after August 2024
  • If you want to include the Process Details URL in the body of the email, please use the new format URL
    • For existing Apps, please proceed to support the new URL format little by little, such as when you edit the app or receive an email

Message Start Event/Receive Task (form)

• In the URL in the expression notation of [Receive Task (Form)], changed the “App ID” part from a fixed number notation to using an expression “#{processModelInfoId}” (variable) (#9207)
• [Message Start Event (Form)] now displays the URL of the form on the settings screen, in the same way as [Receive Task (Form)] (#9267)
• On the node details screen where the URL etc. is displayed, if it is not subject to IP Address Filtering, it is now described so in [Allowed Hosts/Networks] (# 9268)
  • Also as with [Message Start/Catching Message Intermediate Event (HTTP)] and [Message Start/Receive Task (Webhook)]

Update Choices

• $$. If there is no change to the Option Master (no changes before and after update) in [Service Task (Update Choices)], the process result will be “Finished normally” (#9255)
  • There was a difference in the processing result depending on whether the target option master was App-shared or App-specific
• Fixed the following Bug:
  • $$. In [Manage Add-ons], Add-ons may not be deleted if the registered file name contains a space (#9309)
    • Same for Add-ons other than “Choice Master”

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

• Added the following automated processing Steps (Service Task)
  • Twilio Sendgrid
    • Twilio SendGrid: Send Bulk Email（#9226）
      • Send emails in bulk to recipients in SendGrid lists and segments
      • Applicable for Sendgrid served by the sendgrid.com domain
        • Not applicable to Sendgrid, which is provided in Japan with the sendgrid.kke.co.jp domain.
    • Twilio SendGrid: Add or Update Contact (#9241)
      • Add or Update SendGrid Recipients
    • Twilio SendGrid: Add or Update Contact (Custom Fields) (#9246)
      • Add or update SendGrid Recipients and populate specified custom fields
  • DocRaptor
    • DocRaptor: Generate PDF (#9202)
      • Generate PDF file from HTML
  • kintone
    • $. Timer Start: kintone: the number of records (#9306)
      • As with Timer Start Event, starts a Process periodically at a specified time
      • One Process is started for each kintone record that matches the search criteria, and the kintone record ID is saved in a String-type Data Item
      • For example, if your customers are managed in kintone, you can start one Process per customer each month
      • However, the upper limit of the number of Processes that can be automatically started from one node is 100, as with “Count of Operators in Timer Start Event” etc.
  • Adobe
    • $. Adobe: Generate PDF (HTML to PDF) (#9303)
      • Generate PDF file from HTML
  • Box
    • $$. Box Sign: Monitor Sign Request
      • Monitors the progress of a Sign Request on Box Sign until its completion
      • Capable of recording (email addresses of) persons who have not signed/signed/rejected signatures, etc.
  • Slack
    • $$. Start: Slack: Message Received
      • Starts a Process in cases when the following
        • When a message with a mention is sent to a Bot (Slack app) participating in a Slack channel
        • When a message is sent to the Bot (Slack app) in a direct channel with the Bot
    • $$. Slack: Post Message (Block Kit supported)
      • A Bot that receives a message can reply
  • DeepL
    • $$. DeepL: Translate Text
      • Machine translate text
  • OpenAI
    • $$. OpenAI ChatGPT: Chat
      • Chat communication with OpenAI API (ChatGPT)
• Changed specifications, internal implementations or fixed bugs in the following automated processing Steps (Service Tasks)
  • kintone
    • kintone: Add New Record (#9227)
      • Limit the type of HTTP Authorization Setting to [Token Fixed Value] and [Basic Authentication]
    • kintone: kintone: Get Record (#9273)
      • Limit the type of HTTP Authorization Setting to [Token Fixed Value] and [Basic Authentication]
    • kintone: Update Record(#9258)
      • Limit the type of HTTP Authorization Setting to [Token Fixed Value] and [Basic Authentication]
    • kintone: Delete Record (#9228)
      • Limit the type of HTTP Authorization Setting to [Token Fixed Value] and [Basic Authentication]
    • Start: kintone: Record Created (#9230)
      • Change the name from [Start: kintone: Record’s Datetime Field] to [Start: kintone: Record Created]
      • Limit the type of HTTP Authorization Setting to [Token Fixed Value] and [Basic Authentication]
  • Box
    • $$. Box Sign: Create Sign Request (#9293)
      • Added support for saving the signing request ID
  • Generate Text File
    • Generate Text File (#9210)
      • The character code used when generating was fixed to “UTF-8”, but now you can also select from 4 types; “UTF-16 with/without BOM, LE/BE”
  • Converter
    • Converter (Excel-CSV File to Table type data) (#9240)
      • Changed the Internal implementation
    • Converter (Text File to String type data) (#9252)
      • The character code when reading a text file was fixed to “UTF-8”, but it can now be set to including “see/not see the charset of Content-Type” and “4 types of UTF-16 (with/without BOM, LE/BE )”

Message Start Event/Catching Message Intermediate Event (HTTP)

• URL is now visible in the settings screen (#9238)
  • Along with that, changed the display format of the URL so that the API key is included in the query parameter of the URL
  • As with 15.0, it works whether the API key is included in the URL query parameter or in the request body of a POST request (application/x-www-form-urlencoded or multipart/form-data)
• Settings based on the definition of the developing version are now displayed on the node details screen that displays the URL, etc. (#9243)
  • Until Version 15.0, once released, only the contents of the latest version were displayed
  • API key, contents of Reception Parameter settings are the subjects
  • Same for [Message Start Event/Receive Task (Webhook)] and [Message Start Event/Receive Task (Form)]
• $. Even if an error occurs when [Message Start Event (HTTP)] starts debugging, an error notification email is no longer sent (#9204)

Service Task (Start Child Process)

• Improved error message when child App is not found, such as when child App is [Suspended]
  • Messages now include the App ID/node number of the target App

Throwing message Intermediate Event (HTTP)

• Adjusted the design of the drag handle for changing the display order on the Header/Send parameter setting screen (#9224)
• $$. Added “Api-key” to the allow list in Custom HTTP Headers (#9312)
• Fixed the following Bugs:
  • Changing the display order may not be reflected correctly in the Header/Send parameter settings (#9221)

Script Task/Service Task (Add-on)

• An app definition error now occurs when “GraalJS (Nashorn Compatible Mode)” is used as the script engine (#9103)
  • $$. Not to be the application definition error, and instead added the support to output a warning to [Process Log], when updating to Version 15.1(#9320).
  • This will result in an error in the definition of the workflow App, but it will not affect the operation of the latest version of the App that is running or the operation of the running Process (no error will occur when executing the Process)
  • Errors must be fixed before releasing a new version of the App
  • “GraalJS (Nashorn Compatible Mode)” is going to be discontinued in April 2024
• $$. A warning message is now logged in the Process Log when “GraalJS (Nashorn Compatible Mode)” is used (#9320)
• $$. Improved warning messages logged in Process Log
  • Changed content of replacement guide for deprecated method
• Added a method to get options (list) from Select-type Data Items to ItemDaoWrapper class (#9180)
  • findAll(ProcessDataDefinitionView dataDef), findByValue(ProcessDataDefinitionView dataDef)
  • Even if the option type is “Fixed option” or “String-type Data Item”, you can get the list of options
  • If the option type is “Get choice list via HTTP”, it will not work and will result in an error
• When overwriting the value of a Select-type data item, it is now possible to specify the value as a String, ItemView, or List of ItemView (#9195)
  • Up to Ver. 15.0, it was only a List of String, so there are more variations when specifying values
  • If you specify a single option, you no longer have to use a List
  • For ItemView, refer only to the value of the option (accepts even if the display label does not match)
• When overwriting the value of a File-type Data Item, it is now possible to specify the value only with QfileView or NewQfile (#9196)
  • Until Version 15.0, it was necessary to be a List of QfileView / NewQfile, but now it is not necessary to be a List when specifying one file
• $$. Scripts now support RSA256 signing (#5846)
• $$. Scripts can now compute HMAC authentication codes (#9244)
• Fixed the following Bugs:
  • When you try to delete an add-on automatic Step ([Service Task (Add-on)]) with an empty step name, an error occurs and you cannot delete it (#9166)
  • Incorrect error message when charset value of NewQfile class constructor is null (#9231)

HTTP Authorization Setting

• $. Changed the security model of HTTP Authorization Setting (#9275)
  • In addition to the Workflow App-specific settings (up to Version 15.0), it is now possible to add authorization settings that can be shared by all Apps
    • [System Admin Privilege] is required to add Settings Shared by All Apps
• Changed the security model of HTTP Authorization Setting used in built-in automatic steps that work with external cloud services (#7821)
  • In addition to settings shared by all apps up to Version 15.0, the following two sharing ranges have been added
    • Settings associated with the user: Referrable from workflow apps for which a user is App Administrator
    • Workflow app specific settings: Referable only in the corresponding app
• Add-on automatic step ([Service Task (Add-on)]) can now limit the type of authorization settings to be referenced (#9160)
  • It is now possible to refer only to BASIC authentication among HTTP authentication settings
• In [BASIC Authentication], it is now possible to set a blank password (#9162)
• Updated time/user are now displayed on the HTTP Authorization Settings screen (#9170)
  • Both will be empty at the time of updating to Version 15.1
  • After updating to Version 15.1, the last update time/user are recorded
• Settings are now listed by Authorization type on the HTTP Authorization Settings screen (#9173)
• Support for new authentication type, OAuth2 Client Credentials Flow / OAuth2 Client Credentials Grant Type (#9248)
  • Supports the Parameter type among the OAuth2 Client Credentials Grant Type
  • Types that use the Authorization header are not supported
• $. You can now get the HTTP Authentication Setting object (AuthSettingWrapper class) in Script Task (#9253)
  • AuthSettingWrapper httpClient.findAuthSetting(String settingName, boolean sharedOrNot)
  • The AuthSettingWrapper class has methods such as getName() / getBasicPassword() / getToken(), and the available method varies depending on the authentication type.
• $. In [Script Task], some methods concerning HTTP Authorization Settings are deprecated (Version 18.0) (#9299)
  • httpClient.getOAuth2Token(String settingName)
  • httpClient.begin().authSetting(String settingName)
• $$. Changed the error message when processing failed because HTTP authentication settings were not found (#9302)
• Fixed the following Bugs:
  • The label should have been Client Secret but it is Consumer Secret (#9287)

Swimlane

• Fixed the following Bugs:
  • When moving or changing the height of a swimlane requires other swimlanes to be moved, the swimlanes may overlap (#9185).

---

Changes of Functions for Questetra REST API Developer

• $$. [API Reference] renamed to REST API Reference
• In Process/Task search API, XML format search criteria (criteria parameter) are discontinued (#8863)
  • Process search: /API/OR/ProcessInstance/list, listCsv, listCsvUtf16
  • Task search: /API/OR/Workitem/list, listCsv, listCsvUtf16
  • The Criteria parameter is only valid in JSON format
• Added API to get the list of Error Tasks (#8861)
  • /API/PIM/Workitem/errorList
• Add pagination function to API for searching organization/role affiliation (#9142)
  • /API/User/Membership/list, /API/User/RoleMembership/list
• User/Department/Role list API now supports search with limit=0 (#9136)
  • /API/User/Quser/list, /API/User/Qgroup/list, /API/User/Qrole/list
• Changed the internal implementation of the following APIs
  • Process list: /API/OR/ProcessInstance/list, listCsv, listCsvUtf16 (#9085）
  • Task list: /API/OR/Workitem/list, listCsv, listCsvUtf16 (#9118)
  • Start Process: /API/PE/ProcessModel/listStartable, /API/PE/ProcessInstance/start (#9128)
• Deprecated the APIs for searching Organization/Role affiliation without pagination (Ver. 17.0) (#9289)
  • /API/User/Membership/listByQuser, listByQgroup
  • /API/User/RoleMembership/listByQuser, listByQrole

Changes of Functions for System Administrator

• Long App names and email addresses are now wrapped in [Message Start Event (Email)] in App External Connectivity.

User/Organization/Role

• Users can now be marked as “Will be deleted in the future” in bulk via CSV input (#8954)
• Set an upper limit (256) for items that can put a check for batch operations such as deleting affiliation (#8386)
• Introduced a pagination function to lists of affiliation/Role/Users on the User/Organization/Role details screen (#9236)
• It is now possible to filter by whether or not marked as “Will be deleted in the future” when displaying a list of User/Organization/Role (#8821, #8833, #9137)
• Root Org can no longer be marked as “Will be deleted in the future” (#9163)
• Improved handling when Username/Organization name is changed (#9249, #9257)
• Improved the update process of “Main Organization” when the User’s affiliation is changed (#9239)
• Fixed the following Bugs:
  • The [Apps referring to the organization] button is not displayed on the detail screen of the root organization (#9164)
  • The App definition error of the upper limit of the number of launches in [Timer Start Event] is not resolved when belonging to an organization is deleted (#9229)

System Log/Process Log

• It is now possible to search by specifying a range of Log IDs in the System Log search (#9086)
• Changed the notation of “Finished abnormally” in the Process Log to “Terminated” indicating Process Status (#9141)
• $$. In [Process Log], it is now easier to copy the text when displaying details (#9285)
• Fixed the following Bugs:
  • In the Process Log, “Type” may not be displayed depending on the order in [Column] menu (#9222)

---

Details for Version 15.1.1

(Appended 2023-09-04)

Changes of Functions for All Users

Open Chat

• Fixed the following Bug:
  • Some Topic names may be interpreted as regular expressions and posting a message may result in an error (#9368)

Changes of Functions for Workflow Designer

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)
  • Twilio SendGrid
    • Twilio SendGrid: Send Bulk Email (#9376)
      • Changed so that “C2: Sender ID” can only be specified with a fixed value
  • Slack
    • Start: Slack: Message Received
      • Processes are now also started when replies to threads are posted across channels (#9375)
      • Fixed an issue where the help icon was not displayed (#9379)

Script Task/Service Task (Add-on)

• Added a note to the Step settings screen stating that this is a function for programmers (#9332)

Details for Version 15.1.2

(Appended 2023-12-11)

Changes of Functions for All Users

Workflow

• Fixed the following Bug:
  • When a large number of changes have been made to users’ organization affiliation, or to the organization hierarchy, starting processes using “Bulk Start” may result in an error（#9557）

---

Plans for Future Changes

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

Schedule for Version 16.0 (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
  • 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]
  • Targets: APIs marked as “deprecated: 2024-04” in 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

Schedule for Version 17.0 (April 2025)

• The APIs for searching Organization/Role affiliation without pagination will be discontinued
  • /API/User/Membership/listByQuser, listByQgroup
  • /API/User/RoleMembership/listByQuser, listByQrole
  • Please use the following API with pagination function
    • /API/User/Membership/list, /API/User/RoleMembership/list

Schedule for Version 18.0 (April 2026)

• The following methods related to HTTP authentication settings in Script Task/Service Tasks (Add-on) scripts will be discontinued
  • A warning message will be output to the Process log when a deprecated API is executed
  • You can check the target App or Process by searching for “Only logs with warnings” in [Process Log]
  • Subject
    • httpClient.getOAuth2Token(String settingName)
    • httpClient.begin().authSetting(String settingName)