Show TOC

Procedure documentationRegistering Your Consumer Portal with WSRP Producers Locate this document in the navigation structure

 

Content usage mode: WSRP application sharing

Applies to: consumers

Note Note

The functionality described in this topic is not available in an SAP NetWeaver Composition Environment system.

End of the note.

You use the Producer Registration tool in the portal to do the following:

  • Register your portal as a consumer on any producer portal you have added.

  • Unregister your portal.

  • View the current registration status of your portal with your producers.

Registration is a mandatory step before being able to use content exposed by the producer. Registration with the Producer Registration tool is not the same as the formal WSRP-based registration that some non-SAP producer portals require. Nevertheless, when you register your portal with a consumer using this tool, formal WSRP-based registration is performed if the producer requires it.

Some producers may also require that you configure certain parameters as part of the registration process. The Producer Registration tool displays these parameters and allows you to define them before registration.

To redefine your consumer parameters relative to a specific producer portal, such as Your Consumer Name and Your Consumer URL, you need to first unregister. Note however that unregistering your portal has implications on content you have already generated from the producer portal you are registered with. For information, see "Result" below.

Note Note

End of the note.

Prerequisites

  • You have access to the federated portal administration tools in the standard System Admin role on your portal.

  • You have added the producer to your portal. More information: Creating WSRP Connections to Producers.

  • You have been assigned at least administrator read-write permission to the producer object.

    Note Note

    The producer may inherit the permission assigned to its parent folder in the Portal Catalog. For example, NetWeaver Content Producers or WSRP Content Producers.

    End of the note.

  • You have the registration password of the producer. A system administrator on the producer can set a password that must be entered on the consumer upon registration. More information: Setting a Registration Password.

Procedure

Launching the Producer Registration Tool

Do one of the following:

  • If you are currently editing the producer object in the Producer Editor or another secondary editor, choose Producer Registration in the object editor toolbar.

  • If the producer object is not in editing mode, do the following:

    1. In the consumer portal, navigate to   System Administration   Federated Portal   Myself as Content Consumer   Manage My Producers  .

    2. In the Portal Catalog, navigate to the producer object with which you want to register your portal.

    3. Right-click the producer object and choose   Open   Producer Registration   in the context menu. The Producer Registration tool is displayed, showing the current registration status.

Registering Your Consumer Portal

  1. In the Your Consumer Name box, enter the name of your portal is sent to the producer upon registration. NetWeaver producers see this name in their View My Consumers screen.

    Note Note

    To register with the producer portal, your consumer name must be a unique name on the producer. If the consumer name you entered is already in use by a different consumer portal registered with the producer, the registration fails and you will be requested to enter a different name.

    End of the note.

  2. In the Your Consumer URL field, enter your URL (<protocol>://<hostname>:<port>) to be used by a producer portal when channeling information back to your portal while fulfilling a runtime request. This parameter is useful for eliminating problems that may arise as a result of complex system networks, such as reverse proxies.

    Note Note

    If you enter an incorrect URL, registration with the producer will still succeed. You will receive an error at runtime when your portal attempts to retrieve and display remote content from the producer portal.

    End of the note.

    Note Note

    In the event you are using one or more reverse proxies in your landscape, note the following:

    • If a reverse proxy is located between the consumer and the producer, enter the protocol, host name, and port of the reverse proxy.

    • If there is no reverse proxy located between the consumer and the producer, enter the protocol, host name, and port of the consumer portal.

    • Additional configuration steps are needed when using a reverse proxy in a federated portal network landscape. More information: How to Set Up the Landscape for a Federated Portal Network guide, available on SAP Developer Network at   http://sdn.sap.com/irj/sdn/howtoguides   SAP NetWeaver 7.0   User Productivity Enablement   Running an Enterprise Portal  .

    End of the note.

  3. A producer may require that you provide additional information to register, such as a password. If so, the parameters are listed in the Registration Parameters table; enter any requested information in the table to continue.

    Note Note

    The default registration password for NetWeaver producers is: password

    End of the note.

  4. Choose Register.

Unregistering Your Consumer Portal

  1. Click Unregister.

  2. Accept the confirmation message that appears.

Result

Your registration status is displayed in a message on the screen. You can also view your status in the View My Producers screen. More information: Viewing Your WSRP Producers.

After Registration

When you have registered successfully with a NetWeaver producer, you are listed in the View My Consumers screen on the producer portal.

Note Note

When your consumer is registered on a producer, you can no longer change its properties, including the WSDL file path, in the Producer Editor. The editor opens in read-only mode; however, you can change permissions, test connections, and unregister. More information: Editing Properties of WSRP Producer Connections.

End of the note.

When you re-register an existing registration scope, the runtime functionality of any remote-based content generated beforehand on the consumer portal is restored.

After Unregistering

  • Upon unregistration, remote-based content generated in the same registration scope will no longer function at runtime.

    This includes roles consumed through remote role assignment, content consumed through the remote delta link mode, and proxy-to-portlet iViews generated through the WSRP application sharing mode will no longer function at runtime.

    Note Note

    • If you have registered yourself with multiple instances of the same producer portal, only content consumed through the portal instance you unregistered is affected.

    • You can restore the functionality of the content by re-registering your portal with the same registration scope.

    End of the note.

  • Personalization data set for content generated through remote role assignment and remote delta links is maintained. Personalization data for proxy-to-portlet iViews is permanently deleted.

  • The status of your consumer in the View My Consumers screen on the producer is updated. The status is updated only after the system administrator on the producer chooses Refresh in the View My Consumers screen or if the producer portal is restarted.

Reasons for not being able to register or unregister may be:

  • The WSDL service is not accessible (upon registration only) on the producer.

  • The portal server of the producer may be down.

  • There are problems with your network or that of the producer.

  • You entered an incorrect registration password.

  • You have not set up trust with the producer.