Show TOC Start of Content Area

Procedure documentation Publishing Web Services from the SAP NetWeaver Administrator  Locate the document in its SAP Library structure

Use

When you have configured Web services on the provider system, you can set some or all of these Web services to be published to the Services Registry (SR) so that other parties can discover them.

You specify the Web services you want to publish by grouping those Web services in a publication restriction. You do not explicitly publish Web services to the SR. The actual publication of Web services is performed by a background job which runs at a preset interval (every 5 minutes).

Publication Restrictions

A publication restriction is a placeholder containing the Web services which you want to publish. When you create a publication restriction, you can add or remove Web services from it.

Publication restrictions have two statuses: active and inactive. The system publishes only the Web services belonging to a publication restriction which is in status active. By default, when you create a publication restriction, it is in status active, and you can optionally deactivate it.

When a Web service is published, all service endpoints configured for this Web service are published to the SR.

The system synchronizes the published Web services’ current state on the provider system with the information published for these Web services on the SR. The configuration changes which you make to the published Web services are reflected in the information published in the SR the next time the background job runs.

The table below lists the possible changes you can make to a publication restriction or a published Web service and explains the system’s response.

User Action

System Response

You set the status of a publication restriction to Active.

The system publishes all Web services which are part of this publication restriction.

You set the status of a publication restriction to Inactive.

The system unpublishes information about the Web services which are part of the deactivated publication restriction

You create a service endpoint or change the settings of an existing endpoint of a Web service which was already published.

The system publishes information about the newly created service endpoint.

You delete a service endpoint of a Web service which was already published

The system unpublishes information about the deleted service endpoint.

You create a publication restriction which contains a Web service that has already been published as part of another publication restriction.

The system re-publishes the Web service.

You remove a published Web service from a publication restriction.

The system unpublishes the Web service you removed.

Prerequisites

A connection to the Services Registry is configured. More information: Configuring the Services Registry, Configuring a Central Services Registry.

Procedure

       1.      To start the SAP NetWeaver Administrator, in a Web browser, enter the following address:

http://<host>:<port>/nwa

       2.      Then choose SOA Management Business Administration Publication Restrictions.

The Publication Restrictions opens.

Alternatively, you can use the quick link /PublicationRestrictions as follows:

http://<host>:<port>/nwa/PublicationRestrictions.

Creating Publication Restrictions

...

       1.      Choose Create.

       2.      Enter a name and description of the publication restriction, and then choose Next.

       3.      Choose Add Service Definition.

       4.      On the Search tab, proceed as follows:

                            a.      Find the Web services you want to publish.

In the Value field, enter the name of the service definition, and then choose Go. You can use the wildcard search symbols (?) and (*).

The system lists all available service definitions which match your search criteria.

                            b.      From the search results, select the relevant service definitions.

To select multiple entries from the list, on your keyboard, press and hold the SHIFT or CTRL keys and then choose the relevant service definitions.

To select all entries in the table, choose This graphic is explained in the accompanying text, and then choose Select All.

                            c.      Choose Apply and then choose Finish.

The system adds the service definition and its service endpoints in the publication restriction.

       5.      The system creates the publication restriction with status Active.

The service endpoints of the service definitions in the publication restriction are published to the SR the next time the background job runs. The system publishes only service definitions which were not previously published as part of another publication restriction on the Services Registry.

Editing Publication Restrictions

You can edit active and inactive publication restrictions. When you edit publication restrictions, their status remains unaffected.

...

       1.      From the Publication Restrictions List, choose a publication restriction.

The Scenario Details area opens and displays all the Web services in the publication restriction.

       2.      Choose Edit.

Note

If you want to publish all available Web services to the SR, choose Mark all services as publication relevant. All Web services, whether they are added to a publication restriction or not, are published to the SR.

       3.      In the Scenario Details proceed as follows:

       Remove Web services

Choose the service definition, and then choose Remove Service Definition.

Note

To select multiple entries from the list, on your keyboard, press and hold the SHIFT or CTRL keys and then choose the relevant service definitions.

To select all entries in the table, choose  This graphic is explained in the accompanying text , and then choose Select All.

       Add Web Services

                                                  i.       Choose Add Service Definition.

The Search tab opens.

                                                ii.       In the Value field, enter the name of the service definition, and then choose Go. You can use the wildcard search symbols (?) and (*).

The system lists all available service definitions which match your search criteria.

                                               iii.       From the search results, select the relevant service definitions. You can select multiple entries from the list.

                                               iv.       Choose Apply.

The system adds the service definitions you selected to the entries in the publication restriction.

       4.      To save your changes, choose Save.

Deactivating Publication Restrictions

...

       1.      From the list of publication restrictions, choose an entry, and then choose Deactivate.

The next time the background job runs, the system unpublishes the service definitions listed in the publication restriction. If a service definition is listed in another publication restriction which is active, the system does not unpublish this service definition.

Activating Publication Restrictions

...

       1.      From the list of publication restrictions, choose an entry, and then choose Activate.

At the next scheduled task, the system publishes the service definitions listed in the publication restriction. If a service definition was previously published to the Services Registry as part of another publication restriction, the system does not publish it a second time.

 

 

End of Content Area