User Guide

Admin

An administrator (user with administrative privileges) can change the system level and content level settings and reconfigure all the properties within the Quark Publishing Platform NextGen to manage the workflow for all the internal processes of the platform.

Once you are logged in to a Quark Publishing Platform NextGen server, you can access the Admin module through the chocolate menu at the upper-right corner of the screen.

Alternatively, you can directly access the Admin module through the URL https://<SERVER-URL>/admin/. 

The entire Admin module acts as a dashboard for the administrator and has seven sections/pages based on the part of the platform they allow you to manage. These sections/pages are as follows:

Admin Homepage

The Admin homepage contains several statistics to check the productivity of the platform, license information, and quick links to access the other pages of the Admin module. 

The Admin homepage sections are as follows: 

Statistics

This section displays the following statistics: 

  • The number of server licenses: Displays the real-time number of the total server licenses along with the remaining expiration period.

  • Author Licenses: Displays the number of assigned and available licenses for the user with author privileges. This license allows a user to create and edit assets.

  • Access licenses: Displays the number of assigned and available licenses for the user with access privileges. 

  • Storage: Displays the amount of bandwidth that has been allocated to a particular account and the amount of data that is currently being stored in the current account out of the allocated storage. 

  • Content Count: Displays a graph for the count of total assets on the server by content type. You can hover over a graph bar to see the statistics for a specific content type. 

Access Control

The Access Control section displays the total number of users, user groups, and type of roles (privileges) that are defined on a server and provides quick links to the following Admin pages: 

  • Users tab of the People page

  • Groups tab of the People page

  • Roles page

Content Modeling

The Content Modeling section displays the total number of content types, attributes, and value lists that are defined on a server and provides quick links to the following Admin pages: 

Automation Channels

The Automation Channels section displays the total number of automation channels (classified by type - publishing, delivery, and data doc) available on a server and provides quick links to the following Admin pages:

  • Publishing Channels tab of the Automation Channels page

  • Delivery Channels tab of the Automation Channels page

  • Data Doc Channels tab of the Automation Channels page

Workflow Management

The Workflow Management section displays the total number of workflow statuses that are defined on a server and provides a quick link to the Workflow page.

System

The System section provides a quick link to the System Settings page.

People

The People page allows you (the administrator) to create, edit, delete and modify users and user groups. There are several information items and options on the People page, which for the sake of simplicity are categorized as user information, users and groups operations, and generic page operations.

Users Information

The People page has the following user information items:

  • Agreement Status: Displays your license status. 

  • Expiry Date: Displays the expiry date of your license if the status is active.

  • Author Licenses: Total number of assigned author licenses out of the total number of purchased author licenses. 

  • Access Licenses: Total number of assigned access licenses out of the total number of purchased access licenses. 

  • Total Users: The total number of users on the server, which you can click to see. 

  • Active Users: The number of active users on the server, which you can click to see.

Users and Groups Operations

These operations are top bar actions, which become active when you select a user/group from the list, based on the tab you are in. These operations are as follows:

User Operations

The user operations are as follows: 

  • Add New User: Allows you to add a new user to the server (described ahead). 

  • Edit: Allows you to edit the properties and privileges of an already available user.

  • Delete: Deletes a user. 

  • Duplicate: Duplicates a user.

To add a new user: 

  1. Under the Users tab of the People page, select the button + New User in the top of the bar actions to open the Add User pane.

  2. In the Add User pane, add an image, enter a username, first name, last name, email, phone, and then select a license type and privilege for the user.

  3. Select the button Save to create the user.

Once you have created a user, the Admin module displays the user overview in the User Details pane, from where you can also manage groups for the user. 

To manage groups for a user:

  1. In the User Details pane, select the link See Groups to open the Manage Groups pane. 

  2. In the Manage Groups pane, select the button Add to Another Group.

  3. Search and select the group, click Add and then click Done to add the user to the selected group.

  4. The Admin module lists the added group in the Manage Groups pane for the user.

Group Operations

