Client Tools Usability Improvements
Some Client Tools usability improvements explained.
New installers
- We now have .MSI installers per XMLeditor and no longer per editor version. They will detect and offer you a selection on which version you want to install.
- All .MSI files (and assemblies) are now signed by our legal entity certificate
SDL Trisoft. This avoids the yellow User Account Control (UAC) message indicating that "The publisher is unknown". - The matching ClientConfig.xml was extended and also received a new condition name
ClientEditionto distinct the regular JustSystems XMetaL 8 (8.0-CRCL) with the Japanese JustSystems XMetaL 8 J(apanese) (8.0-J-CRCL) XML editor as their executable file name nor version differs.
Menu option 'Duplicate'
The menu option Duplicate will show up in the folder view and allows you to make a copy of the select item(s). These items can be topics, maps, library topics, images and other (PDF, Word,...). We've also added several Locate in Repository menu options to allow easier navigation to this new functionality.
Similar to other batch functions in the Browse Repository dialog like import images, batch metadata,... the properties dialog will only be raised when required. The title of your object will be concatenated with a sequence number like (1), very similar to a New Folder experience on Microsoft Windows.
The main difference of Duplicate compared to existing functionality Check in as is that you don't have to go over a Check outor Viewoperation into your XMLeditor.
Proxy server authentication support
Client Tools render the preview and comments using a browser control. The browser control potentially used to raise an Authentication Required dialog for proxy server authentication next to the standard Client Tools control Connect to .... The credentials from the Connect to ... control are now automatically pushed into the browser control making the proxy server authentication interaction smoother and more predictable.
The Client Tools will first pick up and respect any .config configured <system.net><defaultProxy> entries. Any .config entry overrides the standard operating system proxy settings, as typically configured and viewable in Microsoft Internet Explorer .
Preview does dynamic link text resolving for <xref>, <link> and <topicref>
When browsing the repository in a Insert Hyperlink dialog the Text to display text field will be left empty. Publication Manager and the XML editors involved will try to resolve the empty <xref> element in this case by looking up a title in the referenced @href object. [TS-5966]
Our Client Tools' preview will do dynamic resolving for link texts on <xref>, <link>, <topicref> and derived elements. Dynamically resolved titles are rendered within a light-gray box. The blue underlined links in the preview are now actionable and will trigger a Locate operation in the application.
Preview resolves @conrefs and @conref ranges
Like before, your active publication in Publication Manager will be used as context to resolve versions of the necessary referenced resources.
From now on, your XML editors integration and previews like in Browse Repository or Where Used will render dynamic content like @conref. The resource will be resolved based on the LatestVersion principle.
Preview XML pretty print
Toggling to the XML view of your rendered object will show you the XML using syntax highlighting. The Client Tools preview option to do an XML View has been standardized to use pretty printing. Before you could have a text based XML view or pretty printing depending on having commenting enabled or disabled. In case you want to see the unprocessed XML, we suggest to go to the LocalStorage on the file system. [TS-6419]
Conditions are rendered in the tree
The tree representing the resolved OASIS DITA Maps are no also color coded with a red or green background to indicate if the tree node and its children will be part of the publication or not. The calculation method is exactly the same as when looking at the color coding of a previewed map in Publication Manager. [TS-8608]
Conditions render using labels instead of identifiers
@ishcondition consists out of readable identifiers (Internal Names). From now on the user interface Context Builder in Publication Manager, and Condition Builder in Publication Manager and XML editors will resolve the internal names to labels (if available in your configuration through ishconditionmanagement) for all UI read only screens. [TS-8465|TS-8464]
Batch metadata extended to allow append operation on multi-value fields
A commonly heard request was to allow an Append operation on multi-value fields. We introduce a placeholder that will show up in the metadata assist window when doing a group action on multiple objects. So on ListOfValue fields like for example Requested Languages, you can now add languages to your selected objects. [TS-4334]
As reminder this functionality allows you to reassign multiple topics to a different person or change the status of multiple topics.
Publication Manager menu options 'Open...', 'Open With...' and 'Check Out With...'
Publication Manager shows you the new options Open..., Open With... and Check Out With... in the context menus.
The tree view in Publication Manager had a Check Out menu option which will still immediately check out the selected map inside Publication Manager. The newly added option Check Out With... will trigger your operating systems Choose the program dialog. This allows you to select your favorite XML editor to start editing the OASIS DITA Map.
Menu options Open... and Open With... are added and allow you to open the selected item in your XML editor. Where Open... will use the program linked to .xml and Open With... will trigger your operating systems Choose the program dialog. If a file was already checked out before, then the file will be opened ready for editing in your XML editor.
Publication Manager menu option 'Clean Up'
When working on a publication, it can happen that the baseline overview contains lots of unreferenced objects. This can be caused by selecting different versions of maps or topics which in turn add or remove linked topics or images. Or because the baseline is shared among publications. When executing a Release of your PublicationOutput (essentially the baseline Freeze) will clean up the unused items across all publications. Users requested a manual action that forces a baseline clean-up without freezing it.
The menu option Clean Up appears in Publication Manager's baseline view. All objects not referenced by any publication using the baseline are removed from the baseline.
It is important to know that this baseline operation is executed server-side, so using the objects as available in the repository. This means that Publication Manager will request you to make every checked out object available on the server by triggering a save action.
Publication Manager menu option 'Refresh'
Publication Manager has a main menu option Refresh. This refreshes the current publication; thereby updating panes like the tree, baseline, etc.
Every pane that supports it, received a local Refresh option. So a toolbar button and context menu item on panes like Output, Preview, etc. The tool tip messaging is more clear on which area it will have an effect.
The well known shortcut key F5 will refresh the pane with focus.
Publication Manager Where Used shows 'all' publication versions upon selection of any object
When selecting an object in Publication Manager, the where used reports shows all the relevant publications based on latest version principle. In the table below you see the new information result items highlighted compared to the previous release. The default value of this report control changed from Publication to Repository. [TS-5825]
| Selected type | Map | Topic | Image | Library | Variable | Condition |
|---|---|---|---|---|---|---|
| Resulting type | Map, Topic, Library, Publication | Map, Topic, Library, Publication | Map, Topic, Library, Publication | Map, Topic, Library, Publication | Map, Topic, Library | Map, Topic, Library |
Publication Manager allows a full text search limited to the Current Publication
To better support Find and Replace scenarios we introduced a heavy-lifting full text search functionality in Publication Manager. You can now make use of all full text search functionality you know off, and have your search results limited to the Current Publication. The Search Results widget then allows actions like Locate in Publication and Check Out. [TS-46]
Important to know is that search results are always sorted by ISHSCORE, so best match. The query will make use of your current publication's working language and resolution to know which objects are part of your publication. The query is executed server-side, that is why Publication Manager will prompt you to optionally save all your current edits because a simple edit to your Map could have an effect on your search results.
Publication Manager allows to resolve duplicate variable assignments
When multiple resources define the same variable (so same @varid), the variable reporting screen will now show you an entry for every resource that defines the variable. This allows you to resolve conflicts like "The variable is defined 2 times.". [TS-6926]
Publication Manager system status icons
- Warning / Error
- No version selected
- Released
- Checked in / Checked out by another user / Checked out
Condition Manager got the standard Where Used pane
- improved performance
- latest version view only, so not showing all versions anymore
- the context menu functionality you are used to
Authoring Bridge menu option 'Check In All...'
In your XML editor the SDL LiveContent menu now received an option Check In All.... The option will attempt to check in all open files to the repository.
DITA2Trisoft
DITA2Trisoft command line options to run it unattended. When you run from the command line, no user interaction is required. The actions that the tool is to perform are passed in the command line parameters. Errors and other messages are logged to a file and the program closes automatically when it is finished with the requested task(s).