Output Web service - CLOUD4All/GPII WIKI

voraciousdrabSoftware and s/w Development

Dec 14, 2013 (3 years and 3 months ago)

109 views








Cloud platforms Lead to Open and Universal access
for people with Disabilities and for All


ID203.2
.
Harmonization guidelines


Project Acronym

Cloud4all

Grant Agreement Number

FP7
-
289016


Deliverable No.

ID203.2

Work package No.

WP203

Work package Title

Federating Repositories of Solutions and
Components

Authors

Valerio Gower (FDCGO)

Status

Draft

Dissemination Level

Consortium

Delivery
Date

3
0
/
04
/
2012

Number of Pages

48






Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



2



Keyword List

Assistive Technology databases. Federation. AT Information providers. EASTIN network.

Version History

Table
1
. Version history

Revision

Date

Author

Organization

Description

1

26
/
02
/201
3

Valerio Gower

FDCGO

First draft

2

06/03/2013

Valerio Gower

FDCGO

Advanced draft

3

22/03/2013

Valerio Gower

FDCGO

More detail added

4

26/03/2012

Valerio Gower

FDCGO

Data structure for UL
added







Statement of originality

This
deliverable contains original unpublished work except where clearly indicated
otherwise. Acknowledgement of previously published material and of the work of others has
been made through appropriate citation, quotation or both.



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



3


Table of contents

Cloud platforms Lead to Open and Universal access for people with Disabilities and for All

...

1

ID203.2. Harmonization guidelines

................................
................................
............................

1

1

Executive Summary

................................
................................
................................
.............

7

2

Introduction
................................
................................
................................
.........................

8

3

The EASTIN harmonized data structure

................................
................................
..............

8

3.1

EASTIN Product dataset
................................
................................
................................

9

3.2

The vocabulary for product features

................................
................................
.........

10

3.2.1

Connection of the taxonomy items with ISO 9999 divisions
................................
.

12

3.2.2

EASTIN Subdivisions

................................
................................
...............................

13

3.2.3

Vocabulary management procedure

................................
................................
.....

13

4

Datasets of other databases of Assistive Technology

................................
.......................

14

4.1

OAEG
................................
................................
................................
...........................

14

4.2

AbleData

................................
................................
................................
.....................

15

4.3

OATSoft
................................
................................
................................
.......................

16

5

Web Service communication in the EASTIN system

................................
.........................

18

6

Preliminary data structure for the AT products in the Unified Listing

.............................

18

7

Communication between EASTIN and the Unified Listing

................................
................

20

7.1

Retrieving information from EASTIN
-

Output Web service

................................
......

21

7.2

Making the information included in the GPII Unified Listin
g available to the EASTIN
website


Input Web Service

................................
................................
................................

23

8

Conclusions
................................
................................
................................
........................

24

9

References

................................
................................
................................
.........................

24

10

Annex 1


The

vocabulary of the EASTIN taxonomy

................................
.........................

26

11

Annex 2


Specifications for the EASTIN Input Web services

................................
...........

31

12

Annex 3


Specifications for the Output Web Services

................................
....................

44




Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



4


List of Tables

Table 1. Version history

................................
................................
................................
..............

2

Table 2. List of abbreviations

................................
................................
................................
......

6

Table 3

................................
................................
................................
................................
........

9

Table 4 list of Titles included in the taxonomy

................................
................................
.........

10

Table 5


example of items in the vocabulary of the EASTIN taxonomy

................................
.

11

Table 6 example of relations

between taxonomy items and ISO divisions

.............................

12

Table 7

................................
................................
................................
................................
......

13

Table 8
-

dataset of the OAEG database

................................
................................
...................

14

Table 9


Classification of the OAEG database

................................
................................
.........

15

Table 10


dataset of the AbleData database

................................
................................
..........

16

Table 11


OATSoft dataset

................................
................................
................................
......

17

Table 12
-

OATSoft classification

................................
................................
...............................

17

Table 13


the multi layer structure for the Unified Listing Dataset
................................
........

19




Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



5


List of Figures

Figure 1


Exa
mple of a product description in the EASTIN portal

................................
............

9

Figure 2


model of an ICT based product
................................
................................
................

12

Figure 3 connection between EASTIN website and the databases of the information
providers

................................
................................
................................
................................
...

18

Figure 3


preliminary data structure for the AT products in the Unified Listing

....................

20

Figure 4


EASTIN


Unified Listing connection scheme

................................
..........................

20

Figure 5 Information flowing from the EASTIN database to

the GPII Unified listing

...............

22

Figure 6 connection of the Unified Listing database to the EASTIN network

..........................

24






Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



6


List of abbreviations

Table
2
. List of abbreviations

Abbreviation

Definition

AT

Assistive Technology

EASTIN

European Assistive Technology Information
Network

IAATIP

International Alliance of Assistive Technology Information Providers

ETNA

European Thematic Network on Assistive Information Technologies

GPII

Global Public Inclusive Infrastructure

API

Application Programming Interface

IPR

Intellectual

Property Rights

WS

Web Service

UL

Unified Listing





Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



7


1

Executive Summary

This deliverable is aimed at defining
two key elements for the federation of Assistive
Technology databases (WP 203):



definition of
an harmonized dataset for describing AT products within the Unified
Listing database;



definition of
the
technical specifications for the communication between the EASTIN
system and the Unified Listing database
.

T
he experience of the EASTIN network, that a
ggregates the contents of six databases on AT
products
,

represent
ed

t
he basis for the definition of
both

points listed above
.

....



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



8


2

Introduction

The Unified Listing of solutions for ICT access will be based upon a
federation of resources

(for details on th
e approach for the federation process see the deliverable
ID203.1). This
means that the
information included in the listing will be drawn fro
m many different source
databases

that
store the information in different ways

(i.e. using different platforms and
representing the data in different ways).
This calls for a process of harmonization and
integration of the information included in the different databases.

A core collection of
databases for the Unified Listing will be
the EASTIN network

(Andrich, 2011)
.

The objective of this deliverable is

twofold: on the one side

defini
ng the
dataset
for
describing AT products within the Unified Listing database
, taking into account the existing
dataset used in the
different federated

databases; and on the other side
defini
ng

the
technical specifications for the communication between the
federated databases
and the
Unified Listing.

The starting point for th
e

AT section of the Unified Listing will be
the EASTIN network that
aggregates t
he contents of
the following eight

national
databases on AT products
:



Portale SIVA (Italy) (
http://portale.siva.it/
)



Rehadat (Germany) (
http://www.rehadat.de/
)



HMI
-
Basen
(Denmark) (
http://www.hmi
-
basen.dk/
)



DLF Data (UK) (
http://www.dlf
-
data.org.uk/
)