The group operations are as follows:

  • Add New Group: Allows you to add a new group to the server (described ahead). 

  • Edit: Allows you to edit the properties and privileges of an already available user.

  • Delete: Deletes a group. 

  • Duplicate: Duplicates a group.

To add a new group:

  1. Under the Groups tab of the People page, select the button + New Group in the top of the bar actions to open the Add Group pane.

  2. In the Add Group pane, add an image, enter group name and email address, select a privilege, and search and select a member to add to the group. 

  3. Select the button Add to add the selected user and then select the button Save to create the group.

  4. The Admin module displays the overview of the newly created group in the Group Details pane with the options to edit and delete the group.

Generic Page Operations

The People page has the following generic page operations:

  • Refresh: Refreshes the list to reflect any recent changes. 

  • Find by Name: This search tool allows you to search for a user or group by name. 

  • Column Options: Allows you to select which columns to display against file listing.

  • Sort Options: Allows you to sort the list by Name, Date Logged On, Role, Email, or License type.

  • View Options: Allows you to switch the view from list to the grid and vice versa. 

Roles

The Roles page allows you to create/manage roles by setting various content and application-level privileges within those roles. Roles allow you (administrator) to manage which permissions are to be given to specific users or groups on the server.

The left pane of the Roles page displays the roles that are available on the server. On top of the list, there is a search bar, which by default displays the total number of roles on the server.

When you select a role from the list, the Admin module activates the roles operations such as edit, delete, and duplicate on the top bar, displays the number of users and groups that have been assigned the selected role, and the privileges under the selected role on the right-hand-side part of the page. 

Roles Operations

The top bar displays a few roles operations, which are as follows: 

  • Add New Role: Allows you to create a new role (described ahead). 

  • Edit: Allows you to edit a role already available on the server. 

  • Delete: Deletes a role. 

  • Duplicate: Allows you to create a copy of a role.

To add a new role: 

  1. Select the button + New Role from the top bar actions.

  2. Select a content type.

  3. Set privileges as required. 

  4. Select the button Save.

When you set privileges for a content type, Quark Publishing Platform NextGen also lets you set the same privileges for all the children of that content type without having to apply the same privileges to each child content type individually. You can apply the content privileges to all the children content types through the button Override Privileges for All Child Content Types.

Privileges

Privileges define a set of protocols for a user or group to perform specific operations on the server. When you specify privileges for a role, it defines the instructions available to each member of that role. For example, when users of a certain role do not have the privilege to perform a specific task, Quark Publishing Platform NextGen does not display the command for that task. 

Additionally, you can define privileges for specific types of content and assets. 

Privileges are categorized as follows:

Content Privileges

Content privileges define the degree and type of access that a user can have for different content types. Content privileges are categorized as follows: 

General

General privileges are related to generic actions, which are as follows:

  • Check In New: Allows a user to create or check in new assets to the server.

  • Check Out Assets Assigned to Other Users: Allows a user to check out assets that have already been assigned to other users.

  • Override Another Users Checkout: Allows a user to cancel check out by another users. 

  • Duplicate: Allows a user to duplicate assets. 

  • Delete: Allows a user to delete assets. 

  • Preview: Allows a user to preview assets. 

  • View All Revisions: Allows a user to view all the revisions of an asset within the collection the user has access to. 

  • Revert to the Previous Version: Allows a user to revert to a previous version of an asset. 

  • Read-only Check Out or Get Asset(s) Assigned to Other Users: Allows a user to get a read-only copy of an asset, without checking out the asset. 

  • Change Checked-in Asset Name: Allows a user change the names of checked-in assets that are assigned to other users.

  • Check In Asset without Displaying the Check In Dialog Box: Allows a user to bypass the Check In dialog by pressing Option/Alt on the keyboard while clicking the option Check In Asset.

  • Enable Asset Archiving: Allows a user to archive assets on the server. 

  • Get Original Assets: Allows a user to get the original version of assets from the server.  

  • Check In New Revision: When left unchecked, restricts a user with insufficient privileges from creating a new version of an asset even when an author has routed the asset to the reviewer.

