DOCUMENT CLASSIFICATION TOOLBAR IN A DOCUMENT CREATION APPLICATION

[0001] This application claims priority from United States provisional application No. 60/863,067 filed Oct. 26, 2006 and U.S. patent application No. 11/877,616 filed Oct. 23, 2007 the contents of which is hereby incorporated by reference in their entirety.

[0002] The present disclosure relates to computer systems and software, and in particular to electronic document management and security using a document classification toolbar.

[0003] Electronic documents commonly used in the corporate and government environments are generated being word processing applications, spreadsheets, slide presentations, the most common being Microsoft Office™ application suite. With today's pervasive networking systems such as local area networks (LANs), wide area networks (WANs) and the Internet, and software tools such as e-mail, it is very easy for individuals to move these documents around to different computers, computer systems and other individuals without little or no thought as to the sensitivity of the content contained therein. As a matter of security in the electronic workplace there is therefore a need to classify, manage and control the creation and flow of documents, e-mail correspondence and the like.

[0004] Some document management solutions allow the user to associate classifications to a document when a document is added to a document management repository governed by document management systems. These classification properties are stored in the document library database and are not actually attached to the document itself and are dependent on the document management system for identification and enforcement.

[0005] When a document is removed from the document management repository and sent to or shared with someone, it loses the associated properties because the properties are not part of the document. The classification may not also be visible on any printed copies of the document itself. As a result, the person receiving the document has no easy way to identify the classification of the document, and they therefore do not know what limitations should be placed on the handling and distribution of the document. In addition, compliance systems verifying the handling or distribution of the document have no way to decide what to do with the document as there are no properties attached to the document and potential contained in the document itself.

[0006] There is therefore a need for an improved classification and management system for electronic documents.

[0007] In an aspect there is provided a method for document classification in a document creation application comprising providing a security classification toolbar within an extendable mark-up language (XML) based word processing document in the document creation application, the classification toolbar providing a first classification selection input; populating the first security classification selection input in the classification toolbar with a plurality of security classification selections based upon pre-defined security classification criteria, the pre-defined classification criteria defining the plurality of security classification selections available to a user of the document creation application; receiving a first security classification selection input from the plurality of security classification selections, selected by the user, from the first security classification selections populated in the toolbar; applying visual cues associated with the selected first security classification input, the visual cues presented within editable text portions of the document in the document creation application to provide visual indication within the text of the document to identify that the document has been security classified based upon the selected first security classification; and assigning XML security classification properties to the document metadata embedded in the XML based word processing document identifying the first selected security classification input.

[0008] In accordance with another aspect there is provided a method for document classification in a document creation application comprising the steps: providing a classification toolbar within the document, the classification toolbar providing at least a first classification selection input; populating classification selections in the classification toolbar based upon pre-defined classification criteria; receiving identification of a selected text portion of the document from a user; receiving a portion classification selection input, selected by the user, from the classification selections populated in the toolbar; determining if portion classification input is valid based upon administrator defined classification policy; applying visual cues to the document to identify a portion of the document has been classified; applying visual markers identifying the selected classification at the beginning and end of the portion that has been classified; and applying XML properties within the document representing the classification of the portions.

[0009] In accordance with yet another aspect there is provided a non-transitory computer readable medium containing instructions for providing document classification in a document creation application, the instructions which when executed by a processor for performing providing a security classification toolbar within an extendable mark-up language (XML) based word processing document in the document creation application, the classification toolbar providing a first classification selection input; populating the first security classification selection input in the classification toolbar with a plurality of security classification selections based upon pre-defined security classification criteria, the pre-defined classification criteria defining the plurality of security classification selections available to a user of the document creation application; receiving a first security classification selection input from the plurality of security classification selections, selected by the user, from the first security classification selections populated in the toolbar; applying visual cues associated with the selected first security classification input, the visual cues presented within editable text portions of the document in the document creation application to provide visual indication within the text of the document to identify that the document has been security classified based upon the selected first security classification; and assigning XML security classification properties to the document metadata embedded in the XML based word processing document identifying the first selected security classification input.

[0010] Other aspects and features will become apparent to those ordinarily skilled in the art upon review of the following description of specific embodiment of the invention in conjunction with the accompanying figures.

[0025] It will be noted that throughout the appended drawings, like features are identified by like reference numerals.

[0026] Embodiments are described below, by way of example only, with reference to FIGS. 1-14.

[0027] Due to compliance legislation such as the Sarbanes-Oxley Act in the United States (or more precisely, the Public Company Accounting Reform and Investor Protection Act of 2002), policies such as the Health Insurance Portability and Accountability Act (HIPAA), or other legal or corporate guidelines there is a need for greater security of information. Companies need to be able to determine the classification of documents so that their employees will handle information correctly in terms of privacy, security, distribution and retention. The best way to do this is to generate recognizable classification properties and visual markers in the documents when they are being created so that everyone will know the level of sensitivity of the documents and how to handle them.

[0028] By creating classification criteria metadata properties inserted in a document travel with the document and also allow automatic processes to check the handling of the document. For example, a messaging gateway or content scanner can verify the classification of documents being sent out of the company via e-mail for any violations of policy. In addition classification criteria can allow the automatic insertion of to visual cues to identify the associated classification in a standard manner. Heretofore, this cannot be done with productivity suites such as Microsoft™ Office software, Adobe™ Acrobat, OpenOffice™, Corel™ WordPerfect™ Office and Microsoft Visio™. Most document creation applications allow users to add optional properties to the document such as Title, Author, Subject, but cannot force the user to enter any properties before a document is saved or enforce classification standards. The document classification system described herein can force the user to select classification properties to be associated with the document, or portions therein, in addition to providing visual cues inserted within the document in standard format to ensure classification properties are appropriately identified and transmitted. Automatic insertion of visual markings in document including headers and footers in addition to advanced formatting capabilities which allow the user to apply the classification markings to specific areas of the header and footer (left justified, center, right justified etc.) to provide a consistent level of visibility not previously available. Custom properties that are associated with the document travel with the document and reflect the classification of the document can be integrated with rights management systems to limit access and distribution of document based upon the associated classification.

