Private Public Partnership Project (PPP) Large-scale Integrated Project (IP) D.3.1.1b: FI-WARE GE Open Specification Project acronym: FI-WARE Project full title: Future Internet Core Platform Contract No.: 285248 Strategic Objective: FI.ICT-2011.1.7 Technology foundation: Future Internet Core Platform Project Document Number: ICT-2011-FI-285248-WP3-D.3.1.1b Project Document Date: 2012-10-15 Deliverable Type and Security: Public Author: FI-WARE Consortium Contributors: FI-WARE Consortium Future Internet Core Platform Table of Contents 1 Introduction ...................................................................................................................13 1.1 Executive Summary ...............................................................................................13 1.2 About This Document .............................................................................................13 1.3 Intended Audience .................................................................................................13 1.4 Chapter Context .....................................................................................................13 1.5 Structure of this Document .....................................................................................15 1.6 Typographical Conventions ....................................................................................16 1.6.1 Links within this document...............................................................................16 1.6.2 Figures ............................................................................................................16 1.6.3 Sample software code .....................................................................................16 1.7 Acknowledgements ................................................................................................17 1.8 Keyword list ............................................................................................................17 1.9 Changes History .....................................................................................................17 2 FIWARE OpenSpecification Apps ServiceMashup ........................................................18 2.1 Preface ...................................................................................................................18 2.2 Copyright ................................................................................................................18 2.3 Legal Notice ...........................................................................................................18 2.4 Overview ................................................................................................................18 2.5 Basic Concepts ......................................................................................................19 2.5.1 Build-in Service Repository .............................................................................19 2.5.2 Composition Editor ..........................................................................................20 2.5.3 Service Execution ...........................................................................................21 2.5.4 Users and Groups ...........................................................................................22 2.5.5 Example Scenarios .........................................................................................22 2.6 ServiceMashup Architecture ...................................................................................23 2.6.1 Technical Interfaces ........................................................................................23 2.7 Main Operations .....................................................................................................24 2.7.1 Send SMS Service ..........................................................................................24 2.7.2 Using Data Stores ...........................................................................................28 2.8 Basic Design Principles ..........................................................................................32 2.8.1 Data flow paradigm .........................................................................................32 2.8.2 Typed ports .....................................................................................................32 2.9 Detailed Specifications ...........................................................................................33 2.9.1 Open API Specifications ..................................................................................33 D.3.1.1b FI-WARE GE Open Specification Page 2 Future Internet Core Platform 2.10 Re-utilised Technologies/Specifications .................................................................33 2.11 Terms and definitions .............................................................................................33 3 FIWARE OpenSpecification Apps Application Mashup ..................................................37 3.1 Preface ...................................................................................................................37 3.2 Copyright ................................................................................................................37 3.3 Legal Notice ...........................................................................................................37 3.4 Overview ................................................................................................................37 3.4.1 Target usage ...................................................................................................38 3.5 Basic Concepts ......................................................................................................39 3.5.1 Key concepts and ideas ..................................................................................39 3.5.2 Example scenario ............................................................................................42 3.5.3 Architecture .....................................................................................................43 3.5.4 Mashup and Widgets Definition Languages (MDL and WDL) ..........................45 3.6 Main Interactions ....................................................................................................75 3.6.1 Life-cycle of a Mashable Application Component (mashup, widget and operators) ......................................................................................................................75 3.6.2 Interaction diagrams ........................................................................................76 3.7 Basic Design Principles ..........................................................................................81 3.8 Detailed Specifications ...........................................................................................82 3.8.1 Open API Specifications ..................................................................................82 3.8.2 Other Open Specifications...............................................................................82 3.9 Re-utilized Technologies/Specifications .................................................................82 3.9.1 OpenSocial .....................................................................................................83 3.9.2 Widget Packaging and XML Configuration ......................................................83 3.9.3 OpenAjax Hub 2.0 Specification ......................................................................83 3.9.4 OMA Enterprise Mashup Markup Language ....................................................83 3.10 Terms and definitions .............................................................................................83 4 FIWARE OpenSpecification Apps WidgetAPI ................................................................88 4.1 Introduction to the Widget API ................................................................................88 4.1.1 Widget API Core .............................................................................................88 4.1.2 Intended Audience ..........................................................................................88 4.1.3 API Change History .........................................................................................88 4.1.4 How to Read This Document ...........................................................................88 4.2 Widget API .............................................................................................................89 4.2.1 MashupPlatform.http .......................................................................................89 4.2.2 MashupPlatform.wiring ....................................................................................90 4.2.3 MashupPlatform.prefs .....................................................................................90 5 FIWARE OpenSpecification Apps ApplicationMashupAPI .............................................92 D.3.1.1b FI-WARE GE Open Specification Page 3 Future Internet Core Platform 5.1 Introduction to the Application Mashup API ............................................................92 5.1.1 Application Mashup Core ................................................................................92 5.1.2 Intended Audience ..........................................................................................92 5.1.3 API Change History .........................................................................................92