Handicat (France) (
http://www.handicat.com/




Vl
ibank (Belgium) (
http://www.vlibank.be/
)



Catàlogo de Ayudas Técnicas (Spain) (
http://www.catalogo
-
ceapat.org/
)



Vlans
(Holland)
(
ht
tp://www.vilans.nl/
)

This deliverable is
one of the

outcome
s

of the activity A 203.1 “Approach and mechanism for
federating solution repositories while maintaining data source/credit” included in the WP
203 "Federating Repositories of Solutions and Components”

3

The EA
S
TIN

harmonized data structure

Since 2004, t
he pa
rtners of the EASTIN network have work
ed

together
to
harmonize
their
databases according to common requirements. The result of this work is the harmonized
data structure used to present the information in the EASTIN website
.




Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



9


The EASTIN Portal provides inf
ormation on the following three categories of resources:
Assistive Products, Organizations (Manufacturer/suppliers, Service Providers, Projects), and
Associated Information (Articles, Case Descriptions, Ideas, FAQs, Forums, News,
Regulations).
Recently,

w
i
thin a European funded project called
ETNA

(European Thematic
Network on Assistive Information Technologies)

(ETNA, n.d.)
, the EASTIN

data structure

has
been
improv
ed

by defining a
Taxonomy
1

for the description of
the three categories of
resources
mentioned above
.

In practical terms the EASTIN taxonomy is composed of
three

dataset
s (for AT products, Organizations, Associated Information) and a collection of terms
(i.e. a vocabulary) used for the description of the technical details of AT products.


Figure
1



Example of a product description in the EASTIN portal

Figure
1

present
s

an example of a produc
t
record included in the EASTIN portal
described
according to this new
T
axonomy.



3.1

EASTIN
Product
dataset

As shown in
Figure
1
, the EASTIN product dataset is composed of two parts: the basic
information and the technical details.
Table ... presents the information included in the
EASTIN product dataset.

Table
3

Field

Type

Product Name

String

Product Code

String (representing the unique ID in the information
provider DB)

Information provider

Custom type representing the information provider
(including name,
country,

contact information, ...)

Primary ISO code

Custom type representing the ISO code

Manufacturer info

Custom type representing the manufacturer
(including name,
country,

address
,

website,

...)




1

Within the scope of this deliverable, the term taxonomy is intended as

a structure for
identifying and naming
concepts and arranging them into classifications









Basic information









Technical details



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



10


Text description in original
language

String

Text description

in English

String

Thumbnail image

String representing the url

Large Image

String representing the url

Source webpage (in original
language)

String representing the url

Source webpage (in English)

String representing the url

Download or purchase
webpage (in original
language)

String representing the url

Download or purchase
webpage (in English)

String representing the url

Product state

Custom Enumeration type: Undefined; Active;
OutOfDate; Deleted

Insert Date

DateTime

Last update date

DateTime

Link
s

to further information

Array of custom type representing further
information url
s

Optional ISO codes

Array of custom type representing the ISO code
s

Product technical details

Array of Custom type representing the product
features

As shown in
Table
3
,
while the
basic information

is

made up of

a set of separate fields,
the
product
technical details

consist

of a single field that contains
of an array of
Features

selected among the
collectio
n
of all possible features
(i.e. the vocabulary)
identified in the
ETNA taxonomy
.


3.2

The v
ocabulary for

product features

For what concerns the product detailed dataset, t
he

EASTIN taxonomy can therefore be
basically seen as a
V
ocabulary

used to standardize the description of technical details. The
Vocabulary

is based on a two level hierarchy made up of
T
itles

and
F
eatures
. Groups of
homogeneous Features are clustered together under the same Title. For example the
Features “
Windows
”, “
Mac

OS
”, “
Linux
”, “
Chrome OS
” , etc... are all clustered under the
Title “Operating System”, while “
Printer
”, “
Visual display
”, “
Tactile display
”, etc... are
clustered under the Title “Output devices”.

Features can be of two types:
Measures
, that can
have a n
umeric value or an interval specified (e.g. weight, length, ....), and
Attributes
, that do
not have a specified value (i.e. are Boolean features). Overall 19 Titles and 266 Features have
been identified.

In
Table
4

all the Titles included in the current ETNA taxonomy are listed.

Table
4

list of Titles included in the taxonomy



Overall dimensions



Activation modalities



Browsers



Linguistic
representations



Input adjustments



Capacity/Range



Operating systems



Languages



Functionalities



Output devices



Energy type



Operating system versions



Visualization



Input devices



Output adjustments



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



11




Connectivity



Subdivisions



License



Price

Table
5

gives
an
example

of some

of the items included in the
Vocabulary

of the
EASTIN
taxonomy
.

The current

version of the complete vocabulary
is attached in Annex ....

Table
5



example of items in the vocabulary of the EASTIN taxonomy

Name

Type

Overall dimensions

Title

Width (cm)

Feature


Measure

Length (cm)

Feature


Measure

Height (cm)

Feature


Measure

Weight (kg)

Feature


Measure



...

Capacity / Range

Title

Magnification (x)

Feature


Measure

Number of keys

Feature


Measure

Number of input channels

Feature


Measure

Number of output channels/Devices

Feature


Measure

Signal range (m)

Feature


Measure



...

Output

Title

Speakers/headphones

Feature


Attribute

Printer

Feature


Attribute

Visual screen/display

Feature


Attribute

Tactile display

Feature


Attribute

Vibrator

Feature


Attribute

Voice synthesis

Feature


Attribute

….

...

The model that has been used for identifying the clusters of features of an ICT based product
(i.e. the Titles of the taxonomy) is represented in
Figure
2

The idea be
hind the model is that
in an ICT based product the following conceptual “elements” can be considered: Input,
Central Unit (for processing and storage), Output, Connectivity (with other products or
services), Environment

(in which the product operates), Phy
sical characteristics, and
Software characteristics.



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



12



Figure
2



model of an ICT based product

3.2.1

Connection of the taxonomy items with ISO 9999 divisions

A mechanism has been created to put the items of the
vocabulary
in relation with the
divisions (i.e. the product categories) identified by the ISO 9999 standard
(ISO, 2011)



that
defines a three level hierarchical classification of assistive products for persons with
disability. A matrix has been created to indica
te,
for each of the item in the vocabulary
, the
“relevance” for the ISO 9999 divisions.
Currently a
subset of 38 ISO divisions ha
s

been
considered (
including
those more strictly related to ICT products). The relevance of a
vocabulary
item for each of the ident
ified ISO divisions is evaluated by means of a 5
-
points
scale (1 ‘absolutely irrelevant’ to 5 ‘absolutely relevant’). For instance, for the ISO division

22.36.18 Input Software
”, the item “
Width (Overall dimensions)
” is ranked “1” while item

Acceleromete
r (Input Devices)
” is ranked “3” and item “
Windows (Operating Systems)
” is
ranked “5” (
Table
6
).

Table
6

example of relations between taxonom
y items and ISO divisions

ISO divisions


Taxonomy items

22.36.03
Keyboards

22.36.18 Input
Software

22.39.12
Special output
software




Width (Overall dimensions)

5

1

1



Windows (Operating
Systems)

4

5

5



Accelerometers (Input
devices)

3

3

1



...









One of the advantages of this approach, is related to the possibility of presenting, in a data
entry form, the taxonomy items ordered by relevance with respect to the specific product
category (for example when data of an on screen keyboard are entered int
o a database the


Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



13


items related to the supported operating systems are presented before the items related to
the input devices, while the items related to the dimensions are not presented).

3.2.2

EASTIN Subdivisions

As part of the Taxonomy a list of product typologies have also been identified. Those
typologies are intended to be a refinement of some of the divisions included in the ISO 9999
standard and are therefore called Subdivisions in the
EASTIN

Taxonomy. Simila
rly to the ISO
9999 standard, each subdivision has a code, a title, and an explanatory note. For example
the Subdivisions identified within the ISO division “22.39.12


Special output software” are
reported in
Table
7

Table
7

Code

Title

Explanatory note

ISO 22.39.12

Special output
software

Included are, e.g., software that enlarges the
text and graphics displayed on a computer
screen, software t
hat reads the display and
converts it to speech (screen reader).

223912.01

Magnifying software

Software that enlarges the text and graphics
displayed on the screen of a computer or other
electronic devices. May feature screen reading,
colour choice and
focus enhancement etc.

223912.02

Screen reader
software

Software that interprets what is being displayed
on the screen and presents it to the user with
text
-
to
-
speech, sound icons, or a Braille output
device.

223912.03

Software for
adjusting color
combination and
text size

Software that allows adjusting the color of text,
background, images and other elements
displayed on the screen, and/or to adjust the
font size, to improve visualization.

223912.04

Software to modify
the pointer
appearance

Softw
are to modify the size, color, and/or
shape of the pointer on the screen

3.2.3

Vocabulary management procedure

The vocabulary of EASTIN taxonomy is not intended to be static but dynamically changing
.
New items can in fact be added to the
vocabulary

(both titles and features) if they are
needed. For instance, a new operating system appearing on the market will require that a
new item is introduced under the Title “operating system” in order to describe products
compliant with it; likewise, a new inno
vative product may not fit in any of the current
EASTIN
subdivisions, thus a new subdivision should be created. A consensus procedure for
deciding on the introduction of new items in the taxonomy has been defined. The procedure
foresees the involvement of
the Online Community that will be established within the
ATIS4All project

(ATIS4All, n.d.)



a sister network of the ETNA thematic network
-

that will
include all the stakeholders of the ICT AT field (end users, manufacturer, researchers,
developers, AT pr
ofessionals, ....). The proposal to create a new item will be discussed online


Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



14


and eventually submitted for voting by authorised members of the Community. If the vote is
successful, the new item is entered in the taxonomy by an administrator of the ETNA
in
formation system.

A number of experts, selected within the online community, will also have the possibility to
decide on the “relevance” of the taxonomy items for the different ISO divisions by means of
a 5
-
points scale (as described above).

4

D
atasets
of
other
databases of Assistive Technology

In the following
paragraphs

the
data structure

of
other

AT
datab
ases

that
are not currently
included in EASTIN
are reported.
C
ontacts have been started
with the organizations
responsible for those databases, in order
to include them in the
EASTIN
network.

4.1

OAEG

The key industrial partners of the AEGIS consortium
, a European Funded project (AEGIS,
n.d.)
, together with users’ representatives and the active s
upport of the Scientific Advisory
Board have developed an Open Accessibility Everywhere Group (OAEG) with the aim to
promote the uptake of the AEGIS accessibility open source solutions through a coherent set
of incentives and ultimately standardisation, an
d maintain and upgrade the AEGIS Open
Accessible Framework and the individual open source software resulting from the project,
after the project’s lifetime.

The OAEG website
2

includes
informa
tion on accessibility
standards, a

blog aggregator
, and a R
eposit
ory of open source A
T software
and resources for
development
. The dataset of the software repository is reported in
Table
8

Table
8
-

dataset of

the OAEG database

Field

Ex
ample

Title

of the prototype

Enable Viacam

Developer(s) contact details

Cesar Mauri
-

Sant Isidre 4
-

43120 Spain
-

cesar@crea
-
si.com

Entity

(organization the developer belongs to)

CREA Software Systems

Release

(version)

1.4

Date of current release

15/11/2010

Authoring rights

(c) Cesar Mauri Loba

Short description

Enable Viacam (aka eViacam) is a mouse
replacement software that moves the pointer as you
move your head....

Long description

Enable Viacam can be used as a full

alternative or as
a complement to a conventional computer mouse. It
is especially useful for people with motor
impairments in their hands or their arms...

Target groups


Moderate restriction on hand use, Severe or



2

http://www.oaeg.eu/




Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



15


complete restriction on hand use

Links

https://sourceforge.net/project/showfiles.php?grou
p_id=248049

SVN link

http://sourceforge.net/projects/eviacam/files/

Type of software

Accessible
applications
-

OAF Step 5
-

Use
-

Outside
AEGIS

Assistive Technologies and support libraries
-

OAF
Step 6
-

Use
-

Outside AEGIS

ISO 9999 classification code

22.36.18
-
Input software


The
elements in the
fields “target groups”
and “type of software” are

selected from the list
s

of pre
-
defined
elements reported in the table below
:

Table
9



Classification of the OAEG database

Target groups

Type of software



Partly sighted



Blind



Dexterity difficulties or slight restriction on
arms
or hands




Moderate restriction on hand use



Severe or complete restriction on hand use



Slight cognitive limitation and low support
need



Moderate and severe cognitive limitation and
medium and high support need



Slight or moderate hearing limitation



Severe li
mitation or total deafness



Aphasia, loss of the ability to produce and/or
comprehend language



Stuttering & Dysarthria
-
motor speech disorder



Web developers



Developers of ICT infrastructure, applications
and services



Definitions of accessibility
-

OAF Step 1

-

Creation



Stock elements
-

OAF Step 2
-

Creation



Developer and Authoring tools
-

OAF
Step 3
-

Creation



Platform support
-

OAF Step 4
-

Use



Accessible applications
-

OAF Step 5


Use



Assistive Technologies and support
libraries
-

OAF Step 6
-

Use



Test
tools

4.2

AbleData

AbleData

is a website
3
, based in the U
nited
S
tates
, that

provides objective information on
assistive technology and rehabilitation equipment available from domestic and international
sources to consumers, organizations, professionals, and c
aregivers within the United States.
AbleData's most significant resource is the AbleData database of assistive technology, which
contains objective information on almost 40,000 assistive products

(Lowe, 2011)
. For each
product, a detailed description
is pr
ovided
of the product's functions and features, price
information (when available), and contact information for the product's manufacturer
and/or distributors.




3

http://abledata.com



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



16


In the table below the dataset of the AbleData product database is reported

Table
10



dataset of the AbleData database

Field

Example

Product name

FamilyLink

Text description

FamilyLink is a tablet computer with a touch screen
with an attachable keyboard and a home emergency
monitoring system designed to provide the means
...

Consumer reviews


Notes

Price does not include a $19.95 monthly service fee.

Price

699.00

Record update date

This product record was updated on March 14,
2013.

Manufacturer name

iKare Network Corporation

Manufacturer address

44110 Ashburn
Shopping Plaza

Suite 227

Ashburn, Virginia 20147

United States

Manufacturer telephone

888
-
411
-
4909

Manufacturer web site

http://www.familylink.net
.

Manufacturer email

sales@ikarenetwork.com
.

AbleData Product Categories

Computer with Touch Screen; Prompter; Video
Telephony Program; Electronic Mail Program; …

Image

http://www.abledata.com/product_images/images/
14A0484.png

The products listed in the AbleData database of assistive technology are currently classified
according to the AbleData classification structure (field “
AbleData Product Categories” in the
table above)
. Such classification include

20 functional

areas. Each

area is divided into
categories, each of which may have up to three levels of

subcategories within them. Within
each of the lowest level subcategories, there are

multiple specific product types, which are
called

generic terms

(Lowe, 2011)
4
.
A mapping between
AbleData generic terms
and the
divisions of the ISO 9999 standard is available on the AbleData
website.

4.3

O
ATS
oft

The objective of the OATSoft website
5

(Open Source Assistive Technology Software) is to
provide a one
-
stop “shop” for end user
s, clinicians and open
-
source developers to meet,
exchange notes, promote new ideas, develop new software
.
OATSoft include a repository of
freeware and open source assistive technology software.

In the table below the dataset of the OATSoft product databa
se is reported




4

See the website
www.abledata.com

for the full list of
generic terms

5

http://www.oatsoft.org/



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



17


Table
11



OATSoft dataset

Field

Example

Software name

Special Access To Windows

Short description

Free software that enables Windows to be
controlled by one or two switches, a trackerball or a
headpointer. A new
SAW 6 version
-

supported by
the AEGIS project...

Latest release

Special Access To Windows 6.01.360

Long description

or the switch user, accessing the essentially mouse
-
driven Windows environment appears to be a
formidable task. Not any more. Introducing

SAW5....

OATS function categories

On Screen Keyboard Projects; Text to Speech;
Computer Automation; Switch Input Software;
Alternative and Augmentative Communication;
Educational and Learning

OATS need categories

Text input Projects;
Communication
;

Usin
g the
Mouse
;

Alternative Access

Help page (documentation)

http://acecentre.org.uk/

Download page

http://www.oatsoft.org/Software/SpecialAccessTo
Windows/downloads

Product rating

Rating of the product on a 5 points scale

Roadmap


Project home page

http://acecentre.org.uk/

Contact address

info@email.com

I
mage

http://www.oatsoft.org/Software/SpecialAccessTo
Windows/downloads/6.01.360/screenshot/
...

The elements in the fields “
OATS function categories
” and “
OATS
need categories
” are
selected from the lists of pre
-
defined elemen
ts reported in the table below.
A mapping
between the categories in the table above and the ISO 9999 classification is currently under
development.

Table
12
-

OATSoft
classification

OATS function categories

OATS need categories



On Screen Keyboard Projects



Symbol Library



Text to Speech



Computer Automation



Switch Input Software



Alternative and Augmentative Communication



Environmental Control



Educational and Learning



General Tools



Other function



Text input Projects



Communication



Using the Mouse



Viewing the screen



Accessing the Web



Symbols



Alternative Access



Learning and Education



General Tools



Other need



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



18


5

Web

S
ervice communication in the EASTIN system

The communication between the EASTIN search engine and the databases of the
information providers is ensured by
Web Services
.
Those web services, used to provide data
in input to the EASTIN system, are called
Input Web Services

(to distinguish them from th
e
Output Web Services, described in the following, that are used to export data from EASTIN).
The EASTIN
Input

Web Service Client

sends a request to all the
Input

Web Services Server

of
the information providers that retrieve the data from the databases an
d send it back to the
EASTIN website (
Figure
3
).

Figure
3

connection between EASTIN website and the databases of the information providers


The EASTIN system currently uses the
XML
-
SOAP 1.2

protocol

for input web services
.
The
current version of the input web service specification is includ
ed in

A
nnex 2



Specifications
for the EASTIN
Input W
eb services

6

Preliminary d
ata structure

f
or the

AT product
s

in
the

Unified Listing

In order to have a

lossless


storage of

information coming from different databases, the
dataset representing the AT products in the Unified Listing has to include the
union of the
fields of the source databases.
On the other hand, to avoid redundancy of fields representing
the same data
, a “co
nversion


will be
done
to map similar concepts represented by fields

with different names

in different databases (for example the “
manufacturer
name” field
EASTIN databases is conceptually the same as the
field

entity
” in the
OAEG
database).


In the
Unified Listing database each record will be represented by a “multi layer”

structure

(
Table
13
)
:

there will be a layer for storing the
product description

of each of
the
source
databases and
a
layer for the product description of the GPII Unified Listing

as well as each
available translation of each database
.

Specific product settings will also be
part of

the
record
.
There will also be a “unique product ID” that will
allow the U
nified
L
isting

to track


Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



19


the same product coming from different databases


and different versions of the same
product.



Table
13



the multi layer structure for the Unified Listing Dataset

GPII global unique product
sync

number

5475

GPII Product Name

Dasher

GPII Manufacturer Name

Cavendish Labs
-
Inference group

GPII Description

Dasher is a special on screen keyboard that….

...

...

Information Provider (name
-
country)

EASTIN
-
SIVA (IT)

EASTIN
-
HMI (DK)

AbleData (US)

Product Name

Inference group Dasher

Dasher

Dasher

Product Code

(in info prov.

DB
)

15478

5478

487

Primary ISO code

22.36.18 Input Software

22.36.18 Input Software

-

Manufacturer info

The Inference group

Cavendish laboratory

Inference group

Text
description in original
language

Dasher è un software gratuito
che permette di scrivere…

Auf dem Bildschirm erscheint
ein vertikal angeordnetes...

Dasher is a text entry system…

Image



-

...







Specific Settings

Setting name


values

Font size



10
-

38 pt


Scanning speed


slow, medium, fast

Voice output


on; off

...

...

The preliminary dataset for AT products in the Unified Listing is represented in
Figure
4
. Each
product
record is made up of a single
GPII
product info, N original source product info, and a
single specific setting file.



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



20



Figure
4



preliminary data struc
ture for the AT products in the Unified Listing

7

C
ommunication between EASTIN
and the Unified Listing

A
bidirectional
communication
between EASTIN network and GPII Unified Listing will be
established in such a way
to allow

the users of the
GPII Unified
Listing web portal

to

access
information coming from the EASTIN databases, and us
ers of the EASTIN Web Portal to

access information coming from the GPII Unified Listing.

The overall connection scheme is
depicted in
Figure
5


Figure
5



EASTIN


Unified Listing connection scheme

As already described above, the EASTIN search engine

provides a
specific set of APIs
to
receive input data fr
om the EASTIN information providers

(online databases) and make
them visible in the EASTIN portal.
The EASTIN search engine calls a set of Web Services that
must be implemented by any information provider that aims to send data to the engine.


Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



21


Both the Web
Service functions and the exchanged data format have been standardized by
the EASTIN consortium and these standards must be followed by the external information
provider
s

(see
technical
specifications in
A
nnex 2



Specifications
for the EASTIN
Input W
eb
services
)
.

As already stated above those web services are called
Input Web Services

To

provide data

retrieved by the EASTIN search engine

from the EASTIN databases

to the
GPII Unified Listing, a specific set of Web Services will be implemented within the Cloud4all
project that contains functions to extract data using the EASTIN search engine.

These Web
Services will be exposed by the EASTIN search engine and will be

accessed by a specific
application aimed at collecting the data retrieved from EASTIN into the GPII Unified Listing
database.


It is worth noticing that,
since

the data source is marked when a search is carried
out, the fact that the GPII Unified Listing
will be part of the EASTIN network will not cause a
problem since the data received by GPII Unified Listing from the GPII Unified Listing (Because
because it is part of the EASTIN network) can be
filtered out
.

In the following those Web
Services will be ca
lled
Output Web Services
.

In the following chapters the

details of

input and output Web services
are described

7.1

Retrieving information from EASTIN

-

Output Web service

The process of getting the information from the EASTIN databases, in order to store it in the
GPII Unified Listing, is the following (see
Figure
6
):

1.

The

GPII

Output W
eb Service

Client
sends a query to the EASTIN
Output Web Service
Server

2.

The EASTIN search engine
i
n turn sends the request to all the information providers
(using the
Input Web Service Client
)

3.

The information providers answer the request with the list of
products (using the
Input
Web Service Servers
)

4.

The search engine send
s

the list back to the GPII Unified Listing database (using the
Output Web Service

Server
)

5.

Retrieved information is
validated
6

and stored in the
Unified Listing Database




6

See the wiki page
http://wiki.gpii.net/index.php/Unified_%28Federated%29_Listing_validation_procedure

for
details on th
e validation procedure



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



22


Figure
6

Information flowing from the EASTIN database to the GPII Unified listing


Since the scope of the EASTIN databases is broader than just ICT assistive devices, the query
sent by the GPII Unified Listing will be restricted to Assis
tive products for ICT access. This
filtering
7

will be done on the basis of the
EASTIN Classification of Assistive Technology

based
on the ISO 9999 standard

(ISO 9999, 2011)
.

The procedure described above will be used to initially populate the database of t
he Unified
Listing and will be repeated periodically to keep the list updated. Of course in the following
queries only updated records and new records will be
considered

(this will be based on the
“last update date” information included in each record)
. The time period for repeating the
query will be initially set to
two weeks

and will be adjusted on the basis of the number of
new record and updated record retrieved in each query.

The specifications for the Output Web Services are included in
Annex 3


Specifications for
the Output Web Services
.
Those Web Services
will be

based on the
JSON REST
protocol.

The

output web service server will implement t
wo methods:



FindProductsSortBySimilarity
:
This method is used to search for products in the
databases of the EASTIN network according to the specified parameters (e.g. ISO
code, Commercial Name, Manufacturer Name,…). The method returns an
array

of
“BasicP
roductInfoDto”, a custom data type including the
basic product information

(see the specifications in Annex 3 for details)



GetProduct
: this method returns the detailed information of a specific product. The
methods requires as input parameters the
ProductCode and RepositoryCode

(i.e the
name of the database where the product comes from)
.




7

For details on the ISO codes that will be included see the wiki page
:

http://wiki.gpii.net/index.php/Unified_%28Federated%29_Listin
g_validation_procedure




Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



23


On the GPII Unified Listing side

a set of
Output Web Service C
lient

will be implemented
that will call the two methods above. In particular, to populate the Unified Listing
database, the
Output Web Service Client

will implement a routine that calls the
FindProductsSortBySimilarity

method passing as input parameters a spec
ific set of ISO
codes (those that include ICT AT products
8
). For each of the product returned by the
FindProductsSortBySimilarity

method, the web service client will then call the method
GetProduct

to get the product detailed description.

7.2

Making the
information included in the GPII Unified Listing
available to the EASTIN website



Input Web Service

For the inverse process, i.e. for making the information included in the GPII
Unified Listing

available to the EASTIN website, GPII
will

become one of the

Information provider of the
EASTIN network. In order to plug the GPII
Unified Listing

to EASTIN search engine, a specific
Input Web Service (Server)
will

be implemented following the technical specification already
in place for the other databases partici
pating into the network

(
Figure
7
)
. This requires that
the GPII
Unified Listing

provides

data

in a form that is

compliant with the EASTIN standard.

The Input Web Servi
ce specifications are included in
A
nnex 2



Specifications
for the EASTIN
Input W
eb services
.
Those Web Services are based on the
XML
-
SOAP 1.2

protocol.

Three methods

has to be implemented to comply with the specifications:



integer
GetIsoClassProductCount

(
s
tring

isoCode)
:
returns the number of

products
,

present in the partner database,
belonging to the ISO class passed as a string
parameter to the method



SmallProductD
to
[]

FindSmallProducts

(
s
tring
[]

isoCodes
,

FeatureDto
[]

features
,

s
tring

commercialName,
s
tring

manufacturer,
d
ateTime

insertDateMin
,
d
ateTime

insertDateMax
)
: returns an array of “SmallProductDto”, a custom data type including
the basic product information according to the EASTIN standard (see
A
nnex 2



Specifications
for the EASTIN
Input W
eb services



for more details).



ProductDto

GetProduct
(
s
tring

productCode
)
:
returns the detailed information of a
specific product

(for more information about the ProductDto custom data type see
A
nnex 2



Specifications
for the EASTIN
Input W
eb services
)




8

The detailed list of ISO codes that include ICT products is available on the Cloud4all wiki page:
http://wiki.gpii.net/index.php/Unified_%28Federated%29_Listing_validation_procedure#3._Inclusion.2Fexclusi
on_criteria




Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



24


Figure
7

connection of the Unified Listing database to the EASTIN network


8

Conclusions

In order to federate
different databases of AT products
,

to

create a Unified Listing
of solution
to ICT access, an harmonized data structure should be defined. A strong starting point for
this is the EASTIN data structure that defines the sets of fields needed to describe AT
p
roducts. Within the Cloud4all project, in synergy with the ETNA project, the EASTIN data
structure is currently under improvement to include more detailed description of ICT based
AT products.


....

9

References

(2011
).
ISO

9999:2011
.

Assisitive products for

person with disability


Classification and terminology
.

Standard.

Andrich, R. (2011). Towards a global information network: the European Assistive Technology
Information Network and the World Alliance of AT Information Providers. In: G.J. Gelderblom
et a
l. (Eds),
Everyday technology for independence and care

(pp. 190
-
197).
Amsterdam:
IosPress.

ATIS4all
project
. (n.d.). Retrieved
September

18
, 2012, from
http://www.atis4all.eu/

ETNA
project
. (n.d.). Retrieved
September

18
, 2012, from
http://www.etna
-
project.eu/

AEGIS
project
. (n.d.). Retrieved

March 26
, 201
3
, from
http://www.aegis
-
project.eu/




Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



25


Lowe
,
S
.

W.
(2011).
AbleData.com’s Leap into the Future
.
In: G.J. Gelderblom et al. (Eds),
Everyday
technology for independence and care

(pp. 198
-
204
). Amsterdam: IosPress.






Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



26


10

Annex 1


The

vocabulary of the

EASTIN taxonomy

ID

name

type

1

Overall dimensions

title

2

Width
(cm)

measure

3

Length (cm)

measure

4

Height (cm)

measure

5

Weight (kg)

measure

6

Capacity/Range

title

7

Magnification (x)

measure

8

Number of keys

measure

9

Number of input channels

measure

10

Number of output channels/Devices

measure

11

Signal
range (m)

measure

12

Energy type

title

13

Battery
-

disposable

attribute

14

Battery
-

rechargeable

attribute

15

Mains electric

attribute

16

Power via USB

attribute

17

Activation modalities

title

18

Electro Myo Graphic Signal (EMG)

attribute

19

Eye
blink

attribute

20

Acoustic

attribute

21

Eye gaze

attribute

22

Voice Recognition

attribute

23

Mechanical (push, pull, grasp,…)

attribute

24

Sip/Puff

attribute

25

Inclination

attribute

315

Operating systems

title

316

Windows

attribute

317

Mac OS

attribute

318

Linux

attribute

319

Chrome OS

attribute

320

iOS

attribute

321

Android

attribute

322

Windows mobile/phone

attribute

323

Symbian

attribute

26

Operating system versions

title

27

Mac OS X

attribute

28

Mac OS 9

attribute

29

Mac OS 8

attribute

30

Windows 8

attribute

31

Windows 7

attribute

32

Windows Vista

attribute

33

Windows XP

attribute

34

Windows 2000

attribute

35

Windows 98

attribute

36

Windows 95

attribute

37

iOS 6.x

attribute

38

iOS 5.x

attribute

39

iOS 4.x

attribute

40

iOS 3.x

attribute

41

iOS 2.x

attribute

42

iOS 1.x

attribute

43

Android 4.x

attribute

44

Android 3.x

attribute

45

Android 2.x

attribute

46

Android 1.x

attribute

47

Windows phone 8

attribute

48

Windows phone 7

attribute

49

Windows mobile 6

attribute

50

Windows mobile 5

attribute

51

Windows mobile 2003 SE

attribute

52

Linux Ubuntu

attribute

53

Linux Fedora

attribute

54

Linux Redhat

attribute

314

Linux Debian

attribute

313

Linux SUSE

attribute

57

Browsers

title



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



27


58

Chrome

attribute

59

Firefox

attribute

60

Internet Explorer

attribute

61

Safari

attribute

62

Opera

attribute

63

Languages

title

64

Danish

attribute

65

Dutch

attribute

66

English

attribute

67

French

attribute

68

German

attribute

294

Greek

attribute

295

Italian

attribute

296

Portuguese

attribute

297

Spanish

attribute

298

Bulgarian

attribute

299

Czech

attribute

300

Estonian

attribute

301

Finnish

attribute

302

Hungarian

attribute

303

Latvian

attribute

304

Lithuanian

attribute

305

Maltese

attribute

306

Norwegian

attribute

307

Polish

attribute

308

Romanian

attribute

309

Slovak

attribute

310

Slovenian

attribute

311

Swedish

attribute

69

Visualization

title

70

Black/white display

attribute

71

Colour display

attribute

72

3D

attribute

73

Linguistic
representations

title

74

Sign language

attribute

75

Braille

attribute

76

Alphabetic

attribute

77

Symbolic

attribute

78

Simplified

attribute

89

Functionalities

title

90

Word prediction

attribute

91

Word completion

attribute

92

Spell correction

attribute

93

Abbreviation expansion

attribute

94

Highlights each word/sentence as it is read aloud

attribute

95

Allows creation of macro function

attribute

96

Programmable/configurable

attribute

97

Calendar function

attribute

98

Reminder

attribute

99

Environmental control

attribute

100

Portable

attribute

101

Built
-
in microphone

attribute

102

Speech or acoustic signals on menus

attribute

103

Switch controlled scanning

attribute

104

Input devices

title

105

Joystick (direct)

attribute

106

Joystick (switch)

attribute

107

Keys/keyboard

attribute

108

Chording keyboard

attribute

109

Mouse

attribute

110

Speech recognition

attribute

111

Switch

attribute

112

Touch screen

attribute

113

Track pad (touch pad)

attribute

114

Trackball

attribute

115

Movement tracking system

attribute

116

Eyegaze control system

attribute

117

Video camera/webcam

attribute

118

Microphone

attribute

119

Accelerometer

attribute

120

Biosignals sensor (EMG, EOG, EEG)

attribute



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



28


121

Input adjustments

title

122

Speed

attribute

123

Controls/keys activation delay

attribute

124

Type of scanning

attribute

125

Sensitivity

attribute

126

Scanning speed

attribute

127

Size of controls/keys

attribute

128

Number of controls/keys configuration

attribute

129

Font size
on controls/keys

attribute

130

Colour of controls/keys

attribute

131

Filter on repeated activations

attribute

132

Key repeat rate

attribute

133

Microphone volume

attribute

79

Output devices

title

80

Speakers/headphones

attribute

81

Printer

attribute

82

Visual screen/display

attribute

83

Tactile display

attribute

84

Vibrator

attribute

85

Voice synthesis

attribute

86

Recorded sound

attribute

87

Environmental control devices

attribute

88

Haptic device

attribute

134

Output adjustments

title

135

Enlargement/zoom

attribute

136

Font size

attribute

137

Contrast

attribute

138

Colours

attribute

139

Image reversal

attribute

140

Equalization control

attribute

141

Volume

attribute

142

Sound feedback

attribute

143

Connectivity

title

144

PS2

attribute

145

Serial

attribute

146

USB

attribute

147

Bluetooth

attribute

148

Infrared

attribute

149

Jack (specify size) (mm)

attribute

150

Other wireless

attribute

151

WiFi

attribute

152

Cloud or internet based application

attribute

153

Induction
loop

attribute

154

Inductive coupling

attribute

155

Bluetooth A2DP compatible

attribute

156

Bluetooth
-

not A2DP compatible

attribute

157

License

title

158

Free software

attribute

159

Proprietary

attribute

160

Price

title

161

Free of charge

attribute

162

Bundled with operating system

attribute

163

Subdivisions

title

164

Stationary image
-
enlarging reading apparatus

attribute

165

Stationary image
-
enlarging reading apparatus with connection units for computers

attribute

166

Portable
image
-
enlarging reading apparatus

attribute

167

Accessories for image
-
enlarging reading apparatus

attribute

169

Concha/in
-
the
-
ear hearing aids

attribute

170

Completely in
-
the
-
canal hearing aids

attribute

172

Behind
-
the
-
ear hearing
-
aids

attribute

173

Power behind
-
the
-
ear hearing
-
aids

attribute

175

Voice amplifiers for personal use

attribute

177

Electric typewriters without memory

attribute

178

Electric typewriters with memory

attribute

179

Braille typewriters

attribute

180

Stenotype machines

attribute

181

Electric Braille typewriters

attribute

183

Word
-
processing software

attribute

184

Desktop publishing software

attribute

186

Equipment for recording and/or replaying digital books

attribute

187

Digital note recorders

attribute



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



29


188

Cassette recorders

attribute

189

Accessories for recording and/or replaying sound

attribute

191

Real time captioning systems

attribute

192

Delayed captioning systems

attribute

193

Captioning services

attribute

195

Infrared (IR) systems for audio
information

attribute

197

Induction
-
loop amplifiers

attribute

198

Small induction
-
loop amplifiers

attribute

199

Induction
-
loops

attribute

201

Symbolic voice output communication devices

attribute

202

Alphabetic communication devices

attribute

204

Face
-
to
-
face communication software

attribute

205

Tools for developing grids for communication software

attribute

207

Mobile telephones

attribute

209

Telecommunication and telematics software

attribute

210

Voice over IP Services

attribute

212

Indicators with visual signal

attribute

214

Indicators with acoustic signals

attribute

216

Indicators with mechanical signals

attribute

218

Calendar software

attribute

219

Electronic calendars

attribute

221

Memory support products

attribute

223

Registration of persons without identification

attribute

224

Remote video monitoring systems

attribute

225

Satellite navigation systems

attribute

227

Digital documents readers

attribute

228

Digital document reading (text to speech) service

attribute

230

Paper documents reading devices

attribute

231

OCR software

attribute

232

Portable scanner with electronic dictionary

attribute

234

Braille note taking devices

attribute

236

Software interfaces for computers and mobile devices

attribute

237

Operating systems

attribute

239

Web browsers

attribute

241

Keyboards with a special design

attribute

242

Programmable (concept) Keyboards

attribute

243

Keyboard shields and keyboard gloves

attribute

244

Programmable keyboard configuration tool

attribute

246

Software for accessing the computer in scanning mode

attribute

247

Eyegaze systems

attribute

248

Speech recognition software

attribute

249

Optical scanner, stationary

attribute

250

Optical scanner, hand held

attribute

251

Datagloves

attribute

252

EEG, EOG or EMG controlled input devices

attribute

254

Switch interface

attribute

255

Accessories for input devices

attribute

257

On screen keyboards

attribute

258

Mouse control software

attribute

259

Word prediction and word
termination software

attribute

260

Software for adjusting input devices response

attribute

261

Software based electronic dictionaries

attribute

262

Computer based sound collections

attribute

264

Touch screens

attribute

265

Trackballs, mousetrappers
and touchpads

attribute

266

Traditional mouse devices and pen mouse devices

attribute

267

Joystick mouse device

attribute

268

Switch operated computer mice

attribute

269

Computer and console joysticks

attribute

271

Computer monitors

attribute

272

Screen filters

attribute

274

Braille displays

attribute

276

Speech synthesizers

attribute

278

Magnifying software

attribute

279

Screen reader software

attribute

280

Software for adjusting color combination and text size

attribute

281

Software to
modify the pointer appearance

attribute

283

Single switches (switches with only one function)

attribute

284

Two
-
four function control switches

attribute

285

Five
-
or
-
more
-
function
-
contacts

attribute

287

Remote controller

attribute



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



30


288

Receiver unit for

environmental control

attribute

289

Switch latches and timers

attribute

291

Environmental control software

attribute

293

Software for composing music

attribute

312

Body movement controlled mice

attribute






Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



31


11

A
nnex 2



Specifications
for the EASTIN
Input W
eb
services

EASTIN Input Web services specs

version 4.1

In EASTIN
Input Web services

there are two groups of Web methods: the batch methods
and the live ones. Batch methods are invoked by automatic processes which run in EASTIN
central server and are used to update some almost
-
static information inside the EASTIN
Portal (for example the I
SO tree, the keyword lists, etc.). These methods are called with
different frequencies (from once a day to once a month), depending on how often the
retrieved information content is supposed to change inside each EASTIN partner’s local
system. For example
the method which returns the description of ISO classes, used to
update the ISO

classification

tree in EASTIN Portal, is called once a month, because the ISO
classification is supposed to be almost constant
9
. Instead the method which returns the
number of
products for a given ISO class is invoked once a day because new products could
be often added inside the EASTIN partners’ local systems.

On the other side live methods are invoked directly by the end users through the EASTIN
Portal Web pages and they retu
rn the results of searches inside EASTIN partners’ databases
about products, actors (also called “organisations” in the EASTIN Web pages), and associated
information.


In the following description the name of basic data types derives from the SOAP


XML
Sc
hema Definition standard (XSD). Each partner must cast these types to the specific types
of the language/platform adopted to implement the
Input
Web services.



Batch methods

integer
GetIsoClassProductCount
(
string

isoCode)

Input parameters
:



string

isoCode:

a string representing a single ISO class (for example “12.22”).

Returns:



integer
representing the number of products contained in the ISO class passed in the
input parameter. Returns zero if no product belongs to the ISO class.

Frequency:



Once a day; the

first call to the Web method is executed at any moment between
04.00 AM (GMT +1:00) and 04.59 AM (GMT +1:00). The time at which the last call is
executed is not defined.




9

Please note that not all the partners have to implement all the batch methods. The method that returns the
description of the ISO 9999 classification, for example, has to be implemented only by a
a restricted set of
authorized partners, responsible for p
roviding the localization in different languages of the ISO 9999
classification
.



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



32



This is a batch method which returns the number of products belonging to the ISO cla
ss
whose ISO code is passed as a string parameter to the method. If no product belonging to
the ISO class is found the method returns zero. The method is designed to work in batch
mode. Once a day the ISO classification tree which is stored in the EASTIN c
entral repository
is visited by the batch process and for each node which is a leaf of the ISO tree the method is
called, passing the ISO code of that node as parameter (so the number of calls to the Web
method is equal to the number of leaf nodes of the E
ASTIN ISO classification tree). The
method retrieves the number of products belonging to that ISO class and this information is
updated in the EASTIN ISO tree.



IsoClassLocalizationDto

GetIsoClassLocalization
(
string

isoCode)
10

Input parameters
:



string

isoCode: a string representing a single ISO class (for example “12.22”).

Returns:



IsoClassLocalizationDto
object

containing the description of the ISO class passed in
the input parameter. If no description is found returns the null object.

Frequency:



Once

a month; the first call to the Web method is executed on the second day of
every month at any moment between 03.00 AM (GMT +1:00) and 03.59 AM (GMT
+1:00). The time at which the last call is executed is not defined.


This is a batch method which returns a

single object belonging to the class
IsoClassLocalizationDto
, which represents an element of the ISO classification. The method
searches into the local database for information about the ISO class whose ISO code is
passed as string parameter to the method
. For example if the value "12.22" is passed, the
method will search for information about 12.22 ISO class. The information items retrieved by
the method and stored in the
IsoClassLocalizationDto
object are:



the ISO code;



the title of the ISO class;



the
scope note of the ISO class (if it exists).

If no information for the ISO class is found the method returns the null object. The method is
designed to work in batch mode. Once a month the ISO classification tree which is stored in
EASTIN central repositor
y is visited by the batch process and for each node, which
represents an ISO class, the method is called, passing the ISO code of that node as
parameter (so the number of calls to the Web method is equal to the number of nodes of
the EASTIN ISO classificat
ion tree). The method retrieves the information about that ISO



10

This method has to be implemented only by a restricted set of authorized partners
, responsible for providing
the localization in different languages of the ISO 9999 classifi
cation
. For further information please contact the
EASTIN portal administrators.



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



33


class and this information is updated in the EASTIN Portal ISO tree. For a complete
description of the
IsoClassLocalizationDto
object see below.


KeywordDto
[]
GetKeywords
()
11

Input parameters
:



n
one.

Returns:



KeywordDto
[]: an array of
KeywordDto

objects containing information about
keywords. If no keyword is found returns a not null
KeywordDto
[] array with zero
elements.

Frequency:



Once a month; the unique call to the Web method is executed on th
e third day of
every month at any moment between 03.00 AM (GMT +1:00) and 03.59 AM (GMT
+1:00).


This is a batch method which returns an array of objects belonging to the class
KeywordDto
.
The method searches into the EASTIN partners’ local databases for the dictionary of
(keywords

> ISO classes) which will be used in the keyword research of the EASTIN portal.
This method requires no parameter. Each
KeywordDto

object contains the followin
g
information:



the keyword id in the partner’s local database;



the keyword text;



an array of ISO codes which are related to this keyword.

If no keyword is found the method returns a not null array with zero elements. The method
is designed to work in ba
tch mode. Once a month the method is called and the returned
information are updated in the EASTIN portal keyword lists. For a complete description of
the
KeywordDto

object see below.



Live search methods
12

1. Product searches


SmallProductDto
[]
FindSmallProducts
(
string
[] isoCodes,
FeatureDto
[] features,
string

commercialName,
string

manufacturer,
dateTime

insertDateMin,
dateTime

insertDateMax)





11

This method has to be implemented only by a restricted set of authorized partners
, responsible for providing
the localization in different languages of the keyword list
. For

further information please contact the EASTIN
portal administrators.

12

A
ll the
“Live search
methods
” must be implemented.

For methods that
retrieve

a typology of
data that
is not
available in the partner
’s

database an empty array or a null value (dependin
g on the specific method)

must be
returned
.



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



34


Input parameters
:



string
[]
isoCodes
: an array of strings representing ISO classes (for example
[“12.22”,

09.03.03
”]);



FeatureDto
[] features: an array of
FeatureDto

objects (for a complete description of
the
FeatureDto

object see below);



string

commercialName
: the whole or a part of the commercial name of the products
to be searched;



string

manufact
urer
: the whole or a part of the manufacturer name of the products
to be searched;



dateTime

insertDateMin
: the lower bound for the insert date of the products to be
searched;



dateTime

insertDateMax
: the upper bound for the insert date of the products to be

searched.

Returns:



SmallProductDto
[]: array of
SmallProductDto

objects containing each a light set of
information about a product (for a complete description of the
SmallProductDto

object see below). If no product is found returns a not null
SmallProductD
to
[] array
with zero elements.


This method returns an array of objects belonging to the class
SmallProductDto
. The method
implements five different kinds of searches:

1.

If the
isoCodes

array is not void the method searches for all products belonging to
the

ISO classes passed, using an
OR

statement. For example if [“12.22”, “
09.03.03
”] is
the isoCodes array, all products belonging to the 12.22 ISO class
OR

to the
09.03.03
class are returned.

2.

If the
features

array is not void the method searches for all products that possess the
indicated
FeatureDto

objects and whose measures for the respective features are
compatible with the measure boundaries specified in the
FeatureDto

objects. For
example if features con
tains the
FeatureDto
s

[{“Width (cm)”, 30, 50}, {“Height (cm)”,
80, 100}] the method will search for all products having some widths in the range [30,
50]
AND

having some heights in the range [80, 100]. Note that if a product declares
for example to have a
fixable width between 20 and 40 it should be included in the
search results since for some of its configurations it satisfies the boundaries. The
product is included in the search results only if the compatibility between its
measures and the given boundar
ies present in in the
FeatureDto

objects are satisfied
for all
FeatureDto

objects.

3.

If
commercialName

is not void the method searches a matching between the words
contained in the commercialName parameter and the respective data in the EASTIN
partner’s loc
al database. Since into the commercialName parameter there could be
one or more words, the method must split the words and search inside its database
for products whose commercial name contains
all

these words (even if present as
substrings inside of bigge
st strings). For example if commercialName = “quickie


Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



35


xenon” the method must search for all products whose commercial name contains
both words “quickie”
AND

“xenon”.

4.

If
manufacturer

is not void the method executes the search using the same criteria
specifi
ed in 2 but applied to products’ manufacturer name.

5.

If
insertDateMin

and
insertDateMax

are both not null all products whose insert date
is included within the interval [insertDateMin, insertDateMax], endpoints included,
are returned. These two parameters
must be both not null or both null.

If more than one parameter is not void at the same time, the results coming from the
matches for each parameter are merged together with an
AND

logic: only results
satisfying the conditions specified for each parameter a
re returned. If no product is
found the method returns a not null
SmallProductDto
[] array with zero elements.



ProductDto

GetProduct
(
string

productCode)

Input parameters
:



string

productCode
: the id of the product in the EASTIN partner’s system.

Returns:



ProductDto
: an object
containing detailed information

about a single product. If no
product is found than returns the null object.


This method returns an object belonging to the class
ProductDto
(for a complete description
of the
ProductDto
object see bel
ow). The method searches into EASTIN partner’s local
databases for the product which has the id matching with the method parameter
productCode. If no product is found the method returns the null object.



2. Actor searches


SmallActorDto
[]
FindSmallActors
(
string

actorType,
string
[] isoCodes,
string
[] icfCodes,
string

actorName,
dateTime

insertDateMin,
dateTime

insertDateMax)

Input parameters
:



string

actorType
: the type of the actor;



string
[]
isoCodes
: an array of strings representing ISO classes (for exampl
e [“12.22”,

09.03.03
”]);



string
[]

icfCodes
: an array of strings representing the EASTIN ICF classes (for example
[“b1”, “
d2
”]) which are a subset of the official ICF classification;



string

actorName
: the whole or a part of the name of the searched actor;



dateTime

insertDateMin
: the lower bound for the insert date of the actors to be
searched;



dateTime

insertDateMax
: the upper bound for the insert date of the actors to be
searched.

Returns:



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



36




SmallActorDto
[]: an array of
SmallActorDto

objects containing each
a light set of
information about an actor (for a complete description of the
SmallActorDto

object
see below). If no actor is found returns a not null
SmallActorDto
[] array with zero
elements.


This method returns an array of objects belonging to the class
SmallActorDto
. The method
implements five different kinds of searches:

1.

If the
type

parameter is not void the method searches for all actors belonging to the
specified type; the possible values for type are: “
companies
”, “
projects
” and

serviceproviders
”.

2.

If the
isoCodes

array is not void the method searches for all actors belonging to the
ISO classes passed, using an
OR

statement. For example if [“12.22”, “
09.03.03
”] is the
isoCodes array, all actors belonging to the 12.22 ISO class
OR

to the
09.03.03 clas
s
are returned.

3.

If the
icfCodes

array is not void the method searches for all actors belonging to the
ICF classes passed, using an
OR

statement. For example if [“b1”, “
d2
”] is the icfCodes
array, all actors belonging to the b1 ICF class
OR

to the
d2 class
are returned.

4.

If
actorName

is not void the method searches a matching between the words
contained in the actorName parameter and the respective data in the EASTIN
partner’s local database. Since into the actorName parameter there could be one or
more words, the method must split th
e words and search inside its database for
actors whose name contains
all

these words (even if present as substrings inside of
biggest strings). For example if actorName = “metlex ltd” the method must search for
all actors whose name contains both words “m
etlex”
AND

“ltd”.

5.

If
insertDateMin

and
insertDateMax

are both not null all actors whose insert date is
included within the interval [insertDateMin, insertDateMax], endpoints included, are
returned. These two parameters must be both not null or both null.

I
f more than one parameter is not void at the same time, the results coming from the
matches for each parameter are merged together with an
AND

logic: only results satisfying
the conditions specified for each parameter are returned. If no actor is found ret
urns a not
null
SmallActorDto
[] array with zero elements.



ActorDto
GetActor
(
string
actorType,

string
actorCode)

Input parameters
:



string

actorType
: the type of the actor;



string

actorCode
: the id identifying a single actor inside the EASTIN partner’s loc
al
system.

Returns:



ActorDto
: an object containing detailed infor
mation

about a single actor (for a
complete description of the
ActorDto

object see below). If no actor is found than
returns the null object.




Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



37


This method returns an object belonging to the c
lass
ActorDto
. The method searches into
EASTIN partner’s local database for the actor of the type specified in the actorType
parameter which has the id matching with the method parameter actorCode. If no actor is
found the method returns the null object.


3. Associated information searches


SmallAssociatedInfoDto
[]
FindSmallAssociatedInfos
(
string

infoType,

string
[] isoCodes,
string
[] icfCodes,
string

title,
string

author,
dateTime

insertDateMin,
dateTime

insertDateMax)

Input parameters
:



string

infoType
: the

type of the associated information document;



string
[]
isoCodes
: an array of strings representing ISO classes (for example [“12.22”,

09.03.03
”]);



string
[]
isoCodes
: an array of strings representing EASTIN ICF classes (for example
[“b1”, “
d2
”]);



string

title
: the whole or a part of the title (in the original language or in English) of
the searched associated information document;



string

author
: the whole or a part of the author names of the searched associated
information document;



dateTime

insertDateMin
: the

lower bound for the insert date of the associated
information documents to be searched;



dateTime

insertDateMax
: the upper bound for the insert date of the associated
information documents to be searched.

Returns:



SmallAssociatedInfoDto
[]: an array of
SmallAssociatedInfoDto

objects containing each
a light set of information about an associated information document (for a complete
description of the
SmallAssociatedInfoDto

object see below). If no associated
information document is found returns a not nul
l
SmallAssociatedInfoDto
[] array with
zero elements.


This method returns an array of objects belonging to the class
SmallAssociatedInfoDto
. The
method implements six different kinds of searches:

1.

If the
type

parameter is not void the method searches for a
ll associated information
documents belonging to the specified type; the possible values are: “
articles
”,

casedescriptions
”, “
ideas
”, “
faqs
”, “
forums
”, “
news
” and “
regulations
”.

2.

If the
isoCodes

array is not void the method searches for all associated info
rmation
documents belonging to the ISO classes passed, using an
OR

statement. For example
if [“12.22”, “
09.03.03
”] is the isoCodes array, all associated information documents
belonging to the 12.22 ISO class
OR

to the
09.03.03 class are returned.

3.

If the
icfCodes

array is not void the method searches for all associated information
documents belonging to the ICF classes passed, using an
OR

statement. For example


Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



38


if [“b1”, “
d2
”] is the icfCodes array, all associated information documents belonging
to the b1
ICF class
OR

to the
d2 class are returned.

4.

If
title

is not void the method searches a matching between the words contained in
the title parameter and the respective data in the EASTIN partner’s local database.
Since into the title parameter there could be
one or more words, the method must
split the words and search inside its database for associated information documents
whose title (in original language
OR

in English if present) contains
all

these words
(even if present as substrings inside of biggest str
ings). For example if title = “a guide
to wheeled walking frames” the method must search for all associated information
documents whose original title or whose English title contain all words “a”, “guide”,
“to”, “wheeled”, “walking” and “frames”.

5.

If the
au
thor

parameter is not void the method executes the search using the same
criteria specified in 4 but applied to the name of the authors of the associated
information document (in this case no distinction is needed between original
language and English).

6.

If

insertDateMin

and
insertDateMax

are both not null all associated information
documents whose insert date is included within the interval [insertDateMin,
insertDateMax], endpoints included, are returned. These two parameters must be
both not null or both n
ull.

If more than one parameter is not void at the same time, the results coming from the
matches for each parameter are merged together with an
AND

logic: only results satisfying
the conditions specified for each parameter are returned. If no associated i
nformation
document is found the method returns a not null
SmallAssociatedInfoDoc
[] array with zero
elements.



AssociatedInfoDto

GetAssociatedInfo
(
string

infoType,
string

associatedInfoCode
)

Input parameters
:



string

infoType
: the type of the associated
information document;



string

associatedInfoCode
: the id identifying a single associated information
document inside the EASTIN partner’s local systems.

Returns:



AssociatedInfoDto
: an object containing detailed information about a single
associated informat
ion document (for a complete description of the
AssociatedInfoDto

object see below). If no associated information document is found
than returns the null object.


The method searches into the EASTIN partner’s local database for the associated
information d
ocument of the type specified in the infoType parameter which has the id
matching with the method parameter
associatedInfoCode
. If no associated information
document is found the method returns the null object.





Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



39


EASTIN custom data types


As we have seen EASTIN
Input
Web services return basic SOAP types, such as String, Int and
DateTime, but also custom defined types. A complete description of EASTIN custom defined
types follows below. All mandatory fields are marked with a “*” (all the oth
er fields can be
considered as nullable). For the array fields in case they are empty do not assign a null value
to them but a not null array of zero elements.


IsoClassLocalizationDto



string

IsoCode*: the code of the ISO class;



string

Title*: the name of the ISO class ;



string

ScopeNote: the ISO class description.


KeywordDto




string

KeywordId*: the id of the keyword in the partner’s local database;



string

Text
*: the keyword text;



string
[] IsoCodes*: the array of all ISO classific
ation codes related to the keyword (for
example [“12.22”, “
09.03.03
”]).


FeatureDto




integer

FeatureId*: the id of the

feature in the

EASTIN Taxonomy

vocabulary
;



decimal

ValueMin
: the lower bound value of the measure specified for this feature;



decimal

ValueMax:
the upper bound value of the measure specified for this feature.


SmallProductDto



string

ProductCode*: the id of the product in the partner’s local database;



string

IsoCodePrimary*: the primary ISO Code of the product (for example

09.03.03
”);



st
ring
[] IsoCodesOptional: the array of all secondary ISO classification codes of the
product (for example [“12.22”, “
09.03.03
”]);



string

CommercialName*: the commercial name of the product;



string

ManufacturerCode*: the id of the product’s manufacturer in the partner’s local
database;



string

ManufacturerOriginalFullName*: the full name in the original language of the
product’s manufacturer;



dateTime

InsertDate
*: the insert date of the product;



dateTime

LastUpdateDate*: the last update date of the product;



string

ThumbnailImageUrl: the URL of the small format picture of the product (used
when displaying list of products in EASTIN Portal). The URL must be accessible on the
Web by the end user’s br
owser.


ProductDto



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



40




string

ProductCode*: the id of the product in the partner’s local database;



string

IsoCodePrimary*: the primary ISO Code of the product (for example

09.03.03
”);



string
[] IsoCodesOptional: the array of all secondary ISO classificatio
n codes of the
product (for example [“12.22”, “
09.03.03
”]);



string

CommercialName*: the commercial name of the product;



string

ManufacturerCode*: the id of the product’s manufacturer in the partner’s local
database;



string

ManufacturerOriginalFullName*: th
e full name in the original language of the
product’s manufacturer;



dateTime

InsertDate
*: the insert date of the product;



dateTime

LastUpdateDate*: the last update date of the product;



string

ThumbnailImageUrl: the URL of the small format image of the prod
uct (used
when displaying list of products in the EASTIN portal). The URL must be accessible on
the Web by the end user’s browser.



bool

IsReviewAllowed*: if true the end user is authorized to review this product;



string
ManufacturerAddress: the address of
the product’s manufacturer;



string
ManufacturerPostalCode: the postal code of the product’s manufacturer;



string
ManufacturerTown
: the town of the product’s manufacturer;



string
ManufacturerCountry*: the country code of the product’s manufacturer in
ISO
31
66
-
1
-
alpha
-
2 code

(for example “IT”, “US”, etc.);



string
ManufacturerPhone: the phone of the product’s manufacturer;



string
ManufacturerFax: the fax of the product’s manufacturer;



string
ManufacturerEmail: the email of the product’s manufacturer;



string
ManufacturerSkype: the Skype account name of the product’s manufacturer;



string
ManufacturerWebSiteUrl: the Web site URL of the product’s manufacturer;



string
[] ManufacturerSocialNetworkUrls: an array of URLs linking to the product’s
manufacturer page
inside the main social networks (for example Facebook, Twitter,
LinkedIn, etc.);



string

ImageUrl: the URL of the big format image of the product (used when
displaying the detail view of the product in the EASTIN portal). The URL must be
accessible on the W
eb by the end user’s browser;



string

OriginalDescription: the description of the product in the original language;



string
EnglishDescription: the description of the product in English;



string

OriginalUrl: the URL of the Web page in the original language on

the original
EASTIN partner’s Web site in which the product is presented. The URL must be
accessible on the Web by the end user’s browser;



string

EnglishUrl: the URL of the Web page in English on the original EASTIN partner’s
Web site in which the product

is presented. The URL must be accessible on the Web
by the end user’s browser;



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



41




string

OriginalDownloadUrl: the URL of the download Web page in the original
language on the original EASTIN partner’s Web site in which the product is
presented. The URL must
be accessible on the Web by the end user’s browser;



string

EnglishDownloadUrl: the URL of the download Web page in English on the
original EASTIN partner’s Web site in which the product is presented. The URL must
be accessible on the Web by the end user’s
browser;



string
[] UserManualUrls: an array containing the URLs of product’s user manuals;



string
[] VideoUrls: an array containing the URLs of product’s demo videos;



string
[] BrochureUrls: an array containing the URLs of product’s brochures;



string
[] Furthe
rInfoUrls: an array containing the URLs of other
possible
information
present on the Web related to the product;



FeatureDto
[] Features: an array of
FeatureDto

objects containing all the EASTIN
Taxonomy features (with the measure values

if needed
) for this
product.


SmallActorDto



string

ActorCode*: the id of the actor in the EASTIN partner’s local database;



string

OriginalFullName*: the full name of the actor in the original language;



string
Country*: the country code of the actor in
ISO 3166
-
1
-
alpha
-
2 code

(for
example “IT”, “US”, etc.);



dateTime

InsertDate*: the insert date of the actor in the EASTIN partner’s local
database;



dateTime

LastUpdateDate*: the insert date of the actor in the EASTIN partner’s local
database.


ActorDto



string

ActorCode*: the id of the actor in the EASTIN partner’s local database;



string

OriginalFullName*: the full name of the actor in the original language;



string
Country*: the country code of the actor in
ISO 3166
-
1
-
alpha
-
2 code

(for
example “IT”, “US”, etc.);



dateTime

InsertDate*: the insert date of the actor in the EASTIN partner’s local
database;



dateTime

LastUpdateDate*: the insert date of the actor in the EASTIN partner’s local
database;




string

ShortName*: the short name o
f the actor;



string

EnglishFullName*: the full name of the actor in English;



string

OriginalDescription: the description of the Actor in the original language;



string

EnglishDescription: the description of the Actor in English;



dateTime

StartDate*: the sta
rt date of the actor



dateTime

EndDate: the end date of the actor



string

ContactBody: the reference organization of the actor;



string

Address: the address of the actor;



string

PostalCode: the postal code of the actor;



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



42




string

Town: the town of the actor;



str
ing

Phone: the phone of the actor;



string

Fax: the fax of the actor;



string

Email: the email of the actor;



string

Skype: the Skype account name of the actor;



string

WebSiteUrl: the Web site URL of the actor. The URL should be accessible on
the Web by the e
nd user’s browser;



string

ContactPersonFullName: the complete name of the contact person for the
actor;



string

OriginalUrl: the URL of the Web page in the original language on the original
EASTIN partner’s Web site in which the actor is presented. The URL
must be
accessible on the Web by the end user’s browser;



string

EnglishUrl: the URL of the Web page in English on the original EASTIN partner’s
Web site in which the actor is presented. The URL must be accessible on the Web by
the end user’s browser



string
[] SocialNetworkUrls: an array of URLs linking to the actor page inside the main
social networks (for example Facebook, Twitter, LinkedIn, etc.);



string
[] IcfCodes*: the array of all EASTIN ICF classification codes of the actor (for
example [“b1”, “
d2
”]);



string
[] IsoCodes*: the array of all ISO classification codes of the actor (for example
[“12.22”, “
09.03.03
”]);


SmallAssociatedInfoDto



string

AssociatedInfoCode*: the ID of the associated information document in the
EASTIN partner’s local database;



string

Authors
*
: a string containing the names (or the initials) of the authors of the
associated information document (this is not an array but a single string);



string

OriginalTitle
*: the original title in the native language of the associated
informatio
n document



string

EnglishTitle*: the English translation of the original title of the associated
information document



string

OriginalLanguage*: the ISO
639
-
1 code

of the native language of the associated
information document (for example: "en", "it", "de")
;



dateTime

InsertDate*: the insert date of the associated information document in the
EASTIN partner’s local database;



dateTime

LastUpdateDate*: the last update date of the associated information
document in EASTIN partner’s local database.


AssociatedInfo
Dto



string

AssociatedInfoCode*: the ID of the associated information document in the
EASTIN partner’s local database;



string

Authors
*
: a string containing the names (or the initials) of the authors of the
associated information document (this is
not an array but a single string);



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



43




string

OriginalTitle
*: the original title in the native language of the associated
information document



string

EnglishTitle*: the English translation of the original title of the associated
information document



string

Ori
ginalLanguage*: the ISO
639
-
1 code

of the native language of the associated
information document (for example: "en", "it", "de");



dateTime

InsertDate*: the insert date of the associated information document in the
EASTIN partner’s local database;



dateTime

LastUpdateDate*: the last update date of the associated information
document in EASTIN partner’s local database



integer

PublicationYear*: the publication year of the associated information
document;



string

PublishingDetails: the publishing details (for ex
ample the publishing house) of
the associated information document;



string

OriginalAbstract: the abstract of the associated information document in the
original language;



string

EnglishAbstract: the abstract of the associated information document in the
or
iginal language;



string

OriginalUrl: the URL of the Web page in the original language on the original
EASTIN partner’s Web site in which the associated information document is
presented. The URL must be accessible on the Web by the end user’s browser;



stri
ng

EnglishUrl: the URL of the Web page in English on the original EASTIN partner’s
web site in which the associated information document is presented. The URL must
be accessible on the Web by the end user’s browser;



string

OriginalDownloadUrl: the URL for
the download of the associated information
document in the original language;



string

EnglishDownloadUrl: the URL for the download of the associated information
document in English;



string

ImageUrl: the URL of the picture related to the associated informati
on
document (used when displaying the detail view of the associated information
document in EASTIN Portal). The URL must be accessible on the Web by the end
user’s browser;



string
[] FurtherInfoUrls: an array containing the URLs of other
possible
informatio
n
present on the Web related to the associated information document;



string
[] IcfCodes*: the array of all EASTIN ICF classification codes of the associated
information document (for example [“b1”, “
d2
”]);



string
[] IsoCodes*: the array of all ISO
classification codes of the associated
information document (for example [“12.22”, “
09.03.03
”]);





Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



44


12

Annex 3


Specifications for the Output Web Services

EASTIN
Output

Web services specs

Version 1.1

To provide data retrieved by the EASTIN search engine
to the GPII Unified Listing, a specific
set of Web Services
has been

implemented that contains functions to extract data using the
EASTIN search engine.

These
Output

Web Services Servers
are

exposed by the EASTIN search
engine and will be accessed by a spe
cific application
(
Output Web Service Client
)
aimed at
collecting the data retrieved from EASTIN into the GPII Unified Listing database.


The EASTIN output Web Services use the REST protocol and the response is provided in JSON
format.


Method
FindProduct
sSortBy
S
imilarity

BasicProductInfoDto
[] FindProductsSortBySimilarity

(
string

isoCodes,
string

commercialName,
string

manufacturer,
string

insertDateMin,
string

insertDateMax,
string

baseForSimilarity,
string

features)


This method is used to search for
products in the databases of the EASTIN network according
to the specified parameters. The method returns an array of “BasicProductInfoDto” including
the basic product information (see EASTIN Custom Data Type paragraph for details).


This method can be acc
essed at the url:
http://localhost:50080
/searches/products/listsimilarity


The template for the input parameters is the following:

"
/products/listsimilarity?isoCodes={isoCodes}&
commercialName={commercialName}&manufact
urer={manufacturer}&insertDateMin={insertDateMin}&insertDateMax={insertDateMax}&baseFo
rSimilarity={baseFor
Similarity}&features={features}
"


Input parameters
:



string

isoCodes
: a string representing
the

ISO 9999 codes
of the products to be
searched. Each code must be written without separators (i.e. 223618, not 22.36.18).
Separator among different codes is “
-
“ (e.g. “223618
-
223612”)
.



string

commercialName
:
the whole or a part of the commercial name of the products
to
be searched;



string

manufacturer
:
the whole or a part of the manufacturer name of the products
to be searched;



string

insertDateMin
:

the lower bound for the insert date

of the products to be
searched. Insert date must be written in the format:
“dd
-
mm
-
yy
hh.mm.ss”



string

insertDateMax
:
the upper bound for the insert date of the products to be
searched. Insert date must be written in the format:
“dd
-
mm
-
yy hh.mm.ss”



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



45




string

baseForSimilarity
:

this parameter identifies the product that has to be
taken as base
for similarity.
The parameter is an integer number that represent
the
position

of the product in the result list when no base for similarity is
specified

(0 is the first position).



string

features:
a string representing the IDs of the features of the
products to be
searched. Each feature ID can be followed by a “_” and the minimum and maximum
value to be searched separated by “_” (for example the feature “length (cm)” has
ID=3, if I want to search devices that have length between 10 and 20 cm the strin
g
will be: “3_10_20” ). Separator among different feature is “
-
“ (for example a
complete features string could be: “3_10_20
-
4_5_15”. This means search for
products that have a “length (cm)” (id=3) between 10 and 20, and a “height (cm)”
between 5 and 15)
13
.


Returns:



BasicProductInfoDto
[]
: array of
BasicProductInfoDto

objects
,

each containing a light
set of information about a product (for a complete description of the
BasicProductInfoDto

object see
EASTIN Custom Data Type paragraph
).
If no product is
found
returns a not null
BasicProductInfoDto
[]
array
with zero elements.

If the
parameter
baseForSimilarity

is specified, products are sorted according to the
similarity with the product selected as base for comparison.


This method returns an array of objects belonging to the class
BasicProductInfoDto
. The
method implements five different kinds of searches:

6.

If the
isoCodes

string
is not
void

the method searches for all products belonging to
the ISO classes passed, using
an
OR

statement
. For example if “223618
-
223612”
is
the isoCodes
string
, all products belonging to the
223618

ISO class
OR

to the
223612
class are returned.

7.

If
commercialName

is not void the method searches a matching between the words
contained in the commercialName parameter and the respective data in the EASTIN
partner’s local database. Since into the commercialName parameter there could be
one or more words, the method mu
st split the words and search inside its database
for products whose commercial name contains
all

these words (even if present as
substrings inside of biggest strings). For example if commercialName = “quickie
xenon” the method must search for all products

whose commercial name contains
both words “quickie”
AND

“xenon”.

8.

If
manufacturer

is not void the method executes the search using the same criteria
specified in 2 but applied to products’ manufacturer name.

9.

If
insertDateMin

and
insertDateMax

are both not

void

all products whose insert date
is included within the interval [insertDateMin, insertDateMax], endpoints included,
are returned. These two parameters must be both not null or both null.

10.

If
features
is not void all products whose feature are specified

are returned.

The
feature parameter is a
string representing the IDs of the features of the products to



13

For t
he complete set of feature IDs
see

the deliverable
….



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



46


be searched. Each feature ID can be followed by a “_” and the minimum and
maximum value to be searched separated by “_” (for example the feature “lengt
h
(cm)” has ID=3, if I want to search devices that have length between 10 and 20 cm
the string will be: “3_10_20” ). Separator among different feature is “
-
“ (for example
a complete features string could be: “3_10_20
-
4_5_15”. This means search for
product
s that have a “length (cm)” (id=3) between 10 and 20, and a “height (cm)”
between 5 and 15). The complete set of feature IDs is available in the deliverable ….

If more than one parameter is not void at the same time, the results coming from the
matches for

each parameter are merged together with an
AND

logic: only results
satisfying the conditions specified for each parameter are returned. If no product is
found the method
returns a not null
BasicProductInfoDto
[] array with zero elements.

If
the parameter
b
aseForSimilarity

is specified, products are sorted according to the
similarity with the product selected as base for comparison


Method GetProduct


ProductDetailsDto

GetProduct(
string

database,
string

productCode
);


This method is used get the detailed
description of a specific product in one of the databases
of the EASTIN network. The method returns an object belonging to the class
“ProductDetailsDto” (see EASTIN Custom Data Type paragraph for details).


This method can be accessed at the url:
http://localhost:50080
/searches/products/detail/



The template for the input parameters is the following:

"/products/detail/{database}/{
productCode
}"


Input parameters
:



string

database
: the
name of the database where the product record is stored



string

productCode
: a string representing the unique ID in the specified
database

Returns:



ProductDetailsDto
: an object containing detailed
description

of

a single product. If no
product is found

a nu
ll object is
return
ed
.


This method returns an object belonging to the class
ProductDetailsDto

(for a complete
description of the
ProductDetailsDto

object see below). The method searches into
the
EASTIN partner’s local database
, specified in the parameter
“database”,

for the product
which has the id matching with the parameter

productCode

. If no product is found the
method returns the null object.


EASTIN custom data types




Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



47


EASTIN
Output
Web services return custom defined types. A complete description of
EASTIN
custom defined types follows below. All mandatory fields are marked with a “*” (all the
other fields can be considered as nullable).
For the array fields in case they are empty a not
null array of zero elements is returned
.


BasicProductInfoDto
:



string

Database
*: the name of the database where the product record comes from



string

ProductCode
*:
the id of the product in the partner’s local database



IsoNodeDto

IsoCodePrimary
*: Custom data type (see below) representing the Primary ISO 9999
classific
ation code for the product



IsoNodeDto
[]
IsoCodesOptional
:

the array of all secondary ISO 9999 classification codes of the product



string

CommercialName
*: the name of the product



string

ManufacturerOriginalFullName
*:
the full name in the original language
of the product’s
manufacturer