[0029] Event driven logic is utilized to force user to classify a documents before saving, sending or printing as described in more detail below. In addition to providing overall document classification, portions of the document can be classified at a different level than the document classification with unique classification markings associated to clearly identify the selected portion. All SAVE, PRINT and SEND events are interpreted within the document productivity software and ensure that classification selections have been made before these actions. Prevention or warning can be displayed when the user attempts to downgrade a classification of a document. In the downgrade prevent mode, if the user tries to downgrade the classification, for example from SECRET to UNCLASSIFIED, they can be prevented based upon the existing properties associated with it. Alternatively the document can be automatically classified based on the users profile. For example, all users in the finance department could be configured to automatically apply a classification of FINANCIAL INFO to all their documents. Visual markings within the document such as header, footer or watermarks can be automatically inserted based upon the selected classification.

[0030] Context sensitive classification selections which change based on user selection can also be provided by the toolbar. For example, if the user selects CONFIDENTIAL as a classification they can then be prompted to indicate which department generated the confidential information and how long the information should be retained as a corporate record.

[0031] FIG. 1 provides a high level overview environment in which classification toolbars can be utilized. A user selects 114 classifications for a document via toolbar extensions to the office software applications such as Microsoft Word™, Excel™, PowerPoint™ or Adobe Acrobat™, etc. executed by computers 108, 110 and 112 having processors and memory which are operated by users 114, 116 and 118 respectively. The client may be a personal computer, notebook computer or portable computing device such a mobile phone or personal digital assistant (PDA) device. In a networked environment the clients 108, 110, 112 can access a storage or document management server 104 through a network 102 such as the internet. The server 104 can provide access to a storage device 106 containing documents. The storage device 106 may also contain computer readable code required to implement the toolbar on clients 108, 110 and 112. Alternative the computers 108, 110 and 112 may have local storage for documents and computer executable code.

[0032] Classification selection enables the automatic creation of properties that will travel with the document and may be enforced by document classification software either residing on the computer 108, 110, or 112, or by a central server 104. Trusted label support provides verification that classification of the document has not been modified (tampered with) which can be done by calculating a hash of the document properties on saving and recalculating the hash on re-opening of the document by the software operating on the client. In addition, the classification policy allows users to search a network or PC for documents with specific classifications. Automatic logging may be provided for all classification actions by the user can be provided which can be used to audit user compliance. For example all classification warnings, classification errors, or all classification events (who classified, when classification properties were assigned, name of document etc) can be logged and reviewed by an administrator. Digital rights management policies such as Windows No Print or No Change can also be applied and controlled.

[0033] FIG. 2 describes the high level client architecture for implementing document classification toolbar. In this example, applications such as Word, Excel, PowerPoint, Acrobat applications 202 are implemented in the computing environment. The development environment in this case is application programming interface (API) 204 such as Component Object Model (COM) programming interface utilized in Microsoft™ Office™ or APIs utilized in Adobe™. The end user interface 206 presents a composition screen or editing interface. The document classification is built by programming in the COM programming interface to accommodate a classification toolbar 208 presented to the user when composing a document. The toolbar may be implemented in a traditional toolbar approach or in the ribbon toolbar as provided in Microsoft Office 2007 applications. The classification toolbar 208 can be composed of several components, some presented to the user while others components provide additional functionality in regards to the classification process itself. For example, classification 210 selections may be presented to the user, as will be described in more detail. Classification policies 212 may be enforced based upon rules relative to the classification associated with the document, for example, certain classifications may limit who the has privileges to access, read, edit, save, print the document. Visual markings 214 may also be included in the document based on the classification, as will be discussed in more detail below, and events related to changes in classification may be logged 216 for access by an administrator.

[0034] FIG. 3 shows a document classification toolbar 300 utilized when creating or editing documents. By selecting classification criteria via the toolbar, users can assign visual markers to the document in addition to assigning classification properties. The classification toolbar 300 is added to the application in which the document is being edited to enable the user to select classifications to be associated with the document or portions of the document therein. In this example first level classification criteria entry menu 302 and a secondary classicisation criteria menu defining project 306 classifications are provided. In the classification menu 302, classifications criteria 304 such as for example a Sensitivity or Security level such as Unclassified, Confidential, Restricted, Internal Use Only, Secret, etc. can be selected by the user. Other levels of classification can be introduced such as secondary classification 306 to indicate the appropriate project 308 or department name such as Sales Strategy, Sales Forecast, Sales Plan, etc. or distribution such as Executive Only, Senior Managers only etc. and the like. Any type of classification category can be utilized including but not limited to project, case number, file number, patient number, customer number, program name or number, etc.

[0035] The collection of classification properties can be context sensitive and the selections are configurable. For example, if the user selects Confidential as the security classification, they could then be prompted for a retention property or a distribution property. On the other hand, if the user selects Unclassified as the document type, there would be no need to collect any other classification properties. As an example, the classification collection logic could be implemented as follows:

	IF
	First Level Selection is CONFIDENTIAL
	THEN
	DISPLAY Second Level RETENTION selection
	ELSE
	NO MORE CLASSIFICATIONS

[0036] This example can be extended to many levels of classification allowing the organizations to collect many classification properties for each document. The toolbar is built dynamically based on the user selections. As an example of a possible configuration, if the user selected a sensitivity of PERSONAL, no other selections are necessary. If the user selects a sensitivity of COMPANY CONFIDENTIAL the toolbar is dynamically configured to further prompt the user for the allowed distribution of the document (e.g. LEGAL DEPT ONLY). In this way the toolbar can expand as the user is entering the classification information. Only subsequent classification criteria associated with the first selection is dynamically presented in the toolbar as will be discussed in connection with FIG. 14.

[0037] FIG. 4 shows classification toolbar 400 in which the first classification 402 is related to the security of the document while the second classification selection 404 defines the retention policy to be associated with the document. For example the document may have a retention-based model to classify the information to enforce retention with labels such as Personal, Retain for 90 days, Retain for 1 Year, or Corporate Correspondence. After classifications are assigned to the document, the document can be saved. Third party archiving and retention systems utilized the classification selection to determine if or how to retain a corporate document based on the Retention property assigned.

