Difference between revisions of "Faces Application Profile Album"

From MPDLMediaWiki
Jump to navigation Jump to search
 
(32 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{ESciDoc Solutions}}
{{ESciDoc Solutions}}
== Introduction ==
Please enter all comments concerning the use cases on the [[Talk:Faces_Application_Profile_Album|discussion page]].
== Aim and Scope ==
NOTE: '''Albums''' have been called '''Study Sets''' or - technically - '''Bundles''' before.
An album is a set of selected pictures, which can be published (state released) but also can be used as a private (state submitted) selection. It can be created by a user who automatically is the owner of the album. To create an album means to create new content with its own metadata set.
Albums will be versioned. This means after each change of the album a new version will be created.
As being a content that can be published, each album in its internal workflow goes through the following states: '''submitted (private)''', '''released (published)''' and (optionally) '''withdrawn'''. When changing the status, a version comment can be entered and will be stored. The main workflow is the following:
#An album is created by the owner and is visible by default only to him ('''status: submitted'''). In this state, the owner can also decide to open the album for further editing and specifies users who can further work on the album.
# After decision that the album is in state for publishing, the owner publishes the album and it will be assigned with a persistent identifier. Released albums are visible to all account users and can be referenced as source for a publication. They can be cited, because the metadata of the album will be available for all users (not only account users, as the pictures will be). This information will also be part of the application release agreement. ('''status: released''').
# Optionally: An album can be withdrawn by the owner in case when it is not a valid scientific content any more (or from other reasons). Withdrawn albums are only visible through the owners album list or through the direct URL ('''status: withdrawn''').
Technically, an album is a container (similar to a collection).
The difference between an album and a [[Faces_Application_Profile_Collection|collection]] is that an album can have contributors and a collection must have a date created.
== Data model ==
[[Image:Faces_studyset.jpg]]


== Namespaces ==
== Namespaces ==
{| style="border:1px solid #1b90b5; "
{| style="border:1px solid #1b90b5; "
|width="100pt" bgcolor=#fedcba | '''Term URI'''
|width="150pt" bgcolor=#CEE3F6 | '''Term URI'''
|width="500pt"| http://purl.org/dc/terms/
|width="500pt"| http://purl.org/dc/terms/
|-
|-
| bgcolor=#fedcba | '''Name'''
| bgcolor=#CEE3F6 | '''Name'''
| dcterms:
| dcterms:
|-
|-
| bgcolor=#fedcba | '''Label'''
| bgcolor=#CEE3F6 | '''Label'''
| Dublin Core terms
| Dublin Core terms
|}
|}


==Syntax Encoding Scheme==
== Syntax Encoding Scheme ==


{| style="border:1px solid #1b90b5; "
{| style="border:1px solid #1b90b5; "
|colspan="2" bgcolor=#fedcba | '''String data type definition'''
|colspan="2" bgcolor=#CEE3F6 | '''String data type definition'''
|-
|-
|width="100pt" bgcolor=#fedcba | '''Name'''
|width="150pt" bgcolor=#CEE3F6 | '''Name'''
|width="500pt"| <string>
|width="500pt"| <string>
|-
|-
| bgcolor=#fedcba | '''Label'''
| bgcolor=#CEE3F6 | '''Label'''
| Character string
| Character string
|-
|-
| bgcolor=#fedcba | '''Definition'''
| bgcolor=#CEE3F6 | '''Definition'''
| A string of ASCII characters. No formatting tags may be included. The following characters must be encoded for XML: '&' - '&amp;'; '<' - '&lt;'; '>' - '&gt;'. A limited list of non-ASCII characters may be included encoded as character entities.
| A string of ASCII characters. No formatting tags may be included. The following characters must be encoded for XML: '&' - '&amp;'; '<' - '&lt;'; '>' - '&gt;'. A limited list of non-ASCII characters may be included encoded as character entities.
|}
|}




== Describing a Study Set (used: ESciDoc Publication)==
== Describing an Album ==


[[Image:Faces_studyset.jpg]]
=== Title ===
=== Title (from ESciDoc Publication)===
{| style="border:1px solid #1b90b5; "
{| style="border:1px solid #1b90b5; "
|width="150pt" bgcolor=#fedcba | '''Term URI'''
|width="150pt" bgcolor=#CEE3F6 | '''Term URI'''
|width="500pt"| http://purl.org/dc/terms/title
|width="500pt"| http://purl.org/dc/terms/title
|-
|-
| bgcolor=#fedcba | '''Name'''
| bgcolor=#CEE3F6 | '''Name'''
| title
| title
|-
|-
| bgcolor=#fedcba | '''Label'''
| bgcolor=#CEE3F6 | '''Label'''
| Title
| Title
|-
|-
| bgcolor=#fedcba | '''Defined by:'''
| bgcolor=#CEE3F6 | '''Defined by:'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''DC Definition'''
| bgcolor=#CEE3F6 | '''DC Definition'''
| A name given to the resource.
| A name given to the resource.
|-
|-
| bgcolor=#fedcba | '''DC Comment'''
| bgcolor=#CEE3F6 | '''DC Comment'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''eSciDoc Definition'''
| bgcolor=#CEE3F6 | '''eSciDoc Definition'''
| The name of a study set.
| The name of an album.
|-
|-
| bgcolor=#fedcba | '''eSciDoc Comment'''
| bgcolor=#CEE3F6 | '''eSciDoc Comment'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Type of term'''
| bgcolor=#CEE3F6 | '''Type of term'''
| Property
| Property
|-
|-
| bgcolor=#fedcba | '''Refines'''
| bgcolor=#CEE3F6 | '''Refines'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Refined by'''
| bgcolor=#CEE3F6 | '''Refined by'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Encoding Scheme For'''
| bgcolor=#CEE3F6 | '''Encoding Scheme For'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Has Encoding Scheme'''
| bgcolor=#CEE3F6 | '''Has Encoding Scheme'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Obligation'''
| bgcolor=#CEE3F6 | '''Obligation'''
| Mandatory
| Mandatory
|-
|-
| bgcolor=#fedcba | '''Condition'''
| bgcolor=#CEE3F6 | '''Condition'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Datatype'''
| bgcolor=#CEE3F6 | '''Datatype'''
| string
| string
|-
|-
| bgcolor=#fedcba | '''Occurrence'''
| bgcolor=#CEE3F6 | '''Occurrence'''
| Min: 1; Max: 1;
| Min: 1; Max: 1;
|-
|-
| bgcolor=#fedcba | '''Best practice'''
| bgcolor=#CEE3F6 | '''Best practice'''
| The complete name should be generated automatically from given name and family name
| -
|-
|-
| bgcolor=#fedcba | '''Open Questions'''
| bgcolor=#CEE3F6 | '''Remakrs'''
| -
| Related to "title" form [[ESciDoc_Application_Profile_Publication|ESciDoc Publication]]
|}
|}


=== Description ===
=== Description ===
{| style="border:1px solid #1b90b5; "
{| style="border:1px solid #1b90b5; "
|width="150pt" bgcolor=#fedcba | '''Term URI'''
|width="150pt" bgcolor=#CEE3F6 | '''Term URI'''
|width="500pt"| http://purl.org/dc/terms/description
|width="500pt"| http://purl.org/dc/terms/description
|-
|-
| bgcolor=#fedcba | '''Name'''
| bgcolor=#CEE3F6 | '''Name'''
| description
| description
|-
|-
| bgcolor=#fedcba | '''Label'''
| bgcolor=#CEE3F6 | '''Label'''
| Description
| Description
|-
|-
| bgcolor=#fedcba | '''Defined by:'''
| bgcolor=#CEE3F6 | '''Defined by:'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''DC Definition'''
| bgcolor=#CEE3F6 | '''DC Definition'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''DC Comment'''
| bgcolor=#CEE3F6 | '''DC Comment'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''eSciDoc Definition'''
| bgcolor=#CEE3F6 | '''eSciDoc Definition'''
| A short description of a study set.
| A short description of an album.
|-
|-
| bgcolor=#fedcba | '''eSciDoc Comment'''
| bgcolor=#CEE3F6 | '''eSciDoc Comment'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Type of term'''
| bgcolor=#CEE3F6 | '''Type of term'''
| Property
| Property
|-
|-
| bgcolor=#fedcba | '''Refines'''
| bgcolor=#CEE3F6 | '''Refines'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Refined by'''
| bgcolor=#CEE3F6 | '''Refined by'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Encoding Scheme For'''
| bgcolor=#CEE3F6 | '''Encoding Scheme For'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Has Encoding Scheme'''
| bgcolor=#CEE3F6 | '''Has Encoding Scheme'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Obligation'''
| bgcolor=#CEE3F6 | '''Obligation'''
| Mandatory
| Optional
|-
|-
| bgcolor=#fedcba | '''Condition'''
| bgcolor=#CEE3F6 | '''Condition'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Datatype'''
| bgcolor=#CEE3F6 | '''Datatype'''
| string
| string
|-
|-
| bgcolor=#fedcba | '''Occurrence'''
| bgcolor=#CEE3F6 | '''Occurrence'''
| Min: 1; Max: 1;
| Min: 0; Max: 1;
|-
|-
| bgcolor=#fedcba | '''Best practice'''
| bgcolor=#CEE3F6 | '''Best practice'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Open Questions'''
| bgcolor=#CEE3F6 | '''Remakrs'''
| -
| Related to "abstract" from [[ESciDoc_Application_Profile_Publication|ESciDoc Publication]]
|}
|}


