setClearPassword()

void setClearPassword(string usn, Credential credential)

This method changes the password for an account or subscription. If an account has multiple subscriptions that use the same password, you must change the password for each subscription individually.

You must specify the password in clear text. After you change the password, Smile encrypts the password and stores it in the database.

Parameters

usn: Format: string; Purpose: Specifies the USN of the account or subscription for which to change the password.
credential: Format: Credential XML; Purpose: Defines a Credential XML document that specifies the new password. The password cannot be encrypted.

Example: Change a password

This example changes the password to Pa55w0rd.

<Credential>
  <Type>password</Type>
  <Parameters>
    <Object>
      <String name="password">Pa55w0rd</String>
    </Object>
  </Parameters>
</Credential>

Results

This method does not return any output, and changes the password for the specified USN.

There are no messages defined by this method.

Faults

NoSuchItemException

This fault is returned when the specified USN does not exist.

Java client syntax

java -cp build/smilewsv2-client.jar [options] com.inomial.smile.client.v2.examples.SubscriptionChangePassword usn password

usn: Purpose: Specifies the USN of the account or subscription for which to change the password.
password: Purpose: Specifies the new password.

Note: For more information about the Java client and the options it accepts, see Java client syntax.