[0038] It should be understood that although on two classification criteria are shown each in FIGS. 3 and 4, a toolbar may present multiple classification criteria for selection by the user.

[0039] FIG. 5 shows a word processing application 500, in this example Microsoft Word™ containing document 520 is shown utilizing a ribbon toolbar presentation. Toolbar 502 extends vertically within the application presenting the classification criteria to be selected by the user and applied to the document in contrast to the horizontal toolbar for FIGS. 3 & 4. The toolbar 502 presents a security classification criteria menu 504, a ‘caveat’ criteria menu 506, a ‘derived’ from menu 508 and an additional field 510 for entry of the classifying user. The classification criteria, as they are selected, can result in the application of visual cues to the text and images contained in the document 520. In this example, a header 522 is added which identifies the selected classification criteria. In addition, the classification scheme associated with the selected classification can add a watermark to the document 524, which in this example identifies the document as “SECRET”. Automatic insertion of the author's user name in the document watermark can also be provided based upon the currently logged on user's name can be retrieved from the operating system and inserted into the document watermark.

[0040] Context sensitive text such as disclaimers can be added within the document body or within the header of footer portions. These disclaimers can be intelligently added to be tailored to the classification of the document and the associated content. For example, if UNCLASSIFIED was the selected classification the following text could be appended “This document is the property of XXX Corp. If you are not the intended recipient of the document please notify the originator”, whereas a different postfix such as “This document has been marked as Confidential to XXX Corp. Unauthorized reproduction or transmission of the document is prohibited” if the classification selected was CONFIDENTIAL. Visual cues such as font characteristics can also be used in the added text for instance color, special fonts, font size, or formatting (table etc) can all be applied to text.

[0041] Portions of the document content may also be classified independently of the overall document, however when a portion classification is selected which is higher then the document selection, the document properties may be upgraded to match the selection, such as for example a security or sensitivity related criteria. In document 520, paragraph 526 is selected by the user for individual classification. By making selections using toolbar 502, visual cues 528 and 530 can be added within the document to clearly identify the associate classification criteria. In this example a classification of SECRET has been selected and a caveat RelToUSA_CAN which is not the same as the current selected document caveat RelToNATO. The classification markings for portions are represented within the document as Extensible Markup Language (XML) properties of the document as shown in FIG. 13. In the case or Microsoft Word, for example, the base XML version of the document is modified with custom classification properties which represent the classification portion markings and the overall document classification. The markings may be custom to the application or organization or may be defined as per the Intelligence Community Classification and Control Markings Manual also known as the CAPCO Guide.

[0042] High level functions are available to the user when composing a document through operation of the toolbar. These functions are also available if the user wants to apply classification information to an opened document that currently has no classification properties, or an opened document that already has assigned classifications. Classification selection can be forced on Save, Exit or Print from a pop-up dialog rather than presenting a classification toolbar. In addition a downgrade warning for preventing downgrades when Saving or Printing can also be provided. Although a word processing document is shown should be understood that the application of the classification criteria is equally applicable to any form of document, including but not limited to Microsoft Word™, Excel™ and PowerPoint™ formats. Any document creation product can be utilized which do not currently allow classification of documents.

[0043] FIG. 6 shows an example of document classification properties 600 inserted into document metadata. Document classification information can be added to documents generated by office productivity applications based on document-specific classification criteria properties. In this example under the document properties a custom label is created. The properties section 602 can define the classification criteria 604. Current document management systems do not modify the document in any way, as a result there are no visual markings in the document when it is opened in an application, that would identify the classification properties. Without visual markings the user has no easy way of identifying the classification of the document. The classification properties can be stored with the document properties provided in document metadata which may also be stored as XML properties in the document instead as Microsoft Office custom properties, as shown in FIG. 12. Trusted label support can also be utilized in generating the classification properties by providing verification that the classification of the document has not been modified (tampered with) since document was saved. This is accomplished by computing a hash based on document properties as the document is being saved, and then re-computing the hash for comparison when the document is re-opened. The Microsoft CAPI encryption algorithms can be used to generate a hash which is used to verify the authenticity of the classification properties when the document is opened.

[0044] FIG. 7 presents a screen capture of an exemplary hierarchical tree in a Windows Registry 700. Each Microsoft Office™ product supports the insertion of header/footer objects differently. Microsoft Word allows the insertion of a header and a footer, in PowerPoint only footers are supported and in Excel header/footers are only visible on print. The registry entries 704 defined for each application enable an administrator to enter their requirements, but also result in a setup which is feasible for each product. The method used to implement this is a Windows registry tree which accommodates different settings for Word, Excel and PowerPoint. The entries 706 defines the behaviour of the toolbar within the application and how the classification criteria are applied to the document itself.

[0045] The classification toolbar can also provide built-in integration for users of the Microsoft Windows Rights Management Services (RMS) platform. Administrators can define associated RMS permissions such as Read, Full Control, Printing, Copy and Paste, and document expiration based on the classification label chosen. The RMS permissions or templates are defined within the Microsoft RMS Administration tool. Once these RMS permissions are defined they can be associated with classification criteria. This is done via Windows registry settings that indicate to the document classification toolbar if RMS protection should be automatically assigned based on a classification selection by the user. If RMS protection is to be applied, then another Windows registry would be used to indicate what protection should be assigned for each classification. As an example, a presentation assigned an HR ONLY label could be automatically assigned RMS permissions that would not allow anyone outside the HR department to view the presentation. The Document Classification Administration tool sets the correct Windows Registry settings based on the configuration selected by the administrator. These settings can then be applied to user desktops using scripts or Microsoft Group Policy.

[0046] FIG. 8 shows an classification administration tool window 800. The classification levels 802 of the toolbar are defined by selecting a specific level and associating criteria or tags 804 with the level. A toolbar label 806 can then be associated with the level in addition to a visual tooltip 808. Each level can be defined independently or be conditional on the previous level. Default selection can also be applied to enforce specific document attributes and visual markings. The administration tool also allows the administrator to predefine all possible classification selections and allows for automatic policy enforcement based on the classifications selected by the user. For instance the document could be automatically encrypted & protected using third party encryption schemes, such as digital rights management protection. Automatic logging of all classification actions by the user, which can be used to audit user compliance. The software can be configured to log all classification warnings, classification errors, or all classification events (who classified, when, classification properties assigned, name of document etc), The software writes this log information to the user's local Windows Event Log in a special folder. The administrator can perform the following actions: customize the list of labels you want to use; administrator can define default labels; define if/when the label(s) will appear in the presentation footer; define if/when the label(s) will appear in the presentation notes header/footer; force the user to make an explicit selection of a label before saving or printing the presentation; and turn on the trusted labels feature to ensure classification integrity.

