Export (0) Print
Expand All

Using the Management and Configuration Features

This section contains procedures that demonstrate how to use the Message Analyzer item collection download, auto-syncing, and sharing features for tasks that you are likely to perform on a consistent basis. This section also provides instructions on how to create a Chart viewer for data analysis purposes.

The procedures are presented in the following subsections:

Download and Auto-Sync Item Collections — provides an example of how to download an item collection once without synchronizing it for updates; how to set a selected item collection for auto-syncing updates; and how to synchronize all item collections for updates.

Share Local Library Items on a File Share — provides an example of how to export and import user Library items for mutual sharing and collaboration with others.

Manually Configure Item Update Synchronization on a User Feed — shows how to manually configure an item collection for update synchronization on a user-configured feed.

Create and Edit a Chart Data Viewer — demonstrates how you can create your own Chart-style data viewer for enhanced data analysis perspectives.


Download and Auto-Sync Item Collections

This example demonstrates how to download default Library item collections and how to auto-sync these collections for updates.

To download an item collection

  1. From the Start menu or taskbar of your computer, click the Microsoft Message Analyzer icon to start Message Analyzer.

  2. Click the Downloads tab on the Start Page to display any item collections that are not auto-synced, as indicated by the server download status icon to the right of the item collection you want to download.

  3. Click the server download status icon for an unsynced item collection to display the Item Download Options dialog.

  4. In the Item Download Options dialog, select the Download once and don’t automatically update option and then click OK to exit the dialog and display the Select Items to Import dialog.

  5. In the Select Items to Import dialog, accept the default selection of the Use Existing Categories check box, or optionally deselect this check box and specify the Library category in which to place collection items by clicking the Add to Category drop-down and selecting a category from the menu that displays.

  6. In the Select Items to Import dialog, select the items and/or categories that contain the items you want to download.

  7. Click OK to exit the Select Items to Import dialog.

  8. Open the local Library that corresponds to the type of item collection you downloaded and observe that the Library is populated with the items you selected.

To auto-sync an item collection

  1. From the Start menu or taskbar of your computer, click the Microsoft Message Analyzer icon to start Message Analyzer.

  2. Click the Downloads tab on the Start Page to display any item collections that are not auto-synced, as indicated by the server download status icon to the right of a target item collection.

  3. Click the server download status icon for the item collection that you want to auto-sync for updates, to display the Item Download Options dialog.

  4. In the Item Download Options dialog, select the Automatically sync item updates when available option and then click OK to exit the dialog.

    The item collection that you auto-synced is removed from the Downloads tab and reappears on the Settings tab with the auto-sync status icon displaying to the right of the collection. The auto-synced state indicates that the item collection in your Message Analyzer installation will be periodically and automatically refreshed with updates as they become available.

  5. To auto-sync all item collections that are currently displayed on the Downloads tab of the Start Page, click the Sync All Displayed Items button.

    The item collections that you auto-synced are removed from the Downloads tab and reappear on the Settings tab with the auto-sync status icon displaying to the right of each collection.

    Note  When you click the Sync All Displayed Items button on the Downloads tab to set all items to the auto-sync state, this includes all OPN Parser packages.

Share Local Library Items on a File Share

This example shows how to export Filter items as an asset collection from the centralized Filter Expression Library to a user-configured file share or other designated location to share these items directly with other users. This example also specifies how users can retrieve the asset collections that you post to such a designated location.

To export a Filter asset collection

  1. From the Start menu or taskbar of your computer, click the Microsoft Message Analyzer icon to start Message Analyzer.

  2. Click the Message Analyzer Home tab and then click the Library drop-down in the View Filter group on the Ribbon of the Home tab to expose the Library items and management features.

  3. In the Library drop-down, click the Manage Filters menu item to open the Manage Filter dialog.

  4. In the Manage Filter dialog, select the items and/or Library categories that contain the items you want to export for sharing.

  5. Click the Export button on the Manage Filter dialog command bar to open the Save Library dialog.

  6. In the Save Library dialog, enter a name for the asset collection in the Title text box and the collection author in the Author text box. Optionally, add Description and Organization information.

  7. Click the Save button to exit the Save Library dialog and to display the Select Library Location... dialog, from where you can navigate to the file share location where you intend to post the asset collection.

  8. After you specify a File name for the asset collection, click the Save button to exit the Select Library Location... dialog, at which time your asset collection is posted to the file share location.

    Note  Ensure that users have your file share location information and appropriate permissions to access the share or other location.

