About conversion from Simple XML to Dashboard Studio

Optimize your dashboard building time by converting Simple XML dashboards to Dashboard Studio instead of rebuilding dashboards from the beginning. The conversion process makes a copy of your original Simple XML dashboard to provide the ability to maintain the original while making updates to the Dashboard Studio version.

Reconvert your dashboards with each new version of the Splunk platform to benefit from new functionalities, such as additional automatic conversions from Simple XML to Dashboard Studio.

For more details about starting the conversion process, see Convert a Simple XML dashboard to a Dashboard Studio dashboard.

Inspect changes with the conversion report

The conversion process also includes a conversion report that lists configurations that Dashboard Studio does not automatically convert and offers alternative suggestions that use Dashboard Studio functionality. For example, the conversion report lists visualizations that automatically convert and additional context for visualizations that need manual updates.

Compare conversion for different dashboard components

The Simple XML to Dashboard Studio conversion attempts to convert all dashboard components automatically. However, different components convert to varying extents of fully converted, semi-converted, and unsupported.

• Fully converted components automatically appear in Dashboard Studio without needing manual updates.
• Semi-converted components need manual updates. For example, you can manually update Simple XML conditional visibility by configuring a Dashboard Studio dashboard to show or hide panels conditionally.
• Not converted components aren't supported in Dashboard Studio and have no workaround. You can experiment with different Dashboard Studio features to create similar functionality for unsupported components.

Visualizations

The following table displays which visualization components are fully converted, semi-converted, or not converted. The table also shows if Dashboard Studio supports the component.

Component	Conversion status	Support status	Notes
Standard charts	Fully converted	Supported	Dashboard Studio supports all standard charts, excluding the radial gauge visualization.
Maps	Fully converted	Supported	The conversion does not convert coloring for choropleth maps with categorical coloring. You can reconfigure the coloring with the Dashboard Studio UI.
Drilldown configuration	Fully converted	Supported	Predefined tokens have a different naming system in Dashboard Studio. For example, $click.value2$ in Simple XML is now $value$ in Dashboard Studio.
Trellis layout	Semi-converted	Semi-supported	Dashboard Studio only supports trellis layout for single value visualizations. For other visualizations, you can create a similar effect to trellis layout by creating multiple instances of a visualization and putting the visualizations in a grid.
Conditional visibility	Semi-converted		Dashboard Studio does not automatically convert conditional visibility. Depending on whether data is available to display, you can configure dashboards to conditionally show or hide panels in Absolute layout. For more details, see Conditionally show or hide panels.
Table coloring configurations	Semi-converted	Semi-supported	Dashboard Studio supports most coloring configurations, excluding heatmap, high/low, or gradient percentile scale coloring.
Custom third party visualizations	Semi-converted	Semi-supported	Dashboard Studio does not support third-party visualizations. However, you can find many popular visualizations in Dashboard Studio, such as Sankey, punchcard, and parallel coordinates. Additionally, some visualizations convert to alternative visualizations. For example, the horseshoe meter converts to a single value radial. For more details, see Add and format visualizations.
Prebuilt panels	Not converted	Not supported	Dashboard Studio does not support prebuilt panels.
Iframes	Not converted	Not supported	Dashboard Studio does not support iframes.

Data sources

The following table displays which data source components are fully converted, semi-converted, or not converted. The table also shows if Dashboard Studio supports the component.

Component	Conversion status	Support status	Notes
Inline search	Fully converted	Supported	n/a
Saved searches	Fully converted	Supported	Dashboard Studio does not support the cache option for saved searches.
Base and chain searches	Fully converted	Supported	n/a
Sample ratio option	Not converted	Unsupported	Dashboard Studio does not support the sample ratio option for data sources.

Inputs

The following table displays which input components are fully converted, semi-converted, or not converted. The table also shows if Dashboard Studio supports the component.

Component	Conversion status	Support status	Notes
Standard inputs	Fully converted	Supported	Standard inputs include time, dropdown, multiselect, and text. Dashboard Studio also supports a number input.
Submit button	Fully converted	Supported	n/a
Inputs on canvas	Fully converted	Supported	In Dashboard Studio, inputs on canvas are independent of panels. You can place inputs above or next to panels.
Radio, check box, and link list inputs	Semi-converted	Semi-supported	Certain form inputs convert into different input types in Dashboard Studio. For example, radio inputs convert to dropdown, link lists to dropdown, and check box inputs to multiselect. You can also manually update the converted input type to any input of your choice.
Prefix and suffix attributes	Not converted	Unsupported	n/a
Delimiters for token values	Not converted	Unsupported	n/a
Delimiters in SPL queries	Semi-converted	Semi-supported	The multiselect input currently only supports the comma (,) delimiter in SPL queries. To read more on using multiselect inputs, see Multiselect.
Input change handler	Not converted	Unsupported	Dashboard Studio does not support input-specific change handlers, but you can add logic to searches and then reference results as tokens. For more details, see Setting tokens from search results or search job metadata.
Input event handlers	Semi-converted	Semi-supported	Inputs do not automatically convert certain event handlers, such as conditional event handlers. You can manually update the inputs by setting and evaluating tokens for specific conditions. For more details, see Setting tokens from search results or search job metadata.
Default value	Fully converted	Fully supported	n/a
Initial value	Not converted	Not supported	Converted inputs support the setting for a default value, but not an initial value.

Interactivity, tokens, and drilldown

The following table displays which interactive, token, and drilldown components are fully converted, semi-converted, or not converted. The table also shows if Dashboard Studio supports the component.

Component	Conversion status	Support status	Notes
Eval or condition match tokens, <change> and <init> tags	Semi-converted	Semi-supported	To work around this semi-conversion, evaluate token values inside a search and use search tokens to access the results. For more details, see Setting tokens from search results or search job metadata.
Unsetting an event handler	Semi-converted	Semi-supported	Dashboard Studio does not support unset tags for event handlers. You can conditionally show or hide panels based on data availability. For more details, see Conditionally show or hide panels.
Predefined time tokens	Not converted	Unsupported	Predefined time tokens include $earliest$ and $latest$.
Search event handlers and advanced token logic	Not converted	Unsupported	Dashboard Studio replaced search event handlers with tokens. Like event handlers, you can use tokens that automatically set based on the job status, metadata, or results of a search. For more details, see Setting tokens from search results or search job metadata.
Advanced token logic	Not converted	Unsupported	n/a
Visualization event handlers	Not converted	Unsupported	Dashboard Studio does not automatically convert visualization event handlers, which typically use drilldowns. You can manually update visualizations. For more details, see Setting tokens.

Dashboard level configurations

The following table displays which dashboard level components are fully converted, semi-converted, or not converted. The table also shows if Dashboard Studio supports the component.

Component	Conversion status	Support status	Notes
Light theme and dark theme	Fully converted	Supported	n/a
Hide Edit button	Fully converted	Supported	n/a
Hide Open in Search button	Fully converted	Supported	n/a
Hide Export button	Fully converted	Supported	n/a
Hide Splunk bar, App bar, or filters	Not converted	Unsupported	Dashboard Studio does not support hiding Splunk bar, App bar, or filters.

Extensions

The following table displays which dashboard extension components are fully converted, semi-converted, or not converted. The table also shows if Dashboard Studio supports the component.

Component	Conversion status	Support status	Notes
Custom CSS	Not converted	Unsupported	Dashboard Studio does not automatically convert custom CSS. With the Dashboard Studio UI, you can update common CSS use cases, such as setting a background color and changing a font style. For more details, see Set up a dashboard.
Custom JavaScript	Not converted	Unsupported	n/a
Custom third party visualizations	Not converted	Unsupported	n/a
HTML panels	Semi-converted	Semi-supported	Dashboard Studio automatically converts only some HTML components. You can replace your HTML panels with Markdown. For more details, see Add text, links, and images with Markdown. For more about HTML conversion, see HTML to Markdown conversion.

Sharing dashboard content

The following table displays which dashboard sharing components are fully converted, semi-converted, or not converted. The table also shows if Dashboard Studio supports the component.

Component	Conversion status	Support status	Notes
Export to PDF	Fully converted	Supported	n/a
Update permissions	Fully converted	Supported	n/a
Scheduled email export	Not converted	Unsupported	n/a

HTML to Markdown conversion

During the dashboard conversion process, Dashboard Studio converts most components of HTML panels to Markdown. After conversion, the conversion report lists which HTML components Dashboard Studio fully converted and which did not. For HTML components that do not convert, Dashboard Studio preserves the source code in the Markdown component for reference. For example, iframes do not fully convert, which results in Dashboard Studio displaying the original iframe source code in a Markdown panel for preservation.

The following table shows the HTML components that Dashboard Studio fully converts.

HTML component	Conversion status	Support status	Notes
Images	Fully converted	Supported	n/a
Text	Fully converted	Supported	n/a
Links	Fully converted	Supported	n/a