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.

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.

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.

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>
3. Restart the AR System server.

To create a separate log file for web services

1. Create new appender in the logback_server.xml file. You can locate the logback_server.xml file from the location below:
   <install-location>/conf

2. Locate and copy the existing appender "ServerLog". Paste the existing appender "ServerLog" after the last appender.
   Refer to the following example for a new appender entry:

   <appender
   name="webservicelog"
   class="com.bmc.arsys.logging.ReconfigurableRollingFileAppender">     
   <file>${com.bmc.arsys.homedir}/${com.bmc.arsys.server.dbdir}/arwebsvc.log</file>     
   <append>true</append>     
   <enableThreadLogging>true</enableThreadLogging>     
   <!-- <param name="Encoding" value="UTF-8" />    
   <rollingPolicy class="com.bmc.arsys.logging.StoredRollingPolicy">        
   <fileNamePattern>${com.bmc.arsys.homedir}/${com.bmc.arsys.server.dbdir}/arwebsvc${threadId}.log.%i</fileNamePattern>  
         <minIndex>1</minIndex>        
   <maxIndex>8</maxIndex>     
   </rollingPolicy>     
   <triggeringPolicy
   class="com.bmc.arsys.logging.ARSizeBasedTriggeringPolicy">        
   <maxFileSize>128MB</maxFileSize>     
   </triggeringPolicy>     
   <encoder>    
       <charset>UTF-8</charset>        
   <pattern>%m%n</pattern>     
   </encoder>
   </appender>
   
3. Change the appender name ,file name only  from the <file> tag and the <fileNamePattern> tag. Enter rest of the information as it is. 

4. Create the logger using the created appender name in the logback_server.xml file. Create the logger after the last logger in file.
   Refer to the following example for a new logger entry:

   <logger name="com.bmc.arsys.ws.client.WebServiceSoapClientImpl"   
                 level="debug" additivity="false">
                 <appender-ref ref="webservicelog" />
   </logger>
5. Save the logback_server.xml file.
6.  Restart AR System server.
7. Open the file location mentioned in logback_server.xml file and verify that the newly created file is present.