[0047] Administrator defined settings are captured in the configuration file which is the central source of configuration information. The configuration file may be local on the computer 108, 110 and 112 or be provided by the document server 104. This enables customization of the list of labels for classification; ability for administrator to configure warnings or prevent users from downgrading classifications; ability for administrator configuration to apply different customized headers, footers and watermarks depending on the classification selected; administrator can define default labels; define if/when the label(s) will appear in the document title or file name; define the formatting and color of any visual marking text within the document such as the header or footer portions; define if/when the label(s) will appear including the ability to display abbreviations of the classifications; force the user to make an explicit selection of a label before saving; and sort and search a PC's or network's document database based on the document's classification.

[0048] FIGS. 9 and 10 show a method for executing a classification toolbar and generating an document containing classification properties. At step 902 a user creates or opens a document using a productivity application. The document may be opened/created within an application or selected outside of the application in the operating system interface thus invoking the application to executed at step 904. At step 906 the classification toolbar is presented within the document. Based upon the defined administration policy of the classification the toolbar can then be populated with classification selection (for example function COffice Document:Enable Command Bar) at step 908. As previously noted the toolbar may alternatively only be presented at the end of the document creation process. The population criteria may be a default setting or may utilize existing classification settings previously associated with the document. The user can then select a first classification level at step 910 (for example function Set Dropdown Selection). If multiple classification level policies are implemented, YES at step 912, the next menu selection can then be made available at step 910. The selection of the next level of classification may be related to the previous level of classification selected, for example each selection in the first level may have a different subset of selections available in the second or subsequent levels. If no more classification levels are required, NO at step 912, the input is validated at step 914. Validation may be performed by the server or based upon rules contained within the client or done locally based on the administration policy. If the input is valid, YES at 914, as shown in FIG. 10, it is determined if classifications are assigned at step 1002. If no classification are assigned, NO at step 1002, step 910 is re-executed to require user input. If the classifications are assigned, YES at step 1002 the associated visual cues are added to the document at step 1004 and the document classification properties can be applied at step 1004. The document can then be saved, printed or transmitted with the classification.

[0049] FIGS. 11 shows a method for executing a classification toolbar for classification marking a portion of a document. At step 1102 a user selects to classify a portion of document content, such as a sentence, paragraph, or an image for classification marking. It is assumed that the toolbar is already present, but it may be invoked if it is already not available. The population criteria may be a default setting or may utilize existing classification settings associated with the document, if previously defined. The user can then select a first classification level at step 1104 (for example function COffice Document:Enable Command Bar). If multiple classification level policies are implemented, YES at step 1106, the next menu selection can then be made available at step 1104. The selection of the next level of classification may be related to the previous level of classification selected, for example each selection in the first level may have a different subset of selections available in the second or subsequent levels. If no more classification levels are required, NO at step 1106, the input is validated at step 1108. Validation may be performed by the server or based upon rules contained within the client or done locally based on the administration policy. If the input is valid, YES at 1108, the associated visual cues and visual markings, such as specific graphics or icons, are added to the selection portion at step 1110. At this step XML properties representing the classification selections are written into the XML representation of the document. It is then determined if the selection impacts the overall document classification at step 1112. If the selected portion classification is higher than the document classification, then the document classification properties will also be updated to reflect the change, YES at step 1112. The document properties are then updated at step 1114. The document can then be saved, printed or transmitted at step 1116. If the classification does not impact the overall document classification, NO at step 1112, then the document can then be saved, printed or transmitted with the classification criteria at step 1116. At step 1114 the overall document visual cues of the document may also have to be updated if the classification criteria selected impact the overall document classification. For example, if the document was original UNCLASSIFIED and a portion of text was identified as SECRET, the overall document classification would be upgraded to SECRET.

[0050] FIG. 12 shows XML document classification properties 1200 as represented in XML in a Microsoft Word 2007 document. The classification properties are written to the custom properties file within the Microsoft Word 2007 Word XML representation (docx file). As an example, this document has a Caveat property (TitusCorpidCaveat) 1202 of ReltoNATO (Release to NATO). All of these classification properties are accessible to outside programs via normal XML programming tools.

[0051] FIG. 13 shows a portion of the document 1300 of FIG. 5 in XML and the identifying classification and portion marking. The portion classification markings are written to the document.xml file that is part of the XML representation of a Microsoft Word 2007 document (docx file). The custom XML inserted as a result of portion classification starts at the line that says CustomXML 1302. A custom XML schema representing the classification properties has been added to the base schema implemented by Microsoft for Word 2007 documents. In this example the user has classified the text “This paragraph will be classified” 1304. The text corresponds to what is currently in FIG. 5, section 526. Within this property you can see the actual text that has been portioned marked. The custom XML indicates that this portion has been classified as SECRET and ReItoUSA_CAN (Release to USA and Canada). Using XML to represent classification of portions means they are accessible to outside programs via normal XML programming tools. As an example it would be easy to write a document redaction tool which would redact a document based on the XML portion classifications.

[0052] FIG. 14 shows an illustration of dynamic toolbar population based on user classification selection. Toolbar 1400 shows a first classification selection 1402 of UNCLASSIFIED. Based upon the selected classification the second classification criteria 1404 is populated with the criteria selection and entries associated with the first classification. In this example the UNCLASSIFIED selection results in the dynamic selection only one additional classification property of ‘Document Status’ and the associated entries. In contrast, in toolbar 1410, if the first classification criteria 1412 is selected to be SECRET, the three additional classification criteria are dynamically generated. The secondary classification criteria 1414 is a ‘Caveat’ selection property; third classification criteria 1416 in this case entitled ‘Derived From’; and fourth classification criteria 1418 entitled ‘Classified By’. In addition to independent field 1420 entitled document status, which may be tied back to the original SECRET classification and not dependent on the remaining classification selections. Each of the subsequent criteria may have dependent classification criteria that are dynamically generated based upon the user selections.