The Privileges pane is configurable. You can add custom privileges, disable or choose not to display a default privilege. For more information, connect with Quark Support. 
Publish

Publish privileges are related to the publishing channels available on the server such as PDF, HTML, and so on. 

Edit Attributes

Edit Attributes privileges define the level of access related to editing assets, which are as follows:

  • Edit Normtal Access Fields of Asset(s) Routed to the User: Allows a user to edit Normal Access attributes for the assets routed to the user.

  • Edit Normal Access and Limited Access Fields of Asset(s) Routed to the User: Allows a user to edit Normal Access and Limited Access attributes for the assets routed to the user.

  • Edit Normal Access Fields of Asset(s) Routed to Other Users: Allows a user to edit Normal Access attributes for the assets that are routed to other users.

  • Edit Normal Access and Limited Access Fields of Asset(s) Routed to Other Users: Allows a user edit Normal Access and Limited Access attributes the assets that are routed to other users.

  • Change Collection of Checked-In Asset: Allows a user to move a checked-in asset to a different collection on the server.

  • Change Workflow of Checked-In Asset: Allows a user to change the workflow of checked-in assets.

Edit Redlining

Edit Redlining privileges define the permissions related to reviews and track changes, which are as follows:

  • Accept and Reject Changes (Selected/Displayed/All): Allows a user to accept and reject redlining (track) changes. 

  • Enable/Disable Tracking: Allows a user to turn on/off the red line tracking. 

Revision Control

Revision Control privileges define the permissions related to whether a user can assign a major/minor version to a document.

Application Privileges

Application privileges define the degree and type of access that a user can have to different application features.

For example, you can hide a collection in the Author and Workspace browsing pane through the privilege Hide (configurable) under Collections, even when a user has access to the hidden collection. More more information, see Appendix.

Application privileges are categorized as follows:

Administration

Administration privileges are related to workflow and file management, which are as follows:

  • Attributes: Allows a user to view, create/modify, and delete asset attributes. 

  • Redlining: Allows a user to accept/reject changes and enable/disable red line change tracking. 

  • Users and Groups: Allows a user to view, create/modify, and delete new users and groups.

  • Drop-down Menu Attribute Lists: Allows a user to view, create/modify, and delete lists within drop-down menu attributes.

  • Roles: Allows a user to view, create/modify, and delete roles. 

  • Storage: Allows a user to specify locations for the Quark Publishing Platform NextGen Server to store assets and rules for each kind of file type. 

  • Repositories: Allows a user to view, create/modify, and delete storage repositories. 

  • Storage Rules: Allows a user to view, create/modify, and delete locations to store different file types. 

  • Workflows: Allows a user to view, create/modify, and delete workflows. 

  • Content types: Allows a user to view, create/modify, and delete content types. 

  • Forms: Allows a user to view and modify forms. 

  • Relations: Allows a user to view, create/modify, and delete relationships between assets. 

Workspace

Workspace privileges are related to Workspace module, which are as follows:

  • Collections: Allows a user to create, delete, duplicate, move, copy, browse, and modify collections. 

  • Collection Templates: Allows a user to create, delete, duplicate, move, and copy collection templates. 

  • Searches: Allows a user to create/modify, share/unshare, and delete searches. It also lets you enable enhanced search displays. 

  • Live Preview: Allows users to view a live preview of rendered XML documents in the References/Preview pane of the Author module and Quark XML Author Adapter.

Attributes

The Attributes page allows you to create and configure attributes of assets, article components, collection types, and layout types. The user interface of the Attributes page contains a few top bar actions (such as add and delete attribute/value list), lists the attributes (along with type, creator, modifier, and dates) and value-lists available on the server in their respective tabs, and some generic page operations.

Attributes Tab

All content types and assets have a unique set of attributes on Quark Publishing Platform NextGen. The Attributes tab allows you to manage these attributes that include some system-generated information such as the time and date of an asset's creation and previous modification, some platform-specific properties such as Checked Out By, and some custom properties that you may define based on your workflow requirements; for example, a workflow status for image approval. 

