<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY metainfo SYSTEM "metainfo.sgm">
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY Dash "&ndash;">
]>
<?Pub UDT _bookmark _target>
<?Pub Inc>
<refentry id="create-transformation-rule-1">
<refmeta><refentrytitle>create-transformation-rule</refentrytitle><manvolnum>
1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="create-transformation-rule">create-transformation-rule &mdash;
creates transformation rule for a deployed web service. </primary></indexterm>
<indexterm><primary sortas="creates transformation rule for a deployed webservice">
creates transformation rule for a deployed web service &mdash;create transformation-rule
</primary></indexterm><refname>create-transformation-rule</refname><refpurpose>
creates transformation rule for a deployed web service</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>create-transformation-rule</command><arg choice="plain">
 webservicename <replaceable>webservice_name </replaceable> </arg><arg choice="plain">
rulefilelocation <replaceable>rulefile_location </replaceable></arg>&synopsis-common;
<arg> enabled<option role="nodash">=true</option></arg><arg> applyto<option
role="nodash">=request </option></arg><arg choice="plain"><replaceable>transformation-rule-name
</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>Creates an XSLT transformation rule that can be applied to a webservice
operation. The rule can be applied either to a request or to a response. 
</para>
</refsect1>
<refsect1><title>OPTIONS</title>
<variablelist termlength="medium">
<varlistentry><term><option role="nodash">&Dash;&Dash;webservicename</option></term>
<listitem><para>name of the deployed web service for which you are creating
a transformation rule</para>
</listitem></varlistentry>
<varlistentry><term><option>rulefilelocation</option></term><listitem><para>
location of the file to do the transformation. Only XSLT files are allowed.
Default location is <replaceable>instance_dir</replaceable><filename>/generated/xml/
</filename><replaceable>application_name or module_name</replaceable>/<replaceable>
XSLTfilename</replaceable></para>
</listitem></varlistentry>&options-common;
<?Pub Caret>
<varlistentry><term><option role="nodash">&Dash;&Dash;enabled</option></term>
<listitem><para>if set to true, enables the web service endpoint.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;operationname</option></term>
<listitem><para>name of the web service operation</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;applyto</option></term>
<listitem><para>the kind of operation to which the transformation tule has
to be applied. Allowed values are:<itemizedlist>
<listitem><para><literal>request</literal>, applied to a SOAP request. This
is the default. </para>
</listitem>
<listitem><para><literal>response</literal>, applied to a web service response.
</para>
</listitem>
<listitem><para><literal>both</literal>, applied to all methods in the web
service endpoint.</para>
</listitem>
</itemizedlist></para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>OPERANDS</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>transformation-rule-name</replaceable></term>
<listitem><para>name of the transformation rule being created. </para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>To create a transformation rule that applies to both request and response
operations</title>
<screen><userinput>create-transformation-rule --webservicename jaxrpc-simple#jaxrpc-simple.war#HelloIF 
--enabled=true --applyto=both --rulefilelocation opt/SUNWappserver/generated/xml/res.xslt 
ChangeResponse_Rule</userinput>
Command create-transformation-rule executed successfully</screen>
<para>where, <filename>res.xslt</filename> is the file name that stores the
transformation rule.</para>
<para>and,<filename>jaxrpc-simple#jaxrpc-simple.war#HelloIF</filename> is
the fully qualified name of a web service endpoint.</para>
</example>
</refsect1>
<refsect1><title>EXIT STATUS</title>
<variablelist termlength="medium">
<varlistentry><term>0</term><listitem><para>command executed successfully
</para>
</listitem></varlistentry>
<varlistentry><term>1</term><listitem><para>error in executing the command
</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&also-tt;</title>
<para><link linkend="delete-transformation-rule-1"><citerefentry><refentrytitle>
delete-transformation-rule</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link
linkend="list-transformation-rules-1"><citerefentry><refentrytitle>list-transformation-rules
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000005229>
