The following SOAP methods are provided specifically for the configuration and evaluation of profile pools.
getAttributes
Read attributes of a pool
EvalanchePoolAttribute[] getAttributes ( int pool_id )
Details
Parameters
- int pool_id: ID of the pool
Return value
- EvalanchePoolAttributes[]: List of objects with the following attributes:
- int id: ID of the attribute option
- string value: Display name of the attribute option
- int type_id: ID of the type of the attribute. The following values are possible:
- 1: SALUTATIONs
- 2: COUNTRY
- 3: STATE
- 4: MOBILENETWORK
- 5: INPUT (single-line input)
- 6: MULTILINEINPUT (multi-line input)
- 7: SELECTION (single selection)
- 8: MULTIPLESELECTION (multiple selection)
- 9: DATE (Date)
- 10: EMAIL
- 11: DATETIME (date with time)
- 12: LANGUAGE (language)
- 13: ???
- 14: DATETIMERO (date with time, read only)
- 15: PERMISSION
- 16: BOOLEAN (True/False)
- 17: HARDBOUNCES
- 18: USERSTATE (user status, deprecated)
- 19: FORM (original form)
- 20: INT (integer)
- 21: ZIPCODE (postal code)
- int id: ID of the attribute
- string name: Internal name of the attribute
- string label: Display name of the attribute
- bool has_options: true, if this attribute allows options
- bool can_add_options: true, if options may be added to this attribute
- EvalanchePoolAttributeOption[] options: List of objects with the following attributes:
Required rights
Show pool
Use
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pool="https://scnem.com/soap.php/soap/pool">
<soapenv:Header/>
<soapenv:Body>
<pool:getAttributes>
<pool_id>POOL_ID</pool_id>
</pool:getAttributes>
</soapenv:Body>
</soapenv:Envelope><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://scnem.com/soap.php/soap/pool">
<SOAP-ENV:Body>
<ns1:getAttributesResponse>
<getAttributesResult>
<item>
<id>ATTRIBUTE_ID</id>
<name>ATTRIBUTE_NAME</name>
<label>ATTRIBUTE_LABEL</label>
<has_options>true/false</has_options>
<can_add_options>true/false</can_add_options>
<options>
<item>
<id>ATTRIBUTE_OPTION_ID</id>
<value>ATTRIBUTE_OPTION_VALUE</value>
</item>
[...]
</options>
<type_id>ATTRIBUTE_TYPE_ID</type_id>
</item>
[...]
</getAttributesResult>
</ns1:getAttributesResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
addAttributes
Creating an attribute
EvalanchePoolAttribute addAttribute ( int pool_id, string name, string label, int type_id )
Details
Parameters
- int pool_id: ID of the pool
- string name: Internal name of the attribute (capital letters and numbers only, first character must be an uppercase letter)
- string label: Display name of the attribute
- int type_id: Type ID of the field, see return value under Reading the attributes of a pool
Return value
- EvalanchePoolAttributes: An object of the type EvalanchePoolAttribute analogous to the return value of the methods getAttributes
Required rights
Change pool
Use
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pool="https://scnem.com/soap.php/soap/pool">
<soapenv:Header/>
<soapenv:Body>
<pool:addAttribute>
<pool_id>POOL_ID</pool_id>
<name>ATTRIBUTE_NAME</name>
<label>ATTRIBUTE_LABEL</label>
<type_id>ATTRIBUTE_TYPE_ID</type_id>
</pool:addAttribute>
</soapenv:Body>
</soapenv:Envelope></soapenv:Envelope><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://scnem.com/soap.php/soap/pool">
<SOAP-ENV:Body>
<ns1:addAttributeResponse>
<addAttributeResult>
<id>ATTRIBUTE_ID</id>
<name>ATTRIBUTE_NAME</name>
<label>ATTRIBUTE_LABEL</label>
<has_options>true/false</has_options>
<can_add_options>true/false</can_add_options>
<options/>
<type_id>ATTRIBUTE_TYPE_ID</type_id>
</addAttributeResult>
</ns1:addAttributeResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
addAttributeOptions
Create attribute options
EvalanchePoolAttribute addAttributeOptions ( int pool_id, int attribute_id, string[] labels )
Details
Parameters
- int pool_id: ID of the pool
- int attribute_id: ID of the attribute
- string[] labels: List with the display names of the options to be created
Return value
- EvalanchePoolAttributes: An object of the type EvalanchePoolAttribute analogous to the return value of the methods getAttributes
Required rights
none
Use
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pool="https://scnem.com/soap.php/soap/pool">
<soapenv:Header/>
<soapenv:Body>
<pool:addAttributeOptions>
<pool_id>POOL_ID</pool_id>
<attribute_id>ATTRIBUTE_ID</attribute_id>
<labels>
<!--Zero or more repetitions:-->
<item>ATTRIBUTE_OPTION_LABEL</item>
</labels>
</pool:addAttributeOptions>
</soapenv:Body>
</soapenv:Envelope></soapenv:Envelope><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://scnem.com/soap.php/soap/pool">
<SOAP-ENV:Body>
<ns1:addAttributeOptionsResponse>
<addAttributeOptionsResult>
<id>ATTRIBUTE_ID</id>
<name>ATTRIBUTE_NAME</name>
<label>ATTRIBUTE_LABEL</label>
<has_options>true/false</has_options>
<can_add_options>true/false</can_add_options>
<options>
<item>
<id>ATTRIBUTE_OPTION_ID</id>
<value>ATTRIBUTE_OPTION_VALUE</value>
</item>
[...]
</options>
<type_id>ATTRIBUTE_TYPE_ID</type_id>
</addAttributeOptionsResult>
</ns1:addAttributeOptionsResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
deleteAttributeOption
Delete attribute options
EvalanchePoolAttribute deleteAttributeOption ( int pool_id, int attribute_id, int option_id )
Details
Parameters
- int pool_id: ID of the pool
- int attribute_id: ID of the attribute
- int option_id: ID of the option to be deleted
Return value
- EvalanchePoolAttributes: An object of the type EvalanchePoolAttribute analogous to the return value of the methods getAttributes
Required rights
none
Use
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pool="https://scnem.com/soap.php/soap/pool">
<soapenv:Header/>
<soapenv:Body>
<pool:deleteAttributeOption>
<pool_id>POOL_ID</pool_id>
<attribute_id>ATTRIBUTE_ID</attribute_id>
<option_id>ATTRIBUTE_OPTION_ID</option_id>
</pool:deleteAttributeOption>
</soapenv:Body>
</soapenv:Envelope><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://scnem.com/soap.php/soap/pool">
<SOAP-ENV:Body>
<ns1:deleteAttributeOptionResponse>
<deleteAttributeOptionResult>
<id>ATTRIBUTE_ID</id>
<name>ATTRIBUTE_NAME</name>
<label>ATTRIBUTE_LABEL</label>
<has_options>true/false</has_options>
<can_add_options>true/false</can_add_options>
<options>
<item>
<id>ATTRIBUTE_OPTION_ID</id>
<value>ATTRIBUTE_OPTION_VALUE</value>
</item>
[...]
</options>
<type_id>ATTRIBUTE_TYPE_ID</type_id>
</deleteAttributeOptionResult>
</ns1:deleteAttributeOptionResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
updateAttributeOption
Update Attribute Options
EvalanchePoolAttribute updateAttributeOption ( int pool_id, int attribute_id, int option_id, string label )
Details
Parameters
- int pool_id: ID of the pool
- int attribute_id: ID of the attribute
- int option_id: ID of the option
- string label: New display name for the option
Return value
- EvalanchePoolAttributes: An object of the type EvalanchePoolAttribute analogous to the return value of the methods getAttributes
Required rights
none
Use
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pool="https://scnem.com/soap.php/soap/pool">
<soapenv:Header/>
<soapenv:Body>
<pool:updateAttributeOption>
<pool_id>POOL_ID</pool_id>
<attribute_id>ATTRIBUTE_ID</attribute_id>
<option_id>ATTRIBUTE_OPTION_ID</option_id>
<label>ATTRIBUTE_OPTION_LABEL</label>
</pool:updateAttributeOption>
</soapenv:Body>
</soapenv:Envelope></soapenv:Envelope><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://scnem.com/soap.php/soap/pool">
<SOAP-ENV:Body>
<ns1:updateAttributeOptionResponse>
<updateAttributeOptionResult>
<id>ATTRIBUTE_ID</id>
<name>ATTRIBUTE_NAME</name>
<label>ATTRIBUTE_LABEL</label>
<has_options>true/false</has_options>
<can_add_options>true/false</can_add_options>
<options>
<item>
<id>ATTRIBUTE_OPTION_ID</id>
<value>ATTRIBUTE_OPTION_VALUE</value>
</item>
[...]
</options>
<type_id>ATTRIBUTE_OPTION_TYPE_ID</type_id>
</updateAttributeOptionResult>
</ns1:updateAttributeOptionResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope></SOAP-ENV:Envelope>