OSID Logo
OSID Specifications
contact package
Version 3.0.0
Release Candidate Preview
Interfaceosid.contact.AddressQuery
Implementsosid.OsidObjectQuery
Description

This is the query for searching for addresses. Each method specifies an AND term while multiple invocations of the same method produce a nested OR.

MethodmatchResourceId
Description

Sets a resource Id.

Parametersosid.id.IdresourceIda resource Id
booleanmatch true for a positive match, false for a negative match
ErrorsNULL_ARGUMENT resourceId is null
CompliancemandatoryThis method must be implemented.
MethodclearResourceIdTerms
Description

Clears the resource Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsResourceQuery
Description

Tests if a ResourceQuery is available.

Returnboolean true if a resource query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetResourceQuery
Description

Gets the query for a resource query. Multiple retrievals produce a nested OR term.

Returnosid.resource.ResourceQuerythe resource query
ErrorsUNIMPLEMENTED supportsResourceQuery() is false
ComplianceoptionalThis method must be implemented if supportsResourceQuery() is true.
MethodclearResourceTerms
Description

Clears the resource terms.

CompliancemandatoryThis method must be implemented.
MethodmatchAddressText
Description

Matches the address text.

Parametersstringaddressthe address text
osid.type.TypestringMatchTypea string match type
booleanmatch true for a positive match, false for a negative match
ErrorsNULL_ARGUMENT address or stringMatchType is null
CompliancemandatoryThis method must be implemented.
MethodclearAddressTextTerms
Description

Clears the text address terms.

CompliancemandatoryThis method must be implemented.
MethodmatchContactId
Description

Sets the contact Id for this query to match contacts assigned to addresses.

Parametersosid.id.IdcontactIda contact Id
booleanmatch true for a positive match, false for a negative match
ErrorsNULL_ARGUMENT contactId is null
CompliancemandatoryThis method must be implemented.
MethodclearContactIdTerms
Description

Clears the contact Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsContactQuery
Description

Tests if a contact query is available.

Returnboolean true if a contact query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetContactQuery
Description

Gets the query for an address.

Returnosid.contact.ContactQuerythe contact query
ErrorsUNIMPLEMENTED supportsContactQuery() is false
ComplianceoptionalThis method must be implemented if supportsContactQuery() is true.
MethodmatchAnyContact
Description

Matches addresses with any contact.

Parametersbooleanmatch true to match addresses with any contact, false to match addresses with no contacts
CompliancemandatoryThis method must be implemented.
MethodclearContactTerms
Description

Clears the contact terms.

CompliancemandatoryThis method must be implemented.
MethodmatchAddressBookId
Description

Sets the address Id for this query to match contacts assigned to address books.

Parametersosid.id.IdaddressBookIdan address book Id
booleanmatch true for a positive match, false for a negative match
ErrorsNULL_ARGUMENT addressBookId is null
CompliancemandatoryThis method must be implemented.
MethodclearAddressBookIdTerms
Description

Clears the address book Id terms.

CompliancemandatoryThis method must be implemented.
MethodsupportsAddressBookQuery
Description

Tests if an AddressBookQuery is available.

Returnboolean true if an address book query is available, false otherwise
CompliancemandatoryThis method must be implemented.
MethodgetAddressBookQuery
Description

Gets the query for an address book query. Multiple retrievals produce a nested OR term.

Returnosid.contact.AddressBookQuerythe address book query
ErrorsUNIMPLEMENTED supportsAddressBookQuery() is false
ComplianceoptionalThis method must be implemented if supportsAddressBookQuery() is true.
MethodclearAddressBookTerms
Description

Clears the address book terms.

CompliancemandatoryThis method must be implemented.
MethodgetAddressQueryRecord
Description

Gets the address query record corresponding to the given Address record Type. Multiple record retrievals produce a nested boolean OR term.

Parametersosid.type.TypeaddressRecordTypean address record type
Returnosid.contact.records.AddressQueryRecordthe address query record
ErrorsNULL_ARGUMENT addressRecordType is null
OPERATION_FAILEDunable to complete request
UNSUPPORTED hasRecordType(addressRecordType) is false
CompliancemandatoryThis method must be implemented.