Running the Data Analysis sample

Learn how to run the Data Analysis sample. For more information about this sample, see Read about the sample.

If you encounter any problems when you run the sample, see Resolving problems when running samples in the IBM Integration Bus documentation.

Complete the following tasks to run the Data Analysis sample:

  1. Import the Data Analysis sample. The Data Analysis perspective and the pre-defined Data Analysis Project Overview window open.
  2. Use the Data Analysis Project Overview to complete the steps of the Data Analysis workflow. The Analyze Documents task is already completed for you.
  3. Alternatively, start from the beginning of the process:
    1. Select File > New > Data Analysis Project to open the New Data Analysis Project wizard.
    2. In the Data Analysis Profile field, select Book Series and click Finish. Your Data Analysis project is created.
    3. Click Analyze documents in the Data Analysis Project Overview. Your sample XML documents are analyzed and relevant structures are saved in the Data Analysis Model.
  4. Use the Data Analysis views to explore your data:
    1. Expand the Data Analysis Model tree to view elements from your sample XML files. In the Book Series sample, the elements Media and Section are marked as revealed elements by the Data Analysis Profile. Glossary lookup files are provided to make interpreting element names easier.
    2. Use the Data Filter view to see a summary of all the elements and revealed elements from your sample documents.
    3. Select an element in the Data view to show where it is located in the Data Analysis Model. The Data Paths view shows this location.
    4. Use the Sample Documents view to locate data in your example XML instance data. Click the Data Analysis Model or Data Paths view to activate the Sample Documents view.
    5. Highlight and view properties of elements in the Data Analysis Model view for more in-depth analysis.
  5. Create your Target Model:
    1. Click Create a new target model in the Data Analysis Project Overview. The New Target Model wizard opens.
    2. Take the steps in the New Target Model wizard and click Finish. The Target Model editor opens.
    3. Populate your target model so that it represents the structure that you want to transform your input XML instance document into.
      1. You can drag elements from the Data Analysis Model, Data Filters and Data Paths views.
      2. In the Target Model editor, remove unwanted elements and attributes from your target model.
  6. Generate your Data Analysis tools:
    1. In the Target Model editor, click Generate to open the Generate Data Analysis Tool wizard.
    2. Complete the steps in the Generate Data Analysis Tool wizard and click Finish.
  7. View a sample flow that passes validation, and another sample flow that fails:
    1. Open DataAnalysisSample_MainApplication > Flow Tests > DataAnalysis.mbtest.
    2. In the Events window, run the first flow. This flow passes validation.
    3. In the Events window, run the second flow. This flow fails validation.

Results:

You used the Data Analysis Toolkit sample to complete the steps through the Data Analysis workflow. You analyzed some sample XML documents, and created a target model of elements and attributes that interest you. You generated Data Analysis tools which you can use to transform incoming data. You can create several target models within a Data Analysis Project, and use each of these to create different Data Analysis tools for different purposes.

Back to sample home