How can I move a library version from one release to another?

You can move a library version by manually editing the library release and the custom properties files.

Symptom

When cloning a library version, we selected the wrong release.

Problem

There is no feature in IXIASOFT CCMS that allows a user to move a library version from one release to another.

Solution

CAUTION: This procedure should only be used to move a version from one release to another within the same library or product.
  1. In the DITA perspective, in the Dynamic Release Management view, lock and edit the library release that you want to remove the version from.
  2. In Oxygen Source view, paste the value of <version> into a Notepad file for future reference.
  3. Remove the <version> value. For example change:
    <librelease id="uhi1518792519042" xml:lang="en-us"> 
        <name>LibR1</name> 
        <releasemeta> 
            <description/> 
            <aliases/> 
        </releasemeta> 
        <versions><version href="fso1518792529667.version"/></versions> 
    </librelease> 
    to:
    <librelease id="uhi1518792519042" xml:lang="en-us"> 
        <name>LibR1</name> 
        <releasemeta> 
            <description/> 
            <aliases/> 
        </releasemeta> 
        <versions></versions> 
    </librelease> 
  4. Release the library release file.
  5. Lock and edit the library release where you want to move the version to.
  6. In the <versions> element, paste the <version> value. Make sure there is a closing tag for <versions>. For example change:
    <?xml version="1.0" encoding="UTF-8"?> 
    <!DOCTYPE librelease PUBLIC "-//IXIA//DTD DITA CMS Release//EN" "release.dtd"> 
    <librelease id="nap1518794053288" xml:lang="en-us"> 
        <name>LibR2</name> 
        <releasemeta> 
            <description/> 
            <aliases/> 
        </releasemeta> 
        <versions/> 
    </librelease> 
    to
    <?xml version="1.0" encoding="UTF-8"?> 
    <!DOCTYPE librelease PUBLIC "-//IXIA//DTD DITA CMS Release//EN" "release.dtd"> 
    <librelease id="nap1518794053288" xml:lang="en-us"> 
        <name>LibR2</name> 
        <releasemeta> 
            <description/> 
            <aliases/> 
        </releasemeta> 
        <versions><version href="fso1518792529667.version"/></versions> 
    </librelease> 
  7. Release the library release.
  8. In the Dynamic Release Management view, right-click the library version. Click Copy > Copy Reference.
  9. In the TEXTML Admin perspective, In the Show documents file names containing field, paste the copied reference.
  10. Expand the content/releases folder.
  11. Check out the .version file.
  12. Right-click the .version file. Click Open Custom Properties.
  13. Edit the userproperty type="parent.filename" entry and replace the .release value with the copied reference. For example, change:
    <userproperties> 
       <userproperty type="parent.filename" 
                >/content/releases/uhi1518792519042.release</userproperty> 
    </userproperties> 
    to
    <userproperties> 
       <userproperty type="parent.filename" 
                >/content/releases/nap1518794053288.release</userproperty> 
    </userproperties> 
  14. Save the file.
  15. Check in the file.