Documentation Center

Modifying AppData settings after installing or upgrading Contenta S1000D

After installing or upgrading Contenta S1000D, review new and updated AppData settings and modify the default values as needed to suit your preferences.

Contenta S1000D AppData settings are set to the default values shown below, for the Global user only, when you create a new Contenta S1000D database or upgrade an existing database to Contenta S1000D 5.9. AppData values for other users are not automatically set.

To access AppData, in Contenta Explorer click Tools > Options > Tool Preferences. AppData settings in this topic are generally organized by their AppData path location to facilitate finding the settings and modifying them as needed.

New AppData Settings in Contenta S1000D 5.8
Table 1. bytesPerRequest
Tool or UIS1000D Upload Content
AppData Path

{Global} > Settings > CaS_Upload

Value

bytesPerRequest

Use

Specifies the size (in bytes) of data chunks to be transferred when uploading files larger than 200 MB.

Default104857600
NoteHelps prevent Tomcat out-of-memory and IIS maximum content length issues related to connection speed. Lower this setting for slower connections.

Table 2. application/vds
Tool or UI Content Check Out, Content Check In, Content View, Content Fetch, Check Out, Check In, Edit, View
AppData Path{Global} > mimetypeMappings
Valueapplication/vds
Use

Maps MIME type to .vds file extension for SAP VDS multimedia files.

Default .vds
Note

Table 3. application/octet-stream
Tool or UI Content Check Out, Content Check In, Content View, Content Fetch, Check Out, Check In, Edit, View
AppData Path{Global} > mimetypeMappings
Valueapplication/octet-stream
Use

Maps MIME type to .fla file extension for FLA multimedia files.

Default .fla
Note

Table 4. application/octet-stream
Tool or UI Content Check Out, Content Check In, Content View, Content Fetch, Check Out, Check In, Edit, View
AppData Path{Global} > mimetypeMappings
Valueapplication/octet-stream
Use

Maps MIME type to .fla file extension for FLA multimedia files.

Default .fla
Note

Table 5. enableManageInternalReferencesOnInsert
Tool or UI Manage Internal References
AppData Path{Global} > Settings > Editors > cw_xml_co > enableManageInternalReferencesOnInsert
ValueenableManageInternalReferencesOnInsert
Use

Determines whether the Contenta Manage Internal References tool launches when a user selects Insert > Markup in Arbortext Editor or Oxygen XML Author.

DefaultDefaults to off in an upgraded CSDB; change to on to launch the tool automatically when a user selects Insert > Markup.

Defaults to on in a new CSDB.

Note

New AppData Settings in Contenta S1000D 5.6
Table 6. supportMultipleLanguages
Tool or UIContenta Explorer, Contenta Web
AppData Path

{Global} > Settings > CaS_Languages

Value

supportMultipleLanguages

Use

Enables support of S1000D modules in multiple languages.

Defaultno
NoteDefaults to no in an upgraded CSDB for backward compatibility; change to yes to enable support for multiple language objects in the CSDB. Defaults to yes in a new CSDB. This setting is global, affecting the entire database, and cannot be set at the user level.

Table 7. sourceLanguageCountryCode
Tool or UIContenta Explorer, Contenta Web
AppData Path

{Global} > Settings > CaS_Languages

Value

sourceLanguageCountryCode

Use

Specifies the source language and country of objects.

DefaultEN-US
NoteThis setting is ignored if supportMultipleLanguages is set to no.

Table 8. includeLanguageCountryCodeInSourceObjectNames
Tool or UIContenta Explorer and Contenta Web
AppData Path

{Global} > Settings > CaS_Languages

Value

includeLanguageCountryCodeInSourceObjectNames

Use

Determines whether the value specified for sourceLanguageCountryCode is appended to the names of source objects when they are created.

DefaultDefaults to no for upgrades; yes for new installations.
NoteFor new databases, the recommended setting is yes. This setting is global, affecting the entire database, and cannot be set at the user level. It is ignored if supportMultipleLanguages is set to no.

Updated AppData Settings in Contenta S1000D 5.6
Table 9. listViewPropertyFields
Tool or UIContenta Explorer, Contenta Web
AppData Path

{Global} (or user_desktop) > Settings > Display

Value

listViewPropertyFields

Use

Defines all property fields to be displayed as columns in the list view. This list includes properties from multiple object types. Names are case sensitive and must be comma-separated.

Default

Document Type, Technical Name, Information Name, Information Code, System Difference Code, Language ISO Code, Country ISO Code, Publication Module Title, SCORM Content Package Title

