Adapter for Quark XML Author (BusDoc) User Guide

Work with a Repository

Create a New Document from a Template

Quark Publishing Platform Adapter for Quark XML Author allows you to use documents that are already available in the repository as templates to create new documents. You can use a document template that contains minimum required elements and attributes (for example, custom guidance text or instructions) based on the type of document you want to create.

To create a new document from a template:

  1. Select File > New XML Author.

  2. In the XML Author menu, select New Business Document from Server Template to open the Select Template dialog.

  3. In the Select Template dialog, you can find the template that you want to use in the following ways:

    1. Select one of the following paginated browsing tabs and navigate to the template:

      1. Favorites: Lists the most frequently used folders and files.

      2. My Assignments: Lists the documents assigned to you (logged-in user).

      3. Searches: Lists the Saved Searches on the server that are accessible to you.

      4. Continue Editing: List the documents that you are currently working on.

      5. Browse: Displays the document repository that is accessible to you.

    2. Search for the template in the Search tool.

  4. Select the document template and its version or branch (if required), and then select OK.

    To select a branch, expand the list of branches through the branch pill icon.
  5. QPP Adapter for Quark XML Author creates a new document based on the template you selected.

Open a Document from the Repository

Quark Publishing Platform Adapter for Quark XML Author allows you to open documents that are already saved in the repository.

To open a document from the repository:

  1. Select File > Open > Quark XML Author > Browse.

  2. In the Open from Server dialog box, use one of the paginated tabs or the Search tool to find to document that you want to edit or view.

    You can also open a document that is originally created in QPP as long as it is of content type Smart Document.
  3. Select the document (and its version or branch, if required) and then:

    1. Select Open if you want to edit the document.

    2. Select Read Only if you only want to view the document.

  4. QPP Adapter for Quark XML Author opens the document.

When you try to edit a document that you have opened for viewing only, QPP Adapter for Quark XML Author displays the following message:
If you want to edit a document you have opened in the Read-only mode, you can do it through the option Edit in the File menu.
You can also check out or open a document for editing in the QPP. For more information, see Quark Publishing Platform User Guide. 

Save a Document to the Repository

When you save a document to the server (check-in) in Quark Publishing Platform Adapter for Quark XML Author, components within the document become available for referencing by other documents.

To save a document that you have finished authoring:

  1. Select File > Save to Server to open the Save dialog box.

  2. In the Save dialog box, select a location in the repository where you want to save your document.

  3. Select a workflow from the Workflow drop-down menu. Workflows define the life-cycle stages of a document. For example, the workflow of a document can have the stages - Author, Review, and Publish.

    • Select a stage from the Status drop-down menu within the selected workflow. By default, QPP Adapter for Quark XML Author selects the stage that is listed first in the list or the stage that the document is already in if the document is a revision of an already available document.

  4. Choose the people or group you want to assign (for example, for review) the authored document if required, and then select Assign.

    If your workflow uses automatic status-based assignment, the Assign To menu automatically selects people/groups when you select an option from the Status drop-down menu
  5. Enter a revision comment, if required.

    QPP Adapter for Quark XML Author displays revision comments when you open a document to view or edit.
  6. Choose a version type: major or minor, or create a branch.

    When you select the Create Branch checkbox, QPP Adapter for Quark XML Author displays another optional field Branch Label in which you can enter the name you want to assign to your branch. If you do not assign a label, QPP Adapter for Quark XML Author assigns a branch number automatically. More on this in the section Version Number and Branch Notation. 
  7. Select Save.

In the Save dialog box, there are several fields that represent the metadata of the current document such as created by, last modified, checked out by, and soon.

QPP Adapter for Quark XML Author retains edited attribute values when you change the collection (location in the repository) or the workflow of an asset unless these values are not applicable in the selected collection.
When a document contains validation rules, Quark XML evaluates these rules when you save the document and notifies you if any rules are being violated. For example, certain fields are empty that must have a value.
When you save a document to the server (check-in a document), QPP Adapter for Quark XML Author converts all the references to images on your local machine to server references. QPP Adapter for Quark XML Author automatically check-in the images to make them available for reference to the document on the server.

Done Editing

The option Done Editing is equivalent to saving the file to the server, except that QPP Adapter for Quark XML Author displays the option when you close a document from the window menu button Close. And unlike the option Save to Server & Close, the option Done Editing keeps the document open after saving the document to the server. To save a document to the server through the option Done Editing:

  1. Select the Close Window button.

  2. In the Close Window dialog box, select Done Editing to open the Save dialog box.

  3. In the Save dialog box, if applicable, select location, Status, Assign To, Revision Comment, version number, or create a branch.

  4. Select Save.

QPP Adapter for Quark XML Author saves and checks in the document on the server.

Discard Changes

When you open a document from the repository for editing (check out a document) and after you have made some changes, if you do not want to keep the changes, you can discard those changes.

To discard the changes that you have made to a document:

  1. Select the Close Window button.

  2. In the Close Window dialog box, select Discard Changes.

  3. QPP Adapter for Quark XML Author restores the document to the last version saved on the Server.

When you discard changes, the status of the document in the repository also changes from Checked-out to Checked-in, which allows other users with proper authentication to open the document for editing.

Browsing Options

When you are opening a file from a server or saving a file to a server, you can use the following browsing options:

  • Switch between list view and grid view: By default, QPP Adapter for Quark XML Author displays results in the list view.

  • Sort results in the list view: QPP Adapter for Quark XML Author displays customized sorting options based on the paginated tab you use. For example, under the tab Favorites you can sort the results by Name, Status, Assigned To, Created (date of creation), Last Modified, Last Modifier, and Collection (location in the repository).

  • Use popular and previously made searches.

  • Refresh results when you do not find a file/folder where you expect to find that file/folder within the repository.

  • Switch between result types - files only, folders only, or all files and folders.

Icons

Some files in the repository can have an icon next to them, which either represents the content type or the state the file is currently in.

The following table lists these icons with their description:

Icon

Name

Description

Component

Represents that the file is being used as a component in another document.

Checkout

Represents that the file is check-out and is enabled for editing.

Branch

Represents that the file has branches and which branch is currently selected.