LOGIN NAME:

PASSWORD:

:: Web Services :: XWebSurvey ::
:: Documentation (Version 1) ::

LoadSurveys SOAP Method

DESCRIPTION:

Returns all Surveys (Polls), in the reverse chronological order the records were entered into the system.

PARAMETER(S):

None.

SOAP HEADERS:

LoginName - String. The "Login Name" you chose during the registration process.
Password - String. Your account's "Password".

NOTE***: SOAP Headers are required for authentication.

RETURNS:

XML String , representing all Survey records in an account. To view the validating XSD Schema, please click here (opens in a new window). An example is provided here (opens in a new window) or below:

If the account does not contain any records, the <Surveys> root node will not contain any child elements. An example is provided below:

<Surveys />

All non-XML strings returned by this SOAP method should be considered errors.

<Surveys>
 <Survey Survey_ID="7" Date_Created="2005-09-12T15:29:00">
  <Name>Demo Survey</Name>
  <Description>Our demo survey's Description
	would go here.</Description>
  <Total_Votes>10</Total_Votes>
  <Options>
   <Option Option_Sequence="1">
    <Name>First Option</Name>
    <Votes>6</Votes>
    <Percentage>60</Percentage>
   </Option>
   <Option Option_Sequence="2">
    <Name>Second Option</Name>
    <Votes>4</Votes>
    <Percentage>40</Percentage>
   </Option>
  </Options>
 </Survey>
 <Survey Survey_ID="4" Date_Created="2005-09-12T15:29:00">
  <Name>Name of Survey 2</Name>
  <Description>Description of Survey 2</Description>
  <Total_Votes>0</Total_Votes>
  <Options />
   </Survey>
   ...
<Surveys>

ERROR(S):

If the system encounters an error, the method will return one the following messages instead of the expected XML string:

Error: Unable to authenticate. Your username and/or password are invalid. - authentication errors.
Error: You have not yet registered for this service. - authorization errors.
Error: A database error has occurred. Please try again later. - catastrophic database errors.
Error: System error. Unable to process the request. - catastrophic system errors.

ADDITIONAL SUPPORT RESOURCES:

• Frequently Asked Questions specific to this web service
• Developer community supported Online Forum
• "How-to" Implementation Guides