BCI API Support Reference (version 1.0)


Master Data

Project Categories



URL path: REST Request SOAP Request Base
http://api.bciaustralia.com/rest/projectcategories.json http://api.bciaustralia.com/projectcategories.cfc?wsdl http://api.bciaustralia.com/projectcategories.cfc
Serializable: Yes
Methods: getByPK, getByQuery


getByPK
remote Struct getByPK ( required numeric projectcategoriesid, string fields="", required string token )

Get Project Category by ID

Methods of access are:

SOAP: http://api.bciaustralia.com/projectcategories.cfc?wsdl&method=getByPK&projectcategoriesid={projectcategoriesid}(&returnFormat=wddx / &returnFormat=json)

REST: http://api.bciaustralia.com/rest/projectcategories/{projectcategoriesid}(.json / .xml)

Output: Structure

Parameters:
   projectcategoriesid: numeric, required - ID of the project category
   fields: string, optional - PROJECTCATEGORIESID,PROJECT_CATEGORIES
   token: string, required - allocated token for current login session

getByQuery
remote Array getByQuery ( string projectcategoriesid, string projectcategory, string fields="", required string token )

Get Project Category by Query (passing list of IDs or category name)

Methods of access are:

SOAP: http://api.bciaustralia.com/projectcategories.cfc?method=getByQuery(&returnFormat=wddx / &returnFormat=json)

REST: http://api.bciaustralia.com/rest/projectcategories(.json / .xml)

Output: Array

Parameters:
   projectcategoriesid: string, optional - ID of the project category (single ID or comma-seperated list)
   projectcategory: string, optional - project category name
   fields: string, optional - PROJECTCATEGORIESID,PROJECT_CATEGORIES
   token: string, required - allocated token for current login session

Fields
Selectable fields for category information
PROJECTCATEGORIESIDLONG
PROJECT_CATEGORIESVARCHAR(1000)
Sample Output - getByPK() - XML
<wddxPacket version='1.0'> <header/> <data> <struct> <var name='PROJECTCATEGORIESID'><number>2.0</number></var> <var name='PROJECT_CATEGORIES'><string>Education</string></var> </struct> </var> </data> </wddxPacket>
Sample Output - getByQuery() - XML
<wddxPacket version='1.0'> <header/> <data> <array length='1'> <struct> <var name='PROJECTCATEGORIESID'><number>2.0</number></var> <var name='PROJECT_CATEGORIES'><string>Education</string></var> </struct> </array> </data> </wddxPacket>