=== Creator (from ESciDoc Publication)===
=== Creator ===
{| style="border:1px solid #1b90b5; "
{| style="border:1px solid #1b90b5; "
|width="150pt" bgcolor=#fedcba | '''Term URI'''
|width="150pt" bgcolor=#CEE3F6 | '''Term URI'''
|width="500pt"| http://purl.org/dc/terms/creator
|width="500pt"| http://purl.org/dc/terms/creator
|-
|-
| bgcolor=#fedcba | '''Name'''
| bgcolor=#CEE3F6 | '''Name'''
| creator
| creator
|-
|-
| bgcolor=#fedcba | '''Label'''
| bgcolor=#CEE3F6 | '''Label'''
| Creator
| Creator
|-
|-
| bgcolor=#fedcba | '''Defined by:'''
| bgcolor=#CEE3F6 | '''Defined by:'''
| -
|-
| bgcolor=#CEE3F6 | '''DC Definition'''
| An entity primarily responsible for making the resource.
|-
| bgcolor=#CEE3F6 | '''DC Comment'''
| Examples of a Creator include a person, an organization, or a service. Typically, the name of a Creator should be used to indicate the entity.
|-
| bgcolor=#CEE3F6 | '''eSciDoc Definition'''
| The author of an album.
|-
| bgcolor=#CEE3F6 | '''eSciDoc Comment'''
| For Faces, only persons are valid creators.
|-
| bgcolor=#CEE3F6 | '''Type of term'''
| Property
|-
| bgcolor=#CEE3F6 | '''Refines'''
| -
|-
| bgcolor=#CEE3F6 | '''Refined by'''
| -
|-
| bgcolor=#CEE3F6 | '''Encoding Scheme For'''
| -
|-
| bgcolor=#CEE3F6 | '''Has Encoding Scheme'''
| -
|-
| bgcolor=#CEE3F6 | '''Obligation'''
| Mandatory
|-
| bgcolor=#CEE3F6 | '''Condition'''
| -
|-
| bgcolor=#CEE3F6 | '''Datatype'''
| string
|-
| bgcolor=#CEE3F6 | '''Occurrence'''
| Min: 1; Max: Unbounded;
|-
| bgcolor=#CEE3F6 | '''Best practice'''
| -
|-
| bgcolor=#CEE3F6 | '''Remakrs'''
| The first creator is always the owner of the item.
Related to "creator" from [[ESciDoc_Application_Profile_Publication|ESciDoc Publication]]
|}
 
=== Organization ===
{| style="border:1px solid #1b90b5; "
|width="150pt" bgcolor=#CEE3F6 |  '''Term URI'''
|width="500pt"| http://www.w3.org/2006/vcard/ns/org
|-
|  bgcolor=#CEE3F6 | '''Name'''
| org
|-
|  bgcolor=#CEE3F6 | '''Label'''
| Organization
|-
|  bgcolor=#CEE3F6 | '''Defined by:'''
| -
|-
|  bgcolor=#CEE3F6 | '''vCard Definition'''
| An organization associated with a person.
|-
|  bgcolor=#CEE3F6 | '''vCard Comment'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''eSciDoc Definition'''
| bgcolor=#CEE3F6 | '''eSciDoc Definition'''
| The creator of a study set.
| The organizational unit the person was affiliated to when creating the album.
|-
|-
| bgcolor=#fedcba | '''eSciDoc Comment'''
| bgcolor=#CEE3F6 | '''eSciDoc Comment'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Type of term'''
| bgcolor=#CEE3F6 | '''Type of term'''
| Property
| Property
|-
|-
| bgcolor=#fedcba | '''Refines'''
| bgcolor=#CEE3F6 | '''Refines'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Refined by'''
| bgcolor=#CEE3F6 | '''Refined by'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Encoding Scheme For'''
| bgcolor=#CEE3F6 | '''Encoding Scheme For'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Has Encoding Scheme'''
| bgcolor=#CEE3F6 | '''Has Encoding Scheme'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Obligation'''
| bgcolor=#CEE3F6 | '''Obligation'''
| Mandatory
| Mandatory
|-
|-
| bgcolor=#fedcba | '''Condition'''
| bgcolor=#CEE3F6 | '''Condition'''
| -
| The domain of the vCard:org property is the vCard:VCard class.<br /> The range of the v:org property is the v:Organization class.
|-
|-
| bgcolor=#fedcba | '''Datatype'''
| bgcolor=#CEE3F6 | '''Datatype'''
| string
| string
|-
|-
| bgcolor=#fedcba | '''Occurrence'''
| bgcolor=#CEE3F6 | '''Occurrence'''
| Min: 1; Max: 1;
| Min: 1; Max: unbounded;
|-
|-
| bgcolor=#fedcba | '''Best practice'''
| bgcolor=#CEE3F6 | '''Best practice'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Open Questions'''
| bgcolor=#CEE3F6 | '''Remarks'''
| -
| -
|}
|}


=== Contributor (from ESciDoc Publication)===
=== Contributor ===
{| style="border:1px solid #1b90b5; "
{| style="border:1px solid #1b90b5; "
|width="150pt" bgcolor=#fedcba | '''Term URI'''
|width="150pt" bgcolor=#CEE3F6 | '''Term URI'''
|width="500pt"| http://purl.org/dc/terms/contributor
|width="500pt"| http://purl.org/dc/terms/contributor
|-
|-
| bgcolor=#fedcba | '''Name'''
| bgcolor=#CEE3F6 | '''Name'''
| contributor
| contributor
|-
|-
| bgcolor=#fedcba | '''Label'''
| bgcolor=#CEE3F6 | '''Label'''
| Contributor
| Contributor
|-
|-
| bgcolor=#fedcba | '''Defined by:'''
| bgcolor=#CEE3F6 | '''Defined by:'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''eSciDoc Definition'''
| bgcolor=#CEE3F6 | '''eSciDoc Definition'''
| The editor/contributor of a study set.One or more account users who have the rights to edit a study set.
| The editor/contributor of an album .One or more account users who have the rights to edit an album.
|-
|-
| bgcolor=#fedcba | '''eSciDoc Comment'''
| bgcolor=#CEE3F6 | '''eSciDoc Comment'''
| Only Contributers from the type Editor are allowed.
| Only Contributers from the type Editor are allowed.
|-
|-
| bgcolor=#fedcba | '''Type of term'''
| bgcolor=#CEE3F6 | '''Type of term'''
| Property
| Property
|-
|-
| bgcolor=#fedcba | '''Refines'''
| bgcolor=#CEE3F6 | '''Refines'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Refined by'''
| bgcolor=#CEE3F6 | '''Refined by'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Encoding Scheme For'''
| bgcolor=#CEE3F6 | '''Encoding Scheme For'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Has Encoding Scheme'''
| bgcolor=#CEE3F6 | '''Has Encoding Scheme'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Obligation'''
| bgcolor=#CEE3F6 | '''Obligation'''
| Optional
| Optional
|-
|-
| bgcolor=#fedcba | '''Condition'''
| bgcolor=#CEE3F6 | '''Condition'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Datatype'''
| bgcolor=#CEE3F6 | '''Datatype'''
| string
| string
|-
|-
| bgcolor=#fedcba | '''Occurrence'''
| bgcolor=#CEE3F6 | '''Occurrence'''
| Min: 0; Max: unbounded;
| Min: 0; Max: unbounded;
|-
|-
| bgcolor=#fedcba | '''Best practice'''
| bgcolor=#CEE3F6 | '''Best practice'''
| -
| -
|-
|-
| bgcolor=#fedcba | '''Open Questions'''
| bgcolor=#CEE3F6 | '''Remakrs'''
| -
| Related to "contributor" from [[ESciDoc_Application_Profile_Publication|ESciDoc Publication]]
|}
|}


[[Category:Faces|Application Profile StudySet]]
== Related Application Profiles ==
[[Category:Application Profiles]]
'''eSciDoc'''
* [[ESciDoc_Application_Profile_Publication|ESciDoc Application Profile Publication]]
'''Faces'''
* [[Faces_Application_Profile_Collection|Faces Application Profile Collection]]
* [[Faces_Application_Profile_FacesFile|Faces Application Profile FacesFile]]
* [[Faces_Application_Profile_FacesItem|Faces Application Profile FacesItem]]
 
[[Category:Faces Application Profiles|Album]]

Latest revision as of 09:22, 12 January 2012

eSciDoc Solutions

PubMan:
Overview · Functionalities
Interfaces · Support

Faces:
Overview · Functionalities
Scope · Support

ViRR:
Overview · Functionalities
Scope · Support

imeji
Digitization Lifecycle

edit


Introduction[edit]

Please enter all comments concerning the use cases on the discussion page.

Aim and Scope[edit]

NOTE: Albums have been called Study Sets or - technically - Bundles before.

An album is a set of selected pictures, which can be published (state released) but also can be used as a private (state submitted) selection. It can be created by a user who automatically is the owner of the album. To create an album means to create new content with its own metadata set.

Albums will be versioned. This means after each change of the album a new version will be created.

As being a content that can be published, each album in its internal workflow goes through the following states: submitted (private), released (published) and (optionally) withdrawn. When changing the status, a version comment can be entered and will be stored. The main workflow is the following:

  1. An album is created by the owner and is visible by default only to him (status: submitted). In this state, the owner can also decide to open the album for further editing and specifies users who can further work on the album.
  2. After decision that the album is in state for publishing, the owner publishes the album and it will be assigned with a persistent identifier. Released albums are visible to all account users and can be referenced as source for a publication. They can be cited, because the metadata of the album will be available for all users (not only account users, as the pictures will be). This information will also be part of the application release agreement. (status: released).
  3. Optionally: An album can be withdrawn by the owner in case when it is not a valid scientific content any more (or from other reasons). Withdrawn albums are only visible through the owners album list or through the direct URL (status: withdrawn).

Technically, an album is a container (similar to a collection).

The difference between an album and a collection is that an album can have contributors and a collection must have a date created.

Data model[edit]

Faces studyset.jpg

Namespaces[edit]

Term URI http://purl.org/dc/terms/
Name dcterms:
Label Dublin Core terms

Syntax Encoding Scheme[edit]

String data type definition
Name <string>
Label Character string
Definition A string of ASCII characters. No formatting tags may be included. The following characters must be encoded for XML: '&' - '&'; '<' - '<'; '>' - '>'. A limited list of non-ASCII characters may be included encoded as character entities.


Describing an Album[edit]

Title[edit]

Term URI http://purl.org/dc/terms/title
Name title
Label Title
Defined by: -
DC Definition A name given to the resource.
DC Comment -
eSciDoc Definition The name of an album.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Mandatory
Condition -
Datatype string
Occurrence Min: 1; Max: 1;
Best practice -
Remakrs Related to "title" form ESciDoc Publication

Description[edit]

Term URI http://purl.org/dc/terms/description
Name description
Label Description
Defined by: -
DC Definition -
DC Comment -
eSciDoc Definition A short description of an album.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: 1;
Best practice -
Remakrs Related to "abstract" from ESciDoc Publication

Creator[edit]

Term URI http://purl.org/dc/terms/creator
Name creator
Label Creator
Defined by: -
DC Definition An entity primarily responsible for making the resource.
DC Comment Examples of a Creator include a person, an organization, or a service. Typically, the name of a Creator should be used to indicate the entity.
eSciDoc Definition The author of an album.
eSciDoc Comment For Faces, only persons are valid creators.
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Mandatory
Condition -
Datatype string
Occurrence Min: 1; Max: Unbounded;
Best practice -
Remakrs The first creator is always the owner of the item.

Related to "creator" from ESciDoc Publication

Organization[edit]

Term URI http://www.w3.org/2006/vcard/ns/org
Name org
Label Organization
Defined by: -
vCard Definition An organization associated with a person.
vCard Comment -
eSciDoc Definition The organizational unit the person was affiliated to when creating the album.
eSciDoc Comment -
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Mandatory
Condition The domain of the vCard:org property is the vCard:VCard class.
The range of the v:org property is the v:Organization class.
Datatype string
Occurrence Min: 1; Max: unbounded;
Best practice -
Remarks -

Contributor[edit]

Term URI http://purl.org/dc/terms/contributor
Name contributor
Label Contributor
Defined by: -
eSciDoc Definition The editor/contributor of an album .One or more account users who have the rights to edit an album.
eSciDoc Comment Only Contributers from the type Editor are allowed.
Type of term Property
Refines -
Refined by -
Encoding Scheme For -
Has Encoding Scheme -
Obligation Optional
Condition -
Datatype string
Occurrence Min: 0; Max: unbounded;
Best practice -
Remakrs Related to "contributor" from ESciDoc Publication

Related Application Profiles[edit]

eSciDoc

Faces