Professional Documents
Culture Documents
Extended ECM Content Server SDK 23.4 Release Notes
Extended ECM Content Server SDK 23.4 Release Notes
Release Notes
23.4
We also recommend that you check the OpenText My Support (https://support.opentext.com/) for any
patches or documentation updates that may have been posted after the initial release of OpenText
Content Server SDK 23.4.
• Oscript Search optimization: The OScript search dialog options have changed which now
allows check boxes to select multiple types such as object name, feature name, script contents,
feature value all at once. For more details, see the Content Server SDK guide.
• Added documentation text to the OScript auto format options regarding On/Off Tags. The On/Off
Tags can be used to disable auto formatting for certain sections of an OScript source file. For
more details, see the Content Server SDK guide.
• The ability to switch between "old" and "new" OScript auto format implementations has been
removed. The "new" auto format is now the only auto format. For more details, see the Content
Server SDK guide.
• Content Server SDK Documentation is included in the CSIDE plug-in (via the help menu).
• CSIDE’s OScript Search functionality has changed in this release. The documentation has been
updated to include a description of search functionality (in the “Learning the CSIDE Interface”
section). For more details, see the Content Server SDK guide.
• OBuild: This is an OScript build automation tool that allows third party developers
(Professional services and partners) to build their OScript Modules outside of Content Server
IDE. This build tool is like the OpenText internal Oscript build system that will help CI/CD
systems for our external customers.
Help Reference:
https://knowledge.opentext.com/knowledge/llisapi.dll?func=ll&objId=67790529&objAction=browse
&viewType=1
In CSIDE 21.4 a new Refactor OScript parent menu has been introduced. The menu
contains a number of code refactoring commands, including Remove Unused Variables,
Sort Features, and Fix Variable Declaration Order. This menu improves the user
experience by grouping refactoring features in one place. Refactoring features
support automatic changes of the source code to be compliant with the OScript code style.
This version fixes several issues, including both major and minor enhancements of the external
distribution of the Content Server SDK or otherwise known as CSIDE. Fixed items are listed in section
6 below.
• Formatting
A new OScript submenu has been added to the OScript Explorer context menu. The OScript
submenu includes a Format All command. This command formats each file in the selection.
Multiple selections in the OScript Explorer are also possible. If a folder or project is selected, the
OScript Explorer formats each *.os file in the selection. The formatting can be cancelled at any
time by clicking the stop button in the progress view.
The CSIDE (SDK) build system handles the newly introduced documentation for Cloud API
function(s). The documentation is auto built and renders in an HTML format.
Several start-up logging messages on debug have been modified making them more intuitive
to the user.
• Developer Experience
Similar to Java editors, CSIDE now can add overlays to the editor title icons to indicate if a file
has errors / warnings.
• Error and warning overlays for all editors. These overlays are updated after building
the project or after saving the file (where building does not apply, for example, for
standalone scripts, such as LXE files).
• Script feature editors show a lock overlay if they belong to a locked OSpace.
• OS files either have a green leaf icon or red leaf icon depending on whether the
object is an orphan or not. Previously, OS files always had the green icon.
o Refer to OIDE-2189 for information about how to change the icon on an OS
file.
o Upon startup, OS files have a green icon. Only after the OScriptModel builder
completes, does the icon change to red for orphaned objects.
• Script feature editors have either yellow (new objects), green (inherited but
overridden from parent), or grey (inherited from parent) icons. These icons change
when the object changes. For example, if you edit an inherited feature (grey), after
you save the change, the icon changes to green.
Eclipse 2020-03 (4.15) or higher is now required with CSIDE 20.4. The easiest way to install
Eclipse is to use the Eclipse Installer which can be downloaded from the Eclipse web site.
Select the Eclipse installation package that best fits your requirements.
• Breakpoint Enhancements
OScript long string constants - i.e. string constants delimited by back-ticks (`) - now have a
different highlight color than other string literals, like double (") and single quote (') delimited
string constants. Long string constants may span several lines and the line feed characters
are part of the string. The different highlight color for long strings supports editing them
properly.
• Externalize Strings
A new feature in CSIDE 20.3 is "Externalize Strings", which is like Eclipse's "Externalize
Strings" function for the Java editor.
To use this feature, select Externalize Strings ...on the OScript menu. This brings up a
table of string literals in the active source file (minus any strings marked to not be xlated
via the //$NON-NLS-#$ tags).
From this window, if you click the Ignore button, any strings that have been selected will
be marked in the document as not xlateable. Clicking the Xlate button results in a second
table being displayed which allows you to replace any selected string(s) with an xlate:
On startup, checks are performed for access to folders. Previously, the error messages in the
error log were unnoticeable to users. In CSIDE 20.3, an intuitive warning has been added
when folder access permission is denied.
A usability improvement introduced in 20.3 involves the Debug Perspective of Eclipse which
now includes the OScript Explorer by default.
With this feature, if build automatically is set and an Xlate property file is updated in the
workspace, then it will also get copied over to the server. Furthermore, if a 'full build' is
invoked then any Xlate property file in the workspace that is different from the Xlate property
file on the server will get copied over. In both cases, an info-level message is presented that
mentions the property files were copied over and the end user needs to restart the server for
the change to take effect.
• A new Xlate window should use remember file / group settings from the prior
invocation
When you open a new Xlate window, the window uses the settings from the previous
invocation, rather than displaying a blank window.
• Old format OLL detection and labelling in the Module Explorer View
A new icon has been created to identify and mark old OLL format:
• Release 20.2 provides easy execution of running unit test from the
Modular Explorer.
Support for LAPI was removed from Content Server 16 and later. Applications built using previous
LAPI client libraries will function using the Content Server 10.5 platforms, if integers remain lower than
2,147,483,647.
The Content Server SDK documentation was removed from the Content Server SDK installation
package and is now hosted and maintained on the OpenText My Support.
The following topics have been removed from the Content Server SDK documentation:
• Content Server IDE Plug-in for Eclipse for Windows and Linux
• Eclipse Platform
• Eclipse IDE for Java Developers
• Eclipse IDE for Java EE Developers
• Eclipse IDE for Java and Report Developers
Note: For the latest compatibility information for OpenText products, refer to the Compatibility
Matrix (https://knowledge.opentext.com/go/matrix) on the OpenText My Support.
Component Languages
EN DE JA FR IT ZH ES RU
CSIDE must be installed on the same machine as a Content Server installation. The modifications
you develop in CSIDE on one platform can be deployed in a Content Server installation on any
supported operating system.
For more details on how to install the CSIDE plugin, please access the CSIDE documentation page
on My Support, under the section “Content Server IDE (CSIDE) Plug-in for Eclipse Quick Start
Guide”.
Note: As of Content Server 20.3 the loading of legacy OLLs, the pre-10.5 binary version, will no
longer be supported. Users must use CSIDE 20.3+ to load old formatted OLLs and convert them to
the new format for Content Server 20.3+ to start. CSIDE 20.3+ also supports the loading of greater
than 255 OLLs and is requirement to be at this version or higher.
23.3 OIDE-3952 A warning message is now clearly displayed if user tries to create an
Oscript Project that overlaps with the OTHome directory.
23.3 OIDE-3956 Fixed a bug in the auto edit feature of the OScript editor where extra
closing sequences for comments were automatically inserted whenever
the Enter key was pressed inside a comment.
23.3 OIDE-3947 Fixed a bug in the OScript auto format feature where parts of nested List
or Assoc literals were removed from the code when applying the auto
format.
23.2 OIDE-3901 Fixed a bug in the "double click strategy" of the OScript Editor. Double
clicking elements in the editor typically selects them. When the double
click was applied at the end of (or rather right after) a word, the previous
word was selected. The expectation is, however, that nothing is selected
in this case.
Fixed a bug in the Outline View that is connected to the OScript Editor.
23.2 OIDE-3866
The feature "Sort alphabetically" of the Outline View elements did not
work as expected regarding the grouping of elements in "New",
"Overridden", and "Inherited" elements.
Fixed a bug where the Content Server service could not be stopped for
23.2 OIDE-3585
CSIDE, because the timeout for waiting until the service was actually
stopped was too short. This bug only affected the Linux version of
CSIDE.
Fixed a bug in the auto edit feature for multi-line comments (/** ... */) in
23.2 OIDE-3394
the OScript editor. The comment closing sequence (*/) was not inserted
automatically, unless the comment was the last one in the OScript file.
Fixed a bug in the OScript auto format feature. Indentation was not
23.2 OIDE-3393
correct when only a selection was formatted, and the selection was
preceded by a multi-line list literal definition.
Fixed a bug in the auto indent feature of the OScript editor, where the -
23.2 OIDE-3138
automatically indented - cursor position was miscalculated after entering
a new line.
23.1 OIDE-3579 Content Server IDE matches latest changes in Content Server that not
to run once-per-instance initialization tasks in read-only mode as a
llserverworker thread runs these tasks. If you are using Content Server
version 23.1 or later, you should also use CSIDE version 23.1 or later.
23.1 OIDE-3578 The OScript auto format feature was inserting an extra empty line after
feature definitions that were initialized with a long string.
23.1 OIDE-3389 The OScript auto format feature did not insert a space character
between an IF statement and the following opening parenthesis.
23.1 OIDE-3574 The OScriptVM process was releasing a socket object twice. This
resulted in request handlers returning the "Dispatcher Error: Invalid
request arguments." error when using CSIDE. The bug only affected the
Linux operating system.
22.4 OIDE-3302 Fixed a bug in the WebLingo compiler. Compile errors caused by an
unsupported character encoding of a WebLingo file were not reported in
the CSIDE problem's view and not marked in the UI. If a WebLingo file
cannot be processed due to an unsupported character encoding, the
WebLingo compiler now adds an appropriate error marker on the first
line of the WebLingo file.
22.4 OIDE-3383 Fixed a bug in the OScript auto format feature that resulted in an
inadvertent removal of list expansion operators.
22.4 LPAD- Pagination support added to the REST API for recent history.
105197
22.4 SRCH-6570 Document Conversion Service REST API may become unresponsive
reading HTTP requests when a multi-part file upload is processed.
22.3 OIDE-2806 Ability to cancel unit test execution. Currently unit test execution occurs
as a single server call, and it runs until the call returns. As such
cancelling is not an option. This is not a great experience, especially
when OIDE-2066 introduced the option of running hundreds of tests at a
time.
22.3 OIDE-1964 Added an option that makes CSIDE warn you when comments will be
lost during compilation.
22.2 OIDE-2139 Fixed a bug that resulted in ineffective breakpoints in WebLingo files,
when the breakpoint was created during the startup phase.
22.2 OIDE-2222 Fixed a bug where the use of the "Build OSpace" command could result
in an ineffective breakpoint.
22.2 OIDE-2830 Fixed a bug where the "Build OSpace" or "Build Module" commands
could trigger an unnecessary automatic build of the workspace.
22.2 OIDE-2851 Fixed a bug that resulted in ineffective breakpoints in WebLingo files
when the breakpoint was created during startup.
22.2 OIDE-2860 Fixed a bug that caused the build process to break.
22.2 OIDE-2861 Fixed a bug in the backup mechanism infrastructure that caused some
build breaks as well.
22.2 OIDE-2864 Fixed a bug where creating a new project in a new workspace resulted
in an error. The first build of the new project was not successful,
because the OScriptVM was not started yet.
22.2 OIDE-2865 Fixed a bug where the socket server thread could not be stopped
because the read timeout in Content Server was not set which is
interpreted as an infinite timeout.
22.2 OIDE-2884 Fixed a bug where a non-existing attribute of a breakpoint marker was
accessed which resulted in an "Illegal argument exception".
22.2 OIDE-2968 Fixed a bug that caused CSIDE logs to be created in wrong location.
22.2 OIDE-2978 Improved file handling for OSpace loading when Eclipse is not in synch
with the file system.
22.2 OIDE-2979 Fixed a bug where the OSpace backup folder could appear in the
OScript Explorer when refreshing a project. This could result in an
unexpected automatic build of the project. The OSpace backup folder
has been moved away from the project folder to the workspace folder.
22.2 OIDE-3007 Fixed a bug that caused the creation of a new OScript project to break.
22.2 OIDE-3018 Fixed a bug in the Module Explorer where a right click without any
selection resulted in an error.
22.2 OIDE-3021 Fixed a bug in the Script Feature editor where the icon for the title bar
was re-created every time a new editor window was opened instead of
using the cached image.
22.2 OIDE-3022 Fixed a bug in the "Override Features" command that resulted in a null
pointer exception when the command was invoked when CSIDE is still
in the start-up phase.
22.1 OIDE-2666 Fixed issue of a null pointer on initial project creation happening
occasionally.
22.1 OIDE-2665 Fixed issue of extra empty lines appearing when a function is formatted
multiple times.
22.1 OIDE-2661 Fixed issue of stack frames not always being reloaded during debug.
22.1 OIDE-2660 New Feature: Script errors now have a distinctive icon differentiating
them from compile errors.
22.1 OIDE-2659 Fixed issue of a wrong source file opened from call stack after a script
error.
22.1 OIDE-2653 Fixed minor file read/write issues on case-insensitive file systems.
22.1 OIDE-2645 Closing a project now updates the OUnit view correctly.
22.1 OIDE-2448 Fixed issue that warnings were not appearing during OScript project
creation if the destination folder appears to be set up incorrectly.
21.4 OIDE-1590 New Object should open the new source file.
21.4 OIDE-2278 "The resource tree is locked for modifications" when closing OScript
Source project.
21.4 OIDE-2425 OUnit View: insufficient refresh after unloading test OSpace.
21.4 OIDE-2442 OScript Formatter does not understand "-" in script names.
21.4 OIDE-2453 Eclipse freeze caused by two threads trying to create the same temp
file.
21.4 OIDE-2464 Load / build test OLLs where they exist before generating unit tests.
21.4 OIDE-2527 Creation of test OLL needs to pick up the OUnit view.
21.4 OIDE-2557 Unit test file creation feedback should use multi status.
21.4 OIDE-2604 Errors when starting CSIDE with a closed OScript project.
21.4 OIDE-2607 Variable order of re-factoring reverts the original declaration order.
21.3 OIDE-1972 Cannot create OSpace with error: Unable to update source module's
Ospace list.
21.3 OIDE-2101 Slight behavior change to OIDE-1817 (read-only xlate property files).
21.3 OIDE-2288 Auto close inserts extra "end" statement at Object Definitions.
21.3 OIDE-2339 New objects have incorrect features if it was expanded in module
explorer on restart.
21.3 OIDE-2359 Module Explorer debugging fails when Script and Function name don't
match.
21.3 OIDE-2361 WebLingo builder doesn't handle read-only files in the server.
21.3 OIDE-2367 "SWT Resource was not properly disposed" seen on icon creation.
21.2 OIDE-2251 XLATE keys are not case sensitive according to the server, but within
CSIDE they are.
21.1 OIDE-879 IDE crash when trying to unlock the ospace while in debug mode.
21.1 OIDE-1686 Debugger stepping places locks on the main thread, causing Eclipse to
hang.
21.1 OIDE-1959 Breakpoint markers in 'server' files disappear after building project.
21.1 OIDE-2004 Newline is indenting the function 'end', for no apparent reason.
21.1 OIDE-2134 The module icon has been changed so that the bottom-left corner is no
longer red.
21.1 OIDE-2161 Test OSpaces show up under core module in server after restart.
21.1 OIDE-2163 IDE break/suspend doesn't necessarily happen where breakpoint is.
21.1 OIDE-2176 A number of start-up logging messages on debug have been modified.
21.1 OIDE-2177 Problems with restoring breakpoints after restarting Eclipse / OScriptVM.
21.1 OIDE-2218 Creating projects in folders that were already used by other workspaces.
20.4 OIDE-953 Breakpoints are still active but not visible after an error.
20.4 OIDE-1350 Creating a new OScript Project at a location where already a project
exists removes the <BuildCmd> from the project definition.
20.4 OIDE-1817 Trying to add a group to a read only properties file and cancelling shows
the group in the Xlate dialog.
20.4 OIDE-1866 "Read-Only" file prompt when multiple files have issues.
20.4 OIDE-2020 Create unit test displays multiple pop-ups when error encountered
20.4 OIDE-2071 Exceptions logged with adding breakpoints in non OScript projects.
20.4 OIDE-2076 Script Feature Breakpoints should persist over Eclipse restarts.
OIDE-1785
20.3 Potential NPE in OScriptSourceEditor.syncOutlinePage().
OIDE-1792
20.3 Link to change Xlate source is partially cut off in Find Xlate dialog.
OIDE-1806
20.3 The outline view contextual menu disappears after new document has
been edited.
OIDE-1843
20.3 NullPointer is observed at LocalVariableFinder.java:72.
OIDE-1846
20.3 Build allowed during VM start-up.
OIDE-1848
20.3 Formatter incorrectly indents function parameters.
OIDE-1861
20.3 Export of OBJREF feature that requires hash quotes is incorrect.
OIDE-1871
20.3 Overlay icons in Module Explorer.
OIDE-1872
20.3 Formatting a selection inside a comment sometimes reformats the
wrong part of the document.
OIDE-1904
20.3 Updating read-only files for Xlate / Unit Test sometimes does not prompt
user.
OIDE-1922
20.3 Outline view issue with OS files.
OIDE-1949
20.3 Error logged in OScriptFormattingStrategyTest.testFormat() is
inaccurate.
OIDE-1955
20.3 Jackson Databind upgrade.
OIDE-1960
20.3 OScript format: Unnecessary space added in empty Assoc literal.
OIDE-1963
20.3 Auto insert of 'end' causes issues near variables of type 'Object'.
OIDE-1973
20.3 NullPointerException on full build.
OIDE-1978
20.3 getCSTempDir() in com.opentext.cside.cs.ContentServer returns null if
UploadDirectory preference is set.
OIDE-1986
20.3 HLogger writes empty lines to standard out when checking log file size.
OIDE-2000
20.3 Long-line reformat of function arguments improvement.
OIDE-2029
20.3 Java Debug Info missing.
OIDE-2030
20.3 Module Explorer: object sorting issue resolved.
20.2 OIDE-1931 "Build Automatically" and Xlate "In Workspace" options not working in
unison.
20.2 OIDE-1914 OScriptEditor: AutoIndent uses case sensitive regex to find keywords.
20.2 OIDE-1885 Searching for an Xlate, selecting one, then selecting a different one and
replacing uses first selected instead.
20.2 OIDE-1874 Cannot search in the Xlate tool 'Properties' menu by hitting the first
character of a name.
20.2 OIDE-1804 Unexpected Ctrl-I behavior seen with partial line selection.
20.2 OIDE-1767 "Generate Unit Tests" does not handle read-only files.
7 Known Issues
There are no known issues in this release.
8 Contact Information
OpenText Corporation
275 Frank Tompa Drive
Waterloo, Ontario
Canada, N2L 0A1