There are eight types of properties that Quark Publishing Platform NextGen supports, which are as follows: 

  • Text: Any text properties wherein you also have to define the maximum text length. 

  • Date: A date property wherein you have to define format and date range.

  • Time: A time property wherein you have to define valid time ranges.

  • Date and Time: A combined date and time property, wherein you have to define valid ranges. 

  • Boolean: A Boolean property for which you can set the value as true or false. 

  • Numeric: A number property wherein you have to define a number range. 

  • Measurement: A measurement property, such as file size, wherein you have to define a measurement range. 

  • List: A dropdown property with several list values.

Create a New Attribute

To create a new attribute: 

  1. Under the Attributes tab, select the button + Add New to open the Add New Attribute pane.

  2. In the Add New Attribute pane, select an attribute type from the Type dropdown menu. 

  3. Enter the required fields related to the type of attribute you have selected.

  4. Select whether the attribute would have limited or normal access. 

  5. Select the button Add Content Types to open a pane from where you can select a content type for the attribute and then select Done.

  6. Select Save.

When you add a list type attribute, the Add New Attribute pane asks you to select a value list for the attribute from the server. If an appropriate value list is not available on the server, you can create a new value list (described ahead). 

Value Lists Tab

The value lists are the default list of arguments/values of an attribute. Based on the type of attribute, you can define a single or a list of values for an attribute. Quark Publishing Platform NextGen displays these values when you create a new asset.

Create a Value List

To create a new value list: 

  1. Under the Value Lists tab, select the button + Add New to open the Add Value List pane.

  2. In the Add Value List pane, add a name to the list and add list items. To add a list item, enter a name then select the button + Add next to the list item name.

  3. Select Save.

You can also sort the list items alphabetically through a slide button Sort List Alphabetically at the bottom-left corner of the Add Value List pane. 
Edit a Value List

To edit a value list: 

  1. Double-click on an item listed under the Value Lists tab to open the Value List Details pane.

  2. In the Value List Details pane, select the button Edit to open the Edit Value List pane.

  3. Make your edits (rename list, add a list item, remove a list item, or rename a list item). 

  4. Select Save.

Quick Search

The Quick Search operation allows you to manage attributes for Quark Publishing Platform NextGen quick search functionality. For example, when you add asset name as a value quick search attribute, Quark Publishing Platform NextGen quick search tool searches for the entered text query as the name of asset. 

By default, Quark Publishing Platform NextGen only allows keyword searches in the quick search toolbar. 

To add an attribute to the quick search functionality: 

  1. Select the button Quick Search in the top bar actions to open the Attributes pane.

  2. In the Attributes pane, expand the Select dropdown menu, which lists the attributes available on the server. You can also search for an attribute by name within the dropdown menu.

  3. Select an attribute to add the attribute.

  4. Select Done.

To remove an attribute, select the close icon  next to the attribute name in the list.

Priority Search

The Priority Search operation allows you to set the relevant attributes to appear on top in the parameter list when creating a new search query in the Workspace module.

You can add and remove a priority search attribute in the same manner you add and remove a quick search attribute.

Generic Page Operations

The Attributes page has the following generic page operations:

  • Show All Attributes: By default, the Attributes page only displays the attributes added by users to the platform and does not display the default system attributes. Through the Show All Attributes slide button you can choose to display/hide the system attributes.

  • Find an Attribute/Value List by Name: You can search for an attribute/value list by name through a search toolbar.

Content Types

The Content Types page allows you to manage different content types supported by Quark Publishing Platform NextGen. Apart from different content types that are native to the Author module, Quark Publishing Platform NextGen also supports content types that are native to several other Quark applications such as Quark App Studio, QuarkXPress, and QuarkXPress CopyDesk.

The Content Types page has two sections, which for the sake of simplicity are named as the content types frame (or left frame) and properties frame (or right frame). The left frame lists all the available content types on the server and the right frame displays the attributes, workflows, and automation channels related to the content type selected in the left frame.

Additionally, there are a few top bar actions to create a new content type and to manage the content type you have selected in the left frame.

Content Types Frame