To import a Filter asset collection

  1. From the Start menu or taskbar of your computer, click the Microsoft Message Analyzer icon to start Message Analyzer.

  2. Click the Message Analyzer Home tab and then click the Library drop-down in the View Filter group on the Ribbon of the Home tab to expose the Filter Library items and management features.

  3. In the Library drop-down, click the Manage Filters menu item to open the Manage Filter dialog.

  4. In the Manage Filter dialog, click the Import button on the command bar to display the Select Library to Open... dialog, from where you can navigate to the file share that contains the shared asset collection.

  5. Select the *.asset file that corresponds to the target item collection and then click the Open button to exit the Select Library to Open dialog and to open the Select Items to Import dialog.

  6. In the Select Items to Import dialog, accept the default selection of the Use Existing Categories check box, or optionally deselect this check box and specify the Library category in which to place collection items by clicking the Add to Category drop-down and selecting a category from the menu that displays.

  7. In the Select Items to Import dialog, select the items and/or categories that contain the items you want to import.

  8. Click OK to exit the Select Items to Import dialog and populate your Filter Expression Library with the items you selected.

Manually Configure Item Update Synchronization on a User Feed

This example describes the process that you must follow to manually synchronize an item collection for updates on a user-configured feed that points to a file share or other location where the collection is posted.

To perform manual asset update synchronization

  1. From the Start menu or taskbar of your computer, click the Microsoft Message Analyzer icon to start Message Analyzer.

  2. From the Start Page, click the Settings tab to display the list of Subscribed Feeds.

  3. Click the link under the feed name containing the item collection that you want to update, to display the *.asset and *.metadata files for the collection that exists at the feed location.

  4. For the item collection you intend to update, right-click the *.metadata file and select the Open With context menu item so that you can specify an XML editor or the Visual Studio application to open the file.

  5. In the opened metadata file, copy the GUID in the <UniqueId> or <GroupId> tag and store it in a temporary location.

  6. Close the file and exit the editor application.

  7. In the Message Analyzer UI, locate the Library that contains the items you want to share with other users on your feed, click the Library drop-down, and select Manage<Item> from the menu that displays.

  8. In the Manage<Item> dialog, select the items you want to include in the update and then click Export to display the Save Library dialog.

  9. In the Save Library dialog, specify values for Title and Author, and optionally provide a Description and Organization information.

  10. Click Save to exit the Save Library dialog and to display the Select Library Location... dialog, from where you can navigate to the feed location. Note that you will be overwriting an existing collection when you click Save.

  11. Enter the item collection Title that you specified in the Save Library dialog as the File name for the collection in the Select Library Location... dialog.

  12. Click Save to exit the Select Library Location... dialog.

  13. Click Close to exit the Manage<Item> dialog.

  14. On the Settings tab of the Start Page, click the link beneath the feed name that will contain your updated item collection.

  15. Right-click the *.metadata file and *.asset file for the update collection, and then do the following:

    • Select the Open command to open the files.

    • Paste the GUID that you obtained from step 5 into the <UniqueId/> and <GroupId/> tags in each file.

    • Incrementally increase the <Revision/> tag value in each file with a new matched value to indicate that a revision is available to users.

    • Save the changes and close each file.

  16. Inform users that you have an update that they can download if they are subscribed to your feed, which should appear on the Downloads tab of the user’s Start Page.

Users should then be able to use the download or auto-sync option in the Item Download Options dialog, as described in Auto-Syncing Item Collections, to update their local Library with the latest version of your item collection. After users update a Library, the items should appear in the Library under a category name that matches the feed name.

Create and Edit a Chart Data Viewer

This example demonstrates how to create a new Chart viewer that is named “HTTP Content Types”, which provides a Bar Chart visualizer component that shows the relative volume distributions of the content types for HTTP messages captured in a trace.

