Expected outcomes when re-importing modified HTML source files

Import content

When re-importing HTML source files the actions that occur are based on the modifications made to the content in the source file.

Importing and re-importing HTML source files:

  • Re-import the HTML source file into the same import folder.

    Expected outcome: The content is re-imported and "overwrites" the existing content.

  • Re-import the HTML source file into a different folder.

    Expected outcome: The content is treated as a fresh import. The Book and Topic objects are created in this folder. Hyperlink and File objects are also created. Because a different folder has been used, Topic objects already in the library are not overwritten.

  • Import and re-import is attempted by a user with insufficient folder or release state permissions, or the object is currently open (locked by any user).

    Expected outcome: The objects are not imported or overwritten when re-imported.

Creating and reusing importing books:

  • Import or re-import a single HTML source file into the import folder.

    Expected outcome: A Book object is created for the import and reused if that file is selected as a re-importing job (the book is named using HTML source file/topic name).

    (Re-importing process: Topic content from previous import is overwritten.)

  • Import multiple HTML source files into the import folder.

    Expected outcome: A Book object is created for the import and reused for any re-importing job that includes two or more HTML source files (book is named HTML Import).

    (Re-importing process: Topics from original import are overwritten.)

Modifying text content and links when re-importing HTML source files:

  • Re-import HTML source file after changes to the "topic text" content has changed.

    Expected outcome: The content is re-imported and overwrites the existing content, applying changes to the Author objects to match the modified HTML source files.

  • Re-import HTML source file after Heading or Title of the HTML source file has changed.

    Expected outcome: When the content is re-imported a new object is created.

  • Re-import HTML source file after changes are made to a hyperlink's target.

    Expected outcome: A new Hyperlink object is created and used instead of the original, or previously used, object.

Modifying images when re-importing HTML source files:

When working with graphics, the outcome depends on the changes made to the image source file, and whether an Embedded File object template or a Linked File object template has been used in Author.

Images using "Embedded" File object Templates:

  • The graphic file is modified but the image tag is not changed in the HTML source file (the graphic's name and format are not modified).

    Expected outcome: The embedded File object is updated with the new image.

  • Image name is changed in the HTML source file's image tag.

    Expected outcome: A new File object is created.

  • Image format is changed in the HTML source file's image tag.

    Expected outcome: A new File object is created.

Images using "Linked" File object Templates:

  • The graphic is modified but the image tag in the HTML source file is not changed (the graphic's name and format are not modified).

    Expected outcome: The linked File object already exists in the library and points to the graphic file in the "Graphics" folder. The new graphic file must be moved to the "graphics" folder so it can be used by the File object.

    Note: The graphic file must be swapped by the user - this is a manual process and is not automated by the re-import process.

  • Image name is changed in the HTML source file's image tag.

    Expected outcome: A new File object is created.

    Note: When a new linked File object is created the graphic file is copied from the HTML source file folder and pasted into the "graphics" folder used by the linked template.

  • Image format is changed in the HTML source file's image tag.

    Expected outcome: A new File object is created.

    Note: When a new linked File object is created the graphic file is copied from the HTML source file folder and pasted into the "graphics" folder used by the linked template.