Instructions for running the custom plug-in sample

This topic describes the steps required to run the custom plug-in sample.

1. Load the custom sample plug-in JAR file.
   1. Download the SamplePlugins.jar file to your local file system.
   2. Open the WSRR web UI.
   3. Switch to the Configuration perspective if necessary, by selecting Configuration in the Perspective list.
   4. Click Active Profile > Plug-in JARs.
   5. Click Load JAR plug-in.
   6. Click Browse and navigate to the directory to which you downloaded the SamplePlugins.jar file.
   7. Select SamplePlugins.jar and click Open.
   8. Enter SamplePlugins for the Plug-in JAR configuration item name and click OK.
2. Add the sample validation plug-in to the validation plug-in properties file.
   1. Click Active Profile > Validators.
   2. Click the Validation properties plug-in item and select the Content tab.
   3. If the Validation properties plug-in file has an existing validators definition entry, beginning validators=, append the following to the end of that line:

      ,pluginsample.validator.StoreValidationDate

      Otherwise, insert the following line anywhere in the file:

      validators=pluginsample.validator.StoreValidationDate

   4. Click OK.
3. Add the sample modification plug-in to the modification plug-in properties file.
   1. Click Active Profile > Modifiers.
   2. Click the Modification properties plug-in item and select the Content tab.
   3. If the Modification properties plug-in file has an existing modifiers definition entry, beginning modifiers=, append the following to the end of that line:

      ,pluginsample.modifier.CreateBusinessObject

      Otherwise, insert the following line anywhere in the file:

      modifiers=pluginsample.modifier.CreateBusinessObject

   4. Click OK.
4. Add the sample notification plug-in to the notification plug-in properties file.
   1. Click Active Profile > Notifiers.
   2. Click the Notification properties plug-in item and select the Content tab.
   3. If the Notification properties plug-in file has an existing notifiers definition entry, beginning notifiers=, append the following to the end of that line:

      ,pluginsample.notifier.LogActivity

      Otherwise, insert the following line anywhere in the file:

      notifiers=pluginsample.notifier.LogActivity

   4. Click OK.
5. Run the custom plug-ins by loading a WSDL document.
   1. Download the MonolithicStockQuote_ProductionEnvironment.wsdl file to your local file system.
   2. In the WSRR web UI, switch to the Administrator perspective, by selecting Administrator in the Perspective list.
   3. Click Actions > Load Documents.
   4. Select WSDL for the document type.
   5. Click Browse and navigate to the directory to which you downloaded the MonolithicStockQuote_ProductionEnvironment.wsdl file.
   6. Select MonolithicStockQuote_ProductionEnvironment.wsdl and click Open.
   7. Click OK and then click Finish.
6. Verify that the validation plug-in ran successfully.
   1. Click View > Service Documents > WSDL Documents > MonolithicStockQuote_ProductionEnvironment.wsdl.
   2. Expand Additional Properties. If the validation plug-in ran successfully, you will see a property called Date_and_Time for which the value is the date and time at which you loaded the WSDL document.
7. Verify that the modification plug-in ran successfully.
   1. Click View > Concepts. If the modification plug-in ran successfully, you will see a concept object called MonolithicStockQuote_ProductionEnvironment.wsdl_BusinessObject. This object was created by the modification plug-in.
   2. Click MonolithicStockQuote_ProductionEnvironment.wsdl_BusinessObject to display the object details. Under Relationships, you will see a relationship called referencedWSDL whose target is the WSDL document. This relationship was created by the modification plug-in.
   3. Expand Additional Properties. You will see a property called Date_and_Time. This is because the validation plug-in ran again when the concept object was created.
8. Verify that the notification plug-in ran successfully. Note that you must have access to the WebSphere® Application Server administrative console to perform this step.
   1. Open the WebSphere Application Server administrative console for the server on which WSRR is deployed.
   2. Click Troubleshooting > Logs and Trace > server1 > JVM Logs > Runtime.
   3. Click View alongside the entry for SystemOut.log.
   4. Set the values in the Retrieve Lines field such that you display the last 200 lines of the log file.
   5. Scroll to the end of the file. If the notification plug-in ran successfully, you will see, near the end of the file, the following entry:

      SystemOut     O MonolithicStockQuote_ProductionEnvironment.wsdl
      was created successfully

      This line was written to the log by the notification plug-in. You will see a similar entry for MonolithicStockQuote_ProductionEnvironment.wsdl_BusinessObject, because the notification plug-in ran twice, once for each object.