The left frame lists all the content types categorically. The following are the content types categories and subcategories available in Quark Publishing Platform NextGen, which you can expand through the dropdown menu at top of the left frame: 

Category

Subcategories

Remarks

Structured Content

  • Business Document

  • DITA

  • Smart Content

Content types that are primarily related to the Quark Author.

Layout

  • App Studio

  • Interactive

  • Print

  • Web

Content types that are primarily related to the Quark App Studio and QuarkXPress.

Collection

Indefinite categories based on the folder structure requirements of an organization.

Collection content types are used across all Quark applications.

Article Component

  • Picture Component

  • Text Component

Content types that are primarily related to the QuarkXPress CopyDesk.

Asset

  • Document

  • Layout Resource

  • Library

  • Media

  • Picture

  • Project

  • XML

  • etc.

Asset content types are used across all Quark applications.

In Quark Publishing Platform NextGen, you mostly deal with Structured Content and Asset content types, unless you import a file native to another Quark application. 
Create a New Content Type

To create a new content type:

  1. In the left frame, select the category of which you want to create a new content type.

  2. In the top bar actions, select the button + New Content Type to open the Add New Content Type pane.

  3. In the Add New Content Type pane, enter the name of the content type and then select the button Create and Continue.

  4. The Admin module creates a new content type and assigns the same properties (attributes, workflows, and automation channels) as the parent content type.

You can manage the attributes and automation channels of a content type from within the right frame. The process is described ahead in the section Properties Frame.
Other Content Types Operations

The top bar actions have the following additional content type operations: 

  • Edit: Allows you to edit the name and category of a content type.

  • Delete: Allows you to delete a content type (including all the children content types). 

  • Duplicate: Allows you to duplicate a content type (excluding all the children content types).

Properties Frame

The right frame lists attributes, workflows, and automation channels in respective tabs related to the content type that you have selected in the right frame. Some content types such as layout, collection, and article do not have workflows and automation channels.

You can manage attributes and automation channels from within the properties frame; however, you can manage workflows only through the Workflow page.  

Manage Attributes

The Attributes tab lists all the attributes related to the selected content type. The tab also has a quick search tool to search for an attribute by name, which, by default, displays the total number of attributes related to the selected content type.

To manage (add/remove) attributes:

  1. Select the button Add/Remove Attributes to open the Add Attributes to Content Type pane.

  2. In the Add Attributes to Content Type pane, select or deselect the checkbox against a listed attribute to add/remove the attribute for the selected content type.

  3. Select Done.

In the Add Attributes to Content Type pane, you can also search for an attribute by name and filter attributes by type.
Manage Automation Channels

The Automation Channels tab lists all the automation channels (publishing and delivery channels) related to the selected content type. The tab also has a quick search tool to search for a channel by name, which, by default, displays the total number of channels related to the selected content type.

To manage channels:

  1. Select the button Add Existing to open the Add Channels to Content Type pane.

  2. In the Add Channels to Content Type pane, select/deselect the publishing channels from the tab Publishing and then select/deselect the delivery channels from the tab Delivery

  3. Select Done.

In the Add Channels to Content Type pane, you can also search for a channel by name.

Content Models

The Content Models page allows you to add and manage content models on your Quark Publishing Platform NextGen server. The Content Models page has three tabs - Elements, Properties, and Models, which allow you to add and manage content elements, content properties, and content models, respectively. 

Elements

The Elements tab allows you to add and manage smart content elements such as paragraphs, tables, lists, regions, and so on, which can be used across different content models. There are seven predefined types of smart content elements, which are as follows:

  • Paragraph (heading, quote, and so on)

  • Reference Notes (endnotes, footnotes, and so on)

  • BodyDiv

  • Tag

  • List (numbered list, bulleted list, and so on)

  • Region (boxes, callouts, and so on)

  • Table

Add an Element

To add an element: 

  1. In the Elements tab, select one of the smart content element types to open the Element Types pane. The Element Types pane also list the elements that have already been added to that smart content element type.

  2. In the Element Types pane, select the button +Add to expand the name and type fields for the new element.

  3. Enter the name of the element. 

    While you enter the name of an element, Quark Publishing Platform NextGen automatically generates a value for the field type, which is same as the name with spaces replaced with hyphen. 

  4. Select the button Create.