To create and edit a Chart viewer

  1. From the Start menu or taskbar of your computer, click the Microsoft Message Analyzer icon to start Message Analyzer.

  2. In the Quick Trace area of the Start Page, click the Web Proxy Trace Scenario and then navigate to one or more web sites to generate browser traffic and capture HTTP messages.

    Message Analyzer begins to collect HTTP messages in the Analysis Grid viewer.

  3. At a suitable point, stop the trace by clicking the Stop button in the Session group on the Ribbon of the Message Analyzer Home tab.

  4. Click the Message Analyzer Charts tab to display the Chart controls.

  5. Click the New Chart button to display the default Chart editing surface.

  6. In the Name property text box on the Chart Layout tab to the right of the Chart editing surface, enter the text “HTTP Content Types” to specify the name that will display for your new Chart viewer in the New Viewer menu in the Session group on the Message Analyzer Home tab.

  7. In the Component Common section of the Component Layout tab to the right of the Chart editing surface, specify a title for your Chart viewer in the Name text box.

  8. In the Component Common section of the Component Layout tab to the right of the Chart editing surface, click the Type drop-down and select the Bar Chart visualizer component from the menu that displays.

  9. On the Data tab to the right of the Chart editing surface, click the ellipsis () to the right of the Column Fields property to display the Data Mapping Field Collection Editor dialog.

  10. In the Data Mapping Field Collection Editor dialog, click the Add drop-down and select the Formula menu item.

    A new Formula item appears in the Members pane.

  11. In the Formula properties pane of the Data Mapping Field Collection Editor dialog, click the ellipsis () to the right of the Arguments property to display the Argument Collection Editor.

  12. In the Argument Collection Editor, click the Add button to add an Argument item to the Members pane.

  13. In the Argument properties pane of the Argument Collection Editor, click the FieldName ellipsis () to display the Field Chooser dialog.

  14. In the Field Chooser dialog, scroll down to the HTTP node, expand it, and select the HTTP.Operation.ContentType field.

  15. In the Field Chooser dialog, click the Select button to exit the dialog.

    The ContentType field displays in the Arguments list of the Data Mapping Field Collection Editor.

  16. Click the FormulaType drop-down in the Formula properties pane of the Data Mapping Field Collection Editor and select the Count menu item.

  17. Click OK to exit the Data Mapping Field Collection Editor.

  18. On the Data tab, click the Row Fields ellipsis () to display the Data Mapping Field Collection Editor again, click the Add button drop-down, and select the Entity menu item.

    A new Entity displays in the Members pane of the editor.

  19. In the Entity properties pane, click the Name ellipsis () to display the Field Chooser dialog.

  20. In the Field Chooser dialog, scroll down to the HTTP node, expand it, and select the HTTP.Operation.ContentType field.

  21. In the Field Chooser dialog, click the Select button to exit the dialog.

    The ContentType field displays as the Name property in the ContentType properties pane of the Data Mapping Field Collection Editor.

  22. Click OK to exit the Data Mapping Field Collection Editor.

    Your new HTTP Content Types Chart displays each different HTTP content type as a separate bar in the Bar Chart visualizer component, with each bar representing the count of HTTP messages that carried the indicated ContentType payload, for example, image/gif, text/html, image/jpeg, and so on.

    To view the messages that correspond with the different content types, double-click any bar and the messages display in a separate Analysis Grid viewer tab.

  23. Optionally add other visualizer components or save your existing Chart configuration by clicking the Save Chart button in the Composite Chart group on the Ribbon of the Message Analyzer Chart tab.

    Your new Chart appears in the New Viewer drop-down in the Session group on the Message Analyzer Home tab and in the Session Explorer context menu. It also appears in the Manage Charts dialog that displays when you click the Manage Chart button in the Composite Chart group on the Charts Ribbon.

  24. To edit your new Chart at any time, select it from the New Viewer drop-down against a set of trace results, click the Charts tab, and then click the Edit Chart button in the Composite Chart group on the Charts Ribbon.

    Your Chart enters the edit mode and the data entry tabs appear to the right of the Chart editing surface. From here, you can click the Add Component, Remove Component, and New Data Mapping buttons to display the dialogs that enable you to modify your Chart. You can also modify settings directly from the data entry tabs.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft