To use the Repository Web Service wizard to create a repository Web service:
Open the ATG Dynamo Administration interface and navigate to the Web Service Administration > Web Service Creation Wizard > Repository Web Service page.
Identify the repository component that the Web service should access. You can do this in one of two ways. The Create Repository Web Service page displays a text field in which you can enter the Nucleus address of the repository component and click the Submit button. The Create Repository Web Service page also displays a list of all repository components that are registered in the
initialRepositoriesproperty of the/atg/registry/ContentRepositoriescomponent. You can select a repository component by clicking the link with the Nucleus address of the repository component.The next page, with the heading Select item descriptor, displays all of the item descriptors in the repository component you selected. Click the link for the item descriptor you want to expose in your Web service.
The next page, with the heading Select Method, displays the methods that are available for the item descriptor you selected. For example, if the item descriptor is mutable, the following methods are available:
add
remove
update
getThe Select Method page also allows you to create a Web service for a specific property. The page displays a list of links for each of the properties of the item descriptor you selected. Click one of these property names to create a Web service for an individual repository item property.
The property name link leads to a list of the Web service methods that are available for that repository item property, as well as notes about the Web service limitations, if any, related to the repository item property. See Repository Web Service Limitations for more information.
Click the name of the method you want to expose in your Web service.
In the EAR Name & Servlet Settings page, the Web Service Creation Wizard displays default names for the EAR file and servlet to be created. You can modify the default names. You can also, if you choose, enter a description for the servlet and a network hostname and port number for the Web service. If you leave the fields blank, the values are dynamically assigned at runtime from the URL used for the WSDL file request. You should generally leave these fields blank, unless you want to require the Web service to be accessed on a specific server and port.
Enter any settings you want to change and click the Next button.
In the Enterprise & Web Application Settings page, the Web Service Creation Wizard displays default names for the enterprise application and Web application to be created. You can modify the default names. You can also, if you choose, enter a description for the enterprise application and Web application.
Enter any settings you want to change and click the Next button.
The Session & Security Options page allows you to select one of the following three options for the Web service:
Provide neither a session nor security constraints.
Provide a session, but no security constraints.
Provide both a session and security constraints.
If you choose the last option, the wizard then prompts you to select a security configuration. See the Creating Custom Web Services chapter for information about security configurations for Web services.
The Create EAR File page displays the parameter values you have selected for your Web service. Review them, then click the Create EAR File button to create the Web service.
The Web service is created in an EAR file. You will find the EAR file in the
<ATG9dir>/homedirectory, with the name you selected in step 4.To use the new Web service, you need to deploy it. See Deploying Web Services in the Creating Web Services chapter.