DateTime

InsertDate
*:
the insert date of the product;




DateTime

LastUpdateDate
*:
the last update date of the product;



string

ThumbnailImageUrl
:
the URL of the small format picture of the product (used when displaying
list of products in EASTIN Portal).



string

SimilarityLevel
:
the lev
el of similarity of the current product with the

pr
oduct selected as base
for comparison.
14


ProductDetailsDto
:



string

Database
*: the name of the database where the product record comes from



string

ProductCode
*:
the id of the product in the partner’s local database



IsoNodeDto

IsoCodePrimary
*: Custom data type (see below) representing the Primary ISO 9999
classific
ation code for the product



IsoNodeDto
[]
IsoCodesOptional
:

the array of all secondary ISO 9999 classification codes of the product



string

CommercialName
*: the name of the product



string

ManufacturerOriginalFullName
*:
the full name in the original language
of the product’s
manufacturer



string

ManufacturerAddress
:
the address of the product’s manufacturer;



string

ManufacturerPostalCode
:
the postal code of the product’s manufacturer;



string

ManufacturerTown
:
the town of the product’s manufacturer;



string

ManufacturerCountry
*:
the country code of the product’s manufacturer according to the two
letter
ISO standard 3166
-
1
-
alpha
-
2 code

(for example “IT”, “US”, etc.);



