\\
In this part of the documentation, we will see how to create or import services into Petals Master's registry, how to search services, add organization's and person's roles on services and endpoints .

!createService.png|thumbnail!

Just specify the service name and optionaly a service description. Then click "Submit". You will be redirected to the page where you could edit this new service information (see section 6.3 View services information).

You have two tabs:

The first tab "WSDL URL Import" :
\\
\\ !importServiceURL.png|thumbnail!\\

You have only to copy/paste the URL of the service's WSDL into the field, then validate. You could also specify a name for the registered wsdl file. It will be used as file name when you will download it.

!importServiceUrlExample.png|thumbnail!\\



The second tab "WSDL File Import" :

!importServiceFile.png|thumbnail!\\

Here, browse your files and choose the service's WSDL. You could also specify a name for the registered wsdl file. It will be used as file name when you will download it.
\\
You will be forwarded to a new screen, displaying the service(s) described by the uploaded WSDL and then registered into Petals Master.

!viewNewServiceImported.png|thumbnail!
 
\\
To display service's information (like the roles of the actors (provider, consumer, developer, user, etc.), categorization, brief description of the aim of the service, etc.), click on the service's name : you will arrive on the _View/Edit_ _form_ of the service.
\\

{warning}{color:#cc0000}{*}Caution{*}{color}\\
UI import functionalities allows import of WSDL with absolute imports or without imports. Only Petals Master

!viewService.png|thumbnail!

In this tab you could also manage service related WSDLs (automatically linked when you create a service from a wsdl import or added after service manual creation). If you want to see a WSDL click on the links of the download column. You could also delete them by clicking on the delete button. Deleted WSDL will only be unlinked from the service (if not linked to other services or endpoints, it is totally removed from the registry). If you want to add a new WSDL description to the current service, just click on the Add button of the Service Specification table, a new page appears.
You could add it from an URL...

!addWsdl2ServiceURL.png|thumbnail!

...or from a file

!addWsdl2ServiceFile.png|thumbnail!

The "Store described entities" checkbox allow you to specify if you want to register entities described by the WSDL file (services, endpoints...) into the Petals Master DB in addition to adding the WSDL to the service WSDL list.

!viewServiceEndpoint.png|thumbnail!

You could delete services from the registry by clicking the corresponding "Delete" link in the "Delete" column.

You could to add a new endpoint to the current service : just click on the "Add" button of the Endpoints table, a new page appears.

!createEndpoint.png|thumbnail!

You must specify a name and you could specify a network address for this endpoint. Once created, the endpoint is added to the current service endpoint list.


Like for services, view information about endpoints is possible. You just have to click on the endpoint's name and its information will be displayed. We will detail it later (see {color:#003f80}Section 6.4, "View service's endpoints"{color}).

!viewServiceOrganization.png|thumbnail!\\

To add an organization's role, it is very simple. Click on the 'Create organization's role' button, then fill in the form :
choose an organization, then choose a role and validate.
\\

\\ !addServiceOrganization.png|thumbnail!\\

Then, the organization's role appears into the array :

!viewServiceOrganizationExample.png|thumbnail!

\\
You can filter the array data by role. E.g. select the _user_ role into the list :
\\
\\
and you obtain :

!viewServicePerson.png|thumbnail!\\
To add a person's role, it is very simple. Click on the 'Create person's role' button, then fill in the form : choose an organization, choose a person, then choose a role and validate.

!addEndpointPerson.png|thumbnail!\\
Then, the person's role appears into the array :

!viewServicePersonExample.png|thumbnail!\\

You can filter the array data by role. E.g. select the _user_ role into the list :
\\
\\
and you obtain :
\\
\\ !viewServicePersonFilter.png|thumbnail!\\

!viewServiceRelatedDocs.png|thumbnail!\\

browse your files and choose your document.

To view and edit information about an endpoint (like the roles of the actors (provider, consumer, developer, user, etc.)), click on the endpoint name (reachable via the 'Endpoints' tab of the Service View/Edit screen, as seen previously).

\\
\\ !viewEndpoint.png|thumbnail!

In this tab you could also manage endpoint related WSDLs (automatically linked when you create an endpoint from a wsdl import or added after endpoint manual creation). If you want to see a WSDL click on the links of the download column. You could also delete them by clicking on the delete button. Deleted WSDL will only be unlinked from the endpoint (if not linked to other services or endpoints, it is totally removed from the registry). If you want to add a new WSDL description to the current endpoint, just click on the Add button of the Service Specification table, a new page appears.
You could add it from an URL...

!addWsdl2EndpointURL.png|thumbnail!

...or from a file

!addWsdl2EndpointFile.png|thumbnail!

!viewEndpointCategories.png|thumbnail!\\
To add categories, click the button "add"

!addOrganizationCategory.png|thumbnail!

\\
You obtain :

\\

!viewEndpointOrganization.png|thumbnail!

\\
To add an organization's role, it is very simple. Click on the 'Create organization's role' button, then fill in the form :
choose an organization, then choose a role and validate.

!addEndpointOrganization.png|thumbnail!\\

Then, the organization's role appears into the array :

!viewEndpointOrganizationExample.png|thumbnail!

!viewEndpointPerson.png|thumbnail!


To add a person's role, it is very simple. Click on the 'Create person's role' button, then fill in the form : choose an organization, choose a person, then choose a role and validate.

\\ !addEndpointPerson.png|thumbnail!\\

Then, the person's role appears into the array :

!viewEndpointPersonExample.png|thumbnail!

The use of the services search engine is similar to the one for organizations and persons. Enter your keywords and select fields on which the engine will search.

!searchService.png|thumbnail!


!searchServiceSeeAll.png|thumbnail!

\\
To display the list of all Services in Petals Master database push the "See All" button. The results are displayed as following :
\\
\\
\\