[0053] The following logic describes some example modules in the software and the methods associated with those modules. It also describes the events associated with each module. The COfficeDocument module contains the following methods:

[0054] i. AddHeaderFooter

[0055] ii. BuildPropertyString

[0056] iii. CalcDropdownWidths

[0057] iv. CheckDowngrade

[0058] v. Cleanup

[0059] vi. CreateCommandBar

[0060] vii. CreateHash

[0061] viii. EnableCommandBar

[0062] ix. EnableSecondLevel

[0063] x. ExtractFromSignature

[0064] xi. GetClassificationList

[0065] xii. GetDropdownSelections

[0066] xiii. GetProperty

[0067] xiv. GetSignatureShape

[0068] xv. HasClassifications

[0069] xvi. HashProperties

[0070] xvii. HasSignature

[0071] xviii. HasValidProperties

[0072] xix. HasValidPropertiesHashed

[0073] xx. Initialize

[0074] xxi. InsertFieldCode

[0075] xxii. InsertSignature

[0076] xxiii. InsertTitusTemplate

[0077] xxiv. Invoke

[0078] xxv. ProcessCommand

[0079] xxvi. ReadBuiltlnProperty

[0080] xxvii. ReadSignature

[0081] xxviii. SelectClassifications

[0082] xxix. SetDropdownSelections

[0083] xxx. SetHeader

[0084] xxxi. SetRMSPermission

[0085] xxxii. SetWatermark

[0086] xxxiii. UpdateClassifications

[0087] xxxiv. UpdateHeaderFooter

[0088] xxxv. ValidClassifications

[0089] xxxvi. WriteClassifications

[0090] The CClassificationList module contains the following methods:

[0091] xxxvii. ReadClassificationsFromDocument

[0092] xxxviii. WriteClassificationsToDocument

[0093] xxxix. WritePlaceholdersToDocument

[0094] The CWordApplicationEventhandler module contains the following methods:

[0095] xl. AddOfficeDocument

[0096] xli. Cleanup

[0097] xlii. CleanupStrayDocuments

[0098] xliii. CreateHelpAbout

[0099] xliv. FindOfficeDocument

[0100] xlv. Initialize

[0101] xlvi. Invoke

[0102] xlvii. ProcessCommand

[0103] The following provide more detail on the actual methods:

[0104] i. bool COfficeDocument::AddHeaderFooter(Word::RangePtr pRange, bool fInsert)

[0105] Summary: Adds text to a header/footer

[0106] Parameter pRange: Range to add too

[0107] Parameter fInsert: Can we insert into the document

[0108] Returns: Success of adding text

[0109] Determine if any of the fields in the range match the value for the first property or match the value for the second property

[0110] For all fields in range

• • [0111] If the value for the first property was not found and we can insert
    • [0112] Call InsertFieldCode
  • [0113] If the value for the second property was not found and we can insert
    • [0114] Call InsertFieldCode

[0115] ii. std::string COfficeDocument::BuildPropertyString(Word::_DocumentPtr pDocument)

[0116] Summary: Combine statistics from document and classifications into one string

[0117] Parameter pDocument: Document to get properties from

[0118] Returns: String containing the properties

[0119] iii. void COfficeDocument::CalcDropdownWidths( )

[0120] Summary: Calculate the width for each dropdown

[0121] iv. bool COfficeDocument::CheckDowngrade( )

[0122] Summary: Determines if the classification level is okay in terms of downgrade

[0123] Returns: True if the save is allowed

	If classification downgrade has occurred
	Show warn or prevent message to user
	If downgrading document is okay
	Prevent future warnings from displaying
	Return true
	Else
	Return false

[0124] v. void COfficeDocument::Cleanup( )

[0125] Summary: Cleanup the commandbar

[0126] vi. void COfficeDocument::CreateCommandBar(bool fTampered)

[0127] Summary: Set up our custom toolbar

[0128] Parameter fTampered: Has the document been tampered with

[0129] Calls GetClassificationList

[0130] Adds a new toolbar

[0131] Adds the dropdowns to our toolbar

[0132] Calls EnableCommandBar

[0133] Calls GetDropdownSelections

[0134] Calls WriteClassifications

[0135] vii. bool COfficeDocument::CreateHash(std::string strData, std::string& strHashedData)

[0136] Summary: Creates a hash of the data

[0137] Parameter strData: Data to hash

[0138] Parameter strHashedData: Hash of data

[0139] Returns: Hash creation success

[0140] Use the Crypt API to create a hash of the data

[0141] viii. bool COfficeDocument::EnableCommandBar(bool fEnable)

[0142] Summary: Enable or disable our command bar

[0143] Parameter fEnable: Enable CommandBar

[0144] Returns: True if CommmandBar enabled

[0145] Calls SetDropdownSelections

[0146] Enables or Disables CommandBar

[0147] Calls EnableSecondLevel

[0148] ix. void COfficeDocument::EnableSecondLevel(boot bFirstEnabled)

[0149] Summary: Enables second Level Dropdown

[0150] Parameter bFirstEnabled: Enabled second level

[0151] x. std::string COfficeDocument::ExtractFromSignature(std::string strSignature, std::string strName)

[0152] Summary: Extracts a value of a name-value pair from the signature

[0153] Parameter strSignature: Signature to extract from

[0154] Parameter strName: Name of name-value pair to extract

[0155] Returns: Value of name-value pair to extract

[0156] xi. CClassificationList* COfficeDocument::GetClassificationList(bool fTampered)

[0157] Summary: Returns the classification list

[0158] Parameter fTampered: Has the document been tampered with

[0159] Returns: Classification list

	If we have previously set the classification list
	return that classification list
	Else
	Create new classification list
	If document has not been tampered with
	Call ReadClassificationsFromDocument
	return the new classification list

[0160] xii. bool COfficeDocument::GetDropdownSelections( )

