Versions Compared

Version Old Version 3 New Version Current
Changes made by

WILSON Scott

WILSON Scott

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In order to verify the completeness and the correctness of the Service Definition, the AeronauticalDataset Service is being implemented and deployed by Eurocontrol using the fictitious "Donlon" data set and sample data sets made available by some AIS. This implementation also provides an HMI, that works in a browser and accesses the service via the B2B interface. It is meant to allow AIS and their clients to quickly discover and test the service without having to invest effort in the implementation of a client service.

Child pages (Children Display)

Test implementation (Eurocontrol prototype)

  • Initial Service Overview - provides key information about the service and its implementation
  • Service Description - (to be added later) will be provided once the service prototype is fully available to test users, starting from the service definition, which is augmented with actual implementation information. It will describe (1) what the service provides; (2) the service message (the structure of the message at the logical level); (3) the behavior; (4) the performance levels; and (5) how the service can be accessed.
    • Initial Online access - provides information about how to access the Eurocontrol service prototype implementation.

    The Prototype provides two means to access the service:

    • HMI - an "AeronauticalDatasetClient"  that works in a web browser
    • API - a B2B interface

    Both methods are documented here.

    Table of Contents


    Access via HMI


    Warning
    titleImportant

    In order to access:

    Connect to the following web site using a Web browser: EUROCONTROL "AeronauticalDatasetClient" Prototype

    The following picture shows one of the screens of the Eurocontrol Prototype, This example of a possible client application, working within a Web browser, interacts in fact with the service through the B2B service interfaces, which are implemented as specified in the Service Definition. 

    It shall be well understood that the client application functionality and human interface are not part of the service description! The prototype HMI is provided only in order to help understanding the service functionality, without the need to develop a client application.


    Image Added

    Access via API

    REST interface

    Warning
    titleImportant

    In order to access:

    • You must have an account in the TEST LDAP (https://ext-test.eurocontrol.int).
    • A security certificate must be installed on the local application. This also applies in the case that a web browser is used for the REST calls described here. Please contact aim@eurocontrol.int in order to get the certificate and further instructions about it.

    The prototype service may be accessed through a REST interface. The Swagger documentation provided below contains further details.

    Example calls

    In order to get airports, the following call is used:

    In order to get all non-AIRAC datasets, the following call is used:


    Info
    titledatasets

    The complete list of parameters in this case is: 

    • https://ext-test.eurocontrol.int:10444/aeronautical_dataset/datasets?
      • airacUpdate=
      • &airportDesignators=
      • &airportNames=
      • &airportsIataCodes=
      • &airportsIds=
      • &airspaceDesignators=
      • &airspaceNames=
      • &airspaceTypes=
      • &airspacesIds=
      • &countriesCode=
      • &countriesIds=
      • &countriesName=
      • &dataSubjectIds=
      • &datasetSeriesId=
      • &datasetSeriesTitle=
      • &dpsFileId=
      • &effectiveDate=
      • &encodingId=
      • &endValidity=
      • &limitationOnUse=
      • &operatorEffectiveDate=
      • &operatorPublicationDate=
      • &publicationDate=
      • &title=
      • &typeId=
      • &updateTypeId=

    API documentation generation


    Info
    titleGenerate from provided JSON file

    You can use the following steps to generate your own documentation and client

    There are a lot of possibilities with swagger to generate a client. You can find all the possibilities on the official documentation : https://swagger.io/tools/swagger-codegen/

    Info
    titleGenerate from scratch

    You can regenerate the JSON file following this URL

    If you use this URL to generate the JSON you will notice the host is set as : webprisme-test.cfmu.eurocontrol.int.  You should change it to ext-test.eurocontrol.int:10444