Properties
| TargetVCardField | s | Read only | ||
| TargetURIScheme | s | Read only | ||
| TargetVCardAddress | s | Read only | ||
| TargetURI | s | Read only |
Description
This interface provides properties that can be used for requesting channels through different contact addressing schemes like vCard addresses or URIs.
Properties
TargetVCardField — s
The vCard field, normalized to lower case, TargetVCardAddress refers to.
The url vCard field MUST NOT appear here; see
TargetURI instead.
Rationale:
In practice, protocols have a limited set of URI schemes that make sense to resolve as a contact.
If this is omitted from a request, TargetVCardAddress MUST be omitted as well.
TargetURIScheme — s
The URI scheme used in TargetURI
Rationale:
While this seems redundant, since the scheme is included in TargetURI, it exists for constructing RequestableChannelClasses that support a limited set of URI schemes.
If this is omitted from a request, TargetURI MUST be omitted as well.
TargetVCardAddress — s
The vCard address of the Channel's target.
If this is present in a channel request, TargetVCardField MUST be present, and TargetHandle, TargetID, and TargetURI MUST NOT be present. TargetEntityType must either not be present or set to Entity_Type_Contact. The request MUST fail with error InvalidHandle, without side-effects, if the requested vCard address cannot be found.
TargetURI — s
The URI of the Channel's target. The URI's scheme (i.e. the part before the first colon) MUST be identical to TargetURIScheme.
If this is present in a channel request, TargetVCardField MUST be present, and TargetHandle, TargetID, and TargetVCardAddress MUST NOT be present. TargetEntityType must either not be present or set to Entity_Type_Contact. The request MUST fail with error InvalidHandle, without side-effects, if the requested vCard address cannot be found.