Introduction & Overview
Introduction & Overview
DocuBuilder is an automated publishing system for mutual fund marketing and compliance documents.
DocuBuilder works from within any web browser to give companies control over their documents in a
familiar and uncomplicated environment.
The DocuBuilder Interface allows users to assemble documents from these components with automated
support. The system applies filtering criteria attached to each component and uses document structural
rules and content requirements to ensure compliance with regulatory standards and corporate style.
DocuBuilder Overview:
Documents, in many simultaneous outputs are published and created on-demand in seconds.
While appropriate for many types of documents in many industries, Mutual Fund documents that
have been implemented include;
Prospectuses,
Statements of Additional Information (SAI),
Proxies,
Shareholder reports,
NQs,
Supplements
Exhibits
Factsheets
Pitchbooks
EDGAR filing documents
XBRL filing documents
Library
Components may be
Text
Subhead
Note (a special case of text)
Table
Variable
Image
Components are shared between documents. When a component is edited, the change will be
reflected in all future versions of documents when that component is used.
Traditionally, when working on a document for publication, changes are tracked manually.
Copies are made of these changes and placed in a physical folder for each document that is to be
affected by this change. Then, when starting the process for one of these other documents, the
changes are reviewed, and hopefully, applied where appropriate.
By linking the components from the library to the document, a change made to a component
while editing a document in January, will automatically be made to a different document that is
opened in March.
This reduces the time required to track changes in the department, and to apply those changes to
relevant documents. It also reduces the opportunity for error as all relevant changes are made to
all documents immediately.
Changes may also be applied to the system with an effective and/or expiration date. This is
especially helpful in the use of tables ? where it is imperative that certain data not be shown after
a certain date.
Changes to data are saved. No data is deleted. This facilitates an audit trail for every change to a
document throughout its lifetime. The system also supports black lining: Both at the document
and the component level allowing users to track these changes.
Using business rules, data is filtered for the user. By utilizing features such as expiration,
association and context, users are able to find their data quickly and efficiently. Irrelevant data is
automatically removed from search results thus eliminating the need for a content librarian.
Benefits
Traditional typesetting is essentially removed from the process. Practically, this means that the
time turn changes and the corresponding costs are dramatically reduced. A round of changes that
used to take hours and cost hundreds of dollars can now be done in seconds for free. This
revolutionizes the way that clients work to produce their documents
Accessing DocuBuilder from the Web
Each client has its own unique secure address. The initial screen asks the User to log in with their
User ID and Password . The details of each user?s DocuBuilder capabilities are controlled by the
permissions feature. See the User Roles and Permission section for more information.
If a user has forgotten his or her password, by clicking on Forgot Password they will be brought
to a screen to enter the answer to a secret question. Once answered correctly, the system will
email the user a randomly generated password. Upon re-entry to the system, the user will be
prompted to create a new password.
If user has access to multiple departments, the Select Department dropdown will be available to
choose the desired department. Highlight the department and click Continue to gain access.
Getting Around
DocuBuilder is a menu driven system that is easy to use and learn. The Section highlighted in red
below is fixed in its position and includes the following:.
Command Button
They are located on the top right of every window. They provide one click access as follows:
Home
Favorites
This is a new feature that allows the user to add and delete funds from a personal favorites page.
Instead of performing a document search each and every time for documents they are working on
they only have to click on Favorites and it will bring them to a complete listing of their funds.
Search
Help
Opens help for the current screen. New email ([email protected]) with pre-addressed
information to forward any questions or issues
Breadcrumb
The breadcrumb indicates where the user is currently located within the application. This is an
active breadcrumb so the user can click on any part of the breadcrumb and instantly go to that
page.
Main Menu
These tabs provide access to the various functions and capabilities within DocuBuilder. By
clicking on a tab it will open the main screen for that tab.
Documents Tab
This tab allows users to perform the following actions located in the Function Bar:
Find ? Allows the user to search for documents using the following steps:
Status ? Allows user to view document generation status of cycled or new documents
Create New ? Allows a user to create a new document
Cycle ? Allows user to cycle a published document to a new time period
Action - This drop down allows the user to perform the following functions to documents that
have 1) been returned after performing a search or 2) are listed in Favorites.
Add to Favorite- user can select individual documents to add to their list of Favorites
(this option only appears for the document search results using Find). Once added, these
documents will appear every time the user clicks on Favorites.
Remove Favorites- user can remove documents from their Favorites screen (this option
only appears in the Favorites page)
Proof Documents- user can select multiple documents and request proof rendering.
Change Status- user can select multiple documents of like status and change their status
simultaneously.
Find
Allows users the ability to search the document library using various filters described below.
a. Document Name
b. Document Type
c. Document Status
d. Asset Class
e. Fund
You can hold control key to make multiple selections in the dropdown list
DocuBuilder will search for documents that share today?s date located in the From date
window. If the user wishes to search for documents that have expired they can change or
eliminate the date by clicking on the calendar and clicking Reset or select a new date.
2. Click Submit button and search results will be returned, see screenshot below.
Status
Status allows users to track the status of a document they have created. Each document submitted
will be displayed in this list with its generation status. A user can go directly to the document
tree by clicking on the document name once its? status is green.
Create New
Document name
Select Fund family
Select Fund type: based upon family selection the available fund types and asset class
will display in the drop down
Select Document Type to be created
Select Fund(s) that will be associated to this document
If copying, select document from the Copy From Document drop down
Select From and To dates for the new document
Click on Continue
This step allows you to create the Table of Contents and Document Tree structure.
The new section name will initially only appear on the right hand side. When you highlight the
chapter name again, the section name will appear in the bottom left box (Figure 5.6)
Sections must be highlighted however, in order for them to carry over to the template.
Moving Chapters
1. Highlight the chapter name under the Document Tree (note: associated sections will move
with the chapter)
2. Click on Move Up or Move Down button to move chapters to desired position.
Moving Sections
Only one section at a time can be moved. In addition, users can move a section from one chapter
to another.
1. Highlight the section name under the Document Tree
2. Click on Move Up or Move Down button to move sections to desired position.
All chapters and sections can be dragged and dropped in the Document Tree box.
When a chapter or section name needs to be changed, the steps below should be followed:
1. Double click any chapter or section name in the Document Tree box
2. A pop up box editing window will open (Figure 5.9)
3. Make change and click Update
If an item has been removed in error, simply highlight the item(s) in the chapter and/or section
on the right hand side and click add.
If a chapter is deleted before the section(s) of that chapter are deleted, the section(s) will shift to
the Chapter directly above.
Once all chapters and sections have been created, by clicking Continue, the user will be
taken to the final step.
Step 3:
The final step in creating a new book is to determine the Table of Contents (TOC), Copy Content
and Context.
1. Select all chapters and sections to be displayed in the TOC. Usually Select All is the norm,
but there can be instances where it is not desirable to have a section appear in the TOC, simply
uncheck the section in the TOC column.
2. Copy content is only applicable if creating a new document by copying from an existing one.
For each section checked the components from the source document will be copied over into the
new document.
3. Select Context, if desired, for each section via the drop down menu. This will make the Add
More process much more efficient.
4. By clicking Submit the process of document generation will begin. User will receive a pop
up notice and be taken directly to the Status screen after clicking Ok.
5. Once the status is green the user can click on the document name and go directly to the tree
and begin editing and proofing the document.
Cycle
During Cycling, any component shared in other documents will receive the latest version of that
component in the library.
Data tables that are created and populated via upload will normally be refreshed, i.e. out. Often
tables that are manually loaded and text tables are not zeroed out. User should refer to their
Business Rules document for complete details.
How to Cycle
1. Cycle forward screen can be accessed by clicking on Cycle on the Function bar. The user
will need to:
6. User will receive a Roll-Forward Confirmation giving them one last time to cancel process or
override any table refresh
Blackline
Blacklining highlights the differences between two versions by using red strike through to show
deletions and blue text to indicate additions. DocuBuilder allows two types of blacklining,
document level and component level.
Component blacklining can only be accessed when editing a component. This is discussed in
detail in the Library chapter.
Document blacklining can be accessed either through the Function Bar by clicking on Blackline
or from within the document tree.
It is highly recommended to perform blacklining when within the document tree. The
steps below outline this process.
1. From within the document tree click on Blackline in the Tree Bar.
3. Select the proof round to run the blackline against by highlighting a proof number under
Compare to Document.
4. Click Submit and blackline will run. A confirmation will appear stating blackline has been
submitted.
5. The blacklined proof can be accessed at the View Proofs screen.
Library
The Library tab allows the user to add components to the library, load images and data files and
search the library for components.
The library contains all of the components that are used to build documents. Each component
that is created can be shared across multiple documents and/or funds.
Components are separated by type, with each type having business and style rules attributed to
them which will affect their appearance in the rendered document.
Text
Subhead
Variable
Footnote
Note
Table
Image
Components are a key element within DocuBuilder and can be considered the building blocks of
all documents generated.
New components can be created in the library by using the Add function.
To create a new component follow these steps:
1. Roll over Add with the cursor and select a component type to create by clicking. See
screenshot below.
1. The user will be brought to Add (component type) screen and should follow the steps
outlined below.
3. Format component using the rich text editing bar and/or the style dropdown box.
Always apply styles from drop down first, then styles such as bold, underline etc. from rich text
editing bar.
4. Clicking on Next will save the component into the library and bring user to the Properties
tab. User can set Context for the component and adjust Eff/Exp date if necessary.
5. Clicking Next will take the user to the Associations tab. This is where the user can assign the
component to a Document Type, Document, Asset Class or Fund or combination thereof. (See
section Associating Components for further information.)
6. At this point the user can select Next or Save . By clicking Save the component and
associated information will be saved in the library.
7. By clicking Next, the user will be taken to the Comments tab where they can add a
comment by clicking Add. When finished user can click Next to go to History or Cancel which
will go to the Library home screen.
Adding Tables
DocuBuilder tables are created using the Add>Table feature. Tables can display qualitative
and/or quantitative information. Qualitative table consists entirely of text, whereas quantitative
table can consists of alpha/numeric data.
Tables can be manually entered or created automatically via uploaded files specified in the
business rules.
The table types available are specified in the Style Guide and Table Summary.
Creating tables using the data upload feature is the preferred method of building tables. As
all content, row styles, context, component naming and associations are taken care of
automatically.
Types of files allowed to be loaded into DocuBuilder (csv, xml, excel etc) are based on the
established business rules in the Requirements Document.
1. Select row style for each row by double clicking on default. A list of available row styles
will appear. Select the appropriate style based on Style Guide rules.
2. Entering data into individual cells- the user has two options when entering information into
individual cells. They can either:
a. Double click on an individual cell and key information. Once completed they can tab over to
the next cell.
b. Right click on cell and choose ?Edit in Rich Text Editor?. A pop up will open and the user
can key information and use the rich text editing bar for styling. When finished remember to
click Save.
3. Managing Rows and Columns- the user has the ability to perform the following to the table
whether it is accessed from the library or within a document. a. Insert Rows- click on row
number then click on Insert rows and new row will be placed above.
b. Insert Columns- click on column letter then click on Insert Columns and new column will
be placed before highlighted column.
c. Merge Cells- Highlight cell by single clicking and right click and choose Merge Cells. A pop
up window will appear requesting the number of cells to the right of the highlighted cell you
wish to merge. Key in number and enter select. Cells are now merged.
When Merging, all content in cells to the right of the highlighted cell will be deleted.
d. Delete Rows/Columns- highlight row or column and click on Delete Row or Delete Column.
e. Sort Columns- user can highlight column and sort a-z or z-a for that column.
f. Moving Columns- To move a column click and hold on the letter and drag to the desired
position. A red line will appear while dragging and indicate the new location of the column.
g. Moving Rows- To move a row, click and hold anywhere in the row and drag to desired
position. The row being dragged will appear underneath the row that is light red.
Load- uploading images and data files
The Load Image and Load Data functions allow users to quickly and easily load new images or
data files into the DocuBuilder library.
1. Place cursor over Load in library menu and click on Image.
In most cases, data uploaded into pre-existing tables within DocuBuilder will overwrite all of
the values within those tables.
Tables created for the first time via upload will need to be added to the document(s) using
Add More.
File types and layouts suitable for upload are determined during the requirements gathering
process and are outlined in the Business Requirements Document.
If a file errors out during uploading, make sure type, layout and naming convention rules are
adhered to before using [email protected].
Search Library Search Library allows a user to search the component library using various
filters. As a result the user can drill down to a small subset of components quickly and easily.
Once a component is retrieved it can be edited for content, associations, properties and
comments can be applied.
Footnotes and variables cannot be applied to a component accessed via Library, they must be
applied while in the document tree.
Performing a Search The user can conduct a search using any combination of the search filters
below. By clicking Submit after selecting the search filters the user launches a search and the
qualifying components are retrieved.
If search results are too large click Refine Search and user will be brought back to Search
Library screen with previous search filters selected.
Search Filters
Display Name Search-User can enter a fragment of the display name and the results will
be any component that uses that fragment somewhere in the display name in the sequence
entered.
Exact Search Modifier This modifies searches performed using the
Display Name only. By checking this box the search will look for components with the
exact text entered into the Display Name field. If using this function it is important to key
in the entire Display Name.
Keyword Search- Searches content of component for any of the text entered. The
component does not have to contain all of text entered in the keyword search in order for
it to be in the search results.
Date Search- this date defaults to today?s date. It can be adjusted by clicking on the
calendar and adjusting date or clearing by clicking on Reset.
Best used for uploaded Tables having an Effective and Expiration date. Enter date range to
only search for tables that fall within that date range.
The search results screen will display items in the following order by component type
1. alpha lower case
2. alpha upper case
3. numeric.
To edit a returned component click on the body in the Component Details column and user will
be brought to the Edit window where they can access any of the following tabs.
Edit
Properties
Association
Comments
History
Click on one of the tabs to gain access to tab attributes. Each tab is discussed in detail in the
Working a Document chapter
Proof Tab
Document Proofs is where users can view all of the various proofs generated in DocuBuilder by
clicking on the Proofs tab.
By selecting a proof type from the drop down the user can drill immediately to the type of proof
they are looking for.
Once the desired proof type is returned the user can further refine the returns by using the quick
search fields for Document Name, Doc Type and Submitted By. The user can also sort the
existing returns by clicking on the Date and Proof columns.
In order to view a proof just click on one of the icons in the Output Type columns and the proof
will open.
EDGAR proof
Blackline proof
Print Ready
Section Proof
Table Proof
XBRL Proof
Proof History
DocuBuilder generates a sequential proof number for each proof round requested, regardless of
proof type.
In order to see the proof history just click on the proof number in the Proof column and all proof
rounds for that document will appear.
If you are looking for the history of particular proof type you must be select that proof type
from the drop down and then access proof history. Only that proof type will be displayed in the
history.
Once a document has been moved to Published status all proof rounds prior to this are
removed. Therefore the proof number will be inactive.
Proofs>Chart Status
The rendering of each chart is monitored within DocuBuilder. By clicking on Charts, all charts
that have rendered that day will be displayed. Once displayed the user has the following options:
1. Refine search by using the quick search filesd for Chart Name and Chart Type as well as sort
the other columns by clicking on the column header. 2. View thumbnail by clicking on the proof
icon. 3. Open table by clicking on the chart name. In doing so the underlying table can be
accessed and the user can madke edits to any of the component tabs. If a change is made to the
data and saved a new chart render will be kicked off. Once completed a new document proof will
need to be rendered in order to see it in the document. 4. Access document tree by clicking on
the name of the document in the Applied To column.
To view charts rendered on a previous day click on calendar, choose date and results screen
will be refreshed.
There are multiple proof retrieval screens within DocuBuilder. Regardless of the screen
selected, a proof rendering status and legend is provided.
Proof icons without any color have rendered successfully. User can scroll over each icon to view
information relative to each status.
Settings Tab
This tab contains information relative to User Access and Permissions, Fund Management and
Variables. Each one will be discussed in detail.
DocuBuilder provides varying levels of access and permissions to manage individual and
department capabilities to view, edit, comment, or approve documents. This process is normally
controlled by a client appointed system administrator who is in charge of creating and managing
the various user groups and individual permissions of the user community.
The three tabs used to manage access and permissions are My Profile, Groups and Users.
My Profile
This screen is designed for users to change specific details of their own profile. It is divided into
two sections.
My Profile includes password, secret question and secret answer.
Password must be 8 alpha numeric characters & must include at least one numeric.
System will compare New Password with last 5 passwords used and if it matched, ?
Password in history?, will ask the user to enter a different one from the previous five.
User Preference allows the user to customize certain features based on their login. They are as
follows:
View Proof- user can select the default order in which proofs are displayed when in the
View Proofs tab.
Landing Page- user can select which page they will land on when logging into
DocuBuilder. The options are
Groups
This tab allows the creation of individual groups and the management of their permissions. Each
group will have a group name, a brief description of its? responsibilities and assigned members.
When first setting up groups and users, it is best to first create your user groups with the
appropriate permissions and then create users and add them to the groups.
The type of permissions that an individual user has is determined by the group they are
assigned to. If you want a user to have more or less access to functionality they must be moved
to a different group.
2. Enter the Group Name and Description and click on radio button for New Group or Copy
From Group. a. If copying, then select from an existing group using the drop down menu. This
will pre-select all of the permissions which can be edited following the steps below. 3. Check off
the radio buttons in the Component Permissions and Document Permissions. A brief description
of each permission follows: Component Permissions
Document Permissions
4. Once permissions are selected click Submit and user group will be created and will be
available in the Groups landing page.
Attributes of an existing group can be made by following the steps outlined below.
1. Double click on the user group name in the Group Name column.
2. Make changes to the Component or Document Permissions attributes.
3. Click Submit and changes will be saved.
4. All users associated to this group will now have these new permissions.
3. Click on Ok and this will delete the group from the application. Show Members within
Groups A list of individual users assigned to a group can be provided by accessing the Members
option on Groups list screen. Clicking on the hyperlinked number under Members category
opens the members list
Administrators have the capability to delete a user from within a group by checking box
and clicking Delete. If done, this will delete the user from the system not just the user
group.
Users
The Users tab is where Administrators can create, edit and delete user profiles and assign them to
user groups. Existing users can be found quickly sorted using the quick filter boxes underneath
the column headings.
Every user created in the system must be associated to a group. A user can only be associated
to one user group at a time.
3. Scroll down and select User Preference defaults. These options can be set by users once they
log onto the system.
4. For each Department in the application you must set the Group and Document settings. Check
off department(s) user will need access to. For each department selected follow the steps below:
a. Expand Group Name folder and check off group new user will belong to.
b. Expand Document Types folder- Each type of document that can be created on the system will
be displayed as a separate sub folder. For each document type selected the user will have the
ability to proof and view that output type.
5. Once all Departments/Groups/Output selections are completed click Submit and new user will
be created in the system.
6. Administrator should then communicate ID and Password to new user and have them log in.
Upon login they will be asked to change their password and enter a secret question/answer in
case they forget password.
Administrators also have the capability to delete users by checking the Select check box, then
clicking Delete. A confirmation window appear, click Ok to continue or Cancel to stop.
FUND MANAGEMENT
Fund management allows users to add and delete funds from the system as well as manage the
attributes of each fund through the edit function. Additionally users can create variables of
varying scope that will be discussed later in this chapter.
To find and edit a fund follow the steps outlined below: 1. Click on Fund Management tab to
open the window below. You can now search on any fund existing by filling in one or all of the
key fields highlighted below and filter the search using Fund Type and Asset Class windows
2. Click on submit to start search process and fund summary screen is displayed with all the
available results
3. Click on Fund Id or Fund Name hyperlink to open the edit fund screen window
4. All fields can now be edited by either using a drop down menu selection or changing
information in a key field.
Any change to information contained on this page may affect uploads or variable rendering.
Please refer to business rules and document map or call your Account Manager if you are unsure
of the possible effect of your changes.
Create New Fund 1. Click on create button in search fund screen 2. Enter the following
information
Fund ID
Fund Name
Fund Type
Asset Class
Board Members
Inception Date
FYE
Status
Series Id
Reporting Entity Type
Reporting Entity Id
Reporting Entity Name
Ownership Interest
Actual functions appearing on the function bar vary based on the business requirements and
document type.
Rich Text Editor Toolbar Functions
Text Editor toolbars are used to provide formatting buttons that are allowed within the
component type. Below is a legend of these buttons for review.
Spell check
Add footnote
Undo typing (unlimited)
Redo typing (unlimited)
Cut
Copy
Paste (should only be used to copy information from notepad or within
DocuBuilder)
Paste as plain text
Paste from word
Bold
Italics
Underline
Superscript
Subscript
Special character
Bullets
Numbering
Increase indent
Decrease indent
Image (only available when editing a component within edit document or
editing section properties)
Variable (only available when editing a component within edit document
or editing section properties)
Insert Embedded Component (allows another component to be added to a
component -- only available when editing a component within edit
document or editing section properties)
Ability to select pre-defined style for a particular emphasis
Character count
Page Break
Insert horizontal ruler
Find/Replace
*Availability of buttons will vary based on business rules and style guide
The contents of the information bar will change based on the position of the cursor or
information highlighted.
Time Out
If DocuBuilder has no activity for 30 minutes, the system will automatically log the user out
from the application. This time is pre-set in the system and is used as a security measure to
prevent any unauthorized activity from occurring. The system will not retain any information
that was entered but not saved.
The amount of time can be reduced based on client requirements specified in the business rules.
The time however, cannot exceed 30 minutes.
Blackline