You can edit an element (edit name) and delete an element through icons next to a listed element in the Elements Types pane.

Properties

The Properties tab allows you to add and manage properties, which can used for different smart content types across all the available content models. There are three types of properties you can add and manage: 

  • Attribute: Defines a basic property with a single or several values.

  • Group: Defines a complex property by combining several attributes.

  • Collection: Defines a yet more complex property by combining several attributes and groups.

When you create a new document/component (for example, a smart document), the attributes, groups, and collection are as highlighted in the screenshot below:

The Properties page lists all the properties that are defined on a server along with the property type (attributes, groups, or collections) and provides options to add a new attribute, group, and collection.

Add an Attribute

To add an attribute: 

  1. In the Properties tab, select the button Add Attribute to open the Add Attribute pane.

  2. In the Add Attribute pane, enter the following details:

    1. Display Name (while you enter the name, Quark Publishing Platform NextGen automatically generates a value for the field Type Name)

    2. Data Type (such as text, date, number, and so on)

    3. Read Only (restricts an author to assign the value only once for this property for an asset)

    4. Value (values, if you have selected the checkbox Allow Multiple Values)

  3. Select the button Save.

Add a Group

To add a group: 

  1. In the Properties tab, select the button Add Group to open the Add Group pane.

  2. In the Add Group pane, enter the following details:

    1. Name (while you enter the name, Quark Publishing Platform NextGen automatically generates a value for the field Type)

    2. Members (which are attributes that you can add to a group)

  3. Select the button Save.

Add a Collection

To add a collection: 

  1. In the Properties tab, select the button Add Collection to open the Add Collection pane.

  2. In the Add Collection pane, enter the following details:

    1. Name (while you enter the name, Quark Publishing Platform NextGen automatically generates a value for the field Type)

    2. Member Name (which is the label for the group of attributes in a collection that do not belong to an already defined group)

    3. Members (which are attributes and groups that you can add to a collection)

  3. Select the button Save.

Property Details

You can also view the details of the property by clicking a property name in the list of properties under the Properties tab.

You can also edit a property through the Property Details pane by clicking the button Edit

You cannot delete a property. For more information, connect with Quark Support. 

Models

The Models tab allows you to add and manage content models. The Models tab displays the list of models already available on your server. Additionally, there are a few top bar actions to add a new content model or to duplicate or delete the selected model from the list.

Add a Content Model

To add a content model: 

  1. Select the button +Add in the top bar actions to open the window to create a new content model. 

  2. In the window that opens, enter the following information:

    1. Name (the name of your content model)

    2. Type (while you enter the name, Quark Publishing Platform NextGen automatically generates a value for the field Type)

    3. Label (to be displayed on the user interface)

    4. Section Properties (the attributes of a document built using a content type of this content model)

    5. Label & Title (allows you to set the default title text, placeholder title text, and default body text)

    6. Properties for all the elements that you want to include in your content model. 

  3. Link the content model to a content type through the following steps:

    1. Select the button Update Content Type Link to open the pane Link with Content Type

    2. In the pane Link with Content Type, select the checkbox Represent Content Model with Content Type to expand the list of content types. 

    3. Select a content type and then select the checkbox Create Content Type Under <Selected content type>.

    4. Select the button Ok to close the pane Link with Content Type

  4. Select the button Save.

You can also add a child content model to your content model or add an already available content model as a child to your content model through options on the top bar.

Automation Channels

The Automation Channels page allows you to add and manage automation channels on your Quark Publishing Platform NextGen server. Automation channels automate the process of content publishing, content delivery, and content management. 

There are three types of automation channels that you can define and manage:

  • Publishing Channels: PDF, HTML, JPEG, or any other file format in which you want to publish your content.

  • Delivery Channels: Email, FTP server, or any other means through which you want to deliver your content.

  • Data Doc: Data Doc channels extract a specific type of elements from a file into a specific format; for example, extract a specific sheet in an Excel file as a PNG. You can automate processes related to a Data Doc channel through scripts. For example, you can automate the process to generate PNG of a specific Excel sheet every 24 hours. 

