Property portfolio

The property portfolio is used to store a collection of properties from an estate agency.

This is a persistant portfolio logged against a web user who must be logged in to view and add/remove properties.


Portfolio

The portfolio is located on the Dezrez servers and can be found on the link below. Before a portfolio action can be performed the user has to login or register, the login form is the same form used by the members area and all actions can be performed (register, forgotten password, etc.) The protfolio can be displayed in an iframe or in a new window but it has to run from the Dezrez servers to keep the whole process secure.

The URL is: http://www.dezrez.com/DRApp/DotNetSites/WebEngine/property/Portfolio.aspx


Parameter reference

Parameter name Data type Value Description
apiKey string Example:
DEBF038A-8047-42F8-B0A8-12C35DA33F13
The API (Application Programing Interface) key is an identifier unique for the estate agent and needs to be provided with any request made to the dezrez web engine. After the initial request the web engine will attempt to store the API key for any subsequent request for that session. A key can be obtained from the dezrez web team (0845 465 2222). This is a compulsory value.
eaid int The Estate Agency ID – This number can be obtained from the dezrez web team (0845 465 2222). This is a compulsory value.
sessionGUID string Example:
66ff1de8-0115-48d6-8417-74c238fc8704
The session GUID (Globally Unique Identifier) is used to identify the website users current session. This should be passed from your website to the dezrez web engine to maintain a constant session across the web engine. Not supplying the same sessionGUID with every request for a particular session will result in the website user having to log into the web engine multiple times. See Appendix A for sample code to generate a unique id. This is a compulsory value.
pid long Example: 258204 Dezrez ID for the property to be add/removed from the portfolio. this can be obtained from the property xml. This is a compulsory value.
action string Example:
add
The action to perfom against the property ID. Possible values are:

add
remove
list

This is a compulsory value.

For example, you could create a link to the portfolio to add a property:

http://www.dezrez.com/DRApp/DotNetSites/WebEngine/property/Portfolio.aspx?apikey=DEBF038A-8047-42F8-B0A8-12C35DA33F13&pid=262450&eaid=398&sessionGUID=320a7035-ec69-41ac-a661-9b409727543e&action=add

To remove a property:

http://www.dezrez.com/DRApp/DotNetSites/WebEngine/property/Portfolio.aspx?apikey=DEBF038A-8047-42F8-B0A8-12C35DA33F13&pid=262450&eaid=398&sessionGUID=320a7035-ec69-41ac-a661-9b409727543e&action=remove

To view the portfolio:

http://www.dezrez.com/DRApp/DotNetSites/WebEngine/property/Portfolio.aspx?apikey=DEBF038A-8047-42F8-B0A8-12C35DA33F13&pid=0&eaid=398&sessionGUID=320a7035-ec69-41ac-a661-9b409727543e&action=list

Back to top

Appendix A - Sample GUID generation code


Classic ASP

copy

Function GetGuid() 
    Set TypeLib = CreateObject("Scriptlet.TypeLib") 
    GetGuid = Left(CStr(TypeLib.Guid), 38)
    GetGuid = replace(GetGuid, "{", "")
    GetGuid = replace(GetGuid, "}", "")
    Set TypeLib = Nothing 
End Function 
                                    
                                    

PHP

copy

function getGUID()
{
	$theGuid = uniqid(uniqid(), true);
	return $theGuid;
}
                                    
                                    

Javascript

copy

function createUUID() {
    // http://www.ietf.org/rfc/rfc4122.txt 
    var s = [];
    var hexDigits = '0123456789ABCDEF';
    for (var i = 0; i < 32; i++) {
        s[i] = hexDigits.substr(Math.floor(Math.random() * 0x10), 1);
    }
    s[12] = '4';  // bits 12-15 of the time_hi_and_version field to 0010 
    s[16] = hexDigits.substr((s[16] & 0x3) | 0x8, 1);  // bits 6-7 of the clock_seq_hi_and_reserved to 01 
    var uuid = s.join('');
    return uuid;
}
                                    
                                    

C#

copy

string sessionGUID = Guid.NewGuid().ToString();