Uploading Zipped Assets


Users can upload compressed (.zip) files to Ingeniux CMS Assets Manager. During the upload process, users can extract the contents from .zip files to the Assets Manager.
Version Notes: CMS 10.0–10.5 vs. CMS 10.6
In CMS 10.0–10.5, users can only extract content from .zip files during the upload process. In CMS 10.6, users can extract content from existing .zip files at any time after they upload them to Assets Manager. See Extracting Zipped Assets in 10.6 for details.
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 AssetNew Drop-down Button in the Folder tab toolbar.
    • Version Notes: CMS 10.0–10.5
      Click Create New AssetCreate 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: