Nepomuk Contacts Ontology (NCO)
All about contacts. Rough equivalent of the VCARD standard.
@prefix nco: <http://tracker.api.gnome.org/ontology/v3/nco#>
The following classes are defined:
Affiliation, AuthorizationStatus, BbsNumber, CarPhoneNumber, CellPhoneNumber, Contact, ContactGroup, ContactList, ContactListDataObject, ContactMedium, DomesticDeliveryAddress, EmailAddress, FaxNumber, Gender, IMAccount, IMAddress, IMCapability, InternationalDeliveryAddress, IsdnNumber, MessagingNumber, ModemNumber, OrganizationContact, PagerNumber, ParcelDeliveryAddress, PcsNumber, PersonContact, PhoneNumber, PostalAddress, PresenceStatus, Role, VideoTelephoneNumber, VoicePhoneNumber
Overview
Introduction
This is the ontology modelling contacts and postal addresses. It also extends the original nepomuk adding the Instant Messaging account details, because an ‘identity’ in an IM account can be consider also a contact.
Classes
Affiliation
Aggregates three properties defined in RFC2426. Originally all three were attached directly to a person. One person could have only one title and one role within one organization. This class is intended to lift this limitation.
Class hierarchy
RDF Diagram
Properties
Name | Type | Notes | Description |
---|---|---|---|
department | string | Department. The organizational unit within the organization. | |
org | OrganizationContact | Name of an organization or a unit within an organization the object represented by a Contact is associated with. An equivalent of the ‘ORG’ property defined in RFC 2426 Sec. 3.5.5 | |
role | string | ||
title | string |
AuthorizationStatus
Predefined instances to indicate the auth status: yes, no, requested
Class hierarchy
RDF Diagram
Predefined instances
nco:AuthorizationStatus has the following predefined instances:
- nco:predefined-auth-status-no
- nco:predefined-auth-status-requested
- nco:predefined-auth-status-yes
BbsNumber
A Bulletin Board System (BBS) phone number. Inspired by the (TYPE=bbsl) parameter of the TEL property as defined in RFC 2426 sec 3.3.1.
Class hierarchy
CarPhoneNumber
A car phone number. Inspired by the (TYPE=car) parameter of the TEL property as defined in RFC 2426 sec 3.3.1.
Class hierarchy
CellPhoneNumber
A cellular phone number. Inspired by the (TYPE=cell) parameter of the TEL property as defined in RFC 2426 sec 3.3.1. Usually a cellular phone can accept voice calls as well as textual messages (SMS), therefore this class has two superclasses.
Class hierarchy
Contact
A Contact. A piece of data that can provide means to identify or communicate with an entity.
Class hierarchy
RDF Diagram
Properties
Name | Type | Notes | Description |
---|---|---|---|
belongsToGroup | ContactGroup | Links a Contact with a ContactGroup it belongs to. | |
birthDate | dateTime | Birth date of the object represented by this Contact. An equivalent of the ‘BDAY’ property as defined in RFC 2426 Sec. 3.1.5. | |
contactLocalUID | string | Unique ID for the contact in the local storage | |
contactUID | string | A value that represents a globally unique identifier corresponding to the individual or resource associated with the Contact. An equivalent of the ‘UID’ property defined in RFC 2426 Sec. 3.6.7 | |
fullname | string | To specify the formatted text corresponding to the name of the object the Contact represents. An equivalent of the FN property as defined in RFC 2426 Sec. 3.1.1. | |
hasLocation | Resource | Geographical location of the contact. Inspired by the ‘GEO’ property specified in RFC 2426 Sec. 3.4.2 | |
key | DataObject | An encryption key attached to a contact. Inspired by the KEY property defined in RFC 2426 sec. 3.7.2 | |
nickname | string | A nickname of the Object represented by this Contact. This is an equivalen of the ‘NICKNAME’ property as defined in RFC 2426 Sec. 3.1.3. | |
note | string | A note about the object represented by this Contact. An equivalent for the ‘NOTE’ property defined in RFC 2426 Sec. 3.6.2 | |
photo | InformationElement | Photograph attached to a Contact. The DataObject refered to by this property is usually interpreted as an nfo:Image. Inspired by the PHOTO property defined in RFC 2426 sec. 3.1.4 | |
representative | Contact | An object that represent an object represented by this Contact. Usually this property is used to link a Contact to an organization, to a contact to the representative of this organization the user directly interacts with. An equivalent for the ‘AGENT’ property defined in RFC 2426 Sec. 3.5.4 | |
sound | InformationElement | Sound clip attached to a Contact. The DataObject refered to by this property is usually interpreted as an nfo:Audio. Inspired by the SOUND property defined in RFC 2425 sec. 3.6.6. |
Predefined instances
nco:Contact has the following predefined instances:
- nco:default-contact-me
ContactGroup
A group of Contacts. Could be used to express a group in an addressbook or on a contact list of an IM application. One contact can belong to many groups.
Note: This class emits notifications about changes, and can be monitored using TrackerNotifier
.
Class hierarchy
RDF Diagram
Properties
Name | Type | Notes | Description |
---|---|---|---|
contactGroupName | string | The name of the contact group. This property was NOT defined in the VCARD standard. See documentation of the ‘ContactGroup’ class for details |
ContactList
A contact list, this class represents an addressbook or a contact list of an IM application. Contacts inside a contact list can belong to contact groups.
Note: This class emits notifications about changes, and can be monitored using TrackerNotifier
.
Class hierarchy
RDF Diagram
Properties
Name | Type | Notes | Description |
---|---|---|---|
containsContact | ContactListDataObject | A property used to group contacts into contact groups. This property was NOT defined in the VCARD standard. See documentation for the ‘ContactList’ class for details |
ContactListDataObject
An entity occuring on a contact list (usually interpreted as an nco:Contact)
Class hierarchy
RDF Diagram
ContactMedium
A superclass for all contact media - ways to contact an entity represented by a Contact instance. Some of the subclasses of this class (the various kinds of telephone numbers and postal addresses) have been inspired by the values of the TYPE parameter of ADR and TEL properties defined in RFC 2426 sec. 3.2.1. and 3.3.1 respectively. Each value is represented by an appropriate subclass with two major exceptions TYPE=home and TYPE=work. They are to be expressed by the roles these contact media are attached to i.e. contact media with TYPE=home parameter are to be attached to the default role (nco:Contact or nco:PersonContact), whereas media with TYPE=work parameter should be attached to nco:Affiliation or nco:OrganizationContact.
Class hierarchy
RDF Diagram
Properties
Name | Type | Notes | Description |
---|---|---|---|
contactMediumComment | string | A comment about the contact medium. |
DomesticDeliveryAddress
Domestic Delivery Addresse. Class inspired by TYPE=dom parameter of the ADR property defined in RFC 2426 sec. 3.2.1
Class hierarchy
EmailAddress
An email address. The recommended best practice is to use mailto: uris for instances of this class.
Class hierarchy
RDF Diagram
Properties
Name | Type | Notes | Description |
---|---|---|---|
emailAddress | string | Email address |
FaxNumber
A fax number. Inspired by the (TYPE=fax) parameter of the TEL property as defined in RFC 2426 sec 3.3.1.
Class hierarchy
Gender
Gender. Instances of this class may include male and female.
Class hierarchy
RDF Diagram
Predefined instances
nco:Gender has the following predefined instances:
- nco:gender-female
- nco:gender-male
- nco:gender-other
IMAccount
An account in an Instant Messaging system. This refers to IM accounts of the user ‘me’.
Note: This class emits notifications about changes, and can be monitored using TrackerNotifier
.
Class hierarchy
RDF Diagram
Properties
Name | Type | Notes | Description |
---|---|---|---|
hasIMContact | IMAddress | Indicates that this Instant Messaging account has the specified Instant Messaging address in the contact list. | |
imAccountAddress | IMAddress | Instant Messaging address of this IM account. The user ‘me’ can send and receive messages from this IM address. | |
imAccountType | string | Type of the IM account. This may be the name of the service that provides the IM functionality. Examples might include Jabber, ICQ, MSN etc | |
imDisplayName | string | The user-visible name of this account. This SHOULD be chosen by the user at account creation time. The account creation user interface is responsible for setting a reasonable default value in the user’s locale; something like ‘Jabber (bob@example.com)’ would be sensible. | |
imEnabled | boolean |
IMAddress
An instant messaging address such as xmpp:foo@bar.com.
Note: This class emits notifications about changes, and can be monitored using TrackerNotifier
.
Class hierarchy
RDF Diagram
Properties
Name | Type | Notes | Description |
---|---|---|---|
imAddressAuthStatusFrom | AuthorizationStatus | Has the other end authorize to receive information about his changes | |
imAddressAuthStatusTo | AuthorizationStatus | Do i authorize this im Account to receive my information | |
imAvatar | DataObject | A picture attached to a particular IM address. | |
imCapability | IMCapability | Capabilities of an IM Contact, what can we interact with him | |
imID | string | Identifier of the IM account. Examples of such identifier might include ICQ UINs, Jabber IDs, Skype names etc. | |
imNickname | string | A nickname attached to a particular IM address. | |
imPresence | PresenceStatus | ||
imProtocol | string | Protocol of the account (‘skype’, ‘gtalk’, ‘icq’, …) | |
imStatusMessage | string | A feature common in most IM systems. A message left by the user for all his/her contacts to see. | |
presenceLastModified | dateTime | Timestamp of the last change in the presence status |
IMCapability
Features of a certain IM connection (depends on the IMAccount implementation used by the Contact)
Class hierarchy
RDF Diagram
Predefined instances
nco:IMCapability has the following predefined instances:
- nco:im-capability-audio-calls
- nco:im-capability-dbus-tubes
- nco:im-capability-file-transfers
- nco:im-capability-media-calls
- nco:im-capability-stream-tubes
- nco:im-capability-text-chat
- nco:im-capability-upgrading-calls
- nco:im-capability-video-calls
InternationalDeliveryAddress
International Delivery Addresse. Class inspired by TYPE=intl parameter of the ADR property defined in RFC 2426 sec. 3.2.1
Class hierarchy
IsdnNumber
An ISDN phone number. Inspired by the (TYPE=isdn) parameter of the TEL property as defined in RFC 2426 sec 3.3.1.
Class hierarchy
MessagingNumber
A number that can accept textual messages.
Class hierarchy
ModemNumber
A modem phone number. Inspired by the (TYPE=modem) parameter of the TEL property as defined in RFC 2426 sec 3.3.1.
Class hierarchy
OrganizationContact
A Contact that denotes on Organization.
Class hierarchy
RDF Diagram
Properties
Name | Type | Notes | Description |
---|---|---|---|
logo | DataObject | Logo of a company. Inspired by the LOGO property defined in RFC 2426 sec. 3.5.3 |
PagerNumber
A pager phone number. Inspired by the (TYPE=pager) parameter of the TEL property as defined in RFC 2426 sec 3.3.1.
Class hierarchy
ParcelDeliveryAddress
Parcel Delivery Addresse. Class inspired by TYPE=parcel parameter of the ADR property defined in RFC 2426 sec. 3.2.1
Class hierarchy
PcsNumber
Personal Communication Services Number. A class inspired by the TYPE=pcs parameter of the TEL property defined in RFC 2426 sec. 3.3.1
Class hierarchy
PersonContact
A Contact that denotes a Person. A person can have multiple Affiliations.
Note: This class emits notifications about changes, and can be monitored using TrackerNotifier
.
Class hierarchy
RDF Diagram
Properties
Name | Type | Notes | Description |
---|---|---|---|
gender | Gender | Gender of the given contact. | |
hasAffiliation | Affiliation | Links a PersonContact with an Affiliation. | |
hobby | string | A hobby associated with a PersonContact. This property can be used to express hobbies and interests. | |
nameAdditional | string | Additional given name of an object represented by this contact. See documentation for ‘nameFamily’ property for details. | |
nameFamily | string | The family name of an Object represented by this Contact. These applies to people that have more than one given name. The ‘first’ one is considered ‘the’ given name (see nameGiven) property. All additional ones are considered ‘additional’ names. The name inherited from parents is the ‘family name’. e.g. For Dr. John Phil Paul Stevenson Jr. M.D. A.C.P. we have contact with: honorificPrefix: ‘Dr.’, nameGiven: ‘John’, nameAdditional: ‘Phil’, nameAdditional: ‘Paul’, nameFamily: ‘Stevenson’, honorificSuffix: ‘Jr.’, honorificSuffix: ‘M.D.’, honorificSuffix: ‘A.C.P.’. These properties form an equivalent of the compound ‘N’ property as defined in RFC 2426 Sec. 3.1.2 | |
nameGiven | string | The given name for the object represented by this Contact. See documentation for ‘nameFamily’ property for details. | |
nameHonorificPrefix | string | A prefix for the name of the object represented by this Contact. See documentation for the ‘nameFamily’ property for details. | |
nameHonorificSuffix | string | A suffix for the name of the Object represented by the given object. See documentation for the ‘nameFamily’ for details. |
Predefined instances
nco:PersonContact has the following predefined instances:
- nco:default-contact-me
PhoneNumber
A telephone number.
Class hierarchy
RDF Diagram
Properties
Name | Type | Notes | Description |
---|---|---|---|
phoneNumber | string |
PostalAddress
A postal address. A class aggregating the various parts of a value for the ‘ADR’ property as defined in RFC 2426 Sec. 3.2.1.
Class hierarchy
RDF Diagram
Properties
Name | Type | Notes | Description |
---|---|---|---|
addressLocation | Resource | The geographical location of a postal address. | |
country | string | A part of an address specifying the country. Inspired by the seventh part of the value of the ‘ADR’ property as defined in RFC 2426, sec. 3.2.1 | |
county | string | Regional division between state and city. Not in RFC 2426 sec 3.2.1. Added for API compatibility | |
district | string | Local division inside a city. Not in RFC 2426 sec 3.2.1. Added for API compatibility | |
extendedAddress | string | An extended part of an address. This field might be used to express parts of an address that aren’t include in the name of the Contact but also aren’t part of the actual location. Usually the streed address and following fields are enough for a postal letter to arrive. Examples may include (‘University of California Campus building 45’, ‘Sears Tower 34th floor’ etc.) Inspired by the second part of the value of the ‘ADR’ property as defined in RFC 2426, sec. 3.2.1 | |
locality | string | Locality or City. Inspired by the fourth part of the value of the ‘ADR’ property as defined in RFC 2426, sec. 3.2.1 | |
pobox | string | Post office box. This is the first part of the value of the ‘ADR’ property as defined in RFC 2426, sec. 3.2.1 | |
postalcode | string | Postal Code. Inspired by the sixth part of the value of the ‘ADR’ property as defined in RFC 2426, sec. 3.2.1 | |
region | string | Region. Inspired by the fifth part of the value of the ‘ADR’ property as defined in RFC 2426, sec. 3.2.1 | |
streetAddress | string | The streed address. Inspired by the third part of the value of the ‘ADR’ property as defined in RFC 2426, sec. 3.2.1 |
PresenceStatus
Predefined set of status level instances
Class hierarchy
RDF Diagram
Predefined instances
nco:PresenceStatus has the following predefined instances:
- nco:presence-status-available
- nco:presence-status-away
- nco:presence-status-busy
- nco:presence-status-error
- nco:presence-status-extended-away
- nco:presence-status-hidden
- nco:presence-status-offline
- nco:presence-status-unknown
- nco:presence-status-unset
Role
A role played by a contact. Contacts that denote people, can have many roles (e.g. see the hasAffiliation property and Affiliation class). Contacts that denote Organizations or other Agents usually have one role. Each role can introduce additional contact media.
Class hierarchy
RDF Diagram
Properties
Name | Type | Notes | Description |
---|---|---|---|
blogUrl | Resource | A Blog url. | |
foafUrl | Resource | The URL of the FOAF file. | |
hasContactMedium | ContactMedium | A superProperty for all properties linking a Contact to an instance of a contact medium. | |
hasEmailAddress | EmailAddress | An address for electronic mail communication with the object specified by this contact. An equivalent of the ‘EMAIL’ property as defined in RFC 2426 Sec. 3.3.1. | |
hasIMAddress | IMAddress | An address for communication using instant messages with the object specified by this contact. | |
hasPhoneNumber | PhoneNumber | A number for telephony communication with the object represented by this Contact. An equivalent of the ‘TEL’ property defined in RFC 2426 Sec. 3.3.1 | |
hasPostalAddress | PostalAddress | The default Address for a Contact. An equivalent of the ‘ADR’ property as defined in RFC 2426 Sec. 3.2.1. | |
url | Resource | A uniform resource locator associated with the given role of a Contact. Inspired by the ‘URL’ property defined in RFC 2426 Sec. 3.6.8. | |
video | InformationElement | Video avatar of a contact. Note that is an icon/avatar, not a generic ‘present in video’ property | |
websiteUrl | Resource | A url of a website. |
Predefined instances
nco:Role has the following predefined instances:
- nco:default-contact-me
VideoTelephoneNumber
A Video telephone number. A class inspired by the TYPE=video parameter of the TEL property defined in RFC 2426 sec. 3.3.1
Class hierarchy
VoicePhoneNumber
A telephone number with voice communication capabilities. Class inspired by the TYPE=voice parameter of the TEL property defined in RFC 2426 sec. 3.3.1
Class hierarchy
Properties
Name | Type | Notes | Description |
---|---|---|---|
voiceMail | boolean | Indicates if the given number accepts voice mail. (e.g. there is an answering machine). Inspired by TYPE=msg parameter of the TEL property defined in RFC 2426 sec. 3.3.1 |
Additional properties for nie:InformationElement
Properties this ontology defines which can describe nie:InformationElement resources.
Name | Type | Notes | Description |
---|---|---|---|
contributor | Contact | An entity responsible for making contributions to the content of the InformationElement. | |
creator | Contact | Creator of a data object, an entity primarily responsible for the creation of the content of the data object. | |
publisher | Contact | An entity responsible for making the InformationElement available. |
Credits and Copyright
Authors:
- Antoni Mylka, DFKI, <antoni.mylka@dfki.de>
- Leo Sauermann, DFKI, <leo.sauermann@dfki.de>
- Ludger van Elst, DFKI, <elst@dfki.uni-kl.de>
- Michael Sintek, DFKI, <michael.sintek@dfki.de>
- Tracker Developers
Editors:
- Antoni Mylka, DFKI, <antoni.mylka@dfki.de>
- Tracker developers (translation into turtle)
Contributors:
- Christiaan Fluit, Aduna, <christiaan.fluit@aduna-software.com>
- Evgeny ‘phreedom’ Egorochkin, KDE Strigi Developer, <stexx@mail.ru>
Upstream: Upstream version
ChangeLog: Tracker changes
Copyright:
© 2007