[0161] Summary: Retrieve the dropdown selections from the toolbar

[0162] Returns: If dropdown selection has changes since we last checked

[0163] Calls GetClassificationList

[0164] Get the selection for each dropdown

[0165] xiii. STDMETHODIMP COfficeDocument::GetProperty(LPDISPATCH pDisp, LPOLESTR pszName, VARIANT* pvResult)

[0166] Summary: Retrieve a named property from the document

[0167] Parameter pDisp: Object to get property from

[0168] Parameter pszName: Name of property

[0169] Parameter pvResult: Value of property

[0170] Returns: Success

[0171] xiv. Word::ShapePtr COfficeDocument::GetSignatureShape (Word::_DocumentPtr pDocument, bool fCreateNew)

[0172] Summary: Returns the signature shape that matches our signature name from the document

[0173] Parameter pDocument: Document to get signature shape from

[0174] Parameter fCreateNew: Create a new shape if requested

[0175] Returns: The signature shape

[0176] Match all shape names against our signature name

	If a match is found
	return the match
	Else
	If we can create a new shape
	Add a label to the document with the signature name

[0177] xv. bool COfficeDocument::HasClassifications(Word::_DocumentPtr pDocument)

[0178] Summary: Determines if the document has classifications

[0179] Parameter pDocument: Document to check

[0180] Returns: True if the document has classifications

[0181] Calls ReadClassificationsFromDocument

[0182] xvi. bool COfficeDocument::HashProperties(Word::_DocumentPtr pDocument)

[0183] Summary: Creates a signature of the document properties

[0184] Parameter pDocument: Document to get properties from

[0185] Returns: Success of creating hash

[0186] Calls BuildPropertyString

[0187] Calls CreateHash

[0188] Calls InsertSignature

[0189] xvii. bool COfficeDocument::HasSignature(Word::_DocumentPtr pDocument)

[0190] Summary: Determines if the document has a signature

[0191] Parameter pDocument: Document to check

[0192] Returns: True is document has a signature

[0193] Calls GetSignatureShape

[0194] xviii. bool COfficeDocument::HasValidProperties(Word::_DocumentPtr pDocument)

[0195] Summary: Determine if the document has valid properties

[0196] Parameter pDocument: Document to check

[0197] Returns: True if valid Properties

[0198] Return False if we can't find all of our document properties

[0199] xix. bool COfficeDocument::HasValidPropertiesHashed

[0200] (Word::_DocumentPtr pDocument)

[0201] Summary: Determines if the hash in the signature matches the current document

[0202] Parameter pDocument: Document to check

[0203] Returns: True if signature matches properties of document

[0204] Calls ReadSignature on document

[0205] Calls ExtractFromSignature on the signature

[0206] Calls BuildPropertyString on document

[0207] Calls CreateHash

[0208] Compares hash from document and hash just created

[0209] xx. void COfficeDocument::Initialize(LPDISPATCH/*lpDispatch*/)

[0210] Summary: Get the handle to the window for the document

[0211] Parameter lpDispatch: unused

[0212] xxi. bool COfficeDocument::InsertFieldCode(Word::FieldPtr pField, LPCSTR szName)

[0213] Summary: Insert a new field code using the given property name

[0214] Parameter pField: Field to insert into

[0215] Parameter szName: Name of document property

[0216] Returns: Success of insertion

[0217] xxii. void COfficeDocument::InsertSignature(Word::_DocumentPtr pDocument, std::string strValue)

[0218] Summary: Inserts the text into the signature shape

[0219] Parameter pDocument: Document to insert signature into

[0220] Parameter strValue: Value to put in signature

[0221] Calls GetSignatureShape

[0222] Sets the text of the signature shape

[0223] xxiii. bool COfficeDocument::InsertTitusTemplate( )

[0224] Summary: Insert a Word template into the document

[0225] Returns: True if template inserted

[0226] Open a named word template file (.dot)

[0227] Copy the contents of the template document into the current document

[0228] xxiv. STDMETHODIMP COfficeDocument:: Invoke(DISPID displdMember, REFIID riid, LCID Icid, WORD wFlags, DISPPARAMS* pDispParams, VARIANT* pVarResult, EXCEPINFO* pExcepl nfo, UINT* puArgErr)

[0229] Summary: Event handler for COfficeDocument

[0230] Parameter displdMember: Event type

[0231] Parameter riid: Interface type

[0232] Parameter Icid: unused

[0233] Parameter wFlags: unused

[0234] Parameter pDispParams: unused

[0235] Parameter pVarResult: unused

[0236] Parameter pExcepInfo: unused

[0237] Parameter puArgErr: unused

[0238] Returns: Success

[0239] New Event:

• • [0240] Set Active to true
  • [0241] Set Active Window to current document

[0242] Open Event:

• • [0243] Set Active to true
  • [0244] Set Active Window to current document

[0245] Close Event:

• • [0246] Set Active to false
  • [0247] Unset Active Window to current document

[0248] xxv. HRESULT COfficeDocument::ProcessCommand(int nControlID, int nCommand, bool fMakeDirty)

[0249] Summary: Process commands sent from the toolbar

[0250] Parameter nControlID: What control is sending the command

[0251] Parameter nCommand: unused

[0252] Parameter fMakeDirty: unused

[0253] Returns: Success

	If Control is first level dropdown
	Calls GetDropdownSelections
	Calls EnableSecondLevel
	Calls WriteClassifications
	Else If Control is second level dropdown
	Calls GetDropdownSelections
	Calls WriteClassifications
	Else if Control is third level button
	Calls SelectClassifications
	Calls WriteClassifications

[0254] xxvi. std::string COfficeDocument::ReadBuiltInProperty(Word::_DocumentPtr pDocument, std::string strPropertyName)

[0255] Summary: Return a string for the named built in property

[0256] Parameter pDocument: Document to read from

[0257] Parameter strPropertyName: Name of property to read

[0258] Returns: Value of property

[0259] xxvii. std::string COfficeDocument::ReadSignature(Word::_DocumentPtr pDocument)

[0260] Summary: Gets the text from the signature shape

[0261] Parameter pDocument: Document to read from

[0262] Returns: Text of signature

