Page tree
Skip to end of metadata
Go to start of metadata

 

IdMaps

IdMaps are defined to map internal location and parameter ID's to external location and parameter ID's. The configuration of these can be done in two ways. In the first separate mappings can be defined for the locations and for the parameters. Although this is the most efficient method, it is not suitable in all cases, as specific locations may require a different mapping. A second definition can be created where the mapping is done on the basis of the unique combination of location/parameter. Each IdMap configuration may only use one method of defining mappings to avoid ambiguity.

In older FEWS versions each IdMap configured must be registered in the IdMapsDescriptors configuration (see Regional Configuration). The Id used in registering the IdMap is the same as the name of the configuration. In more recent versions of FEWS (2010 and later) this is no longer necessary.

When available on the file system, the name of the XML file for configuring an IdMap called for example ImportNWP may be:

ImportNWP 1.00 default.xml

ImportNWP

Fixed file name for the ImportNWP IdMap.

1.00

Version number

default

Unit to indicate the version is the default configuration (otherwise omitted).


Figure 155 Root element of the IdMaps configuration

parameter

Mapping of internal to external parameters. Multiple entries may exist.

Attributes;

  • internal : Internal parameter Id (must be in the parameters configuration)
  • external : External parameter Id (free format string)
  • externalQualifier : Optional additional qualifier to uniquely identify a parameter (for use in conjunction with EA-XML schema only.
    location
    Mapping of internal to external location Id's. Multiple entries may exist.

Attributes;
internal : internal location Id (must be in the location configuration )
external : external location Id (free format string)

map

Parameter/location mapping using unique combination. Multiple entries may exist.

Attributes;

  • internalParameter : Internal parameter Id (must be in the parameters configuration)
  • internalLocation : internal location Id (must be in the location configuration )
  • internalQualifier : Optional internal qualifier
  • internalQualifierN (N=1..4) : Optional additional internal qualifier
  • internalEnsembleId : Optional internal ensemble id
  • internalEnsembleMemberIndex : Optional internal ensemble member index
  • internalEnsembleMemberId : Optional. Can be used instead of the internalEnsembleMemberIndex when the id is not an integer.
  • externalParameter : External parameter Id (free format string)
  • externalLocation : external location Id (free format string)
  • externalQualifier : Optional external qualifier. The file format must support qualifiers for this (e.g. EA-XML).
  • externalQualifierN (N=1..4) : Optional additional external qualifiers.
  • externalEnsemble : Optional external ensemble id.
  • externalEnsembleMemberIndex : Optional external member
  • externalEnsembleMemberId : Optional. Can be used instead of the externalEnsembleMemberIndex when the id is not an integer. Only works when non integer member ids are supported by the file format.

Qualifier and ensemble member and index can be specified only for external or internal.
e.g. You can map different external parameters to one internal parameter and different ensemble members.


ignoreExternalQualifiersWhenMappingToInternal

Allow mapping of external id's with qualifiers to internal id's where the external qualifiers are optional. Se the following example where the parameter P.meting is mapped to the external NEERSG parameter with some external qualifiers. When the ignoreExternalQualifiersWhenMappingToInternal is used in the idMapping configuration, the external parameter NEERSG will be mapped to P.meting.

    <parameter internal="P.meting" external="NEERSG" externalQualifier="mm" externalQualifier1="NVT" externalQualifier2="LT"/>

A typical use case is using de FEWS PI Service with the EXPORT_ID_MAP_ID configured in the FEWS Web Services configuration FewsPiService.properties.


  • No labels