How it works/Semantic forms and structured data

Semantic data allow a data consumer to accurately retrieve data based on their semantic meaning. For instance, an internal search engine might serve all your pages marked as "article" to a user searching for articles created by your organization, or articles of a given author, written in a specific time frame, courses of a given languages, delivered by a specific teacher, and so forth.

In order to reach this purpose, we have created a rich set of semantic properties and forms (a form might be considered a container of a consistent set of semantic properties) which can be simply inserted in any wiki page, can be edited as a form therein, and which will transform an "anonymous" wiki page (or html page as soon as it is served) in a database of semantic contents which can be used in the most profitable ways.

For instance, if you create a wiki page describing one of your language courses for a given academic year, that information can be displayed within the main portal of this platform (or by whatever other data consumer which will query the APIs) within a list of available language courses, and to fuel interactive functions, for instance the purchase of a number of lessons by a student, a chat between a prospective student and school's manager, and more.

Here is the set of forms/templates available at present: a template is just the form by which a collection of semantic data is recorded within a wikipage, so a template is entirely sufficient for describing the data structure filled in by a given form.

Organization

This is the main form/data structure related to an organization. Some of the values foreseen by the template (like 'coordinates') will be automatically filled in by the related form, which you can find here. Managers of a given organizations can edit only the form related to their organization, once is created by an administrator following the application.

{{Form organization
|Name=
|Type=
|Logo=
|Country=
|Address=
|Coordinates=
|Foundation year=
|Email=
|Website=
}}

Article

Related form: Article. The forms intended to create articles of a given organization or to indicate as 'article' whatever sub-page of it. An article can be of type 'news', 'article' and 'post', and each kind foresees a different page's title (created automatically on form submission based on type, title and date).

{{Form article 
|Type=
|Title=
|Authors=
|day=
|month=
|year=
|Excerpt=
|Tags=
}}

Language course

Related form: Language course. The form intended to create language courses offered by a given organization or to mark whatever subpage of it as representing a language course. The "teachers" field is automatically filled in with the teachers created through the following form or indicated as such, of the organization to which the logged in user is affiliated.

{{Form language course
|Title=
|Language=
|Academic year=
|Description=
|Level=
|Teachers=
|Price=
|Dates and times=
|Contact email=
|Contact phone=
}}

Teacher

Related form: Teacher. The form intended to indicate language teachers of a given organization. "Taught languages" and "Spoken languages" contain the languages which the teacher is able to teach, and those in which is able to communicate. (both are a multiple select items). The form is currently used by the tool classes in order to relate classes of students recorded in a private wiki, with the public course information.

{{Form_teacher
|First name=
|Last name=
|Curriculum=
|Picture=
|Mother tongue=
|Taught languages=
|Spoken languages=
|In charge from=
|In charge to=
}}

Meeting

Related form: Meeting. The form intended to represent meeting of various kind (for instance presentations, workshops, exhibitions, cineforum, etc.) held at a given organization. The form foresee complementary records in the organization's private wiki with information about participants, in order to let participants of meeting retrieve their basic contacts of each other, once the meeting has ended.

{{Form meeting
|Title=
|Type=
|Date=
|Country=
|City=
|Address=
|Coordinates=
|Venue=
|Description=
|Webpage=
|Contact phone=
|Contact email=
}}

Organization member

Related form: Organization member. The form is intended to indicate the information publicly available about members of a given organization (e.g. board members). The email (if present) is meant to be public and might be in the format <first name.last name@culturaitaliana.org>

{{Form organization member
|First name=
|Last name=
|Picture=
|Curriculum=
|Affiliated from=
|Affiliated to=
|Email=
}}

Opportunity

Related form: Opportunity. This is among the form with data intended for the general audience of this platform, shown in the genera home page. Basically, affiliated members of any organization can insert information useful for everyone and they will be shown in the home page, and in the "advertisements" area of the page of a given organization on the front end, with a reference about the editor and the organization to which he or she is affiliated, so that (inasmuch as the related link will direct to their organization's page) encourage the insertion of such information.

{{Form opportunity
|Type=
|Title=
|Provider=
|Description=
|Target country=
|Funding information=
|Requisites=
|Url=
|Deadline=
|Deadline as soon as possible=
}}

Reading suggestion

Related form: Reading suggestion. As above: This is among the form with data intended for the general audience of this platform, shown in the genera home page and affiliated members of any organization can insert information useful for everyone and they will be shown in the home page, and in the "advertisements" area of the page of a given organization on the front end, with a reference about the editor and the organization to which he or she is affiliated, so that (inasmuch as the related link will direct to their organization's page) encourage the insertion of such information.

{{Form reading suggestion
|Book title=
|Book author=
|Reason=
|Book excerpt=
}}

Digital library

Related form: Digital library. As above: This is among the form with data intended for the general audience of this platform, shown in the genera home page and affiliated members of any organization can insert information useful for everyone and they will be shown in the home page, and in the "advertisements" area of the page of a given organization on the front end, with a reference about the editor and the organization to which he or she is affiliated, so that (inasmuch as the related link will direct to their organization's page) encourage the insertion of such information.

{{Form digital library
|Name=
|Logo=
|Description=
|Headquarters country=
|Books approximate number=
|Active from=
|Active to=
|Website=
|Opac url=
|Digital resource example url=
}}