[0263] Calls GetSignatureShape\

[0264] xxviii. bool COfficeDocument::SelectClassifications( )

[0265] Summary: Shows Select Classification Dialog

[0266] Returns: Classifications set from dialog

[0267] Calls GetClassificationList

[0268] Shows Select Classifications Dialog <<Screenshot of dialog>>

[0269] xxix. void COfficeDocument::SetDropdownSelections( )

[0270] Summary: Set the selections on each dropdown

[0271] Calls GetClassificationList

[0272] Set the selection for each dropdown

[0273] xxx. void COfficeDocument::SetHeader(bool fInsert)

[0274] Summary: Updates or inserts text in all headers and footers

[0275] Parameter fInsert: Are we allowed to insert text into the header if it doesn't exist already

[0276] For all sections of the document

[0277] Calls UpdateHeaderFooter on the PrimaryHeaderRange

• • [0278] Calls UpdateHeaderFooter on the FirstPageHeaderRange

[0279] Calls UpdateHeaderFooter on the EvenPageHeaderRange

• • [0280] Calls UpdateHeaderFooter on the PrimaryFooterRange
  • [0281] Calls UpdateHeaderFooter on the FirstPageFooterRange
  • [0282] Calls UpdateHeaderFooter on the EvenPageFooterRange
  • [0283] If we can insert
    • [0284] If header required
      • [0285] Calls AddHeaderFooter on the PrimaryHeaderRange
      • [0286] Calls AddHeaderFooter on the FirstPageHeaderRange
      • [0287] Calls AddHeaderFooter on the EvenPageHeaderRange
    • [0288] If footer required
      • [0289] Calls AddHeaderFooter on the PrimaryFooterRange
      • [0290] Calls AddHeaderFooter on the FirstPageFooterRange
      • [0291] Calls AddHeaderFooter on the EvenPageFooterRange

[0292] xxxi. bool COfficeDocument::SetRMSPermission( )

[0293] Summary: Sets the RMS template to be applied to the document

[0294] Returns: Success

[0295] Get the RMS template assosiated with the current classification

[0296] Calls GetProperty passing in “Permission”

[0297] Retrieves current RMS template applied

	If RMS is required
	Enable RMS
	Apply RMS template
	Else
	If RMS is on
	Remove RMS
	If RMS failed
	Show RMS failure warn or prevent message

[0298] xxxii. void COfficeDocument::SetWatermark(std::string strClassification, bool fInsert)

[0299] Summary: Updates or inserts the watermark using the given classification

[0300] Parameter strClassification: Text to put as the watermark

[0301] Parameter fInsert: Are we allowed to insert a watermark if one isn't there

[0302] If the Titus watermark is found by matching the name of the watermark against a known name

	If we require a watermark
	Update the text of the watermark to reflect the current
classification
	Else
	Delete the watermark from the document
	Else
	If we require a watermark
	Insert the watermark into the document with the text set to
the current classification

[0303] xxxiii. void COfficeDocument::UpdateClassifications(bool fTampered)

[0304] Summary: Updates the header, footer, watermark, and selected fields within the document

[0305] Parameter fTampered: Has the document been tampered with

[0306] If the document has not been tampered with

• • [0307] Call SetWatermark
  • [0308] Call SetHeader

[0309] Update fields in the document that match our property names

[0310] xxxiv. bool COfficeDocument::UpdateHeaderFooter(Word::RangePtr& pRange, bool fInsert)

[0311] Summary: Update a header/footer

[0312] Parameter pRange: Range of a header/footer

[0313] Parameter fInsert: False to hide the text

[0314] Returns: True if update successful

[0315] For all fields in the range of the document

• • [0316] If the field code text matches the value for the first property
    • [0317] Change the hidden value and update it
  • [0318] If the field code text matches the value for the second property

[0319] Change the hidden value and update it

[0320] xxxv. bool COfficeDocument::ValidClassifications( )

[0321] Summary: Determines if all dropdowns that require a selection have been set

[0322] Returns: True if no dropdown requires a selection

[0323] xxxvi. bool COfficeDocument::WriteClassifications(bool fAskIfRequired, bool fTampered)

[0324] Summary Writes classifications to document

[0325] Parameter fAskIfRequired: Ask for classifications if they are not valid

[0326] Parameter fTampered: Has the document been tampered with

[0327] Returns: True if classifications are valid

[0328] Calls GetClassificationList

[0329] Calls ValidClassifications

[0330] If ForceSelect is on and classifications are not valid

• • [0331] Calls SelectClassifications
  • [0332] Calls ValidClassifications

[0333] If the classifications are valid

[0334] Calls WriteClassificationsToDocument

[0335] Calls UpdateClassifications

[0336] xxxvii. short CClassificationList::ReadClassificationsFromDocument (Word::_DocumentPtr pDocument)

[0337] Summary: Reads the classifications from the document

[0338] Parameter pDocument: Document to read classifications from

[0339] Returns: Number of levels

[0340] Get the custom document properties from the document

[0341] Get the value from the named property for the first level

[0342] Get the value from the named property for the second level

[0343] Get the value from the named property for the third level

[0344] xxxviii.short CClassificationList::WriteClassificationsToDocument (COfficeDocument* pDocument)

[0345] Summary: Writes classifications into the custom document properties

[0346] Parameter pDocument: Document to write classification to

[0347] Returns: Zero

[0348] Gets the custom document properties

[0349] Adds or updates the value of the custom document property with the value of the first dropdown

[0350] Adds or updates the value of the custom document property with the value of the second dropdown

[0351] Adds or updates the value of the custom document property with the value of the third level

[0352] xxxix. short

[0353] CClassificationList::WritePlaceholdersToDocument(COfficeDocument* pDocument)

[0354] Summary: Write classifications to document properties

[0355] Parameter pDocument: Document to write to

[0356] Returns: Zero

[0357] Add a custom document property for the first level

[0358] Add a custom document property for the second level

[0359] Add a custom document property for the third level

[0360] xl. COfficeDocument*

[0361] CWordApplicationEventHandler::AddOfficeDocument (Word::_DocumentPtr pDocument, bool fNew, bool fIsE-mail)

[0362] Summary: Add the word document to our collection

