Professional Documents
Culture Documents
00
Customization Guide
November 2009
www.bmc.com
Contacting BMC Software
You can access the BMC Software website at http://www.bmc.com. From this website, you can obtain information
about the company, its products, corporate offices, special events, and career opportunities.
United States and Canada
Address BMC SOFTWARE INC Telephone 713 918 8800 or Fax 713 918 8000
2101 CITYWEST BLVD 800 841 2031
HOUSTON TX 77042-2827
USA
Outside United States and Canada
Telephone (01) 713 918 8800 Fax (01) 713 918 8000
If you have comments or suggestions about this documentation, contact Information Design and Development by email at
doc_feedback@bmc.com.
Support website
You can obtain technical support from BMC Software 24 hours a day, 7 days a week at
http://www.bmc.com/support. From this website, you can:
■ Read overviews about support services and programs that BMC Software offers.
■ Find the most current information about BMC Software products.
■ Search a database for problems similar to yours and possible solutions.
■ Order or download product documentation.
■ Report a problem or ask a question.
■ Subscribe to receive email notices when new product versions are released.
■ Find worldwide BMC Software support center locations and contact information, including email addresses, fax
numbers, and telephone numbers.
Preface 7
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Contents 5
6 Customization Guide
Preface
Prerequisites
To perform the procedures described in the guide, you must have accessibility to,
and know how to use, the following applications or application files:
BMC SMPM (application files)
Microsoft Visio 2007
Microsoft Image Composer
Microsoft Word
Microsoft Excel
HTML editor
Preface 7
BMC Service Management Process Model 7.6.00
8 Customization Guide
Chapter
This section describes the main graphical elements used in the BMC SMPM
interface.
The following topics are provided:
Process model box (page 10)
Process model header (page 10)
Other graphical elements (page 10)
10 Customization Guide
Other graphical elements
12 Customization Guide
Chapter
The process and procedure diagrams used in BMC SMPM were created using
Microsoft Visio 2007 and converted to the graphics interchange (GIF) format.
When using BMC SMPM, a process diagram appears when you click its
corresponding process model box. Similarly, a procedure diagram appears when
you click its corresponding procedure box.
The individual action boxes and decision diamonds that are found in the
procedure diagrams also exist in the work instruction pages as individual
drawings.
The drawing types are:
process diagrams
procedure diagrams
action box or decision diamond
This section describes how to change a BMC SMPM drawing and then how to
update the corresponding work instruction.
The following topics are provided:
Changing a diagram (page 14)
Updating related work instructions (page 15)
Changing a diagram
If your organization uses a workflow for a process or procedure that is not the
same as the one suggested by BMC SMPM, you can change the related diagram to
indicate that difference. You can make the following types of changes:
Update the graphical elements in the diagram
Change the text in the diagram
The following procedure describes how to make these types of changes.
NOTE
You need Microsoft Visio 2007 to perform the following procedure.
X To change a diagram
1 Using Microsoft Visio 2007, open the diagram that you want to change.
The diagrams are located in the following location:
instDir\Process and Procedure Diagrams\SMPMProcessDir.
For example: instDir\Process and Procedure Diagrams\Event Management
2 Make a copy of the original drawing file for recovery purposes.
3 Make the necessary changes in the original drawing.
NOTE
If you add or modify action boxes or decision diamonds in the diagram, you must
perform the steps described in “Updating related work instructions” on page 15.
Do this as soon as you finish this procedure.
4 Save the changed drawing as a VSD file (that is, Microsoft Visio 2007 format).
5 Convert the changed VSD file to a GIF file.
For specific instructions about how to convert the VSD file to a GIF file, see
“Converting VSD files to GIF format” on page 16.
6 Make sure the new GIF file has the same name as the VSD file (exclusive of the
extension).
7 Copy the new GIF file to the directory that contains the original GIF file and
overwrite the original GIF file with it.
For example, if you are changing a diagram in the Event Management process,
open instDir\SMPM\Event\.
NOTE
If the physical size of the new diagram is not the same as the previous diagram, it
does not display correctly in its corresponding HTML page. If this happens, see
“Adjusting diagram size” on page 19 for instructions about how to adjust the
HTML size settings that control the display position of the GIF file.
14 Customization Guide
Updating related work instructions
8 If you added, moved, or removed an action box or decision diamond, adjust their
hotspots accordingly in the HTML file that contains the diagram.
For instructions about how to change the hotspots, see “Changing hotspots” on
page 17.
9 Open the BMC SMPM process related to the diagram that you changed and make
sure that the new process or procedure diagram appears correctly. Make sure also
that its hotspots are in the correct position and that they take the user to the correct
procedure or work instruction.
NOTE
Make sure the step number portion of the file name has two digits. In the preceding
example, the step number is 01.
4 Open BMC SMPM and check the work instruction to make sure the new text
appears correctly.
NOTE
Make sure that you use the same naming convention for the new file that is used
with the existing files, that is, WprocedureNumber_stepNumber.htm. The
stepNumber must have two positions. For example, procedure 1, step 2 must be
represented as W1_02.htm. The procedureNumber does not use a leading zero.
2 Using an HTML editor such as Notepad, open the new work instruction file.
3 Edit the contents of the file to match the new work instruction.
4 Save and close the file.
5 Open BMC SMPM and check the new work instruction to make sure the new text
and GIF file appears correctly. If the GIF file is the wrong size, see “Adjusting
diagram size” on page 19 for information about how to reposition it.
NOTE
For a process or procedure diagram, this should not include the edges around the
diagram, nor should it include the name that appears above the diagram in the
header. To create a GIF file for a single action box or decision diamond from a
procedure diagram (for example, to use in a work instruction HTML page), select
only the box or the diamond.
16 Customization Guide
Updating related work instructions
Changing hotspots
BMC SMPM uses the hotspot code to indicate the location of the hyperlink target,
the shape of the hotspot, and its position on the interface.
The following is a list of the hotspot types used in BMC SMPM:
box
diamond
process or procedure link
roles link
Table 2-1 shows examples of the different types of hotspots along with a sample
section of code for each hotspot type.
Table 2-1: Hotspot types and sample code
Type Code sample
Box <area href="Work_Instructions/W2_07.htm"
shape="rect"
coords="327, 382, 475, 421">
Diamond <area href="Work_Instructions/W2_06.htm"
shape="polygon"
coords="400, 249, 326, 298, 400, 348, 475, 298">
X To change a hotspot
1 Using an HTML editor, open the related process or procedure HTML file.
2 Locate the section of code that relates to the hotspot you are changing.
18 Customization Guide
Updating related work instructions
20 Customization Guide
Chapter
The text that appears in the process model boxes and the process model headers
can be changed to reflect the needs of your organization.
This section describes how to change the text in process model boxes. It also
describes how to change the text in process model headers using either the out-of-
the-box alternative process model headers or by creating a new process model
header.
The following topics are provided:
Changing text in process model boxes (page 22)
Changing the text in process model headers (page 23)
NOTE
If you change the name of a process or a procedure, you must also change the name
of the related HTML frames page. For information about how to do this, see
“Changing the HTML frames page files” on page 33.
Use the following procedure to change the text in a process model box.
22 Customization Guide
Changing the text in process model headers
24 Customization Guide
Changing the text in process model headers
TIP
The names of the files in this directory indicate their content. For example,
Alarm_Management.gif contains the text, “Alarm Management.”
4 Rename the copied file to that of the original file name in step 1.
For example, rename Alarm_Manager.gif to Event_Header.gif.
5 Open the target process model and view the model header to make sure the
Process Header File was replaced successfully.
TIP
You might need to refresh the browser to see the process model header.
NOTE
To perform the following procedure, you need access to the Microsoft PowerPoint
and Microsoft Image Composer applications.
NOTE
If the Toolbox is not visible, select View > Toolbars, and select the Toolbox
checkbox.
26 Customization Guide
Changing the text in process model headers
NOTE
If the composition guides are not visible, select View > Composition Guides.
TIP
See Table 3-1 on page 24 to determine the correct directory and file name.
Directories and file names are listed in the “Directory and File Name in the BMC
SMPM directory structure” column.
15 Click Save.
16 Click Yes to overwrite the existing file.
17 Click OK to dismiss the message that warns you about flattening the format.
18 Open the related BMC SMPM process to make sure that the standard process
model header file was replaced successfully.
TIP
You might need to refresh the browser to see the process model header.
19 In the code of the HTML file that uses the picture, make sure that the width and
height are correct.
For information about how to do this, see “Adjusting diagram size” on page 19.
28 Customization Guide
Chapter
This section describes other tasks that you can perform to customize your
installation of BMC SMPM.
The following topics are provided:
Updating the version number and date (page 30)
Replacing the BMC SMPM logo (page 31)
Changing the Page Header (page 32)
Changing the Page Footer (page 32)
Changing the HTML frames page files (page 33)
Configuring the CSS for Section 508 compliance (page 33)
30 Customization Guide
Replacing the BMC SMPM logo
NOTE
Make sure that the new documents have the same names as the old documents.
NOTE
To perform this procedure, you need an graphic file containing your company’s
logo in a format that can be read by a graphical editor.
32 Customization Guide
Changing the HTML frames page files
NOTE
Most frames page files end with _Frames.htm. For example:
Event_Procedure1_Frames.htm. The frames page file for the BMC SMPM main
page uses the following naming convention:instDir\SMPM\index.htm.
NOTE
For more information about Section 508 requirements, see www.section508.gov.
Use the following procedure to configure the CSS for Section 508 compliance.
34 Customization Guide
Appendix
BMC SMPM uses some special, non-standard HTML characters and tags, which
are listed and described in this section.
The following topics are provided:
Special HTML characters (page 36)
Special HTML tags (page 36)
36 Customization Guide
Appendix
Table B-1 lists the steps that you must perform when changing a process name. Use
this table as a checklist.
38 Customization Guide
*107031*
*107031*
*107031*
*107031*
*107031*