NoteAdd or remove property fields from the default list as desired. The Language ISO Code and Country ISO Code property fields have been added to this setting to allow sorting the List View by language or country code.

New AppData Settings in Contenta S1000D 5.5
Table 10. application/vnd.openxmlformats-officedocument.wordprocessingml.document
Tool or UI Content Check Out, Content Check In, Content View, Content Fetch, Check Out, Check In, Edit, View
AppData Path

{Global} > mimetypeMappings

Value

application/vnd.openxmlformats-officedocument.wordprocessingml.document

Use

Specifies a Word mime type mapping. This is used to control which file extension is added to a Word (.docx) file when it is exported for content editing or viewing.

Default.docx
Note
Table 11. application/vnd.openxmlformats-officedocument.presentationml.presentation
Tool or UI Content Check Out, Content Check In, Content View, Content Fetch, Check Out, Check In, Edit, View
AppData Path

{Global} > mimetypeMappings

Value

application/vnd.openxmlformats-officedocument.presentationml.presentation

Use

Maps MIME type to .pptx file extension.

Default.pptx
Note
Table 12. application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Tool or UI Content Check Out, Content Check In, Content View, Content Fetch, Check Out, Check In, Edit, View
AppData Path

{Global} > mimetypeMappings

Value

application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Use

Maps MIME type to .xlsx file extension.

Default .xlsx
Note
New AppData Settings in Contenta S1000D 5.4
Table 13. customS1000DEditorPath
Tool or UIContenta Web checkout tools
AppData Path

{Global} (or user desktop) > Settings > Editors > cw_xml_co

Value

customS1000DEditorPath

Use

Specifies the path to a custom S1000D XML editor to be launched with the Contenta S1000D Web Check Out tool.

Defaultempty
NoteDefaults to empty for backward compatibility.

This AppData setting is not supported in Contenta S1000D 5.8 and later.

Table 14. launchCustomS1000DEditor
Tool or UIContenta Web checkout tools
AppData Path

{Global} (or user desktop) > Settings > Editors > cw_xml_co

Value

launchCustomS1000DEditor

Use

Specifies the whether to launch a custom S1000D XML editor with the Contenta S1000D Web Check Out tool.

Defaultno
NoteDefaults to no for backward compatibility; change to yes if using a custom S1000D XML editor.

This AppData setting is not supported in Contenta S1000D 5.8 and later.

New AppData Settings in Contenta S1000D 5.3
Table 15. createSystemDifferenceCodeObjects
Tool or UIS1000D Upload Content
AppData Path

{Global} > Settings > CaS_Upload

Value

createSystemDifferenceCodeObjects

Use

Specifies whether the System Difference Code layer should be included in the S1000D hierarchy.

DefaultDefaults to no for backward compatibility with earlier databases; yes for new databases.
NoteImpacts the following tools:
  • S1000D Upload Content: Uploading DMs and ICN-based graphics.
  • S1000D Define DRML and IRL: When the option to create a DM or ICN from the code is checked.
  • S1000D Manage DMRL and IRL: When the create tool is selected for a DM or ICN. Uploading PMs or SCORM Content Packages is not impacted by this change.
New AppData Settings in Contenta S1000D 5.0
Table 16. DModule, PModule, Dispatcher, BMP, GIF, JPG
Tool or UIContenta Web
AppData Path

{Global} (or user_desktop) > content@web > Settings > ObjectViewPrefTools

Value

Six values (Contenta object types): DModule, PModule, Dispatcher, BMP, GIF, JPG

Use

Specifies the default web tool for a Contenta object type.

Default

For DModule: S1000D LiveContent Preview

For PModule: S1000D Publish

For Dispatcher: S1000D DDN Export

For BMP, GIF, JPG: Content View

NoteYou can change the default web tools as desired, and add default tools for other object types as well. Different users can have different default tools. For example, a writer may have Arbortext (the round-trip edit tool) as their default tool for DModule objects, whereas a reviewer may have or Fetch as their default tool for DModule objects.
Table 17. stylesFolder
Tool or UIS1000D LiveContent Preview
AppData Path

{Global} > Settings > CaS_LCPreview

Value

stylesFolder

Use

Specifies the name of the LiveContent styles folder.

Default

s1000d

NoteContenta S1000D delivers default styles to the s1000d folder. If you have your own custom LC styles that you want to use instead, change this value to the name of your LC styles folder. See the Configuring LC Preview to use custom styles topic in the Contenta S1000D Installation and Upgrade Guide.
Table 18. applicIdPrefix
Tool or UIManage Applicability (Contenta S1000D Editor plug-in)
AppData Path

