Login
Home CMS Documentation Home CMS 10 Assets Manager Uploading Assets Uploading Zipped Assets

Uploading Zipped Assets

You can upload compressed (.zip) files to Ingeniux CMS Assets Manager. During the upload process, you can extract the contents from .zip files to the Assets Manager.

Version Notes: CMS 10.6 vs. CMS 10.0–10.5

Keep the following in mind:

  • In CMS 10.x, the Assets Tree context menu action only uploads .zip files. To upload and extract .zip file content at the same time, use the asset toolbar Create New Asset action.

  • In CMS 10.6, if you choose not to extract .zip file content during the upload process, you can still extract content from the existing .zip file at any time after upload. See Extracting Zipped Assets in CMS 10.6 for details.

  • In CMS 10.0–10.5, you can only extract content from .zip files during the upload process.

To upload and extract a .zip file in Assets Manager:

  1. Navigate to Assets > Asset Tree.
  2. Choose one of the following steps:

    • Select an asset folder to contain the assets generated from the .zip file in the Assets Tree.

    • Create an asset folder to contain the assets generated from the .zip file in the Assets Tree.

    Note

    Ensure the containing folder allows the .zip extension. See Creating New Asset Folders for details.

    The asset folder displays in the main pane.

  3. Follow the step that corresponds with your site version.
    • Version Notes: CMS 10.6

      Click New > Create New Asset

      New Drop-down Button

      in the Folder tab toolbar.

    • Version Notes: CMS 10.0–10.5

      Click Create New Asset

      Create New Asset Button

      in the Folder tab toolbar.

  4. Choose one of the following steps.

    • Drag .zip from your operating system's file explorer to the Drag files here workspace.

      Drag Zipped Asset to Uploader in Asset Folder

    • Click the asset uploader area to browse for and select the .zip file from your system’s file explorer.

    The .zip asset displays in the Drag files here workspace.

  5. Select or clear the Update existing assets for conflicting names checkbox.
    Note

    If you select this checkbox and you upload an asset with a file name already used within the chosen upload directory, the system uploads the new asset file to the pre-existing a/ID that uses the same name. If you clear this checkbox and you upload the asset, then you can choose to create a new a/ID for the uploaded asset. See Uploading Assets from Toolbar for details.

  6. Select or clear the Use default asset schema checkbox. You can use the default asset schema or another schema type for this asset.
    Note

    The Use default asset schema checkbox is selected by default to allow the system to set a default asset schema based on the extension of the new asset. To use a different schema, clear the checkbox. See Uploading Assets from Toolbar for details.

  7. Click Upload.

    The Zip unpack options dialog displays.

    Zip Unpack Options

  8. Optional: Indicate how to handle compressed files:

    • Unpack zip packages: (Default: Enabled)

      Clear this option if you want Ingeniux CMS to leave zip files compressed when it encounters them.

    • Remove existing folder when name matches package: (Default: Disabled)

      Enable this option if you want Ingeniux CMS to remove if the uploaded zip package matches the folder in the Asset Tree.

    • Conflict handling: , You need to provide the CMS with the appropriate instructions as to how to handle collisions of incoming paths, file names, or asset IDs with those already in the Asset Tree.

      • If paths match, update asset content.

        If you keep this default setting, the CMS retains the original asset IDs and updates their content.

      • Create new assets to replace existing ones.

        If you choose to enable this setting, assets with the same filename receive new asset IDs upon upload. The updated assets will retain the original files names, but new IDs will be generated for them.

      • Create new assets with unique names.

        If you choose to enable this setting, the conflicting assets will be replaced by the incoming ones. The updated assets will have unique files names and IDs. The original assets will remain unchanged.

    • Note

      Only consider enabling this option if you are uploading DITA assets. Clear this option when uploading all other asset types.

      Change asset file extension from *.xml to *.dita: (Default: Disabled)

      If you choose to enable this setting, all uploaded DITA files with the .xml extension will be changed to the .dita extension.

      Note

      Your DITA set could contain XML files with the .xml extension, such as XML code samples. If this is the case, consider that enabling this option will apply the .dita extension, which may not be your intention.

  9. Click Upload.

    The system uploads the .zip file to Assets Manager and executes .zip extraction actions based on options selected via the Zip unpack options dialog.

 

This section includes: