Searching the Help
To search for information in the Help, type a word or phrase in the Search box. When you enter a group of words, OR is inferred. You can use Boolean operators to refine your search.
Results returned are case insensitive. However, results ranking takes case into account and assigns higher scores to case matches. Therefore, a search for "cats" followed by a search for "Cats" would return the same number of Help topics, but the order in which the topics are listed would be different.
Search for | Example | Results |
---|---|---|
A single word | cat
|
Topics that contain the word "cat". You will also find its grammatical variations, such as "cats". |
A phrase. You can specify that the search results contain a specific phrase. |
"cat food" (quotation marks) |
Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase. |
Search for | Operator | Example |
---|---|---|
Two or more words in the same topic |
|
|
Either word in a topic |
|
|
Topics that do not contain a specific word or phrase |
|
|
Topics that contain one string and do not contain another | ^ (caret) |
cat ^ mouse
|
A combination of search types | ( ) parentheses |
|
Reconciling differences
The next step is to reconcile any differences between your tailored objects and the updated objects introduced by the applications patch.
Use the RAD Comparison Utility to assist in merging changes in RAD applications. For all other types of objects, you can use the standard Service Manager tools, or the Merge utility.
Merging new objects with your tailored objects
After you have applied the out-of-box patch successfully, you are ready to reconcile the differences and merge the new objects with your tailored versions of the objects where necessary.
- Use the Merge utility to view and merge simple objects.
- Use the Merge utility to identify the changes necessary for records with complex data structures, such as formatctrl, joindefs, links, and structured arrays, but use the normal tool for tailoring these objects to integrate the necessary changes manually.
Caution Avoid merging changes in XML records where there are instance nodes with record IDs (such as, recordid=“svcCatalog”). Changes to instance nodes with record IDs can break the primary key for a record.
Follow these steps to use the Merge utility:
- From the Windows client, log in to your Service Manager server as a System Administrator.
- Go to System Administration > Ongoing Maintenance > Upgrade Utility > View/Merge Results.
-
Enter optional search criteria, and then click Search.
Service Manager displays the results of your search. For more information, see Description of View/Merge results.
-
Open the record you wish to merge, right-click the detail page and then click Merge in the drop-down menu.
Service Manager displays both objects side-by-side in the Merge Applications Patch Records view.
Tip The XML for the new object is shown on the left side, and the XML for your tailored object is shown on the right side with the differences highlighted.
- For simple objects and elements, use the arrow buttons at the top of the pane to select individual changes and copy them from the new object over to your tailored object, or copy all changes from the new record to your tailored object. For complex objects, do the merge manually by using the appropriate tool for the object type.
- Click SAVE.
- Test the updated functionality of the merged object.
- When you are satisfied that the object is working correctly, right-click the detail page and then click Mark as Reconciled in the drop-down menu.
- Repeat this procedure for all changes that need to be merged.
Example of reconciling an object by using the Merge utility
For this example, before applying the patch, we tailored the displayoption record with a UniqueID of notify_email
by adding some comments. After applying the out-of-box patch, the notify_email
is one of the Renamed objects in the results list.
Follow these steps to merge the example form change:
-
Go to System Administration > Ongoing Maintenance > Upgrade Utility > View/Merge Results.
Service Manager displays the Applications Patch Results screen.
- Specify
login.prompt.g
as the object name, and then click Search. - Right-click the detail page and then click Merge in the drop-down menu.
-
Service Manager displays both objects side-by-side in the Merge Applications Patch Records view.
After you compare the two forms, you decide to merge the new changes into your tailored form.
-
Use the arrow buttons at the top of the pane to select the change.
- Click Copy All from Left to Right on the tool bar.
- Click SAVE.
-
Log out from the Service Manager server, and then log in again.
-
Confirm that the updated label is displayed on login.
-
Go to System Administration > Ongoing Maintenance > Upgrade Utility > View/Merge Results.
Service Manager displays the Applications Patch Results screen.
-
Specify
login.prompt.g
as the object name, and then click Search. -
Right-click the detail page and then click Mark as Reconciled in the drop-down menu.
Reconciling differences between RAD applications
Use these guidelines when reconciling differences between a tailored RAD application and the new one.
-
If your company does not have a RAD license, you are not able to merge the changes using the RAD Editor. However, you can use the RAD Comparison Utility to compare the two objects and then automatically replace your tailored RAD application with the new one using the Merge option. For details, see Automatically replace Renamed RAD applications.
- If your company has a RAD license, use the RAD Comparison Utility to compare the objects and use the RAD editor to merge the changes.
Note The codes for RAD applications for which "Current Release Level" is not marked as the current version "SM 9.61" (instead, it is still marked as the original version, "9.60" or "9.60.xxx"), are already current with the ones in Service Manager 9.61. Therefore, you should not change the "Current Release Level" field to "SM 9.61". There are two cases in which a RAD application's "Current Release Level" may be marked as "SM 9.61":
- The RAD applications which are new in Service Manager 9.61.
- The RAD applications whose code has been changed in Service Manager 9.61.
Automatically replace Renamed RAD applications
The Merge option enables you to automatically replace your tailored RAD application with the new one.
To use this option, perform the following steps:
- Navigate to System Administration > Ongoing Maintenance > Upgrade Utility > View/Merge Results.
- Locate a Renamed RAD application by performing a search.
- Click More or the More Actions icon and select Merge. Service Manager will automatically create a backup of the old object by renaming it OLDSM9.6<object_name> and then rename the new object by removing the prefix NEW9.61.00xx from the object name. The result is then marked as "Reconciled."
Example of reconciling a RAD difference
For this example, we have tailored the RAD panel approval.generate
by adding the comment //TAILORED VERSION
to the start panel. After we apply the out-of-box patch, the approval.generate
is one of the Renamed
objects in the results list.
Follow these steps to merge the panels:
- Open
approval.generate
(the tailored version) in the RAD Editor. - Click More or the More Actions icon and then select Compare Applications.
- Enter
NEW9.61.00xxapproval.generate
in the field for New Application Name. - Click Compare All on the tool bar.
-
Make a note of the Unmatched and Deleted Panels (these are the panels that you would like to analyze when reconciling differences).
In this example, the start panel appears in the Unmatched Panels column.
- On the current session, navigate to the Start panel.
- On another session, open
NEW9.61.00xxapproval.generate
, and then navigate to the Start panel. - After you compare the two panels, you decide that you would like to keep your tailoring. Copy the tailored expression (
//TAILORED VERSION
) to the start panel ofNEW9.61.00xxapproval.generate
, then save and compile. - Delete your old tailored RAD application, and then rename
NEW9.61.00xxapproval.generate
toapproval.generate
. - Confirm the functionality of your change.
-
Go to System Administration > Ongoing Maintenance > Upgrade Utility > View/Merge Results.
Service Manager displays the Applications Patch Results screen.
- Specify
approval.generate
as the object name, and then click Search. - Right-click the detail page and then click Mark as Reconciled in the drop-down menu.
Using the Mass Mark as Reconciled feature
During the patch upgrade process, you must mark conflicting objects as “Reconciled” after resolving each conflict. To help with this process, you can use the Mass Mark as Reconciled feature to mark multiple renamed objects as “Reconciled.”
To use the Mass Mark as Reconciled feature, follow these steps:
-
Go to System Administration > Ongoing Maintenance > Upgrade Utility > View/Merge Results.
Service Manager displays the Applications Patch Results screen.
-
Select Renamed in the Result drop-down list, and then click Search.
- If more than two objects exist in the resulting search, click the Mass Mark as Reconciled button from the More Actions menu and then click Yes. After you click Yes, all objects that you selected will be marked as “Reconciled” and removed from current conflict list.