string

ManufacturerPhone
:
the phone of the product’s manufacturer;



string

ManufacturerEmail
:

t
he email of the product’s manufacturer;




string

ManufacturerWebSiteUrl

: the Web site URL of the product’s manufacturer;



DateTime

InsertDate
*:
the insert date of the product;




DateTime

LastUpdateDate
*:
the last update date of the product;



string

ThumbnailImageUrl
:
the URL of the small format picture of the product (used when displaying
list of products in EASTIN Portal).



string

ImageUrl

the URL of the big format image of the product (used when displaying the detail view
of the product in the EASTI
N portal).




14

For more information about the similarity
concept and the algorithm to evaluate similarity see the
deliverable…..



Cloud platforms Lead to Open and Universal access


for people with Disabilities and for All


European Commission, FP7 Project 289016



http://www.cloud4all.info



48




string

EnglishDescription
:
the description of the product in English;



string

OriginalUrl
:
the URL of the Web page in the original language on the original EASTIN partner’s
Web site in which the product is presented. The URL must be accessible
on the Web by the end user’s
browser;



string

EnglishUrl
: the URL of the Web page in English on the original EASTIN partner’s Web site in
which the product is presented. The URL must be accessible on the Web by the end user’s browser;



FeatureWithNameDto
[]
F
eatures

: an array of
FeatureWithNameDto

objects
(see the custom data
type below)
containing the
product features according to the
EASTIN Taxonomy
.


IsoNodeDto




string

Code
: the numeric code of the ISO 9999 item (e.g. “223618”)



string

Name
:
the name of the

ISO 9999 item (e.g. “Input devices”)


FeatureWithNameDto:




int

FeatureId
: the ID of the feature in the ETNA taxonomy



string

FeatureName
:
the name of the feature according to the ETNA taxonomy

(e.g. “Weight (Kg)”)




string

FeatureParentName
:
the name of
the “cluster” the feature belongs to
(e.g. “Overall dimensions”)



decimal

ValueMin
:
for features that can have an associated numeric value (e.g.
“Magnification”)
,

is the minimum value of the feature for the specific product





decimal

ValueMax
:

for features
that can have an associated numeric value (e.g.
“Magnification”)
,

is the
maximum

value of the feature for the specific product