[0363] Parameter pDocument: Document to add

[0364] Parameter fNew: Is the document new

[0365] Parameter fIsE-mail: Is the document an e-mail

[0366] Returns: COfficeDocument

[0367] Calls FindOfficeDocument

[0368] If that returns NULL

• • [0369] Calls HasClassifications
  • [0370] Calls HasValidPropertiesHashed
  • [0371] If those two calls return true
    • [0372] Calls HasSignature
    • [0373] If that call returns true
      • [0374] Set tampered to true
    • [0375] Create a new COfficeDocument
    • [0376] Calls CreateCommandBar
    • [0377] If tampered
      • [0378] Show Invalid Signature message
    • [0379] If new document and not an e-mail
      • [0380] Calls InsertTitusTemplate

[0381] xli. void CWordApplicationEventHandler::Cleanup( )

[0382] Summary: Cleanup help command bar

[0383] xlii. void CWordApplicationEventHandler::CleanupStrayDocuments( )

[0384] Summary: Remove any documents from our collection that we don't need anymore

[0385] xliii. void CWordApplicationEventHandler::CreateHelpAbout( )

[0386] Summary: Add a menu item to the Help About menu

[0387] If the menu item is already there delete it

[0388] Add the menu item

[0389] xliv. COfficeDocument*

[0390] CWordApplicationEventHandler::FindOfficeDocument (Word::_DocumentPtr pDocument)

[0391] Summary: Find the document in our collection

[0392] Parameter pDocument: Document to find

[0393] Returns: Document in our collection

[0394] Match the document in our collection with the one passed in

	If matched
	return that document
	Else
	return null

[0395] xlv. void CWordApplicationEventHandler::initialize(LPDISPATCH /*lpDispatch*/)

[0396] Summary: Initialize event handler

[0397] Parameter IpDispatch: unused

[0398] Calls CreateHelpAbout

[0399] xlvi. STDMETHODIMP CWordApplicationEventHandler::Invoke(DISPID displdMember, REFIID riid, LCID Icid, WORD wFlags, DISPPARAMS* pDispParams, VARIANT* pVarResult, EXCEPINFO* pExcepInfo, UINT* puArgErr)

[0400] Summary: Event handler for CWordApplicationEventHandler

[0401] Parameter displdMember: Event type

[0402] Parameter riid: Interface type

[0403] Parameter Icid: Unused

[0404] Parameter wFlags: Unused

[0405] Parameter pDispParams: Parameters for event

[0406] Parameter pVarResult: Unused

[0407] Parameter pExcepinfo: Unused

[0408] Parameter puArgErr: Unused

[0409] Returns: Success

[0410] Quit Event:

• • [0411] Calls CleanupStrayDocuments

[0412] DocumentBeforePrint Event:

• • [0413] Calls WriteClassifications
  • [0414] Cancel print if classifications are not okay

[0415] DocumentBeforeSave Event:

• • [0416] If document is dirty and this is not an auto-save
    • [0417] Calls WriteClassifications on Document
    • [0418] Calls CheckDowngrade on Document
    • [0419] Calls SetRMSPermission on Document
    • [0420] Calls HashProperties on Document
    • [0421] If any of these methods return false
      • [0422] Cancel the Save

[0423] WindowActivate Event:

• • [0424] Calls FindOfficeDocument
  • [0425] If document not in collection
    • [0426] Calls AddOfficeDocument
  • [0427] Calls EnableCommandBar
  • [0428] Calls ShowCommandBar
  • [0429] Calls CleanupStrayDocuments

[0430] WindowDeactivate Event:

• • [0431] Calls FindOfficeDocument
  • [0432] Calls CleanupStrayDocuments

[0433] xlvii. HRESULT CWordApplicationEventHandler::ProcessCommand(int nControllD, int nCommand, bool fMakeDirty)

[0434] Summary: Show the about dialog

[0435] Parameter nControlID: ID of control

[0436] Parameter nCommand: unused

[0437] Parameter fMakeDirty: unused

[0438] Returns: Success

[0439] Show About Dialog

[0440] It will be apparent to persons skilled in the art that many alternatives, modifications, and variations can be made without departing from the scope as defined in the claims. The method steps described may be embodied in sets of executable machine code stored in a variety of formats such as object code or source code. Such code is described generically herein as programming code, or a computer program for simplification. Clearly, the executable machine code may be integrated with the code of other programs, implemented as subroutines, by external program calls or by other techniques as known in the art.

[0441] A computing environment for executing the document creation application and the classification toolbar may be implemented as computer software in the form of computer readable code executed. The computing environment may be any number of computing or computer based platforms such as mobile devices, personal computer, notebook computers, or personal digital assistants. The computer comprises central processing unit (CPU) and memory. The CPU may be a single processor or multiprocessor system. In various computing environments, main memory and storage can reside wholly on computer environment, or they may be distributed between multiple computers.

[0442] Input devices such as a keyboard and mouse may be coupled to a bi-directional system bus of a computer for receiving input for creating documents within the web client. The keyboard and mouse are for introducing user input to a computer and communicating that user input to processor if required. Computer may also include a communication interface. Communication interface provides a two-way data communication coupling via a network link to a network by wired or wireless connection or may provide an interface to other host devices by a direct radio frequency connection. In any such implementation, communication interface sends and receives electrical, electromagnetic or optical signals which carry digital data streams representing various types of information. Communication between the communication interface unit and the network or host use electrical, electromagnetic or optical signals which carry digital data streams. The signals through the various networks and the signals on network link and through communication interface, which carry the digital data to and from computer, are exemplary forms of carrier waves transporting the information.

[0443] The computer processor or similar device may be programmed in the manner of method steps, or may be executed by an electronic system which is provided with means for executing these steps. The storage device may include both fixed and removable media, such as magnetic, optical or magnetic optical storage systems, Random Access Memory (RAM), Read Only Memory (ROM) or any other available mass storage technology. The storage device or media may be programmed to execute such method steps. As well, electronic signals representing these method steps may also be transmitted via a communication network.

[0444] The embodiments described above are intended to be illustrative only. The scope of the invention is therefore intended to be limited solely by the scope of the appended claims.