{Global} > Settings > CaS_ManageApplic

Value

applicIdPrefix

Use

Specifies the prefix for system-generated Applicability IDs. This prefix applies across the CSDB, not to a particular ACT file.

Default

app

UseChange this value to a different value if desired.

Table 19. enableBrexValidation
Tool or UIS1000D Validate
AppData Path

{Global} (or user_desktop) > Settings > CaS_Validate

Value

enableBrexValidation

UseIndicates whether a user may access the Validate BREX options in the Validate tool interface.

When set to no, Validate BREX options do not appear in the UI.

Default

yes

NoteYou may want to set the Global value to no for all users by default, then add the enableBrexValidation value under individual users' desktops in the Settings > CaS_Validate path and set this value to yes for users whom you want to have this permission. If the value is not found for a user, the Global setting is used.
Table 20. displayName
Tool or UIContenta Explorer, Contenta Web
AppData Path

{Global} (or user_desktop) > Settings > Display

Value

displayName

Use

Indicates whether to display object names or alternate names in the tree view in Contenta Explorer and Contenta Web.

Default

name

NoteChange this value to alternateName to display alternate names rather than object names in the tree view. An end user may override this AppData setting in Contenta Explorer as follows: Click Tools > Options > Startup to toggle the Display Name in Hierarchy setting (Name or Alternate Name). Whether modifying this AppData setting or the related Startup value, you must log out of Contenta and then log back in before this change will take effect.
Table 21. DModule, PModule, SCORMContentPackage
Tool or UIContenta Explorer, Contenta Web
AppData Path

{Global} (or user_desktop) > Settings > Display > alternateNames

Values

Three values (Contenta object types): DModule, PModule, SCORMContentPackage

Use

Specifies one or more property field names to display as alternate names for different object types in the tree view, and to display as tooltips when hovering over the Name column in the list view. Property field names must be comma-separated.

Default

For DModule: Technical Name, Information Name

For PModule: Publication Module Title

For SCORMContentPackage: SCORM Content Package Title

NoteYou can change the existing values to different property field names, or add values for other object types. Do not add values for the following object types, which display code descriptions as alternate names: System, Subsystem, Subsubsystem, PNumber.
Table 22. listViewPropertyFields
Tool or UIContenta Explorer, Contenta Web
AppData Path

{Global} (or user_desktop) > Settings > Display

Value

listViewPropertyFields

Use

Defines all property fields to be displayed as columns in the list view. This list includes properties from multiple object types. Names are case sensitive and must be comma-separated.

Default

Document Type, Technical Name, Information Name, Information Code, System Difference Code, Publication Module Title, SCORM Content Package Title

NoteAdd or remove property fields from the default list as desired.
Table 23. Sort
Tool or UIContenta Explorer, Contenta Web
AppData Path

{Global} (or user_desktop) > Settings > Display

Value

Sort

Use

Defines the sort order for the list view and tree view in Contenta Explorer and Contenta Web. The default sort order can be changed by modifying this AppData value; the sort column and order for the list view can also be changed by the end user in Contenta Explorer and Contenta Web. After modifying this AppData value, you must log out of Contenta and then log back in before this change will take effect.

Default

Build

NoteBuild sorts in build order. Change to Asc to sort alphabetically in ascending order, or Desc to sort alphabetically in descending order.
Table 24. showSensitiveInfo
Tool or UIContenta Web
AppData Path

{Global} > Settings > Display

Value

showSensitiveInfo

Use

Specifies whether Contenta API and Contenta Server version information and Database type and schema information will be displayed in the About Contenta Web dialog.

Default

yes

NoteIf this setting is changed to no, the About Contenta Web dialog will display only the Contenta Web version. Contenta API and Contenta Server version and platform information and Database type and schema information will be suppressed. The suppressed information will be recorded in Tomcat's stdout log.
Table 25. launchArbortext or launchOxygen
Tool or UIContenta Web checkout/fetch tools: Arbortext or Oxygen (round-trip edit tool), Arbortext or Oxygen Check Out, Arbortext Fetch
AppData Path

{Global} (or user_desktop) > Settings > Editors > cw_xml_co

Value

launchArbortext or launchOxygen

Use

Indicates whether the web checkout tools should automatically launch the XML editor.

Defaultyes
NoteChange this value to no if Arbortext or Oxygen editor is not installed on Contenta Web clients, or if you don't want it to be automatically launched for other reasons.

This AppData setting is not supported in Contenta S1000D 5.8 and later.

Table 26. exportReferencedGraphics
Tool or UIContenta Explorer/Contenta Web checkout/fetch tools (Arbortext or Oxygen, Arbortext or Oxygen Check Out, Arbortext Fetch - web tool only), Insert Reference (Contenta S1000D Editor plug-in)
AppData Path

user_desktop > Settings > Graphics

Value

exportReferencedGraphics

Use

Set on a per-user basis to specify whether graphics should be exported for display in the editor when a user checks out a module, and downloaded and displayed when a user inserts a reference to a graphic via Contenta > Insert Reference... in the editor.

DefaultNone: Because there is no Global user setting for exportReferencedGraphics, this setting is not set in new or upgraded databases.
NoteSet this value to prompt if the user should be asked if they want to export graphics each time they check out or fetch a module. Set this value to yes if graphics should always be exported or downloaded, or no if graphics should never be exported or downloaded. If this value is set to yes or no, the user is not prompted during checkout. Because there is no Global user setting for exportReferencedGraphics, this setting is not set in new or upgraded databases.
Table 27. multimediaObjects
Tool or UI Insert Reference (Contenta S1000D Editor plug-in)
AppData Path

{Global} (or user_desktop) > Settings > Graphics

Value

multimediaObjects

Use

Defines which object types will have multimedia (vs. graphic) markup inserted when a user inserts a reference to a graphic via Contenta > Insert Reference... in the XML editor. Names are case sensitive and must be hyphen-delimited.

Default

AVI-MOV-MP3-MP4-MPEG-NGrain_3KO-PDF-RHI-RM-SWF-WAV-WMA-WMV

NoteAdd or remove object types from this list as needed. For example, if your content includes FLA multimedia files, add FLA to the hyphen-delimited list. Likewise, if your content includes VDS multimedia files, add VDS to the list.
Updated AppData Settings in Contenta S1000D 5.0
Table 28. cw_searchObjectTypes
Tool or UISearch (Contenta Web tool)
AppData Path

{Global} > content@web > Settings

Value

cw_searchObjectTypes

Use

Specifies which object types you want the Search tool (Contenta Web) to include in searches. Names are case sensitive and must be hyphen-delimited.

Default

DModule-PModule-SCORMContentPackage-AVI-BMP- CGM-EPS-GIF-JPG-MOV-MP3-MP4-MPEG-NGrain_3KO- PNG-RHI-RM-SVG-SWF-TIF-WAV-WMA-WMV

Note Several new object types were added in Contenta S1000D 5.0, and the graphics types were reordered alphabetically. Remove any object types that you do not want included in Contenta Web searches.
New AppData Settings in Contenta S1000D 4.1
Table 29. autoUpdateTableOfReferences
Tool or UIContenta Explorer/Contenta Web checkin tools (Arbortext or Oxygen, Arbortext or Oxygen Check In)
AppData Path

For all S1000D programs (models): {Global} > S1000D Programs > DEFAULT

For a specific program (model): Global > S1000D Programs > program_name

Value

autoUpdateTableOfReferences

Use

Indicates whether to automatically update the table of references when a DM is checked in.

Default

no

NoteChange values to yes if you want the table of references to be rebuilt each time you check in an updated DM. If a program name is not set, the value for the DEFAULT program is used.
Table 30. allowUploadToOverwriteStableData
Tool or UIS1000D Upload Content
AppData Path{Global} (or user_desktop) > Settings > CaS_Upload
ValueallowUploadToOverwriteStableData
UseIndicates whether a user is allowed to overwrite stable data when they run S1000D Upload Content.
Defaultyes
NoteYou may want to set the Global value to no for all users by default, then add the allowUploadToOverwriteStableData value under individual users' desktop names in the Settings > CaS_Upload path and set this value to yes for users whom you want to have this permission. If the value is not found for a user, the Global setting is used.
Table 31. allowLockObjectsOnDDNExport, allowUnlockObjectsOnDDNUpload
Tool or UIS1000D DDN Export, S1000D Upload Content
AppData Path

{Global} (or user_desktop) > Settings > DDNExport

Value

allowLockObjectsOnDDNExport

allowUnlockObjectsOnDDNUpload

Use

Indicates whether a user is allowed to lock objects when using the DDN Export tool and/or to unlock objects when using the Upload Content tool to upload a DDN.

Default

no

NoteYou may want to set the Global value to no for all users by default, then add the allowLockObjectsOnDDNExport and allowUnlockObjectsOnDDNUpload values under individual users' desktop names in the Settings > DDNExport path and set these values to yes for users whom you want to have this permission. If the value is not found for a user, the Global setting is used.