Configure what content is exported
You can define which content you want to download from Inspire using export configurations. You'll need to specify the component type and, within that component, which referenced content you want to export. To define how content is transformed when exported, you can also add a custom Extensible Stylesheet Language Transformation (XSLT). Export configurations can also be created for publishing and translating components.

Required permissions
You must have administrator permissions to work with export configurations.
- If you go to the top menu and can see the
Administration option, then you have the necessary permissions. - If you can't see the
Administration menu, contact your local administrator.

FAQ's
- Can I export the folder structure along with the components?
- Can I save an export configuration under a new name?
- Do export configurations only use DITA references?
- Can I add multiple XSLT files?
- Which export type should I use?
- What are relations?
- How do I specify which component types should use an export configuration?
- I don't have an option to export content to my SFTP server. How do I get it?






Can I export the folder structure along with the components?
Yes, if you:
- Are logged in as an Admin
- Export one or more component(s) (and not History records)
- Select the Create subfolders option (it isn't selected by default)
- The Create subfolders option is not available:
- On the History tab
- For Deleted items
- In a Project
Results:
- The files are exported in a folder structure and zipped
- If a single file is exported, it is still zipped
- If the folder structure contains empty folders, the empty sub-folders are not included
The export uses the following format:
Export-{Component Name}-{date/time}.zip
- For example, Export-Cloud_Computing-2022-12-21-03588.zip
- {Component Name} is the source component you select.
- The Component Name is truncated after 50 characters.





Can I save an export configuration under a new name?
Yes.
This helps you avoid making multiple export configurations with subtle variations. You can create a master configuration, then save it under a new name to make changes.

After the new copy is created, you can change settings on any of the following tabs.
- Details
- Relations
- Source Component Types
- Plugins
- Permissions
- Transforms





Do export configurations only use DITA references?
No - you have other options.
You can use DITA references and also use XSLT rules.
You can export references to XML link types, attributes, and elements. This can include conrefs, DocBook hrefs, filerefs, images, and XPointers. You can create an XML link type by specifying a link method, attributes, and a schema standard. Follow the steps in Create an XML link type.
For example, you can set up a conref configuration that exports a DITA topic's content using only the DITA conref attribute. This export configuration won't include content referenced using the DITA href attribute, such as images and cross-references. This configuration is useful when exporting a component to translate the text in a conref.





Can I add multiple XSLT files?
Yes, you can have:
- Multiple stylesheets in one export configuration.
- Multiple export configurations with one or more stylesheets.





Which export type should I use?
You select an export type based on how you want to use the content after downloading it. All export types can be configured with Source Components, Relations, and Permissions. Although the Plugins tab is always available, you should use it only for Publish export configurations. You can select from the following export types:
- Standard - Use this option to download content that you aren't going to publish or translate. For example, you can use the Standard export type and a relations list that includes image references to download a list of links in all topics. This is a quick way to extract the location and names of all images used in a project.
- Publish - Use this option when you want to download the content in a specific format so that it can be published. When you choose a Publish export type, you can also specify plugin information that can be used to further customize the format of your exported content and, optionally, any parameters that are available. For example, you can use the Publish export type with a relations list for DocBook content (DocBook Filename, Href, Linkend, and XPointer) and publish to HTML or PDF using a PublishDocBook plugin.
- Translate - Use this option when you want to include or exclude content from translation. This option is useful when you want to define the content in the copies that Inspire creates for translation. For example, if you don't want images translated, you can use the Translate export type with a relations list that doesn't include image links. This tells Inspire to create translation source files that don't contain any images.
- Compare Content - Use this option when you want to export a comparison of content within components. For example, if you want to see if any references changed between versions, you can use the Compare Content export type with a relations list that includes hrefs and conrefs to see what changed





What are relations?
A relation defines what the objects in the export configuration have in common.
- Usually, a relation is an XML Link type that all components have and can be exported, such as DITA conref.
- If you're an administrator, you can define the way XML elements are connected by creating a relationship.
- For example, you can create a relationship to collect DocBook filenames by URI using the XML link type of fileref. You can then use this relationship to create an export configuration that downloads the locations of DocBook files.
- For more information, read Create a relationship configuration.





How do I specify which component types should use an export configuration?
When you create the configuration, you'll see a tab labeled Source Components.
- This is where you identify which types of components are exported.
- For example, you select all the files in a project (DITA concepts, DITA map, and binaries) and choose to export them.
- If you select an export configuration that lists only a source component in a DITA map, the other files you're exporting won't be included in the downloaded output.





I don't have an option to export content to my SFTP server. How do I get it?
Contact your Vasont representative.
- The Secure File Transfer Protocol (SFTP) server configuration is completed by a Vasont Operations team member.
You must provide Vasont with the details needed to connect to your SFTP server. - Vasont will configure an export plugin to add support for sending Inspire files to your SFTP server.

- The SFTP server configuration is stored in the secure Azure Key Vault.
- To check your list of plugins for ExportToSFTP, follow the steps in: View your export plugins.
- After the configuration is complete, you must create a new export condition for SFTP. In Export Type, select SFTPServer. Follow the steps in: Create an SFTP export configuration.
You can also update an existing configuration to select the SFTPServer option. Follow the steps in: Update an export configuration.
- After you create the SFTP export configuration, when a user opens the Components browser, selects a component, and chooses Export, there is an option for Export to SFTP (or whatever name you gave to the configuration.)

The user receives the following notifications:- The export process has begun
- Export to SFTP Server Submitted Successfully
- Export to SFTP Server Updated (indicating that export request has been received by the Inspire SFTP server)
- Export to SFTP Server Completed Successfully