Attachments on Configuration Items r12 - Revision history

Mitcr01: /* The Attachment Tab form */ - fix.

2013-10-01T14:36:33Z

‎The Attachment Tab form: - fix.

Mitcr01 at 13:04, 6 December 2012

2012-12-06T13:04:00Z

Mitcr01 at 13:01, 6 December 2012

2012-12-06T13:01:24Z

Mitcr01 at 13:00, 6 December 2012

2012-12-06T13:00:27Z

Mitcr01 at 12:59, 6 December 2012

2012-12-06T12:59:00Z

Mitcr01: /* Configuration Item detail form */

2012-12-06T12:39:16Z

‎Configuration Item detail form

Mitcr01: New page: NOTOC Category:Configuration Items Category:Customizations Category:r12 {{Global Header}} {{Global Announcement}} {{Attachments on Configuration Items, v2}} == Overview ==...

2012-12-06T12:38:11Z

New page: __NOTOC__ Category:Configuration Items Category:Customizations Category:r12 {{Global Header}} {{Global Announcement}} {{Attachments on Configuration Items, v2}} == Overview ==...

New page

__NOTOC__
[[Category:Configuration Items]]
[[Category:Customizations]]
[[Category:r12]]
{{Global Header}}
{{Global Announcement}}
{{Attachments on Configuration Items, v2}}

== Overview ==
This article provides instructions for adding attachment capabilities to Configuration Items in CA Service Desk Manager.

''Note: This customization is designed for r12.5 and above versions, providing an implementation of the previous [[Attachments_on_Configuration_Items|Attachments on Configuration Items]] customization. The previous customization is targeted for r11.x and r12.0/r12.1 CA SDM version.''

== Procedures ==
=== SDM Schema customizations ===
Use the Web Screen Painter to add a new Table in the Schema Designer. The new table should be called '''zlrel_attachment_nrs''' and should have 2 fields:
{| border="1"
|-
! style="width:100px;" | Field name
! style="width:200px;" | Type of Field
|-
| nr
| SREL to 'nr', required
|-
| attmnt
| SREL to 'attmnt', required
|-
|}

Set the Function Group of this new table to "Configuration Item". Save the Schema changes in the Schema Designer and then choose 'File->Save and Publish' from the menu.

In order for the Schema changes to be applied, stop the '''CA Service Desk Manager''' service on the primary server and then execute 'pdm_publish' from a command prompt.

Before starting the '''CA Service Desk Manager''' service, create a new MAJ file in the ''$NX_ROOT/site/mods/majic'' folder, called z_nr_cis.maj. This file should contain the following lines:
<source lang=SQL>
////////////////////////////////////////////////////////////////////////
// Factory: attmnt
////////////////////////////////////////////////////////////////////////

OBJECT attmnt {
ATTRIBUTES Attachment {
nrs BREL zlrel_attachment_nrs attmnt { LREL nr; } ;
};
};

////////////////////////////////////////////////////////////////////////
// Factory: nr
////////////////////////////////////////////////////////////////////////

OBJECT nr {
ATTRIBUTES usp_owned_resource SECONDARY {
attachments BREL zlrel_attachment_nrs nr { LREL attmnt; } ;
};
};
</source>
Make sure the file has the .maj extension, otherwise it will not be processed by SDM.

Finally, start the '''CA Service Desk Manager''' service back on and make sure that there are no errors reported in the stdlogs.

=== Interface customizations ===
==== Configuration Item detail form ====
Customize the '''cmdbNotebook.htmpl''' form to add a new Tab to the Configuration Item detail form. The form contains the definition of all the Tabs that appear on the Configuration Item detail form, you can just insert the new Tab definition where desired, using the following code:

<source lang="html4strict"> <PDM_MACRO NAME = TAB title="Files" ID=Attachments SRC="OP=SHOW_DETAIL+HTMPL=xx_attmnt_tab.htmpl+FACTORY=nr+PERSID=$args.persistent_id+NO_DP=yes"></source>

==== Attachments list form ====
Customize the '''list_attmnt_sd.htmpl''' form by adding lines in 2 places.
'''First''', after the line <source lang="Javascript">document.write('<input type="hidden" name="QBE.EQ.issues.iss.persistent_id" value="$args.QBE.EQ.issues.iss.persistent_id">');</source>
the following code should be added
<source lang="Javascript">
// Custom - enable the display of Attachments in a Tab on the Configuration Item detail form
document.write('<input type="hidden" name="QBE.EQ.nrs.nr.id" value="$args.QBE.EQ.nr_list.nr.id">');
// END Custom
</source>

'''Second''', after the line
<source lang="javascript">
case "chg": attmntAccess = "${ACCESS.FAC_chg:0}" - 0; break;
</source>
the following code should be added
<source lang="javascript">
// Custom - enable the display of Attachments in a Tab on the Configuration Item detail form
case "nr": attmntAccess = "${ACCESS.FAC_nr:0}" - 0; break;
// END Custom
</source>

==== The Attachment Tab form ====
Customize the '''xx_attmnt_tab.htmpl''' file and search for the following code fragment
<source lang="javascript">
var attmntAccess = 0;
switch ("$prop.factory") {
case "cr": attmntAccess = "${ACCESS.FAC_cr:0}" - 0; break;
case "iss": attmntAccess = "${ACCESS.FAC_iss:0}" - 0; break;
case "chg": attmntAccess = "${ACCESS.FAC_chg:0}" - 0; break;
}
</source>
and replace it with
<source lang="javascript">
var attmntAccess = 0;
switch ("$prop.factory") {
case "cr": attmntAccess = "${ACCESS.FAC_cr:0}" - 0; break;
case "iss": attmntAccess = "${ACCESS.FAC_iss:0}" - 0; break;
case "chg": attmntAccess = "${ACCESS.FAC_chg:0}" - 0; break;
// Custom - enable the Attachments tab on the Configuration Item detail form
case "nr": attmntAccess = "${ACCESS.FAC_nr:0}" - 0; break;
// End Custom
}
</source>

==== Clear the SDM web cache ====
Clear the SDM Webengine web cache by executing 'pdm_webcache' in a command prompt on the SD primary server. This will incorporate the interface customizations done in the previous steps and show them in the SDM web client.

@@ Line 86: / Line 86: @@
 </source>
 === The Attachment Tab form ===
-Customize the '''xx_attmnt_tab.htmpl''' file and search for the following code fragment
+Customize the '''xx_attmnt_tab.htmpl''' file.
 <source lang="javascript">
 var attmntAccess = 0;
@@ Line 106: / Line 108: @@
    // End Custom
+}
 </source>
 === Clear the SDM web cache ===
 Clear the SDM Webengine web cache by executing 'pdm_webcache' in a command prompt on the SD primary server. This will incorporate the interface customizations done in the previous steps and show them in the SDM web client.

@@ Line 59: / Line 59: @@
 Finally, start the '''CA Service Desk Manager''' service back on and make sure that there are no errors reported in the stdlogs.
-=== Interface customizations ===
+==Interface customizations ==
-==== Configuration Item detail form ====
+=== Configuration Item detail form ===
 Customize the '''cmdbNotebook.htmpl''' form to add a new Tab to the Configuration Item detail form. The form contains the definition of all the Tabs that appear on the Configuration Item detail form, you can just insert the new Tab definition where desired, using the following code:
@@ Line 87: / Line 87: @@
-==== The Attachment Tab form ====
+=== The Attachment Tab form ===
 Customize the '''xx_attmnt_tab.htmpl''' file and search for the following code fragment
 <source lang="javascript">

@@ Line 5: / Line 5: @@
 {{Global Header}}
 {{Global Announcement}}
-== Overview ==
 This article provides instructions for adding attachment capabilities to Configuration Items in CA Service Desk Manager.
@@ Line 13: / Line 13: @@
-== Procedures ==
+= Procedures =
-=== SDM Schema customizations ===
+== SDM Schema customizations ==
 Use the Web Screen Painter to add a new Table in the Schema Designer. The new table should be called '''zlrel_attachment_nrs''' and should have 2 fields:
 {| border="1"
@@ Line 65: / Line 65: @@
 <source lang="html4strict"> <PDM_MACRO NAME=TAB  title="Files" ID=Attachments SRC="OP=SHOW_DETAIL+HTMPL=xx_attmnt_tab.htmpl+FACTORY=nr+PERSID=$args.persistent_id+NO_DP=yes"></source>
-==== Attachments list form ====
+=== Attachments list form ===
 Customize the '''list_attmnt_sd.htmpl''' form by adding lines in 2 places.
 '''First''', after the line <source lang="Javascript">document.write('<input type="hidden" name="QBE.EQ.issues.iss.persistent_id" value="$args.QBE.EQ.issues.iss.persistent_id">');</source>
@@ Line 110: / Line 110: @@
 </source>
-==== Clear the SDM web cache ====
+=== Clear the SDM web cache ===
 Clear the SDM Webengine web cache by executing 'pdm_webcache' in a command prompt on the SD primary server. This will incorporate the interface customizations done in the previous steps and show them in the SDM web client.

@@ Line 33: / Line 33: @@
 In order for the Schema changes to be applied, stop the '''CA Service Desk Manager''' service on the primary server and then execute 'pdm_publish' from a command prompt.
-Before starting the '''CA Service Desk Manager''' service, create a new MAJ file in the ''$NX_ROOT/site/mods/majic'' folder, called z_nr_cis.maj. This file should contain the following lines:
+Before starting the '''CA Service Desk Manager''' service, create a new MAJ file in the ''$NX_ROOT/site/mods/majic'' folder, called '''z_nr_cis.maj'''. This file should contain the following lines:
-<source lang=SQL>
+<source lang=text>
 ////////////////////////////////////////////////////////////////////////
 // Factory:   attmnt