Create a Producer definition
A Producer is a portal that provides WSRP services. Consumer portals can then consume these WSRP services as remote portlets. To enable this, you create and configure a Producer definition.
To work with the Web Service Configuration portlet, click Administration > Portlet Management > Web Services.
To consume remote portlets as Web services from a Producer, create a new Producer definition for this Producer. To do this...
- Click New Producer. Web Service Configuration displays the Create New Producer panel. Work with the fields and options as described in the following steps.
- Type a title for the new Producer in the Title field. This field is mandatary.
- Type a description for the new Producer in the Description field. This field is optional.
- Check if the default URL to WSDL service definitions shows the correct URL. If not, change it and type the URL under which the WSDL service definitions of the new Producer can be accessed. This field is mandatary. You get this information from the Producer.
For example, if the WSRP service Producer is an IBM WebSphere Portal, we can access the WSDL document of the Producer at the following URL: http://producer_portal_host:producer_port/wp_contextRoot/wsdl/wsrp_service.wsdl. Note that the host and port and the wp_contextRoot directory must match those of the Producer portal installation.
- Optional: We can specify user attributes to be passed on to this Producer:
- Click the link I want to specify the user attributes that should be passed to this Producer. The portal displays the panel for selecting user attributes.
- Select user attributes as required by clicking the appropriate check boxes.
- Click OK to save the selection or Cancel to return without saving. The portal returns to the panel for configuring the new Producer.
- Click Next . The portal shows the next panel. It shows the transport URLs and other security information for this Producer for the Markup, Registration, Management, and Service description ports:
- Whether this port supports HTTP.
- Whether this port supports HTTPS.
- Which transport protocol is currently selected.
- Which security profile is currently applied.
We can edit the configuration for the ports...
- Click the Edit icon for the port to modify. The portal displays the panel for configuring the port.
- Type HTTP or HTTPS URLs into the appropriate fields as required.
- Select one of the options for the transport protocol:
- HTTP
- HTTPS
- Dynamic. This option is only available for the Markup port, and only if the Producer has configured this port for both HTTP and HTTPS.
- Select a security profile as required from the pulldown list.
- Click OK to save the data or Cancel to return without saving. The portal returns to the panel for configuring the new Producer.
- Click Next to save the data and proceed creating the Producer, or click Cancel to return to the panethat shows the security information.
- Optional: This step applies only if the Producer supports registration. In this case the portal displays the panel for setting registration information. Set the registration information as required. Depending on whether to register with the Producer offline or online, select one of the following options:
- For offline registration enter the registration handle. You get the registration handle from the Producer. Only Consumers to whom the Producer gave a registration handle can consume the Web services on that Producer. To enter the handle:
- Select the option Enter a registration handle. The portal displays the panel for entering the registration handle.
- Type the registration handle into the input field.
- Click Next to save the data and proceed creating the Producer, or click Cancel to return to the panel for selecting the type of registration without saving.
- If the Producer supports registration properties, we can add them for online registration. These are properties that are passed on to the Producer during the registration. To add them:
- Select the option Enter registration properties. The portal displays the panel for setting registration properties.
- Type a new property and its value in the entry fields New parameter and New value.
- To add the new property, click the Add button.
- Edit or delete properties as required by clicking the Edit and Delete icons.
- Click Next to save the data and proceed creating the Producer, or click Cancel to return to the panel for selecting the type of registration without saving.
For more information about registration handles and properties refer to the section about WSRP in the portal information center.
- Depending on the previous steps and actions, we might have to click Next once more to save the new Producer definition or Cancel to return without saving. The portal returns to the Producer list. The newly created Producer has been added to the list.
You have created the new Producer in the portal, and we can now consume Web services from that Producer.
Use the Manage Web Modules portlet to consume Web services.
- Set registration properties for Web service Producers
On the Consumer portal we can create registration properties for a Web service Producer. These properties are passed on to the Producer during the registration.For example, they can provide information about the or your users' geographical location. The Producer can then adapt the Web service to the location. If many of the users live near the mountains, a travel agent Producer might then provide information or offers for hiking or ski vacation. Setting registration properties is optional and only for Producers that require registration by the Consumer.
- Set user attributes to be passed to a Web service Producer
We can set user attributes to be passed on to the Web service Producer. The values for the selected attributes are passed on to the Producer when the portal users use the Producer's Web service.For example, if we select the attribute for user name, the user's name is passed on to the Producer. As a result, the Producer's Web service can address the portal users by their name. Setting user attributes is optional.
Parent: Use the Web Service Configuration portlet to work with Producer definitions online