Download EASTIN *input* Web services

Background - What is EASTIN
• A European network that offers information on Assistive
Technologies of all kind (mobility, self care, ICT, ….)
• The core is the EASTIN website www.eastin.eu that includes
information on assistive technology products, manufacturers
and associated info (articles, case studies, …)
• EASTIN stems from a project founded by the European
Commission in 2004-2005 (eTEN programme)
• Now is a self financing association
• EASTIN is currently expanding (including new information
providers), and improving the dataset for the description of
products
the EASTIN Website
The current EASTIN approach
Query from
the user
I want an on
screen keyboard
User interface (eastin website)
EASTIN
Search
engine
Retrieved
product list
<SmallProduc
tDto[]>
Product details
EASTIN
<ProductDto[]>
Webservice Client
Data in EASTIN format
Webservice
Server
Webservice
Server
Webservice
Server
Webservice
Server
…
Product
DB
Product
DB
Product
DB
Product
DB
Provider 1
(e.g. SIVA)
Provider 2
(e.g. HMI Basen)
Provider 3
(e.g. DLF Data)
Provider N
Product description in the EASTIN portal
Example
Basic information
Additional technical details
Currently sent to EASTIN as Free text
=> will be separate fields from January 2013
The new dataset (from Jan 2013) – basic information
Item
Commercial name
ISO Code
Insert date
Latest update
Manufacturer Name
Man. Address
Man.Postcode
Man.Town
Man.Country
Man.Phone
Man.Fax
Man.E-mail
Man.Website
Man.Social network
Man.Skype acc.
Description in original language
Description in English
Image
User manual
Video demo
Brochure
Original document
download or purch. webpage
Source Database
Source D. country
numerosity
1
More
1
1
1
1
1
1
1
1
1
1
1
2
1
1
1
1
2
2
2
1
1
1
1
Example
Victor Reader Stream
22.18.03
16-05-2012-00:50
16-06-2012-21:26
Humanware
1800, Michaud street
4500
Drummondville
CA
+1 819 471 4818
+1 819 471 4818
[email protected]
http://...
http://...
skypename
VR Stream er både en DAISY afspiller...
VR Stream is both a DAISY player…
(http://.. )
http://..
http://..
http://..
http://..
http://..
HMI
DK
The
new
datasetfor
(from
Jan 2013)
– Additional Technical details (only some
New
dataset
product
description
fields are shown here as an exemple)
Overall dimensions
Width (cm)
Length (cm)
Height (cm)
Weight (kg)
Capacity / Range
Magnification (x)
Number of keys
Number of input channels
Number of output channels/Devices
Signal range (m)
Output
Auditive
Print
Screen
Tactile display
Voice synthesis
Recorded sound
….
TITLE
Features with
numeric value
(measures)
Features without
numeric value
Information flowing from the EASTIN database to the
GPII Unified listing
EASTIN
User
GPII
User
Unified Listing Web
Portal
EASTIN Web Portal
EASTIN search engine
API
Output Web
Service
Input Web Service (client)
2
3
4
Marketplace
web site
Validation
procedure
1
Input W.S.
(server)
Input W.S.
(server)
Input W.S.
(server)
SIVA
(Italy)
DLF
(UK)
Rehadat
(Germany)
Input W.S.
(server)
…
W.S.
Client
5
GPII Unif.
listing
EASTIN Distributed DB of AT products
Queries
Retrieved data
Validator
Marketpl.
database
Connection of GPII into the EASTIN network
EASTIN
User
EASTIN Web Portal
EASTIN search engine
Input Web Service (client)
Input W.S.
(server)
Input W.S.
(server)
Input W.S.
(server)
SIVA
(Italy)
DLF
(UK)
Rehadat
(Germany)
Input W.S.
(server)
Input W.S.
(server)
GPII Unif.
listing
…
EASTIN Distributed DB of AT products
Queries
Retrieved data
Overall EASTIN-GPII connection scheme
EASTIN
User
GPII
User
Unified Listing Web
Portal
EASTIN Web Portal
EASTIN search engine
Validation
procedure
Output Web
Service
Input Web Service (client)
W.S.
Client
Input W.S.
(server)
Input W.S.
(server)
Input W.S.
(server)
SIVA
(Italy)
DLF
(UK)
Rehadat
(Germany)
Input W.S.
(server)
Input W.S.
(server)
Validator
GPII Unif.
listing
…
EASTIN Distributed DB of AT products
Marketplace
web site
Queries
Retrieved data
Marketpl.
database
Validation procedure DRAFT!
See wiki page: http://wiki.gpii.net/index.php/Unified_%28Federated%29_Listing_validation_procedure
?
=
1. Find out duplicated products (aided by
automatic functions)
2. Information of duplicates is merged into
one record (automatic procedure) that will
include:
–
–
–
–
–
–
Source: database +
country
Names
all the commercial names (alias)
all the manufacturer names
all the ISO codes
all the images
all the text descriptions
the sum of the detailed information
3. if needed, technical data are
completed/modified and feedback is sent
to the information provider
4. Specific settings are added for the product
(automatically if the product is Cloud4all
compliant)
SIVA (IT)
Vlibank (BE)
ACE CENTRE - SAW
5
SAW 5
ISO codes
manufacturer
names + country
last update
22.36.18
ACE Centre
Advisory Trust (UK)
21/09/2012
22.36.15
ACE CENTRE (UK)
text description
Software for
computers running
Windows, enabling
control by
Software for
computers
running Windows,.
Images
Source: database +
country
Names
SIVA (IT)
ACE CENTRE - SAW 5
Settings
Vlibank (BE)
SAW 5
Property
values
Input devices
Joystick; Keyboard; Mouse; Touch
pad; Touch screen; On screen
keyboard; Sing
Activation
modality
Mechanical (touch, push, pull,
squeeze,
Output
devices/software
Screen; Printer; Loudspeaker;
Vibrator; Tactile display;
Output modality
Acoustic/sound; Speech synthesis;
Speech recorded;
Images
ISO codes
manufacturer names
+ country
last update
22.36.18
ACE Centre Advisory
Trust (UK)
21/09/2012
22.36.15
ACE CENTRE (UK)
text description
Software for
computers running
Windows, enabling
control by
Software for
computers running
Windows,.
21/09/2012
21/09/2012
Product description in the Solution Registry
Source: database + country
Names
Images
SIVA (IT)
ACE CENTRE - SAW 5
Vlibank (BE)Basic information
SAW 5
ISO codes
manufacturer names + country
last update
text description
22.36.18
ACE Centre Advisory Trust (UK)
21/09/2012
Software for computers running
Windows, enabling…
22.36.15
ACE CENTRE (UK)
21/09/2012
Software for Windows that
allows to …
Technical details
INPUT DEVICES
technical details
Mouse; Double switch; …
INPUT ADJUSTMENTS
Scanning speed adjustable; Size of controls (or keys) adjustable…
Setting name
Font size
Possibe values
10- 38 pt
Scanning speed
slow, medium, fast
Voice output
on; off
Speech rate
10-60 Word per minute
Specific settings
EASTIN “input” Web services
EASTIN
User
EASTIN Web Portal
EASTIN search engine
Input Web Service (client)
Input W.S.
(server)
Input W.S.
(server)
Input W.S.
(server)
SIVA
(Italy)
DLF
(UK)
Rehadat
(Germany)
Input W.S.
(server)
Input W.S.
(server)
GPII Unif.
listing
…
EASTIN Distributed DB of AT products
Queries
Retrieved data
“input” Web services protocol
• Protocol: XML-SOAP 1.2
• SIVA Web Service for Eastin is an example of implementation based on
Microsoft .NET Windows Communication Foundation (WCF) technology. Other
Eastin partners used Java-based or PHP-based frameworks. Here you can get
the WSDL of SIVA Web Service for Eastin:
http://www.portale.siva.it/eastinetnawebservices/searches.svc?wsdl
“input” Web services product search function
The Web service must implement 9 functions. The most important function in
Cloud4all repository perspective is:
SmallProductDto[] FindSmallProducts(string[] isoCodes,
FeatureDto[] features,
string commercialName,
string manufacturer,
DateTime insertDateMin,
DateTime insertDateMax);
features parameter is an array of FeatureDto objects that represent the new
Eastin-Etna taxonomy (from Jan 2013) and can be used together with isoCodes
parameter to find all ICT products caracterized by a specified techincal feature.
“input” Web services returned object 1
The function returns an array of SmallProductDto objects which are defined here:
public class SmallProductDto
{
public string ProductCode { get; set; }
public string IsoCodePrimary { get; set; }
public string[] IsoCodesOptional { get; set; }
public string CommercialName { get; set; }
public string ManufacturerCode { get; set; }
public string ManufacturerName { get; set; }
public DateTime InsertDate { get; set; }
public DateTime LastUpdateDate { get; set; }
public string ThumbnailImageUrl { get; set; }
}
“input” Web services product detail function
Once you get the product ID (called ProductCode) you can get all the possible
information about a single product calling the function:
ProductDto GetProduct(string productCode,
string languageCode);
The languageCode parameter (for ex.: “en”, “it”, “de”) is used to decide how to
localize some of the textual content contained in the returned object.
“input” Web services returned objects 2
The ProductDto returned object is defined here:
public class ProductDto {
<... all fields contained in SmallProductDto plus ... >
public string ManufacturerAddress { get; set; }
public string ManufacturerPostalCode { get; set; }
public string ManufacturerTown { get; set; }
public string ManufacturerCountry { get; set; }
public string ManufacturerPhone { get; set; }
public string ManufacturerFax { get; set; }
public string ManufacturerEmail { get; set; }
public string ManufacturerSkype { get; set; }
basic
public string ManufacturerWebSiteUrl { get; set; }
information
public string[] ManufacturerSocialNetworkUrls { get; set; }
public string ImageUrl { get; set; }
public string Description { get; set; }
public string OriginalUrl { get; set; }
public string DownloadUrl { get; set; }
public string[] UserManualUrls { get; set; }
public string[] VideoUrls { get; set; }
public string[] BrochureUrls { get; set; }
public string[] FurtherInfoUrls { get; set; }
public FeatureDto[] Features { get; set; }
Additional technical details
}
EASTIN “output” Web services
EASTIN
User
GPII
User
Unified Listing Web
Portal
EASTIN Web Portal
EASTIN search engine
API
Output Web
Service
Input Web Service (client)
2
3
4
Marketplace
web site
Validation
procedure
1
Input W.S.
(server)
Input W.S.
(server)
Input W.S.
(server)
SIVA
(Italy)
DLF
(UK)
Rehadat
(Germany)
Input W.S.
(server)
…
W.S.
Client
5
GPII Unif.
listing
EASTIN Distributed DB of AT products
Queries
Retrieved data
Validator
Marketpl.
database
“output” Web services protocol
• XML-SOAP 1.2
or
• REST
The decision about the protocol to be used will be taken in the first quarter of
2013 but there is the possibility that both protocols will be supported.
“output” Web services product search function
Again, the most important functions for Cloud4all project are:
SmallProductDto[] FindSmallProducts(string[] isoCodes,
FeatureDto[] features,
string commercialName,
string manufacturer,
DateTime insertDateMin,
DateTime insertDateMax);
ProductDto GetProduct(string repositoryCode,
string productCode,
string languageCode);
Here the only difference is that in GetProduct() you must pass the repository ID
(repositoryCode parameter). The RepositoryCode field is contained (together with
ProductCode) in SmallProductDto objects, returned by FindSmallProducts().