You can automate processes related to publishing and delivery channels with respect to a content type. For more information, see the section Content Types > Manage Automation Channels 

The Automation Channels page lists all three types of default and custom (the ones your organization has added) automation channels in their respective tabs and top bar actions to add, edit, duplicate, and delete automation channels. The page also contains a search bar through which you can search for an automation channel by channel name or channel id.

The top bar actions to edit, duplicate, and delete automation channels only get enabled after you have selected an automation channel in the list and you have sufficient privileges to manage automation channels. 

To view the specifications of an automation channel, select the name of the channel in the list. This opens the Asset Channel Details pane that also provides an option to edit the channel specifications.

The process to edit an automation channel is similar to the process to add an automation channel, which is described in the next section.

You cannot edit a default automation channel.

Add an Automation Channel

To add an automation channel:

  1. In the top bar actions, select the button + Add to open the Add New Automation Channel pane.

  2. In the Add New Automation Channel pane, provide the following information:

    1. Channel Type: Select a channel type Publishing, Delivery, or Data Doc from a dropdown list.

    2. Channel ID: Enter a unique channel id, which by convention, also defines the function of the channel. For example, a channel that transforms DITA documents into HTML format should have the Channel ID DitaToHTML.

    3. Channel Name: Enter a name for your automation channel.

    4. Description (optional): Provide a description of your automation channel around its function.

    5. Output Type (optional): Provide the file formats your automation channel can produce; for example, text, image, JPEG, HTML, and so on. 

    6. Process Name: Select a pre-defined process from a dropdown.

  3. After you have selected a process, the Add New Automation Channel pane displays a list of parameters related to that process, which you need to define for your automation channel. You can provide a default value for a parameter, make a parameter mandatory to define (through the checkbox), or delete a parameter.

  4. Select the button Save

Workflow

The Workflow page allows you to manage workflows for a Quark server. A workflow consists of a set of stages or statuses that define the life cycle of a content type based on the content publishing and content management requirements of an organization. For example, a business document may have the workflow statuses - draft, review, approve, publish, and deliver. 

The Workflow page displays a list of workflows available on the server along with the color coded status and the content types on which a workflow have been applied. On top of the list, the page also displays the total number of available workflows.

You can expand the list of statuses by clicking the dropdown menu icon  and expand the list of content types by clicking + XX others against a workflow under the columns Content Types.

Additionally, there are the following top bar actions:

  • Add New Workflow: Allows you to add a new workflow to the server.

  • Edit: Allows you to edit the specifications of the selected workflow in the list.

  • Delete: Allows you to delete the selected workflow in the list.

  • Duplicate: Duplicates the selected workflow in the list.

Add New Workflow

To add a new workflow:

  1. Select the button + New Workflow in the top bar actions to open the Manage Work Steps pane.

  2. In the Manage Work Steps pane, enter a unique name for the workflow.

  3. Select the link Manage Content Types to open the pane Add Content Types to Workflow in which you can select the content types that you want to add to the workflow and then select the button Done

    You can see the added content types right below the Workflow name in the Manage Work Steps pane.
  4. Select the button Click to add new status to add a new status to the workflow (added as a new status card in the left frame), which opens the information related to new status in the right frame of the Manage Work Steps pane, wherein you can set a name and other properties to manage the flow of a status.

  5. Select the button Save.

Manage Workflow Statuses

You can manage workflow statuses while creating or editing a workflow. The following are the status settings that you can manage:

General Settings

In the general settings, you can manage the following: 

  • Status Name: A text field wherein you can edit/update the name of the status.

  • Color code: A color bar left to the name of a status, which you can select to open the color pallet and then select a unique color for the status.

  • Set as starting status: A check box that allows you to set or remove a status as a starting status (or one of the starting statuses), which a user can assign to a new document as the first workflow status.

    You can only set a status as a starting status when at least one more status is already available for the same workflow and after you have created a transition relation between them. 
  • Enable Redlining: A check box that allows/disallows tracking changes in a document.

  • Delete Status: You can delete a status through the delete icon within the status card.

Transitions

You can set transitions between two or more statuses to define a structured flow between the statuses.

To set transition for a status: 

  1. Select the status for which you want to set transition. 

  2. Select the Select another status dropdown menu to see the list of the other statuses in the workflow.

  3. Select the status(es) that you want to transition to from the current status.

After you have set transition for a status, Quark Publishing Platform NextGen adds a Transitions button to the status card to expand or hide the transitions related the status. 

You can remove a transition status through the delete icon next to the transition status.
Participation

The settings in the Participation section allows you to decide who can set this status for their documents.

There are three options: 

  • Allow all roles to participate at this status: Usually the default selection that allows everyone with a certain role the access to a status.

  • Allow no one: This option helps prevent any manual override to content automation flow.

  • Select a few roles: Allows you to grant access to a status to only a certain set of users. You can manage the list of users through the button Manage, which gets enabled when you select the Select a few roles radio button.

The Manage button opens a pane with a list of roles from which you can select the ones you want to grant access to a status.

Quark Publishing Platform NextGen also displays the selected roles within the Participation section.

Privileges

The settings in the Privileges section allows you to set default or custom privileges for the selected roles. Essentially, the section allows you to override privileges; for example, when you override the check out privilege for a role that means a user with that role can cancel the checkout of document by another user.

These settings are as follows: 

  • For All Roles, use default privileges at this status: Allows you to use the default settings as defined in the selected roles for a status.

  • For All Roles, override privileges at this status: Allows you to override certain default privileges for certain content types in the selected roles for a status. You can manage the list of privileges through the button Manage, which gets enabled when you select the For All Roles, override privileges at this status radio button.

To override privileges for a status:

  1. Select the button Manage to open the Redefine Privileges for All Roles pane.

  2. In the pane, select the content types from the dropdown menu for content types. Be default, all content types are selected.

  3. Select the role icon next to the listed privilege that you want to override. This opens a dialog with the following three options:

    1. Allow: Allows to override the privilege for the selected role and content types for a status. 

    2. Deny: Denies overriding of the privilege for the selected role and content types for a status.

    3. Do Nor Override: The default privilege settings.

  4. Select the button Done to apply override privilege settings.

Rules

The settings in the Rules section allows you to set constraints related to the attributes on the transition from one workflow status to another. The section allows you to set constraints on both ends - while entering a status and while exiting a status for which there are separate tabs - Before Entering and Before Exiting.

You can apply the following types attribute constraints on the status transition (before entering or before exiting a status):

  • Prevent change of the following attributes: Prevents a user from changing the value of the selected attributes to successfully transition between statuses.  

  • Require change of the following attributes: Makes a user to change the value of the selected attributes to successfully transition between statuses.  

  • Require a value of the following attributes: Makes a user to provide the value of the selected attributes to successfully transition between statuses.  

You can select the attributes on which you want to apply transition constraints on through the button Manage, which opens a pane with a list of attributes.

Settings

The Settings page allows you to set up an environment on a local machine or in an organization to trigger requests and get responses from a Quark server to be able to use Quark Publishing Platform NextGen. You can roll out various changes in accordance with an organization's needs through these settings which are mostly related to the Service Provider and the Identification Provider values with some admin-based attributes. 

The settings are as follows:

SAML

  • SAML 2.0 ENDPOINT (HTTP): Allows you to add your IDP (Identification Provider) address that gets a response from the server.

  • Identity Provider Issuer: A unique key that allows you to identify the identity provider on the server.

  • Callback URL: Allows the system to send requests to access Quark applications from a machine.

  • Public Certificate: Allows the system to receive encrypted data from the server and then to decrypt data at the user end.

  • SAML Assertion for login: Allows you to choose attributes that are used universally within an organization. 

Extensibility

The Extensibility tab under the Settings page allows you to add new extensions to Quark Publishing Platform NextGen.