Release Notes 2022.1.6.0

When you're organizing topics into a map's hierarchy, you can change how you see the content in a map. You can view the actual content in the topic without leaving the Oxygen map editor.

You can now see the Topic Title in the Topic Content view.

For more details, read:

• Change how a map displays in Oxygen
• Display topic content in a map

If you don't want to edit the content in a component, you can just view it in Oxygen as Read-Only.

While developing content in Inspire, you have more choices when comparing content.

• History - opens a list of related snapshots so you can select an older version to compare to the component you're currently editing.
• Branch - opens a screen to find branches related to the component you're currently editing.
• Component - opens a screen so you can select an unrelated component to compare to the one you're currently editing

For more details, read:

• Compare and merge versions in Oxygen
• Compare and merge with a historical snapshot
• Compare and merge branched versions
• Compare and merge with an unrelated component

To perform an action on multiple components at once, you can select a few components, an entire page, or all pages of components in a folder.

When you select more than one component, Inspire opens the Selected Components panel.

On the Selected Components panel, after the name of the component, there is a new context menu (three horizontal dots).

• Edit - Opens the component in the Oxygen XML Editor. If the component is a workflow, then it's opened in the workflow editor. This option doesn't work for binary components.
• View - Opens the component in the Oxygen XML Editor as Read Only. If the component is a workflow, then it's opened in the workflow editor as Read Only. If the component is a binary, then it's opened in a viewer.
• Go to - Displays the component on the Components tab in the grid and selects the component. If the component isn't listed on the first page, then Inspire displays the page where the component is listed.

You can access this new menu when you select multiple components from:

• The Components browser
• A project when you add components

For more details, read:

• Select multiple components from the Components browser
• Create a project from components 

Malformed XML is no longer imported.

• If you import an XML that has incorrect syntax or uses an illegal characters, Inspire no longer imports the XML file as a binary with an InvalidXML file type.
• After Inspire shows you an error, the malformed XML file is skipped.
• You can correct the XML errors and try again.

Important

• During import, Inspire does not check to see if your document conforms to the XML syntax rules of a Document Type Definition (DTD) , XML Schema, or other type of schema that defines the structure of an XML document.
• Well-formed XML that doesn’t parse against the Schema is imported without error.
• To see any schema errors, you can:
  • Export the XML errors reported in Oxygen
  • Go to the Component's browser and use the Validate XML option

For more details, read:

• Import components
• Import components using drag and drop
• Import components by browsing

File names must be 200 characters or less.

• When you create a component in Inspire, you must use a component name of 100 characters or less.
• When you export a component, a GUID (globally unique identifier) is added to the file name.
• When you import a file back into Inspire, the file name and GUID together must not exceed 200 characters.
• If the file name and GUID length exceeds 200 characters, Inspire won't import the file.

For more details, read: Create a component.

You can use a component's snapshot history to select two versions and display the differences between them in two side-by-side panes in a read-only viewer.

• This feature is only available for components that are not binary or workflow components.
• You can use this feature to view two read-only components at the same time.
• You can't change any components or snapshots you view as read-only, but you can now use Merge As to save merged changes to a new file.

For more details, read:  Compare component snapshots side-by-side

Previously, if you:

1. Open a map component.
2. In the map, open a referenced file for editing.
3. Make a change to the file.
4. Click Save and Submit.
5. In the Oxygen map editor, refresh the map to see updates in the referenced file.
6. Repeat steps 2 and 3.

You see this result: If you click an option on the toolbar, nothing happens.

Now, when you make changes to components referenced in a map, if you click an option on the toolbar, the option functions as expected

For more details, read: Display topic content in a map.

Previously, if you:

1. Go to Components.
2. Create a new map.
3. Create a new concept.
4. Open the map and add a topic reference to the new concept.
5. Open the concept and add some track changes and comments.
6. In the Components pane, select the new map.
7. Right-click the map's row, and the select Check component completeness.

You see these results:

• For both new and updated maps and components, a completeness report is generated.
• When you view the report, in the section called Components with Comments or Track Changes, it displays a message that "No components match this criteria."

Now, when you include components that have comments or tracked changes, they are listed in the completeness report in the section called Components with Comments or Track Changes.

For more details, read: View a completeness report.

Previously, if you:

1. Click Components.
2. In the Folders pane, locate the component that you want to restore to a previous version.
3. In the Components pane, right-click the component and then select Details...
4. On the Component Details screen, select the History tab.
5. In Search, enter a keyword or phrase found in a snapshot's name.
6. Click Search.

Previously, if you:

1. Click Components.
2. To view a component and not make changes, right-click the component, and then select View...
3. In the Oxygen editor, to save a copy for editing, in the toolbar, click Save as.

You see this result: No screen opens so you can save the read-only file with another name.

Now, when you click Save as, a screen opens so you can save the read-only file with another name

For more details, read: View a component without locking it.

Previously, if you:

1. Click Components.
2. In the Folders pane, navigate to a map using the Arabic language that you want to update.
3. In the Components pane, right-click the map component and then select Edit...
4. To see a topic's content that is written in Arabic, click the blue expand button.

You see these results:

• No content displays.
• An error similar to: "Conversion of one or more characters from XML to target collation impossible" is caused by "RetrieveXmlComponentElementsWithAttribute" cast to varchar rather than nvarchar. nvarchar is required for Arabic.cast(XmlContent.query('//*[@{0}]') as varchar(max))

Now, when you click the blue expand button, the topic's content is shown and DITA keys are built properly.

For more details, read: Display topic content in a map.

Previously in Inspire you could add a profiling attribute to any DITA element, even if the element didn't allow their use. In this case you would see a validation error.

For example, you could:

1. Open a component for editing.
2. Insert a table.
3. Add a profiling attribute to a table cell element.

You see this result: The DITA element doesn't allow for the use of a profiling attribute, and it generates an error.

Now, if you:

1. Open a component for editing.
2. Select a DITA element that doesn't allow for profiling attributes.
3. Click Update Profiling Attributes (Ctrl+Alt+F).

You see these results on the Update profiling attributes screen:

• No attributes are listed.
• You only see profiling attributes if the element allows them.

If you need to apply a profiling attribute to content, move the content into a DITA element that allows for the use of profiling attributes.

For more details, read:

• Use profiling attributes
• Apply profiling attributes

Previously, if you:

1. Click Projects.
2. On the Project Management tab, all projects in your organization are listed.
3. To download a list of specific projects, you can:
   1. Filter the list of available projects by words in the project name. In the Search text box, enter a keyword, and then click Search.
   2. Filter the list of available projects to include only those you own or are participating in. In Type, select an option to filter the list by that criteria.
   3. Include completed projects in the list by selecting Include Completed and then clicking Search.
4. Click Save as CSV.

By default, Inspire sends a notification to:

• A user's Notifications tab
• The email address associated with their Inspire account

If you want Inspire to also send the notification to a user's Slack workspace, you can update an Inspire webhook.

• You must be an Administrator to work with webhooks.
• Use the webhook Link action to log into Slack and identify your company's Slack workspace.
• Once linked to Slack, Inspire sends notifications to users in that workspace.
• Inspire identifies the user in the Slack workspace by the email address associated with their Inspire account.
• If a user is not found in the Slack workspace, Inspire doesn't send a Slack notification.

For more details, read:

• Use a webhook to send notifications to Slack
• Link a Slack workspace to Inspire