This documentation supports the 9.0 version of Remedy Action Request System.

To view the latest version, select the version from the Product version menu.

AR System and web services introduction

Web services enable BMC Remedy AR System functionality to be available over the web (publishing), and enable BMC Remedy AR System applications to access third-party applications. For both publishing and consuming web services, you establish a base form to which the information is set, or through which the information is pushed to other forms or applications. You must map the BMC Remedy AR System fields on a base form to input or output parameters of a web services operation. A field can participate as an input parameter, an output parameter, or both. You can map BMC Remedy AR System fields to a simple flat document or to a complex hierarchical document involving parent and child relationships.

Consuming a web service

You can use an external web service by creating a Web Service Set Fields filter action to enter data from the web service into a base form. You can then view the form in an BMC Remedy AR System client. For more information, Publishing the BMC Remedy AR System functionality as a web service.

In BMC Remedy Developer Studio, you can use the web services graphical user interface to create and modify a web service. Publishing web services makes BMC Remedy AR System operations available over the Internet or an intranet.

Note

The Web services do not support all the Unicode characters that are not supported in Apache Xerces.

Creating and publishing a web service

Each web service consists of the following resources:

  • A base form on which it operates. You specify this form when you create the web service. For web services that span across multiple BMC Remedy AR System forms, the base form is the master form.
  • A list of Create, Get, or Set operations. When you create a web service, by default, it has these named operations: OpCreate, OpGet, OpList, and OpSet. You can have multiple operations of the same type, or you can have no operations of a particular type.
  • A mapping that specifies how individual elements of incoming and outgoing XML documents are mapped to fields and forms of the BMC Remedy AR System. These are essentially the input and output parameters of the web service.
  • An association with XML Schema (.xsd file). Global elements and complex types referred to in the schema can be used in mappings associated with operations.

To enable logging for web services

  1. Open the <ARInstallationFolder>\conf\logback_server.xml file for editing.
  2. Update the file with the following lines:

    <logger name="com.bmc.arsys.ws.client.WebServiceSoapClientImpl"   
                   level="debug" additivity="false">
                   <appender-ref ref="ServerLog" />
    </logger>

    Note

    If you have provided the appender-ref as ServerLog, the logs for web services will be generated in arerror.log file.

  3. Restart the AR System server.

    Note

    Enable the Reload Log Conf File option to reload the config changes made to the logback_server.xml files without restarting the AR System server. For more information, see Setting log files options.

Was this page helpful? Yes No Submitting... Thank you

Comments