AddPropertySetRowForUser

# AddPropertySetRowForUser API

Adds one or more property set rows to the specified infoRouter user. Property sets are custom metadata schemas; each row contains field values for a given property set definition.

Endpoint¶

/srv.asmx/AddPropertySetRowForUser

Methods¶

• GET /srv.asmx/AddPropertySetRowForUser?authenticationTicket=...&userName=...&xmlpset=...
• POST /srv.asmx/AddPropertySetRowForUser (form data)
• SOAP Action: http://tempuri.org/AddPropertySetRowForUser

Parameters¶

xmlpset Format¶

The xmlpset parameter is an XML string. The root element contains one child element per property set; each property set element contains one child element per row to add.

<propertysets>
  <propertyset name="EmployeeInfo">
    <row RowNbr="0" Department="Finance" CostCenter="CC001" StartDate="2023-01-15" />
  </propertyset>
  <propertyset name="ContactInfo">
    <row RowNbr="0" PhoneNumber="+1-555-0100" OfficeLocation="Building A" />
  </propertyset>
</propertysets>

• The root element name (e.g., <propertysets>) can be anything.
• Each child element must have a name attribute matching an existing property set definition name.
• Each grandchild element represents one row to add. Set RowNbr="0" to add a new row.
• All other attributes on the row element are property set field names and their values.
• The pipe character | in field values is automatically escaped.

Response¶

Success Response¶

<response success="true" error="" />

Error Response (single error)¶

<response success="false" error="Error message" />

Error Response (multiple errors)¶

<response success="false" error="[log]">
  <logitem propertyset="PropertySetName" error="Error detail" />
</response>

Required Permissions¶

System administrator or a user with permission to manage the target user's property sets.

Example¶

GET Request¶

GET /srv.asmx/AddPropertySetRowForUser
  ?authenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301
  &userName=jdoe
  &xmlpset=%3Cpropertysets%3E%3Cpropertyset+name%3D%22EmployeeInfo%22%3E%3Crow+RowNbr%3D%220%22+Department%3D%22Finance%22+%2F%3E%3C%2Fpropertyset%3E%3C%2Fpropertysets%3E
HTTP/1.1

POST Request¶

POST /srv.asmx/AddPropertySetRowForUser HTTP/1.1
Content-Type: application/x-www-form-urlencoded

authenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301
&userName=jdoe
&xmlpset=<propertysets><propertyset name="EmployeeInfo"><row RowNbr="0" Department="Finance" CostCenter="CC001" /></propertyset></propertysets>

SOAP Request¶

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:tns="http://tempuri.org/">
  <soap:Body>
    <tns:AddPropertySetRowForUser>
      <tns:AuthenticationTicket>3f2504e0-4f89-11d3-9a0c-0305e82c3301</tns:AuthenticationTicket>
      <tns:UserName>jdoe</tns:UserName>
      <tns:XmlPset>&lt;propertysets&gt;&lt;propertyset name="EmployeeInfo"&gt;&lt;row RowNbr="0" Department="Finance" /&gt;&lt;/propertyset&gt;&lt;/propertysets&gt;</tns:XmlPset>
    </tns:AddPropertySetRowForUser>
  </soap:Body>
</soap:Envelope>

Notes¶

• Use RowNbr="0" to add a new row. The system assigns the actual row number.
• Multiple property sets and multiple rows can be submitted in a single call.
• If one property set in the XML fails (e.g., not found), the error is logged and the call continues to process remaining property sets.
• To remove a row, use DeletePropertySetRowForUser.

Related APIs¶

• DeletePropertySetRowForUser - Delete a property set row from a user
• GetUser - Get user properties
• AddPropertySetRow - Add property set rows to a document or folder

Error Codes¶

For detailed documentation visit: https://support.inforouter.com/api-docs/AddPropertySetRowForUser