Home

NeSS Data Exchange User Guide v0.2

1. amp Office for User Guide National Statistics NeSS Data Exchange 2 3 2 Message Element There are three message types AuthorizationFailure These errors only occur when the username and password are correct but the username has not been granted the web services role by the NeSS support team ValidationFailure Validation of the XML against the XSD occurs outside of the web service Validation errors are thrown when the parameters supplied are incorrect In the example above a non existent dataset id is supplied SystemFailure This is where an unexpected error has occurred when processing the request The user has submitted valid parameters but the request has failed for some reason 2 3 3 Code Element This is a four section delimited code for the benefit of ONS in tracking down errors Project Name Class Name Method Name Short Error Description The names do not exactly match the real classes and methods for security reasons The final Short Error Description may be of use to clients as it contains further detail as to the nature of the failure that may be shared across several different methods E G ValidationFailure can have Short Error Descriptions including ERROR_AREA Area Not Found or ERROR_HIER Hierarchy Not Found or ERROR_DATASET Dataset not found 2 3 4 Detail Element This is the most useful part for the user as it describes the reason for the failure in English Office for
2. amp Office for User Guide National Statistics NeSS Data Exchange NeSS Data Exchange Neighbourhood Statistics Web Services User Guide Beta Version Office for National Statistics 2008 Page 1 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange Office for National Statistics 2008 Page 2 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange 1 Neighbourhood Statistics Data Exchange Beta User Guide aa 5 Tvl BACkKQFOUNG ag seems vas g s ai teens SEAN EE desires 5 1 2 Discovery S rvic s sviedrus us SR ii E ej 6 1 3 Delivery Services srra en seters eesti era vts 6 LA Registering to use this service 1 aaraa 7 LS Awareness and feedb ck sve ss in RR NEET alu gr ds 7 1 6 Contact Information sis sodam seska n m S XT RX iaa 03 S dies REN NEE SEENEN EEN An 7 2 Annex A Discovery Service esse esse esse essen nenen ennenen ennenen e 8 SNE e tie E EE 9 2 11 USCKIG BET 9 22 EMG ROME EE 9 2 2 Discovery OPERatlONS iis eege NEE vad weed cance ketene nea NENNEN NEE EN UE 10 E NEE Ee E TEE 10 22 2 G t r abD t il issues duetam von aS 11 2 2 3 Getkli rarchi s ssssaw an s ta vi smag nt
3. amp Office for User Guide National Statistics NeSS Data Exchange lt lgdx Boundary Code 24 Name Hampshire BoundaryId 2 gt lt Igdx SpatialData gt lt lgdx Polygon gt lt lgdx Point gt lt lgdx XCoordinate gt 403095 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 89692 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 403095 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 165381 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 488767 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 89692 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 488767 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 165381 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Polygon gt lt lgdx SpatialData gt lt lgdx Boundary gt lt lgdx Boundaries gt lt lgdx Topics gt lt lgdx Topic Commentary Unit Count Title 2001 Population All people TopicId 3 gt lt lgdx Topic Commentary Unit Count Title 2001 Population Males TopicId 4 gt lt lgdx Topic Commentary Unit Count Title 2001 Population Females TopicId 5 gt lt lgdx Topic Commentary Unit Count Title People living in households TopicId 6 gt lt lgdx Topic Commentary Unit Count Title People living in communal establishments TopicId 7 gt lt lgdx Topic Commentary Unit Count Title Number of students a
4. lt operation name SearchAreaByNameHierarchy gt lt input name SearchAreaByNameHierarchyReguest message tns SearchAreaByNameHierarchyReguest gt lt output name SearchAreaByNameHierarchyResponse message tns SearchAreaByNameHierarchyResponse gt lt fault name NeSSProcessingProblem message tns NeSSProcessingProblem gt lt operation gt Office for National Statistics 2008 Page 25 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange Sample Query lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmlns wsu http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity utility 1 0 xsd gt lt soap Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmIns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmins env http schemas xmlsoap org soap envelope soap mustUnderstand 1 gt lt wsse UsernameToken xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd gt lt wsse Username gt gimme data stats com lt wsse Username gt lt wsse Password Type http docs oasis open org wss 2004 01 oasis 200401 wss username token profile 1 04 Pa
5. 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange WSDL Definition lt operation name GetVariableFamilies gt lt input name VariableFamiliesRequest message tns VariableFamiliesRequest gt lt output name VariableFamiliesResponse message tns VariableFamiliesResponse gt lt fault name NeSSProcessingProblem message tns NeSSProcessingProblem gt lt operation gt Sample Query lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmlns wsu http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity utility 1 0 xsd gt lt soap Header gt lt wsse Security xmIns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns env http schemas xmlsoap org soap envelope soap mustUnderstand 1 gt lt wsse UsernameToken xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd gt lt wsse Username gt gimme data stats com lt wsse Username gt lt wsse Password Type http docs oasis open org wss 2004 01 oasis 200401 wss username token profile 1 04PasswordText gt Ima5tatto lt wsse Password gt lt wsse UsernameToken gt lt wsse
6. Name gt lt MeasurementUnit gt lt MUId gt 1 lt MUId gt lt Name gt Count lt Name gt lt MeasurementUnit gt lt StatisticalUnit gt lt SUId gt 2 lt SUId gt lt Name gt Households lt Name gt lt StatisticalUnit gt lt VarFamily gt lt VarFamilies gt lt ns0 VariableFamiliesResponseElement gt lt env Body gt lt env Envelope gt Office for National Statistics 2008 Page 23 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange 2 2 8 SearchSByAByName Description The two SByA operations simulate the behaviour of the Statistics By Area facility on the NeSS web site In order to speed up and simplify the area selection process a number of potential user choices are automated A table of rules is used to make these choices One principal choice is that for each potentially matching area a selection is made of the most appropriate Hierarchy taking into account time and boundary name changes This saves selecting between e g 1998 2003 2004 Fareham Ward as the system chooses the 2004 Fareham Ward as most appropriate This operation allows you to supply a name or part of a name and all matching areas with the specified level type are returned In the example below we are searching for LAs type 13 with the characters york as part of the name If no match is found for a
7. docs oasis open org wss 2004 01 oasis 200401 wss username token profile 1 04 PasswordText gt Iam5tatto lt wsse Password gt lt wsse UsernameToken gt lt wsse Security gt lt soap Header gt lt soap Body xmlns ns1 http neighbourhood statistics gov uk dissemination resources wsdl deliveryservice gt lt ns1 getDataCubeElement gt lt DataCubeQueryMessage xmlns xsi http www w3 org 2001 XMLSchema instance xmins http neighbourhood statistics gov uk dissemination resources schemas datacubequery xsi schemaLocation http neighbourhood statistics gov uk dissemination resources schemas datacubequery NeSSDataCubeQueryMessage v0 4 xsd version 0 5 gt lt Query repository NeSS type custom gt lt Dimension name dataset gt lt Item code 724 gt lt Dimension gt lt Dimension name variablefamily isMeasuredDimension true gt lt Group dimension dataset code 724 type all gt lt Dimension gt lt Dimension name area isSpatialDimension true gt lt Item gt lt HierarchyArea gt lt Areald gt 276980 lt Areald gt lt HierarchyArea gt lt Item gt lt Item gt lt HierarchyArea gt lt Areald gt 276722 lt Areald gt lt HierarchyArea gt lt Item gt lt Dimension gt lt SeriesGrouping gt lt SeriesGroup dimension dataset gt lt SeriesGrouping gt lt Query gt lt DataCubeQueryMessage gt lt nsi getDataCubeElement gt lt soap Body gt lt soap Envelope gt Explanations
8. lt Igdx ArtefactDescription gt lt lgdx Metadata gt lt lgdx ArtefactTitle gt National Statistics Socio economic Classification All People KS14A lt lgdx ArtefactTitle gt lt lgdx HostReference gt 41 lt lgdx HostReference gt lt lgdx Boundaries gt lt lgdx Boundary Code 24UE Name Fareham BoundaryId 1 gt lt Igdx SpatialData gt lt lgdx Polygon gt lt lgdx Point gt lt lgdx XCoordinate gt 448760 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 101385 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 448760 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 111270 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 462605 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 101385 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 462605 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 111270 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Polygon gt lt lgdx SpatialData gt lt lgdx Boundary gt lt lgdx Boundary Code 24 Name Hampshire BoundaryId 2 gt lt lgdx SpatialData gt lt lgdx Polygon gt lt lgdx Point gt lt lgdx XCoordinate gt 403095 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 89692 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 403095 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 165381 lt lgdx YCoordinate gt lt lgdx Point gt l
9. 1 0 xsd xmIns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmins env http schemas xmlsoap org soap envelope soap mustUnderstand 1 gt lt wsse UsernameToken xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd gt lt wsse Username gt gimme data stats com lt wsse Username gt lt wsse Password Type http docs oasis open org wss 2004 01 oasis 200401 wss username token profile 1 0 PasswordText gt Iam5tatto lt wsse Password gt lt wsse UsernameToken gt lt wsse Security gt lt soap Header gt lt soap Body xmlns ns1 http neighbourhood statistics gov uk dissemination resources wsdl deliveryservice gt lt ns1 getDataCubeElement gt lt DataCubeQueryMessage xmlns xsi http www w3 org 2001 XMLSchema instance xmins http neighbourhood statistics gov uk dissemination resources schemas datacubequery xsi schemaLocation http neighbourhood statistics gov uk dissemination resources schemas datacubequery NeSSDataCubeQueryMessage v0 4 xsd version 0 5 gt lt Query repository NeSS type custom gt lt Dimension name dataset gt lt Item code 1354 gt lt Dimension gt lt Dimension name variablefamily isMeasuredDimension true gt lt Group dimension dataset code 1354 type all gt lt Dimension gt lt Dimension name area isSpatialDimens
10. BoundaryId 1 gt lt lgdx Dataltem Value 180 PeriodId 5 TopicId 17 BoundaryId 1 gt lt lgdx Dataltem Value 1080 PeriodId 1 TopicId 18 BoundaryId 1 gt lt lgdx Dataltem Value 1050 PeriodId 2 TopicId 18 BoundaryId 1 gt lt lgdx Dataltem Value 1070 PeriodId 3 TopicId 18 BoundaryId 1 gt lt lgdx Dataltem Value 990 PeriodId 4 TopicId 18 BoundaryId 1 gt lt lgdx Dataltem Value 950 PeriodId 5 TopicId 18 BoundaryId 1 gt lt lgdx Dataltem Value 270 PeriodId 1 TopicId 19 BoundaryId 1 gt lt lgdx Dataltem Value 280 PeriodId 2 TopicId 19 BoundaryId 1 gt lt lgdx Dataltem Value 280 PeriodId 3 TopicId 19 BoundaryId 1 gt lt lgdx Dataltem Value 270 PeriodId 4 TopicId 19 BoundaryId 1 gt lt lgdx Dataltem Value 280 PeriodId 5 TopicId 19 BoundaryId 1 gt lt lgdx Dataltem Value 1810 PeriodId 1 TopicId 20 BoundaryId 1 gt lt lgdx Dataltem Value 1780 PeriodId 2 TopicId 20 BoundaryId 1 gt lt lgdx Dataltem Value 1810 PeriodId 3 TopicId 20 BoundaryId 1 gt lt lgdx Dataltem Value 0 PeriodId 4 TopicId 20 BoundaryId 1 gt lt lgdx Dataltem Value 0 PeriodId 5 TopicId 20 BoundaryId 1 gt lt lgdx Dataltem Value 460 PeriodId 1 TopicId 21 BoundaryId 1 gt lt lgdx Dataltem Value 370 PeriodId 2 TopicId 21 BoundaryId 1 gt lt lgdx Dataltem Value 420 PeriodId 3 TopicId 21 BoundaryId 1 gt lt lgdx Data
11. DataSourceName This is always NESS rather than our original supplier Had we used the original supplier it would have bloated the response for multiple datasets ArtefactTitle This is the dataset title from the NeSS database ArtefactDescription Any metadata held for the dataset on the NeSS database Boundary The code is the SNAC code for the area The four points are the area s envelope This is held as a string Minx MinY MaXX MaxY OS easting northing on the NeSS database but there is no attribute in LGDX for it so a polygon has to be created Note that there may be metadata for areas in the intermediate NeSS ML output but there is no slot for it in the final LGDX output Topic NeSS variables become Topics in LGDX Any mandatory metadata held for the variable on the NeSS database is passed through to the Commentary attribute Period Each time instance for which data is held gives rise to a separate period element with its own start and end date Dataltem Each of these is the eguivalent of a table cell referenced by the internal identifiers for period topic and boundary Office for National Statistics 2008 Page 46 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange 3 2 2 Multiple Datasets Grouped Example Query 2 In this example the query is reques
12. Security gt lt soap Header gt lt soap Body xmlns ns2 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt ns2 VariableFamiliesElement gt lt DSFamilyId gt 149 lt DSFamilyId gt lt ns2 VariableFamiliesElement gt lt soap Body gt lt soap Envelope gt Sample Response lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt env Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmIns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmins env http schemas xmlsoap org soap envelope env mustUnderstand 1 gt lt env Header gt lt env Body gt lt ns0 VariableFamiliesResponseElement gt lt VarFamilies gt lt VarFamily gt lt VarFamilyId gt 2317 lt VarFamilyId gt lt Name gt All Household Spaces lt Name gt lt MeasurementUnit gt lt MUId gt 1 lt MUId gt lt Name gt Count lt Name gt lt MeasurementUnit gt lt StatisticalUnit gt lt SUId gt 2 lt SUId gt lt Name gt Households lt Name gt lt StatisticalUnit gt lt VarFamily gt lt VarFamily gt lt VarFamilyId gt 2318 lt VarFamilyId gt lt Name gt In an Unshared Dwel
13. To_Date 2001 08 01 From_Date 2001 08 01 PeriodId 1 gt lt lgdx Period To_Date 2002 08 01 From_Date 2002 08 01 PeriodId 2 gt lt lgdx Period To_Date 2003 08 01 From_Date 2003 08 01 PeriodId 3 gt lt lgdx Period To_Date 2004 08 01 From_Date 2004 08 01 PeriodId 4 gt lt lgdx Period To_Date 2005 08 01 From_Date 2005 08 01 PeriodId 5 gt lt lgdx Periods gt lt lgdx DatasetItems gt lt lgdx Dataltem Value 740 PeriodId 1 TopicId 1 BoundaryId 1 gt lt lgdx Dataltem Value 660 PeriodId 2 TopicId 1 BoundaryId 1 gt lt lgdx Dataltem Value 650 PeriodId 3 TopicId 1 BoundaryId 1 gt lt lgdx Dataltem Value 570 PeriodId 4 TopicId 1 BoundaryId 1 gt lt lgdx Dataltem Value 540 PeriodId 5 TopicId 1 BoundaryId 1 gt lt lgdx Dataltem Value 1830 PeriodId 1 TopicId 2 BoundaryId 1 gt lt lgdx Dataltem Value 1800 PeriodId 2 TopicId 2 BoundaryId 1 gt lt lgdx Dataltem Value 1830 PeriodId 3 TopicId 2 BoundaryId 1 gt lt lgdx Dataltem Value 110 PeriodId 4 TopicId 2 BoundaryId 1 gt lt lgdx Dataltem Value 90 PeriodId 5 TopicId 2 BoundaryId 1 gt lt lgdx Dataltem Value 8 PeriodId 1 TopicId 3 BoundaryId 1 gt lt lgdx Dataltem Value 7 PeriodId 2 TopicId 3 BoundaryId 1 gt lt lgdx Dataltem Value 6 PeriodId 3 TopicId 3 BoundaryId 1 gt lt lgdx Dataltem Value 13 PeriodId 4 TopicId 3 BoundaryId 1 gt Office
14. dataset shows both the 2001 population the 1991 population along with the rate of change the split of the population between those living in households and those living in communal establishments the size of the area in hectares population density and the number of students away from home in the area lt lgdx ArtefactDescription gt lt lgdx Metadata gt lt lgdx ArtefactTitle gt Usual Resident Population KS01 lt lgdx ArtefactTitle gt lt lgdx HostReference gt 67 lt lgdx HostReference gt lt lgdx Boundaries gt lt lgdx Boundary Code 24UE Name Fareham BoundaryId 1 gt lt lgdx SpatialData gt lt Igdx Polygon gt lt Igdx Point gt lt lgdx XCoordinate gt 448760 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 101385 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 448760 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 111270 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 462605 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 101385 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 462605 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 111270 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Polygon gt lt lgdx SpatialData gt lt lgdx Boundary gt Office for National Statistics 2008 Page 48 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc
15. for National Statistics 2008 Page 43 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc Office for a National Statistics User Guide NeSS Data Exchange lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx lt Igdx Dataltem Value 13 Dataltem Value 31 Dataltem Value 31 Dataltem Value 32 Dataltem Value 68 Dataltem Value 67 PeriodId 5 TopicId 3 BoundaryId 1 gt PeriodId 1 TopicId 4 BoundaryId 1 gt PeriodId 2 TopicId 4 BoundaryId 1 gt PeriodId 3 TopicId 4 BoundaryId 1 gt PeriodId 4 TopicId 4 BoundaryId 1 gt PeriodId 5 TopicId 4 BoundaryId 1 gt Dataltem Value 8 PeriodId 1 TopicId 5 BoundaryId 1 gt Dataltem Value 8 PeriodId 2 To
16. gives you a list of these It returns a list of current level types on the NeSS database belonging to the specified hierarchy The list is ordered from largest to smallest area So what is a level type It is a general type of area about which data is held for example a Local Authority LA a level type can exist in more than one hierarchy but there is only one level type per level in each hierarchy WSDL Definition lt operation name GetLevelTypesByHierarchy gt lt input name LevelTypesByHierarchyRequest message tns LevelTypesByHierarchyRequest gt lt output name LevelTypesByHierarchyResponse message tns LevelTypesByHierarchyResponse gt lt fault name NeSSProcessingProblem message tns NeSSProcessingProblem gt lt operation gt Sample Query lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmlns wsu http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity utility 1 0 xsd gt lt soap Header gt lt wsse Security xmIns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmins env http schemas xmlsoap org soap envelope soap mustUnderstand 1 gt lt wsse UsernameToken xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xs
17. gt lt AreaFallsWithin gt lt AreaFallsWithin gt lt Area gt lt Areald gt 3567612 lt Areald gt lt Name gt Yorkshire and The Humber lt Name gt lt HierarchyId gt 10 lt HierarchyId gt lt LevelTypeld gt 11 lt LevelTypeld gt lt Area gt lt FallsWithin xsi nil 1 gt lt AreaFallsWithin gt lt AreaFallsWithin gt lt Area gt lt Areald gt 3567601 lt Areald gt lt Name gt England lt Name gt lt HierarchyId gt 10 lt HierarchyId gt lt LevelTypeld gt 10 lt LevelTypeld gt lt Area gt lt FallsWithin xsi nil 1 gt lt AreaFallsWithin gt lt AreaFallsWithin gt lt Area gt lt Areald gt 3567607 lt Areald gt lt Name gt England and Wales lt Name gt lt HierarchyId gt 10 lt HierarchyId gt lt LevelTypeld gt 9 lt LevelTypeld gt lt Area gt lt FallsWithin xsi nil 1 gt lt AreaFallsWithin gt lt AreaFallsWithin gt lt Area gt lt Areald gt 3567608 lt Areald gt lt Name gt Great Britain lt Name gt lt HierarchyId gt 10 lt HierarchyId gt lt LevelTypeld gt 8 lt LevelTypeld gt lt Area gt lt FallsWithin xsi nil 1 gt lt AreaFallsWithin gt lt AreaFallsWithin gt lt Area gt lt Areald gt 3567790 lt Areald gt lt Name gt United Kingdom lt Name gt lt HierarchyId gt 10 lt HierarchyId gt lt LevelTypeld gt 7 lt LevelTypeld gt lt Area gt lt FallsWithin xsi nil 1 gt lt AreaFallsWithin gt lt AreaFallsWithins gt Office for National Statistics 2
18. gt lt MeasurementUnit gt lt StatisticalUnit gt lt SUId gt 2 lt SUId gt lt Name gt Households lt Name gt lt StatisticalUnit gt lt VarFamily gt lt VarFamily gt lt VarFamilyId gt 2322 lt VarFamilyId gt lt Name gt In an Unshared Dwelling House or Bungalow Terraced including end terrace lt Name gt lt MeasurementUnit gt lt MUId gt 1 lt MUId gt lt Name gt Count lt Name gt lt MeasurementUnit gt lt StatisticalUnit gt lt SUId gt 2 lt SUId gt lt Name gt Households lt Name gt lt StatisticalUnit gt lt VarFamily gt lt VarFamily gt lt VarFamilyId gt 2323 lt VarFamilyId gt lt Name gt In an Unshared Dwelling Flat Maisonette or Apartment lt Name gt lt MeasurementUnit gt lt MUId gt 1 lt MUId gt lt Name gt Count lt Name gt lt MeasurementUnit gt lt StatisticalUnit gt lt SUId gt 2 lt SUId gt lt Name gt Households lt Name gt lt StatisticalUnit gt lt VarFamily gt lt VarFamily gt lt VarFamilyId gt 2324 lt VarFamilyId gt lt Name gt In an Unshared Dwelling Flat Maisonette or Apartment In a Purpose Built Block of Flats lt Name gt Office for National Statistics 2008 Page 22 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange lt MeasurementUnit gt lt MUId gt 1 lt MUId gt lt Name gt Count lt Name gt lt MeasurementUni
19. gt lt ns0 SearchAreaByPostcodeLevelTypeResponseElement gt lt AreaFallsWithins gt lt AreaFallsWithin gt lt Area gt lt Areald gt 789827 lt Areald gt lt Name gt South West London lt Name gt lt HierarchyId gt 8 lt HierarchyId gt lt LevelTypeld gt 81 lt LevelTypeld gt lt Area gt lt FallsWithin xsi nil 1 gt lt AreaFallsWithin gt lt AreaFallsWithins gt lt ns0 SearchAreaByPostcodeLevelTypeResponseElement gt lt env Body gt lt env Envelope gt Office for National Statistics 2008 Page 34 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange 2 3 Error Messages Each operation returns a SOAP Fault message containing a NeSSProcessingProblemElement if it fails Each NeSSProcessingProblemElement consists of message code and detail subelements Note that if the XML is invalid against the XSD an SOAP Client fault will be returned without a NeSSProcessingProblemElement 2 3 1 Sample Message Server Fault lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt env Body gt lt env Fault xsi type env Fault gt lt faultcode gt env Server lt faultcode g
20. information they require Delivery Services enable the NeSS system to be interrogated using the user s criteria All data that matches the criteria will then be sent to the user The output will be in the LGDX format of XML For an external system to utilise these services changes will be required to your system to enable the functionality offered Further guidance in the form of technical specifications and examples to assist in the incorporation of the Delivery services into your system are contained in Annex B Office for National Statistics 2008 Page 6 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange 1 4 Registering to use this service All service users must be registered with the Neighbourhood Statistics team to be allowed to use the Web Service There are also strong security measures provided by SSL in place to protect all data transfers To use the service we will also ensure that users have a HMSO click use licence for the re use of the information provided through NeSS To register to use the service you should contact Email better info ons gov uk 1 5 Awareness and feedback The ESD Toolkit will provide a forum for LIS users to discuss issues swap experiences and talk about new functionality that the service could provide in the future This is seen as an important way to communicate futu
21. lt HierarchyId gt lt LevelTypeld gt 14 lt LevelTypeld gt lt Area gt lt FallsWithin gt lt Area gt lt Areald gt 277115 lt Areald gt lt Name gt St Edmundsbury lt Name gt lt HierarchyId gt 2 lt HierarchyId gt lt LevelTypeld gt 13 lt LevelTypeld gt lt Area gt lt FallsWithin gt lt AreaFallsWithin gt lt AreaFallsWithin gt lt Area gt lt Areald gt 5942271 lt Areald gt lt Name gt East Wickham lt Name gt lt HierarchyId gt 11 lt HierarchyId gt lt LevelTypeld gt 14 lt LevelTypeld gt lt Area gt lt FallsWithin gt lt Area gt lt Areald gt 276746 lt Areald gt lt Name gt Bexley lt Name gt lt HierarchyId gt 2 lt HierarchyId gt lt LevelTypeld gt 13 lt LevelTypeld gt lt Area gt lt FallsWithin gt lt AreaFallsWithin gt lt AreaFallsWithins gt lt ns0 SearchAreaByNameLevelTypeResponseElement gt lt env Body gt lt env Envelope gt 2 2 11 SearchSByAByPostcode Description The two SByA operations simulate the behaviour of the Statistics By Area facility on the NeSS web site In order to speed up and simplify the area selection process a number of potential user choices are automated A table of rules is used to make these choices A selection is made of the most appropriate Hierarchy taking into account time and boundary name changes This operation allows you to supply a postcode and a single area with the specified level type is returned In the example below we a
22. lt AreaFallsWithins gt lt AreaFallsWithin gt lt Area gt lt Areald gt 276822 lt Areald gt lt Name gt East Riding of Yorkshire lt Name gt lt HierarchyId gt 2 lt HierarchyId gt lt LevelTypeld gt 13 lt LevelTypeld gt lt Area gt lt FallsWithin xsi nil 1 gt lt AreaFallsWithin gt lt AreaFallsWithin gt lt Area gt lt Areald gt 276825 lt Areald gt lt Name gt York lt Name gt lt HierarchyId gt 2 lt HierarchyId gt lt LevelTypeld gt 13 lt LevelTypeld gt lt Area gt lt FallsWithin xsi nil 1 gt lt AreaFallsWithin gt lt AreaFallsWithins gt lt ns0 SearchSByAByNameResponseElement gt lt env Body gt lt env Envelope gt 2 2 9 SearchAreaByNameHierarchy Description This operation allows you to search for an area in a particular hierarchy The parameters are a string which is all or part of the each matching area s name and the hierarchy id obtained from getHierarchies Some strings such as West could give a large number of results Large results sets can also be obtained from the NeSS Geography Hierarchy as LSOAs are named Fareham 001A Fareham 001B etc If no match is found for a valid area string an empty response is returned The area is sent with a falls within area attached This is the area that the rules table thinks is the most suitable parent or grandparent area and will not necessarily be in the same hierarchy The falls within area can be nil WSDL Definition
23. ns0 LevelTypesByHierarchyResponseElement gt lt LevelTypes gt lt LevelType gt lt LevelTypeld gt 9 lt LevelTypeld gt lt Name gt EW lt Name gt lt LevelType gt lt LevelType gt lt LevelTypeld gt 10 lt LevelTypeld gt lt Name gt CTRY lt Name gt lt LevelType gt lt LevelType gt lt LevelTypeld gt 11 lt LevelTypeld gt lt Name gt GOR lt Name gt lt LevelType gt lt LevelType gt lt LevelTypeld gt 13 lt LevelTypeld gt lt Name gt LA lt Name gt lt LevelType gt lt LevelType gt lt LevelTypeld gt 16 lt LevelTypeld gt lt Name gt P lt Name gt lt LevelType gt lt LevelTypes gt lt ns0 LevelTypesByHierarchyResponseElement gt lt env Body gt lt env Envelope gt 2 2 6 GetSubjectTree Description This operation has no parameters and returns a nested tree of subjects by datasets with supported data ranges for each dataset The datasets listed are datasetfamilies each of which has one or more datasetinstances see getVariableFamilies for a fuller description of families and instances each one of these being shown by a DateRange element Often the DateRange is a single day on which the data was collected There was some debate about whether or not a tree is the best way to supply this information or if lower level calls e g getSubjects getDatasetsForSubject would be better WSDL Definition lt operation name GetSubjectTree gt lt input name SubjectTreeRequest message tns Su
24. ns0 SubjectTreeResponseElement gt lt env Body gt lt env Envelope gt 2 2 7 GetVariableFamilies Description This operation gives you the variable family ids for a dataset In the NeSS Database we use the concept of families and instances A dataset that is collected annually would have an instance for each year So an example of a family would be Unempolyment Stats and its instances Unemployment Stats 2000 Unemployment Stats 2001 etc Within each dataset we call the constituent items variables TOPIC in LGDX In our example the variable families might be Unemployed females Unemployed males and Unemployed IT developers These families would have corresponding variable instances under all of the datestet instances except where a variable is added or removed over time For example in 2005 ONS decided to no longer count unemployed IT developers For each variable we return its id name measurement unit and statistical unit A measurement unit is a count rate percentage etc and a statistical unit is a person household etc So percentage of households with broadband would have measurement unit percentage statistical unit household Note that we return MUId and SUId even though they appear to be no use as metadata calls such as getMeasurementUnitDetail and getStatisticalUnitDetail might be added ina future release Office for National Statistics 2008 Page 20 of 60 Issue No
25. port gt lt wsdl service gt Office for National Statistics 2008 Page 9 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange 2 2 Discovery Operations 2 2 1 GetAreaAtLevel Description This operation gives you child areas for a known area id This Areald is internal to the NeSS database and must have been previously obtained via other discovery calls Your application needs a list of level types see GetLevelTypes In the example below the start areaid 276704 is West Midlands region in the NeSS Geography hierarchy and we are asking for type 12 children Type 12 is County So in effect we are asking Give me all the counties in West Midlands Use getAreaDetail to get more information on these areas if required Note that the areas are not explicitly output in any order though they may appear ordered WSDL Definition lt operation name GetAreaAtLevel gt lt input name AreaAtLevelReguest message tns AreaAtLevelRequest gt lt output name AreaAtLevelResponse message tns AreaAtLevelResponse gt lt fault name NeSSProcessingProblem message tns NeSSProcessingProblem gt lt operation gt Sample Query lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmlns wsu http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity utility 1 0 xsd g
26. valid area string an empty response is returned The area is sent with a falls within area attached This is the area that the rules table thinks is the most suitable parent or grandparent area and will not necessarily be in the same hierarchy The falls within area can be nil WSDL Definition lt operation name SearchSByAByName gt lt input name SearchSByAByNameRequest message tns SearchSByAByNameRequest gt lt output name SearchSByAByNameResponse message tns SearchSByAByNameResponse gt lt fault name NeSSProcessingProblem message tns NeSSProcessingProblem gt lt operation gt Sample Query lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmlns wsu http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity utility 1 0 xsd gt lt soap Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmIns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns env http schemas xmlsoap org soap envelope soap mustUnderstand 1 gt lt wsse UsernameToken xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd gt lt wsse Username gt gimme data stats com lt wsse Username gt lt wsse Password Type http docs oasis open org wss 2004 01 oasis 200401 w
27. 008 Page 32 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange lt ns0 SearchAreaByPostcodeHierarchyResponseElement gt lt env Body gt lt env Envelope gt 2 2 13 SearchAreaByPostcodeLevelType Description This operation allows you to search for an area with a particular level type You can get similar areas from multiple hierarchies e g 2003 and 2004 version of the Admin hierarchy The parameters the level type id from getLevelTypes and a postcode complete If no match is found for a valid postcode string an empty response is returned The area is sent with a falls within area attached This is the area that the rules table thinks is the most suitable parent or grandparent area and will not necessarily be in the same hierarchy The falls within area can be nil Note that hierarchies with incomplete coverage such as parishes do affect the results Search by Name for Fareham LevelType LA and you get a match in hierarchies 2 3 4 9 and 11 Search by Postcode for PO155RR LevelType LA and you get a match in hierarchies 2 3 4 and 11 The reason is that although Fareham exists as an LA in the Parish Hierarchy 9 there are no parishes in Fareham so this breaks the chain Search by Postcode is implemented as 1 Find Postcode 2 Go from Postcode to its Output Area in the NeSS Georgap
28. 1 gt PeriodId 3 TopicId 7 BoundaryId 1 gt PeriodId 4 TopicId 7 BoundaryId 1 gt PeriodId 5 TopicId 7 BoundaryId 1 gt PeriodId 1 TopicId 8 BoundaryId 1 gt PeriodId 2 TopicId 8 BoundaryId 1 gt PeriodId 3 TopicId 8 BoundaryId 1 gt PeriodId 4 TopicId 8 BoundaryId 1 gt PeriodId 5 TopicId 8 BoundaryId 1 gt PeriodId 1 TopicId 9 BoundaryId 1 gt PeriodId 2 TopicId 9 BoundaryId 1 gt PeriodId 3 TopicId 9 BoundaryId 1 gt PeriodId 4 TopicId 9 BoundaryId 1 gt PeriodId 5 TopicId 9 BoundaryId 1 gt PeriodId 1 TopicId 10 BoundaryId 1 gt PeriodId 2 TopicId 10 BoundaryId 1 gt PeriodId 3 TopicId 10 BoundaryId 1 gt PeriodId 4 TopicId 10 BoundaryId 1 gt PeriodId 5 TopicId 10 BoundaryId 1 gt PeriodId 1 TopicId 11 BoundaryId 1 gt PeriodId 2 TopicId 11 BoundaryId 1 gt PeriodId 3 TopicId 11 BoundaryId 1 gt PeriodId 4 TopicId 11 BoundaryId 1 gt PeriodId 5 TopicId 11 BoundaryId 1 gt PeriodId 1 TopicId 12 BoundaryId 1 gt PeriodId 2 TopicId 12 BoundaryId 1 gt PeriodId 3 TopicId 12 BoundaryId 1 gt Dataltem Value 8 PeriodId 4 TopicId 12 BoundaryId 1 gt Dataltem Value 6 PeriodId 5 TopicId 12 BoundaryId 1 gt Dataltem Value 1010 PeriodId 1 TopicId 13 BoundaryId 1 gt Dataltem Value 1010 PeriodId 2 TopicId 13 BoundaryId 1 gt Dataltem V
29. 2 Process 0 1 Many lt th E Message lt 7 Request y Area Area Invalid Level Hierarchy VA Create Error N 4 Message Message b Inputs Not Known Arcai Search Area Ee Return Result V A e Area Structure of the DIE PE below an Area Limits 47 apply Area Structure E Kl etrieve Area Structure KISS Retrieve Area e k Types d List Hierarchy Retrieve N moy vu Hierachies List Topic Retrieve Topic Structure List Variables Retrieve N Variables d E V Send Response gt Create Discovery tas SS Ey End Office for National Statistics 2008 Issue No 0 3 Date 17 04 08 File NeSS_Data_Exchange_User_Guide_v0 2 doc Page 8 of 60 Status Draft amp Office for User Guide National Statistics NeSS Data Exchange 2 1 Getting Started 2 1 1 Userid You need a userid on the NeSS PRODLIVE database Your userid requires the web service user role to be enabled 2 1 2 End Point The following URL should be used https www neighbourhood statistics gov uk interop NeSSDiscoveryBindingPort The delivery WSDL needs to point to the correct end point URL for the application server being connected to PRODLIVE lt wsdl service name NeSSDiscoveryService gt lt wsdl port name NeSSDiscoveryBindingPort binding tns NeSSDiscoveryBinding gt lt soap address location https www neighbourhood statistics gov uk interop NeSSDiscoveryBindingPo rt gt lt wsdl
30. 29 lt startDate gt lt endDate gt 2001 04 29 lt endDate gt lt DateRange gt lt DSFamily gt lt DSFamily gt lt DSFamilyId gt 1073 lt DSFamilyId gt lt Name gt VAT Based Local Units Urban Rural lt Name gt lt DateRange gt lt startDate gt 2005 03 18 lt startDate gt Office for National Statistics 2008 Page 19 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange lt endDate gt 2005 03 18 lt endDate gt lt DateRange gt lt DateRange gt lt startDate gt 2006 03 17 lt startDate gt lt endDate gt 2006 03 17 lt endDate gt lt DateRange gt lt DateRange gt lt startDate gt 2007 03 16 lt startDate gt lt endDate gt 2007 03 16 lt endDate gt lt DateRange gt lt DSFamily gt lt DSFamily gt lt DSFamilyId gt 253 lt DSFamilyId gt lt Name gt VAT Registered Enterprises by Employment Sizeband lt Name gt lt DateRange gt lt startDate gt 2000 03 31 lt startDate gt lt endDate gt 2000 03 31 lt endDate gt lt DateRange gt lt DSFamily gt lt DSFamily gt lt DSFamilyId gt 251 lt DSFamilyId gt lt Name gt VAT Registered Enterprises by Industry Group lt Name gt lt DateRange gt lt startDate gt 2000 03 31 lt startDate gt lt endDate gt 2000 03 31 lt endDate gt lt DateRange gt lt DSFamily gt lt DSFamilies gt lt Branch gt lt SubjectTree gt lt
31. 4UE Name Fareham BoundaryId 1 gt lt Igdx SpatialData gt lt lgdx Polygon gt lt lgdx Point gt lt lgdx XCoordinate gt 448760 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 101385 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 448760 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 111270 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 462605 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 101385 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 462605 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 111270 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Polygon gt lt lgdx SpatialData gt lt lgdx Boundary gt lt lgdx Boundary Code 24 Name Hampshire BoundaryId 2 gt lt lgdx SpatialData gt lt lgdx Polygon gt lt lgdx Point gt lt lgdx XCoordinate gt 403095 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 89692 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 403095 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 165381 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 488767 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 89692 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 488767 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 165381 lt lgdx YCoordinate gt lt lgd
32. 7 2 4 2 Download Only Datasets ss sss esse sss sse eee eee eee eee 37 24 3 Order of s 0 se dT 37 2 44 Provisional Hierarchies x vaza seters aus ea cork EEN SEENEN a 37 3 Annex B Delivery Service css sss cesses sss ee sse ennenen ennenen ennenen 38 3 1 Getting St tt d sesausas seems dsk sea m m 39 KK NEE 39 31 2 End eu EE 39 3 2 Delivery Query Examples aaa aaa 39 3 2 1 Single Dataset All Variables sese e eee eee 39 3 2 2 Multiple Datasets Grouped sss s esse eee eect eee eee eee teeta eens teens 47 3 2 3 Latest D t svaine veras vereta re Cerreek ceru tener tanks re renter dene vneres 53 SC DE e Tel EE 54 8 9 Error MCSSAGES eeh TTT 57 3 3 1 Sampl M ss dg s saws od EE Reegele dd 57 Server Fal egen azra y seu tai RST v ks 57 Client k lilt negen d se deserts tver saan BEEN 58 3 3 2 Message Elem nt sssisg sama era des 58 AuthorizationF llUf s v ci verde end ve ve ret s EE dE REES de 58 Valid tionFailUf sceszisssapbaci e i veter nus vu A 58 U US adobe era m mre beds vasks vali d erences 58 3 3 3 gt Gode Elem ntiseradai snake gai ga 58 3 34 Detail Elem nt saa s NEE DER d SEENEN aka ra SEENEN NEEN as st gl STTS taa 58 BA NOUS desa d ed A S N ater seen 59 3 4 1 Warning About Latest Data Queries id aaa 59 Office for National Statistics 2008 Issue No 0 3 Date 17 04 08 File NeSS_Data_Exchange_User_Guide_v0 2 doc Page 4 of 60 Status Dra
33. Area gt lt FallsWithin gt lt Area gt lt Areald gt 276773 lt Areald gt lt Name gt Waltham Forest lt Name gt lt HierarchyId gt 2 lt HierarchyId gt lt LevelTypeld gt 13 lt LevelTypeld gt lt Area gt lt FallsWithin gt lt AreaFallsWithin gt lt AreaFallsWithins gt lt ns0 SearchAreaByNameHierarchyResponseElement gt lt env Body gt lt env Envelope gt Office for National Statistics 2008 Page 26 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange 2 2 10 SearchAreaByNameLevelType Description This operation allows you to search for an area with a particular level type You can get similar areas from multiple hierarchies e g 2003 and 2004 version of the Admin hierarchy The parameters the level type id from getLevelTypes and a string which is all or part of the each matching area s name Some strings such as South could give a large number of results If no match is found for a valid area string an empty response is returned The area is sent with a falls within area attached This is the area that the rules table thinks is the most suitable parent or grandparent area and will not necessarily be in the same hierarchy The falls within area can be nil WSDL Definition lt operation name SearchAreaByNameLevelType gt lt input name SearchAreaByNameLevelTyp
34. Dataltem Value 30 86 PeriodId 1 TopicId 4 BoundaryId 2 gt lt lgdx DatasetItems gt lt lgdx DataSet gt lt lgdx DataSource gt lt lgdx DataRoot gt lt ns0 getDataCubeResponseElement gt lt env Body gt lt env Envelope gt Office for National Statistics 2008 Page 56 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange 3 3 Error Messages Each operation returns a SOAP Fault message containing a NeSSProcessingProblemElement if it fails Each NeSSProcessingProblemElement consists of message code and detail subelements There are some minor differences between delivery and discovery for delivery there is an addition NeSSDataCubeFault element hangover from the Cafeteria pilot Also the XSD validation is done internally so you get a Server fault instead of a Client fault These differences will be ironed out in the full version 3 3 1 Sample Message Server Fault Validation lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources wsdl deliveryservice gt lt env Body gt lt env Fault xsi type env Fault gt lt faultcode gt env Server lt faultcode gt lt faultstring xsi nil 1 gt lt de
35. Envelope gt 2 2 2 GetAreaDetail Description This is a simple operation which gives you extra information about an area by supplying its Areald This Areald is internal to the NeSS database and must have been previously obtained via other discovery calls In the returned information the Envelope can be used in a GIS system it is the four corners of the map of the area MinX MinY MaxX MaxY these numbers being OS eastings and norhtings The ExtCode is the standard SNAC code for the area There may be metadata for the area or nil elements WDSL Entry lt operation name GetAreaDetail gt lt input name AreaDetailRequest message tns AreaDetailReguest gt lt output name AreaDetailResponse message tns AreaDetailResponse gt lt fault name NeSSProcessingProblem message tns NeSSProcessingProblem gt lt operation gt Office for National Statistics 2008 Page 11 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange Sample Query lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmlns wsu http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity utility 1 0 xsd gt lt soap Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmIns http docs oasis open org wss 2004 01 oasis 200401 w
36. HierarchyElement gt lt AreaPostcodeWithOptHierarchy gt lt Postcode gt DN55 1PT lt Postcode gt lt HierarchyId gt 10 lt HierarchyId gt lt AreaPostcodeWithOptHierarchy gt lt ns2 SearchAreaByPostcodeHierarchyElement gt lt soap Body gt lt soap Envelope gt Office for National Statistics 2008 Page 31 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange Sample Response lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt env Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmins env http schemas xmlsoap org soap envelope env mustUnderstand 1 gt lt env Header gt lt env Body gt lt ns0 SearchAreaByPostcodeHierarchyResponseElement gt lt AreaFallsWithins gt lt AreaFallsWithin gt lt Area gt lt Areald gt 3567733 lt Areald gt lt Name gt Doncaster lt Name gt lt HierarchyId gt 10 lt HierarchyId gt lt LevelTypeld gt 180 lt LevelTypeld gt lt Area gt lt FallsWithin xsi nil 1
37. LevelType gt lt LevelTypeId gt 21 lt LevelTypeld gt lt Name gt GAZ lt Name gt lt Gazetteer placename entry gt lt LevelType gt lt LevelType gt lt LevelTypeld gt 8 lt LevelTypeld gt lt Name gt GB lt Name gt lt Great Britain gt lt LevelType gt lt LevelType gt lt LevelTypeId gt 11 lt LevelTypeId gt lt Name gt GOR lt Name gt lt Government Office Region gt lt LevelType gt lt LevelType gt lt LevelTypeId gt 19 lt LevelTypeld gt lt Name gt HA lt Name gt lt Health Authority gt lt LevelType gt lt LevelType gt lt LevelTypeId gt 13 lt LevelTypeId gt lt Name gt LA lt Name gt lt Local Authority gt lt LevelType gt lt LevelType gt lt LevelTypeId gt 141 lt LevelTypeId gt lt Name gt LSOA lt Name gt lt Super Output Area Lower Layer gt lt LevelType gt lt LevelType gt lt LevelTypeId gt 140 lt LevelTypeId gt lt Name gt MSOA lt Name gt lt Super Output Area Middle Layer gt lt LevelType gt lt LevelType gt lt LevelTypeId gt 201 lt LevelTypeId gt Office for National Statistics 2008 Page 15 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange lt Name gt NDC lt Name gt lt New Deal for Community gt lt LevelType gt lt LevelType gt lt LevelTypeld gt 17 lt LevelTypeld gt lt Name gt NP lt N
38. National Statistics 2008 Page 36 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange 2 4 Notes 2 4 1 Empty Lists For some operations an empty list of matches is a valid response For example if you search for an area name matching ooagadoogoo you will get no matches and this is of course correct 2 4 2 Download Only Datasets Some datasets on NeSS cannot be queried by the web service as they only exist as precanned files for download Currently NeSS Data Exchange does not output these via getSubjectTree If named in getVariableFamilies they yield no results 2 4 3 Order of Output None of the discovery responses is sorted prior to output with the exception of getLevelTypesByHierarchy and getAreaByName PostcodeHierarchy For other responses the order of presentation is just how the database holds it Due to the way the data is loaded it may appear ordered but it isn t explicitly so 2 4 4 Provisional Hierarchies Some hierarchies such as Parliamentary Constituencies appear on the database in provisional status e g if there is no election the boundaries may not be used The beta version does not filter these out in any way though this is under consideration for a later release Office for National Statistics 2008 Page 37 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Excha
39. Suffolk Coastal lt Name gt lt HierarchyId gt 2 lt HierarchyId gt lt LevelTypeld gt 13 lt LevelTypeld gt lt Area gt lt FallsWithin gt lt AreaFallsWithin gt lt AreaFallsWithin gt lt Area gt lt Areald gt 553043 lt Areald gt lt Name gt Wickhamford lt Name gt lt HierarchyId gt 3 lt HierarchyId gt lt LevelTypeld gt 14 lt LevelTypeld gt lt Area gt lt FallsWithin gt lt Area gt lt Areald gt 277149 lt Areald gt lt Name gt Wychavon lt Name gt lt HierarchyId gt 2 lt HierarchyId gt lt LevelTypeld gt 13 lt LevelTypeld gt lt Area gt lt FallsWithin gt lt AreaFallsWithin gt lt AreaFallsWithin gt lt Area gt lt Areald gt 549119 lt Areald gt lt Name gt Wickham Bishops lt Name gt lt HierarchyId gt 3 lt HierarchyId gt lt LevelTypeld gt 14 lt LevelTypeld gt lt Area gt lt FallsWithin gt lt Area gt lt Areald gt 276964 lt Areald gt lt Name gt Maldon lt Name gt lt HierarchyId gt 2 lt HierarchyId gt lt LevelTypeld gt 13 lt LevelTypeld gt lt Area gt lt FallsWithin gt lt AreaFallsWithin gt lt AreaFallsWithin gt lt Area gt lt Areald gt 5943100 lt Areald gt lt Name gt Wickhambrook lt Name gt Office for National Statistics 2008 Page 28 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange lt HierarchyId gt 11
40. There is no need to show the response to this example as there are no significant differences to the previous two Office for National Statistics 2008 Page 53 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange 3 2 4 Pick and Mix Example Query 4 This final example shows an alternative approach for when cherry picking from a lot of datasets Instead of outputting multiple datasets with one or two variables each and lots of repetition we define a dummy dataset to which all the variables belong To make this happen your query must a Have no datasets referenced b Have no Series Grouping element lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmlns wsu http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity utility 1 0 xsd gt lt soap Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmins env http schemas xmlsoap org soap envelope soap mustUnderstand 1 gt lt wsse UsernameToken xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd gt lt wsse Username gt gimme d
41. UsernameToken xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd gt lt wsse Username gt gimme data stats com lt wsse Username gt lt wsse Password Type http docs oasis open org wss 2004 01 oasis 200401 wss username token profile 1 04 PasswordText gt Ima5tatto lt wsse Password gt lt wsse UsernameToken gt lt wsse Security gt lt soap Header gt lt soap Body xmlns ns2 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt ns2 SearchSByAByPostcodeElement gt lt AreaPostcodeWithLevelType gt lt Postcode gt PO175JE lt Postcode gt lt LevelTypeId gt 13 lt LevelTypeld gt lt AreaPostcodeWithLevelType gt lt ns2 SearchSByAByPostcodeElement gt lt soap Body gt lt soap Envelope gt Sample Response lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt env Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmins env http schemas xmlsoap org soap envelo
42. alue 1050 PeriodId 3 TopicId 13 BoundaryId 1 gt Dataltem Value 500 PeriodId 4 TopicId 13 BoundaryId 1 gt Dataltem Value 500 PeriodId 5 TopicId 13 BoundaryId 1 gt Dataltem Value 2420 PeriodId 1 TopicId 14 BoundaryId 1 gt Dataltem Value 2320 PeriodId 2 TopicId 14 BoundaryId 1 gt Dataltem Value 2330 PeriodId 3 TopicId 14 BoundaryId 1 gt Dataltem Value 940 PeriodId 4 TopicId 14 BoundaryId 1 gt Dataltem Value 910 PeriodId 5 TopicId 14 BoundaryId 1 gt PeriodId 2 TopicId 15 PeriodId 3 TopicId 15 PeriodId 4 TopicId 15 PeriodId 5 TopicId 15 PeriodId 1 TopicId 16 PeriodId 2 TopicId 16 PeriodId 3 TopicId 16 PeriodId 4 TopicId 16 PeriodId 5 TopicId 16 BoundaryId 1 gt BoundaryId 1 gt BoundaryId 1 gt BoundaryId 1 gt BoundaryId 1 gt BoundaryId 1 gt BoundaryId 1 gt BoundaryId 1 gt BoundaryId 1 gt BoundaryId 1 gt Dataltem Value 260 PeriodId 1 TopicId 17 BoundaryId 1 gt Dataltem Value 220 PeriodId 2 TopicId 17 BoundaryId 1 gt Dataltem Value 210 PeriodId 3 TopicId 17 BoundaryId 1 gt Office for National Statistics 2008 Issue No 0 3 Date 17 04 08 File NeSS_Data_Exchange_User_Guide_v0 2 doc Page 44 of 60 Status Draft amp Office for User Guide National Statistics NeSS Data Exchange lt lgdx Dataltem Value 190 PeriodId 4 TopicId 17
43. ame gt lt National Park gt lt LevelType gt lt LevelType gt lt LevelTypeId gt 15 lt LevelTypeId gt lt Name gt OA lt Name gt lt Output Area gt lt LevelType gt lt LevelType gt lt LevelTypeId gt 16 lt LevelTypeId gt lt Name gt P lt Name gt lt Parish gt lt LevelType gt lt LevelType gt lt LevelTypeld gt 25 lt LevelTypeld gt lt Name gt PA lt Name gt lt Postcode Area gt lt LevelType gt lt LevelType gt lt LevelTypeld gt 22 lt LevelTypeld gt lt Name gt PCD lt Name gt lt Postcode gt lt LevelType gt lt LevelType gt lt LevelTypeId gt 20 lt LevelTypeId gt lt Name gt PCO lt Name gt lt Primary Care Organisation gt lt LevelType gt lt LevelType gt lt LevelTypeld gt 24 lt LevelTypeld gt lt Name gt PD lt Name gt lt Postcode District gt lt LevelType gt lt LevelType gt lt LevelTypeld gt 23 lt LevelTypeld gt lt Name gt PS lt Name gt lt Postcode Sector gt lt LevelType gt lt LevelType gt lt LevelTypeld gt 97 lt LevelTypeld gt lt Name gt RO lt Name gt lt Regional Office gt lt LevelType gt lt LevelType gt lt LevelTypeId gt 81 lt LevelTypeId gt lt Name gt SHA lt Name gt lt Strategic Health Authority gt lt LevelType gt lt LevelType gt lt LevelTypeld gt 143 lt LevelTypeld gt lt Name gt SN lt Name gt lt Statistical Neighbourhood gt lt LevelType gt lt LevelType gt lt LevelT
44. ata stats com lt wsse Username gt lt wsse Password Type http docs oasis open org wss 2004 01 oasis 200401 wss username token profile 1 0 PasswordText gt Iam5tatto lt wsse Password gt lt wsse UsernameToken gt lt wsse Security gt lt soap Header gt lt soap Body xmlns ns1 http neighbourhood statistics gov uk dissemination resources wsdl deliveryservice gt lt ns1 getDataCubeElement gt lt DataCubeQueryMessage xmlns xsi http www w3 org 2001 XMLSchema instance xmins http neighbourhood statistics gov uk dissemination resources schemas datacubequery xsi schemaLocation http neighbourhood statistics gov uk dissemination resources schemas datacubequery NeSSDataCubeQueryMessage v0 4 xsd version 0 5 gt lt Query repository NeSS type custom gt lt Dimension name variablefamily isMeasuredDimension true gt lt Item code 314 gt lt Item code 325 gt lt Item code 124 gt lt Item code 125 gt lt Dimension gt lt Dimension name area isSpatialDimension true gt lt Item gt lt HierarchyArea gt lt Areald gt 276980 lt Areald gt lt HierarchyArea gt lt Item gt lt Item gt lt HierarchyArea gt lt Areald gt 276722 lt Areald gt lt HierarchyArea gt lt Item gt lt Dimension gt lt Dimension name time isTimeDimension true gt lt Item gt lt Period gt lt Start gt 2001 04 29 lt Start gt lt End gt 2001 04 29 lt End gt lt Period gt lt Item gt lt Dimens
45. be combined together in a single custom table Item code 1354 This is instructing the service to retrieve data for the dataset with this NeSS id isSpatialDimension isMeasuredDimension isTimeDimension These attributes are used to identify special dimension types and therefore dictate how the dimension items should be specified For example spatial dimension items are specified using the HierarchyArea structure and time dimension items are specified using the Period structure Dimension name dataset It is necessary to add dataset to the list of dimensions to make the XML consistent The dataset dimension is referred to both within the Group element in the variable family dimension and within the SeriesGrouping element Group dimension dataset code 67 type all This is a short hand way of asking NeSS to return all the variables within a dataset Dimension name time If no time range is specified you will get given the latest data only If the time dimension is specified all time instances falling between the start and end times will be returned SeriesGrouping This instructs as discussed above the data instances returned to be grouped by dataset This will also slightly reduce the overall size of the intermediate NESS ML and see pick and mix Office for National Statistics 2008 Issue No 0 3 Date 17 04 08 File NeSS_Data_Exchange_User_Guide_v0 2 doc Pag
46. bjectTreeRequest gt lt output name SubjectTreeResponse message tns SubjectTreeResponse gt lt fault name NeSSProcessingProblem message tns NeSSProcessingProblem gt lt operation gt Office for National Statistics 2008 Page 18 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange Sample Query lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmlns wsu http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity utility 1 0 xsd gt lt soap Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmIns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmins env http schemas xmlsoap org soap envelope soap mustUnderstand 1 gt lt wsse UsernameToken xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd gt lt wsse Username gt gimme data stats com lt wsse Username gt lt wsse Password Type http docs oasis open org wss 2004 01 oasis 200401 wss username token profile 1 04 PasswordText gt Ima5tatto lt wsse Password gt lt wsse UsernameToken gt lt wsse Security gt lt soap Header gt lt soap Body xmlns ns2 http neighbou
47. blemElement gt lt detail gt lt env Fault gt lt env Body gt lt env Envelope gt Office for National Statistics 2008 Page 57 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange Client Fault Invalid XML lt HTML gt lt HEAD gt lt TITLE gt Web Service lt TITLE gt lt HEAD gt lt BODY gt lt Hi gt Bad Request lt H1 gt lt PRE gt Error parsing envelope 4 1119 End tag does not match start tag DataCubeQueryMassage lt PRE gt lt BODY gt lt HTML gt 3 3 2 Message Element There are three message types AuthorizationFailure These errors only occur when the username and password are correct but the username has not been granted the web services role by the NeSS support team ValidationFailure Validation of the XML against the XSD occurs inside the web service whereas the basic XML validity is checked outside SystemFailure This is where an unexpected error has occurred when processing the request The user has submitted valid parameters but the request has failed for some reason 3 3 3 Code Element This is a four section delimited code for the benefit of ONS in tracking down errors Project Name Class Name Method Name Short Error Description The names do not exactly match the real classes and methods for security reasons The final Short Error De
48. cId 25 BoundaryId 1 gt lt lgdx Dataltem Value 510 PeriodId 4 TopicId 25 BoundaryId 1 gt lt lgdx Dataltem Value 540 PeriodId 5 TopicId 25 BoundaryId 1 gt lt lgdx Dataltem Value 400 PeriodId 1 TopicId 26 BoundaryId 1 gt lt lgdx Dataltem Value 420 PeriodId 2 TopicId 26 BoundaryId 1 gt lt lgdx Dataltem Value 430 PeriodId 3 TopicId 26 BoundaryId 1 gt lt lgdx Dataltem Value 140 PeriodId 4 TopicId 26 BoundaryId 1 gt lt lgdx Dataltem Value 150 PeriodId 5 TopicId 26 BoundaryId 1 gt lt lgdx Dataltem Value 860 PeriodId 1 TopicId 27 BoundaryId 1 gt lt lgdx Dataltem Value 870 PeriodId 2 TopicId 27 BoundaryId 1 gt lt lgdx Dataltem Value 890 PeriodId 3 TopicId 27 BoundaryId 1 gt lt lgdx Dataltem Value 770 PeriodId 4 TopicId 27 BoundaryId 1 gt lt lgdx Dataltem Value 780 PeriodId 5 TopicId 27 BoundaryId 1 gt lt lgdx DatasetItems gt lt lgdx DataSet gt lt lgdx DataSource gt lt lgdx DataRoot gt lt ns0 getDataCubeResponseElement gt lt env Body gt lt env Envelope gt Note that for this dataset there are no data for Hampshire Boundaryld 2 Office for National Statistics 2008 Page 45 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange Explanations Element attribute Explanation
49. currently a Beta version and we are particularly interested in any comments or feedback you may have Office for National Statistics 2008 Page 5 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange 1 2 Discovery Services These enable external system users to find the NeSS information they are looking for by providing a number of services to identify the information that is available on NeSS Services offered will include Searching for an Area The user will be able to search for a geographic Area of interest There will be supporting services that can filter by Hierarchy only retrieve those areas that are Local Authorities etc The retrieval of a layer of child areas under a Parent area is supported For example the user may like to see information about all or some Wards under a Local Authority Retrieving the NeSS topic structure This will give a user the full structure of topics datasets and the time periods relevant to the dataset If the user only requires certain Variables to be returned they have the option to select only those required The Web Service also supports simultaneous multiple areas and multiple topics searches A full technical manual on how to use and implement these Discovery Services is contained in Annex A 1 3 Delivery Services Once the user has identified what
50. d gt lt wsse Username gt gimme data stats com lt wsse Username gt lt wsse Password Type http docs oasis open org wss 2004 01 oasis 200401 wss username token profile 1 0 PasswordText gt Ima5tatto lt wsse Password gt lt wsse UsernameToken gt lt wsse Security gt lt soap Header gt lt soap Body xmlns ns2 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt ns2 LevelTypesByHierarchyElement gt lt HierarchyId gt 9 lt HierarchyId gt lt ns2 LevelTypesByHierarchyElement gt lt soap Body gt lt soap Envelope gt Office for National Statistics 2008 Page 17 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange Sample Response lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt env Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns env http schnemas xmlsoap org soap envelope env mustUnderstand 1 gt lt env Header gt lt env Body gt lt
51. delivery WSDL needs to point to the correct end point URL for the application server being connected to PRODLIVE lt wsdl service name NeSSDeliveryService gt lt wsdl port name NeSSDeliveryBindingPort binding tns NeSSDeliveryBinding gt lt soap address location https www neighbourhood statistics gov uk interop NeSSDeliveryBindingPort gt lt wsdl port gt lt wsdl service gt 3 2 Delivery Query Examples Below are a number of examples of delivery queries supported by the service 3 2 1 Single Dataset All Variables This is a common query where all the variables in a single dataset over a range of years are required for a small number of areas The preceding discovery requests will have obtained the Ness Dateset d for the dataset and the Ness Arealds for the areas The available periods could have been obtained via discovery or a range of interest could be chosen independently Office for National Statistics 2008 Page 39 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange Query example 1 lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmlns wsu http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity utility 1 0 xsd gt lt soap Header gt lt wsse Security xmIns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext
52. e 41 of 60 Status Draft amp Office for User Guide National Statistics NeSS Data Exchange Response XML for query example 1 lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources wsdl deliveryservice gt lt env Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns env http schnemas xmlsoap org soap envelope env mustUnderstand 1 gt lt env Header gt lt env Body gt lt ns0 getDataCubeResponseElement gt lt lgdx DataRoot xmlns lgdx http www esd org uk LGDX gt lt lgdx DataSource DataSourceName NESS gt lt lgdx DataSet gt lt Igdx Metadata gt lt Igdx ArtefactDescription gt This dataset provides a count of Income Support Claimants by 4 bands of age 16 24 25 49 50 59 and 60 and over gender five categories of duration on benefit two family types and some benefit specific information lt lgdx ArtefactDescription gt lt lgdx Metadata gt lt Igdx ArtefactTitle gt Income Support Claimants lt lgdx ArtefactTitle gt lt lgdx HostReference gt 1354 lt lgdx HostReference gt lt lgdx Boundaries gt lt lgdx Boundary Code 24UE Name Fareham B
53. e Ouery lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmlns wsu http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity utility 1 0 xsd gt lt soap Header gt lt wsse Security xmIns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns env http schemas xmlsoap org soap envelope soap mustUnderstand 1 gt lt wsse UsernameToken xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd gt lt wsse Username gt gimme data stats com lt wsse Username gt lt wsse Password Type http docs oasis open org wss 2004 01 oasis 200401 wss username token profile 1 04 PasswordText gt Ima5tatto lt wsse Password gt lt wsse UsernameToken gt lt wsse Security gt lt soap Header gt lt soap Body xmlns ns2 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt ns2 LevelTypesElement gt lt soap Body gt lt soap Envelope gt Office for National Statistics 2008 Page 14 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange Sample Response lt env Envelope xmi
54. eReguest message tns SearchAreaByNameLevelTypeReguest gt lt output name SearchAreaByNameLevelTypeResponse message tns SearchAreaByNameLevelTypeResponse gt lt fault name NeSSProcessingProblem message tns NeSSProcessingProblem gt lt operation gt Sample Ouery lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmlns wsu http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity utility 1 0 xsd gt lt soap Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns env http schemas xmlsoap org soap envelope soap mustUnderstand 1 gt lt wsse UsernameToken xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd gt lt wsse Username gt gimme data stats com lt wsse Username gt lt wsse Password Type http docs oasis open org wss 2004 01 oasis 200401 wss username token profile 1 04PasswordText gt Ima5tatto lt wsse Password gt lt wsse UsernameToken gt lt wsse Security gt lt soap Header gt lt soap Body xmlns ns2 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt ns2 SearchAreaByNameLevelTypeElement gt lt AreaNamePartWithLevelType
55. emaLocation http neighbourhood statistics gov uk dissemination resources schemas datacubequery NeSSDataCubeQueryMessage v0 4 xsd version 0 5 gt lt Query repository NeSS type custom gt lt Dimension name dataset gt lt Item code 67 gt lt Item code 41 gt lt Dimension gt lt Dimension name variablefamily isMeasuredDimension true gt lt Group dimension dataset code 41 type selection gt lt Item code 314 gt lt Item code 325 gt lt Group gt lt Group dimension dataset code 67 type all gt lt Item code 124 gt lt Item code 125 gt lt Dimension gt lt Dimension name area isSpatialDimension true gt lt Item gt lt HierarchyArea gt lt Areald gt 276980 lt Areald gt lt HierarchyArea gt lt Item gt lt Item gt lt HierarchyArea gt lt Areald gt 276722 lt Areald gt lt HierarchyArea gt lt Item gt lt Dimension gt lt Dimension name time isTimeDimension true gt lt Item gt lt Period gt lt Start gt 2001 04 29 lt Start gt lt End gt 2001 04 29 lt End gt lt Period gt lt Item gt lt Dimension gt lt SeriesGrouping gt lt SeriesGroup dimension dataset gt Office for National Statistics 2008 Page 47 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange lt SeriesGrouping gt lt Query gt lt DataCubeQ
56. ft amp Office for User Guide National Statistics NeSS Data Exchange 1 Neighbourhood Statistics Data Exchange Beta User Guide 1 1 Background Over recent years there has been a significant growth in the number of Local Information Systems Many of these systems want to incorporate data from Neighbourhood Statistics NeSS into their own system to use alongside other data Some may want to physically hold that data others may be offering a service where they want to enable real time access to NeSS data through their system This User Guide provides information you will need to incorporate NeSS Web Services into your system enabling seamless access to NeSS data This service allows Machine 2 Machine interaction between NeSS and other Information Systems over the internet enabling an external system to query and retrieve NeSS data The system can then manipulate display and save if required this data on their machine The service offers two functions these are Discovery Services and Delivery Services These services are XML based using a combination of a bespoke NeSS XML format called NeSS ML and the format developed in partnership with the Department for Communities and Local Government CLG called LGDX Local Government Data eXchange LGDX is the XML standard being used by the CLG s Data Interchange Hub for the exchange of information relating to Performance Indicators It should be noted that this is
57. gt lt AreaNamePart gt Wickham lt AreaNamePart gt lt LevelTypeld gt 14 lt LevelTypeld gt lt AreaNamePartWithLevelType gt lt ns2 SearchAreaByNameLevelTypeElement gt lt soap Body gt lt soap Envelope gt Office for National Statistics 2008 Page 27 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange Sample Response lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt env Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns env http schnemas xmlsoap org soap envelope env mustUnderstand 1 gt lt env Header gt lt env Body gt lt ns0 SearchAreaByNameLevelTypeResponseElement gt lt AreaFallsWithins gt lt AreaFallsWithin gt lt Area gt lt Areald gt 552301 lt Areald gt lt Name gt Wickham Market lt Name gt lt HierarchyId gt 3 lt HierarchyId gt lt LevelTypeld gt 14 lt LevelTypeld gt lt Area gt lt FallsWithin gt lt Area gt lt Areald gt 277116 lt Areald gt lt Name gt
58. hemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt env Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns env http schnemas xmlsoap org soap envelope env mustUnderstand 1 gt lt env Header gt lt env Body gt lt ns0 AreaAtLevelResponseElement gt lt Areas gt lt Area gt lt Areald gt 276734 lt Areald gt lt Name gt Shropshire lt Name gt lt HierarchyId gt 2 lt HierarchyId gt lt LevelTypeld gt 12 lt LevelTypeld gt lt Area gt lt Area gt lt Areald gt 276736 lt Areald gt lt Name gt Staffordshire lt Name gt lt HierarchyId gt 2 lt HierarchyId gt lt LevelTypeld gt 12 lt LevelTypeld gt lt Area gt lt Area gt lt Areald gt 276739 lt Areald gt lt Name gt Warwickshire lt Name gt lt HierarchyId gt 2 lt HierarchyId gt lt LevelTypeld gt 12 lt LevelTypeld gt lt Area gt lt Area gt lt Areald gt 276742 lt Areald gt lt Name gt Worcestershire lt Name gt lt HierarchyId gt 2 lt HierarchyId gt lt LevelTypeld gt 12 lt LevelTypeld gt lt Area gt lt Areas gt lt ns0 AreaAtLevelResponseElement gt lt env Body gt lt env
59. hy Hierarchy 3 Link from this OA to the smallest area in the Parish Hierarchy parish 4 Work up the Parish Hierarchy until you find an object at leveltype LA The result is that the LA can only be found if the postcode is within a real parish WSDL Definition lt operation name SearchAreaByPostcodeLevelType gt lt input name SearchAreaByPostcodeLevelTypeReguest message tns SearchAreaByPostcodeLevelTypeReguest gt lt output name SearchAreaByPostcodeLevelTypeResponse message tns SearchAreaByPostcodeLevelTypeResponse gt lt fault name NeSSProcessingProblem message tns NeSSProcessingProblem gt lt operation gt Office for National Statistics 2008 Page 33 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange Sample Query lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmlns wsu http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity utility 1 0 xsd gt lt soap Header gt lt wsse Security xmIns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmIns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmins env http schemas xmlsoap org soap envelope soap mustUnderstand 1 gt lt wsse UsernameToken xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss ws
60. input name SearchAreaByPostcodeHierarchyReguest message tns SearchAreaByPostcodeHierarchyReguest gt lt output name SearchAreaByPostcodeHierarchyResponse message tns SearchAreaByPostcodeHierarchyResponse gt lt fault name NeSSProcessingProblem message tns NeSSProcessingProblem gt lt operation gt Sample Ouery lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmlns wsu http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity utility 1 0 xsd gt lt soap Header gt lt wsse Security xmIns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns env http schemas xmlsoap org soap envelope soap mustUnderstand 1 gt lt wsse UsernameToken xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd gt lt wsse Username gt gimme data stats com lt wsse Username gt lt wsse Password Type http docs oasis open org wss 2004 01 oasis 200401 wss username token profile 1 0 PasswordText gt Ima5tatto lt wsse Password gt lt wsse UsernameToken gt lt wsse Security gt lt soap Header gt lt soap Body xmlns ns2 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt ns2 SearchAreaByPostcode
61. ion true gt lt Item gt lt HierarchyArea gt lt Areald gt 276980 lt Areald gt lt HierarchyArea gt lt Item gt lt Item gt lt HierarchyArea gt lt Areald gt 276722 lt Areald gt lt HierarchyArea gt lt Item gt lt Dimension gt lt Dimension name time isTimeDimension true gt lt Item gt lt Period gt lt Start gt 1998 01 01 lt Start gt lt End gt 2006 01 21 lt End gt lt Period gt lt Item gt lt Dimension gt lt SeriesGrouping gt lt SeriesGroup dimension dataset gt lt SeriesGrouping gt lt Query gt lt DataCubeQueryMessage gt lt nsi getDataCubeElement gt lt soap Body gt lt soap Envelope gt Office for National Statistics 2008 Page 40 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for National Statistics User Guide NeSS Data Exchange Explanations Element attribute Explanation version 0 5 The version attribute tells the web service how to process the query XML and which version of the response XML schema to return This response is intermediate gets transformed to LGDX We currently support version 0 5 and for backward compatibility for existing Cafeteria request versions 0 2 0 3 and 0 4 should work Note that regardless of the setting for the version attribute the query xsd file remains as NeSSDataCubeQueryMessage v0 4 xsd as the version attribute cont
62. ion gt Office for National Statistics 2008 Page 54 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange lt Query gt lt DataCubeQueryMessage gt lt nsi getDataCubeElement gt lt soap Body gt lt soap Envelope gt Response XML for query example 4 lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources wsdl deliveryservice gt lt env Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns env http schnemas xmlsoap org soap envelope env mustUnderstand 1 gt lt env Header gt lt env Body gt lt ns0 getDataCubeResponseElement gt lt lgdx DataRoot xmlns lgdx http www esd org uk LGDX gt lt lgdx DataSource DataSourceName NESS gt lt lgdx DataSet gt lt Igdx Metadata gt lt Igdx ArtefactDescription gt Pick and Mix lt lgdx ArtefactDescription gt lt lgdx Metadata gt lt Igdx ArtefactTitle gt Custom lt lgdx ArtefactTitle gt lt lgdx HostReference gt 0 lt lgdx HostReference gt lt lgdx Boundaries gt lt lgdx Boundary Code 2
63. itle Working Age Statistical Group Carers and Others TopicId 12 gt lt lgdx Topic Commentary Unit Count Title Male TopicId 13 gt lt lgdx Topic Commentary Unit Count Title Female TopicId 14 gt lt lgdx Topic Commentary Unit Count Title Total TopicId 15 gt lt lgdx Topic Commentary Unit Count Title Single TopicId 16 gt lt lgdx Topic Commentary Unit Count Title Claimants Aged 16 24 TopicId 17 gt lt lgdx Topic Commentary Unit Count Title Claimants Aged 25 49 TopicId 18 gt lt lgdx Topic Commentary Unit Count Title Claimants Aged 50 59 TopicId 19 gt lt lgdx Topic Commentary Unit Count Title Claimants Aged 60 and Over TopicId 20 gt lt lgdx Topic Commentary Unit Count Title Claim Duration Less Than 6 Months TopicId 21 gt lt lgdx Topic Commentary Unit Count Title Claim Duration 6 Months 1 Year TopicId 22 gt lt lgdx Topic Commentary Unit Count Title Claim Duration 1 2 Years TopicId 23 gt lt lgdx Topic Commentary Unit Count Title Claim Duration 2 5 Years TopicId 24 gt lt lgdx Topic Commentary Unit Count Title Claim Duration 5 Years and Over TopicId 25 gt lt lgdx Topic Commentary Unit Count Title Couple TopicId 26 gt lt lgdx Topic Commentary Unit Count Title Working Age Statistical Group Incapacity Benefits TopicId 27 gt lt lgdx Topics gt lt Igdx Periods gt lt lgdx Period
64. ling lt Name gt lt MeasurementUnit gt lt MUId gt 1 lt MUId gt lt Name gt Count lt Name gt lt MeasurementUnit gt lt StatisticalUnit gt Office for National Statistics 2008 Page 21 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange lt SUId gt 2 lt SUId gt lt Name gt Households lt Name gt lt StatisticalUnit gt lt VarFamily gt lt VarFamily gt lt VarFamilyId gt 2319 lt VarFamilyId gt lt Name gt In an Unshared Dwelling House or Bungalow lt Name gt lt MeasurementUnit gt lt MUId gt 1 lt MUId gt lt Name gt Count lt Name gt lt MeasurementUnit gt lt StatisticalUnit gt lt SUId gt 2 lt SUId gt lt Name gt Households lt Name gt lt StatisticalUnit gt lt VarFamily gt lt VarFamily gt lt VarFamilyId gt 2320 lt VarFamilyId gt lt Name gt In an Unshared Dwelling House or Bungalow Detached lt Name gt lt MeasurementUnit gt lt MUId gt 1 lt MUId gt lt Name gt Count lt Name gt lt MeasurementUnit gt lt StatisticalUnit gt lt SUId gt 2 lt SUId gt lt Name gt Households lt Name gt lt StatisticalUnit gt lt VarFamily gt lt VarFamily gt lt VarFamilyId gt 2321 lt VarFamilyId gt lt Name gt In an Unshared Dwelling House or Bungalow Semi detached lt Name gt lt MeasurementUnit gt lt MUId gt 1 lt MUId gt lt Name gt Count lt Name
65. ltem Value 16301 PeriodId 1 TopicId 8 BoundaryId 2 gt lt lgdx Dataltem Value 97 89 PeriodId 1 TopicId 9 BoundaryId 1 gt lt lgdx Dataltem Value 97 94 PeriodId 1 TopicId 9 BoundaryId 2 gt lt lgdx Dataltem Value 2 11 PeriodId 1 TopicId 10 BoundaryId 1 gt lt lgdx Dataltem Value 2 06 PeriodId 1 TopicId 10 BoundaryId 2 gt lt lgdx Dataltem Value 7424 PeriodId 1 TopicId 11 BoundaryId 1 gt lt lgdx Dataltem Value 14 54 PeriodId 1 TopicId 12 BoundaryId 1 gt lt lgdx DatasetItems gt lt lgdx DataSet gt lt lgdx DataSet gt Office for National Statistics 2008 Page 49 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange lt Igdx Metadata gt lt Igdx ArtefactDescription gt This dataset is about Socio economic classification It shows the usual resident population aged 16 to 74 by their socio economic classification The National Statistics Socio economic Classification NS SeC was introduced by the Government to replace Social Class based on Occupation and Socio Economic Groups SEG The NS SeC is an occupationally based classification but has rules to provide coverage of the whole adult population The population of this dataset is all people aged 16 to 74 There are separate tables available giving the same information separately for Males and Females
66. ltem Value 230 PeriodId 4 TopicId 21 BoundaryId 1 gt lt lgdx Dataltem Value 200 PeriodId 5 TopicId 21 BoundaryId 1 gt lt lgdx Dataltem Value 320 PeriodId 1 TopicId 22 BoundaryId 1 gt lt lgdx Dataltem Value 300 PeriodId 2 TopicId 22 BoundaryId 1 gt lt lgdx Dataltem Value 260 PeriodId 3 TopicId 22 BoundaryId 1 gt lt lgdx Dataltem Value 130 PeriodId 4 TopicId 22 BoundaryId 1 gt lt lgdx Dataltem Value 150 PeriodId 5 TopicId 22 BoundaryId 1 gt lt lgdx Dataltem Value 500 PeriodId 1 TopicId 23 BoundaryId 1 gt lt lgdx Dataltem Value 490 PeriodId 2 TopicId 23 BoundaryId 1 gt lt lgdx Dataltem Value 430 PeriodId 3 TopicId 23 BoundaryId 1 gt lt lgdx Dataltem Value 210 PeriodId 4 TopicId 23 BoundaryId 1 gt lt lgdx Dataltem Value 190 PeriodId 5 TopicId 23 BoundaryId 1 gt lt lgdx Dataltem Value 750 PeriodId 1 TopicId 24 BoundaryId 1 gt lt lgdx Dataltem Value 820 PeriodId 2 TopicId 24 BoundaryId 1 gt lt lgdx Dataltem Value 910 PeriodId 3 TopicId 24 BoundaryId 1 gt lt lgdx Dataltem Value 370 PeriodId 4 TopicId 24 BoundaryId 1 gt lt lgdx Dataltem Value 330 PeriodId 5 TopicId 24 BoundaryId 1 gt lt lgdx Dataltem Value 1400 PeriodId 1 TopicId 25 BoundaryId 1 gt lt lgdx Dataltem Value 1370 PeriodId 2 TopicId 25 BoundaryId 1 gt lt lgdx Dataltem Value 1350 PeriodId 3 Topi
67. nge_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange 3 Annex B Delivery Service The NeSS Data Exchange Delivery Service is a modified version of the Cafeteria pilot system from 2006 The main differences are that it is now expected to be run after a number of discovery requests and the final payload is delivered in the new LGDX format 0 2e The old NeSS ML format is used internally then transformed to LGDX so in future we could support multiple output formats such as SDMX and NESS ML itself System Diagram NeSS Web Service NeSS Start Receive Web T Checking data content 5 N Request etc Validate Request Message Message Invalid adi Process Request V Create Error G Message Error Retrieve Delivery Data Send Response Create Delivery KE ay e End SS Office for National Statistics 2008 Page 38 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange 3 1 Getting Started 3 1 1 Userid You need a userid for NeSS PRODLIVE database Your userid requires the web service user role to be enabled This has to be done by NeSS support 3 1 2 End Point The endpoint URL to use is https www neighbourhood statistics gov uk interop NeSSDeliveryBindingPort The
68. ns env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt env Header gt lt wsse Security xmIns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmIns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmins env http schemas xmlsoap org soap envelope env mustUnderstand 1 gt lt env Header gt lt env Body gt lt ns0 LevelTypesResponseElement gt lt LevelTypes gt lt LevelType gt lt LevelTypeld gt 164 lt LevelTypeld gt lt Name gt COM lt Name gt lt Community gt lt LevelType gt lt LevelType gt lt LevelTypeId gt 10 lt LevelTypeId gt lt Name gt CTRY lt Name gt lt Country gt lt LevelType gt lt LevelType gt lt LevelTypeId gt 12 lt LevelTypeId gt lt Name gt CTY lt Name gt lt County gt lt LevelType gt lt LevelType gt lt LevelTypeId gt 180 lt LevelTypeId gt lt Name gt EA lt Name gt lt Education Area gt lt LevelType gt lt LevelType gt lt LevelTypeld gt 9 lt LevelTypeld gt lt Name gt EW lt Name gt lt England and Wales gt lt LevelType gt lt LevelType gt lt LevelTypeId gt 96 lt LevelTypeld gt lt Name gt FCTY lt Name gt lt Former County gt lt LevelType gt lt
69. nv Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmins env http schemas xmlsoap org soap envelope env mustUnderstand 1 gt lt env Header gt lt env Body gt lt ns0 HierarchiesResponseElement gt lt Hierarchies gt lt Hierarchy gt lt HierarchyId gt 2 lt HierarchyId gt lt Name gt NeSS Geography Hierarchy lt Name gt lt Hierarchy gt lt Hierarchy gt lt HierarchyId gt 4 lt HierarchyId gt lt Name gt 2003 Administrative Hierarchy lt Name gt lt Hierarchy gt lt Hierarchy gt lt HierarchyId gt 13 lt HierarchyId gt lt Name gt Provisional Parliamentary Constituencies 2007 lt Name gt lt Hierarchy gt lt Hierarchy gt lt HierarchyId gt 8 lt HierarchyId gt lt Name gt 2003 Health Hierarchy lt Name gt lt Hierarchy gt lt Hierarchy gt lt HierarchyId gt 9 lt HierarchyId gt lt Name gt 2003 Parish Hierarchy lt Name gt lt Hierarchy gt lt Hierarchy gt lt HierarchyId gt 11 lt HierarchyId gt lt Name gt 2004 Administrative Hierarchy lt Name gt Office for National Statistics 2008 Page 13 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange lt Hierarchy gt lt Hierarchy gt lt HierarchyId gt 3 l
70. oundaryId 1 gt lt lgdx SpatialData gt lt lgdx Polygon gt lt lgdx Point gt lt lgdx XCoordinate gt 448760 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 101385 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 448760 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 111270 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 462605 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 101385 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 462605 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 111270 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Polygon gt lt lgdx SpatialData gt lt lgdx Boundary gt lt lgdx Boundary Code 24 Name Hampshire BoundaryId 2 gt lt lgdx SpatialData gt lt lgdx Polygon gt lt lgdx Point gt lt lgdx XCoordinate gt 403095 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 89692 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 403095 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 165381 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 488767 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 89692 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 488767 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 165381 lt lgdx YCoordinate gt lt lgdx Point gt lt lgd
71. ours Worked It covers all people aged 16 to 74 in employment giving information split by males and females lt lgdx ArtefactDescription gt lt lgdx Metadata gt lt lgdx ArtefactTitle gt Hours Worked KS10 lt lgdx ArtefactTitle gt lt lgdx HostReference gt 287 lt lgdx HostReference gt lt lgdx Boundaries gt lt lgdx Boundary Code 24UE Name Fareham BoundaryId 1 gt lt Igdx SpatialData gt lt lgdx Polygon gt lt lgdx Point gt lt lgdx XCoordinate gt 448760 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 101385 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 448760 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 111270 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 462605 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 101385 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 462605 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 111270 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Polygon gt lt lgdx SpatialData gt lt lgdx Boundary gt lt lgdx Boundary Code 24 Name Hampshire BoundaryId 2 gt lt lgdx SpatialData gt lt lgdx Polygon gt lt lgdx Point gt lt lgdx XCoordinate gt 403095 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 89692 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 403095 lt lgdx XCoordinate gt lt lgdx YCoordinate g
72. pe env mustUnderstand 1 gt lt env Header gt lt env Body gt lt ns0 SearchSByAByPostcodeResponseElement gt lt AreaFallsWithins gt lt AreaFallsWithin gt lt Area gt lt Areald gt 276987 lt Areald gt lt Name gt Winchester lt Name gt lt HierarchyId gt 2 lt HierarchyId gt lt LevelTypeld gt 13 lt LevelTypeld gt lt Area gt lt FallsWithin xsi nil 1 gt lt AreaFallsWithin gt lt AreaFallsWithins gt lt ns0 SearchSByAByPostcodeResponseElement gt lt env Body gt lt env Envelope gt Office for National Statistics 2008 Page 30 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange 2 2 12 SearchAreaByPostcodeHierarchy Description This operation allows you to search for an area in a particular hierarchy The parameters are a full postocde and the hierarchy id obtained from getHierarchies The result is a vertical stack of areas each one being the parent of the previous one If no match is found for a valid postcode string an empty response is returned The area is sent with a falls within area attached This is the area that the rules table thinks is the most suitable parent or grandparent area and will not necessarily be in the same hierarchy The falls within area can be nil WSDL Definition lt operation name SearchAreaByPostcodeHierarchy gt lt
73. picId 5 BoundaryId 1 gt Dataltem Value 8 PeriodId 3 TopicId 5 BoundaryId 1 gt Dataltem Value 19 Dataltem Value 20 Dataltem Value 53 Dataltem Value 53 Dataltem Value 54 PeriodId 4 TopicId 5 BoundaryId 1 gt PeriodId 5 TopicId 5 BoundaryId 1 gt PeriodId 1 TopicId 6 BoundaryId 1 gt PeriodId 2 TopicId 6 BoundaryId 1 gt PeriodId 3 TopicId 6 BoundaryId 1 gt Dataltem Value 0 PeriodId 4 TopicId 6 BoundaryId 1 gt Dataltem Value 0 PeriodId 5 TopicId 6 BoundaryId 1 gt Dataltem Value 29 Dataltem Value 30 Dataltem Value 31 Dataltem Value 34 Dataltem Value 35 Dataltem Value 71 Dataltem Value 69 Dataltem Value 69 Dataltem Value 65 Dataltem Value 65 Dataltem Value 88 Dataltem Value 87 Dataltem Value 88 Dataltem Value 90 Dataltem Value 89 Dataltem Value 25 Dataltem Value 26 Dataltem Value 26 Dataltem Value 53 Dataltem Value 55 Dataltem Value 22 Dataltem Value 20 Dataltem Value 19 Dataltem Value 39 Dataltem Value 38 Dataltem Value 53 Dataltem Value 54 Dataltem Value 54 Dataltem Value 3430 PeriodId 1 TopicId 15 Dataltem Value 3340 Dataltem Value 3370 Dataltem Value 1450 Dataltem Value 1410 Dataltem Value 3030 Dataltem Value 2910 Dataltem Value 2950 Dataltem Value 1310 Dataltem Value 1260 PeriodId 1 TopicId 7 BoundaryId 1 gt PeriodId 2 TopicId 7 BoundaryId
74. re asking which LA type 13 with postcode PO175JE is in If no match is found for a valid postcode string an empty response is returned The area is sent with a falls within area attached This is the area that the rules table thinks is the most suitable parent or grandparent area and will not necessarily be in the same hierarchy The falls within area can be nil WSDL Definition lt operation name SearchSByAByPostcode gt lt input name SearchSByAByPostcodeRequest message tns SearchSByAByPostcodeRequest gt lt output name SearchSByAByPostcodeResponse message tns SearchSByAByPostcodeResponse gt lt fault name NeSSProcessingProblem message tns NeSSProcessingProblem gt lt operation gt Office for National Statistics 2008 Page 29 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange Sample Query lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmlns wsu http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity utility 1 0 xsd gt lt soap Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmIns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmins env http schemas xmlsoap org soap envelope soap mustUnderstand 1 gt lt wsse
75. re development of the services NeSS will offer We will also be seeking additional feedback through other methods and holding workshops to get feedback on these developments We hope you are able to take advantage of these new services Callum Foster Neighbourhood Statistics Service and Development Manager Office for National Statistics 1 6 Contact Information For general enquiries For technical enquiries Better info ons gov uk Better info ons gov uk same email address for the time being will be redirected to technical support Office for National Statistics 2008 Page 7 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc Office for National Statistics a User Guide NeSS Data Exchange 2 Annex A Discovery Service The discovery service is new not part of the original pilot It presents the user with a wide variety of operations with which to query the NeSS database to get areas variables datasets times etc These requests are normally the precursor to the delivery request which yields the actual data System Diagram NeSS Web Service NeSS Star Receive Web vu Regauet 7 Validate and identify the message Validate Request gt Message d Check data content etc Inputs A Text string g Retum result
76. rhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt ns2 SubjectTreeElement gt lt soap Body gt lt soap Envelope gt Sample Response lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt env Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns env http schnemas xmlsoap org soap envelope env mustUnderstand 1 gt lt env Header gt lt env Body gt lt ns0 SubjectTreeResponseElement gt lt SubjectTree gt lt Branch gt lt Subject gt lt SubjectId gt 16 lt SubjectId gt lt Name gt 2001 Census Census Area Statistics lt Name gt lt Subject gt lt DSFamilies gt lt DSFamily gt lt DSFamilyId gt 149 lt DSFamilyId gt lt Name gt Accommodation Type Household Spaces UV56 lt Name gt lt DateRange gt lt startDate gt 2001 04 29 lt startDate gt lt endDate gt 2001 04 29 lt endDate gt lt DateRange gt lt DSFamily gt lt DSFamily gt lt DSFamilyId gt 129 lt DSFamilyId gt lt Name gt Accommodation Type People UV42 lt Name gt lt DateRange gt lt startDate gt 2001 04
77. rols the format of the response not the query repository NeSS Currently only NeSS is supported although others have been prototyped within ONS This allows the same schema to be used for other data sources in future for example from NS Online www statistics gov uk type custom Currently only custom is supported This refers to the type of query to be run and influences which query parameters are required Custom means that the query can mix and match individual areas variables and time ranges from any number of datasets Other options may be added later Dimension NeSS queries support variablefamily area dataset and time dimensions The first two are mandatory The dataset dimension can be used for grouping the data in the response see later If the time dimension is not specified only the very latest data is returned L name variablefamily NeSS refers to statistical topics as variables A dataset subject consists of a number of variables A dataset collected at a particular time point is referred to as a dataset instance and contains variable instances To refer to a dataset without being specific about a particular date we speak of dataset families and variable families Each variable family and variable instance has a numeric identifier which is unigue across the entire NeSS database This is how the NeSS web site allows variables from any number of datasets to
78. s ent S 12 2 2 4 Getlevelfvpes r 14 2 2 5 GetLevelTypesByHierarchy aaa 17 226 EE HEET EE Se ee Mu vice nats ruds dk ds d al vas k dai 18 2 2 7 GetVariableFamilies cs eee eee ee e e e ee e e ee eee eee 20 2 2 8 SearchSByYABYNaME ces e eee aaa 24 2 29 GearchAreabvhameierarchw eee e eens Kee 25 2 2 10 SearchAreaByNameLevelType aaa 27 2 2 11 SearchSByAByPostcode aaa 29 2 2 12 SearchAreaByPostcodeHierarchy ee ee e e e ee eee eee 31 2 2 13 SearchAreaByPostcodeLevelType eee eteeeeeeeeeeeaees 33 23 EMO MESSAGES sed taste T 35 2 3 1 Sample Messag sar amidader dessen ege AER e REENEN ENEE a 35 SEENEN ele NEE e EE E E Ha page 35 Client FaUlti sv e ug eg ge zatageggeesse na d seus veer rhe TX EO Te iad ENEE REESEN 35 2 3 2 Message Element users deeper eT HX aida taatad dara EA ENEE NEE rai EN 36 AuthorizationF ll f ss mnei d r etege hg ege Se geg Ze Ee dog NEEN NEEN EEN 36 ValidationF il f6s sev astes sada dvd canal on Be eg iad eo dE d NEEN AER A EEN 36 SYStOMPAIUNC vecie is dE sede be tween dvs tva v z eg ita wees 36 2 3 3 Code ElEMEN eis cdectetacieuteenbid a a pened caadaguteebdaacachtbedaeds cei 36 Office for National Statistics 2008 Page 3 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange 234 Ke UR E EE 36 E D e 37 2 4 1 ul Lei 3
79. s soap http schemas xmlsoap org soap envelope xmlns wsu http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity utility 1 0 xsd gt lt soap Header gt lt wsse Security xmIns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmIns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmins env http schemas xmlsoap org soap envelope soap mustUnderstand 1 gt lt wsse UsernameToken xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd gt lt wsse Username gt gimme data stats com lt wsse Username gt lt wsse Password Type http docs oasis open org wss 2004 01 oasis 200401 wss username token profile 1 04 PasswordText gt Ima5tatto lt wsse Password gt lt wsse UsernameToken gt lt wsse Security gt lt soap Header gt lt soap Body xmlns ns2 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt ns2 HierarchiesElement gt lt soap Body gt lt soap Envelope gt Sample Response lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt e
80. scription may be of use to clients as it contains further detail as to the nature of the failure that may be shared across several different methods E G ValidationFailure can have Short Error Descriptions including ERROR_AREA Area Not Found or ERROR_HIER Hierarchy Not Found or ERROR_DATASET Dataset not found 3 3 4 Detail Element This is the most useful part for the user as it describes the reason for the failure in English Office for National Statistics 2008 Page 58 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange 3 4 Notes 3 4 1 Warning About Latest Data Queries At the time of writing a problem which affects some latest data queries i e where no time range is specified has not yet been resolved This should be rectified shortly after launch with a database update Page 59 of 60 Office for National Statistics 2008 Status Draft Issue No 0 3 Date 17 04 08 File NeSS_Data_Exchange_User_Guide_v0 2 doc
81. security secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd gt lt wsse Username gt gimme data stats com lt wsse Username gt lt wsse Password Type http docs oasis open org wss 2004 01 oasis 200401 wss username token profile 1 04 PasswordText gt Ima5tatto lt wsse Password gt lt wsse UsernameToken gt lt wsse Security gt lt soap Header gt lt soap Body xmlns ns2 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt ns2 SearchAreaByPostcodeLevelTypeElement gt lt AreaPostcodeWithLevelType gt lt Postcode gt CR2 6XH lt Postcode gt lt LevelTypeld gt 81 lt LevelTypeld gt lt AreaPostcodeWithLevelType gt lt ns2 SearchAreaByPostcodeLevelTypeElement gt lt soap Body gt lt soap Envelope gt Sample Response lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt env Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns env http schnemas xmlsoap org soap envelope env mustUnderstand 1 gt lt env Header gt lt env Body
82. ss username token profile 1 04 PasswordText gt Ima5tatto lt wsse Password gt lt wsse UsernameToken gt lt wsse Security gt lt soap Header gt lt soap Body xmlns ns2 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt ns2 SearchSByAByNameElement gt lt AreaNamePartWithLevelType gt lt AreaNamePart gt York lt AreaNamePart gt lt LevelTypeld gt 13 lt LevelTypeld gt lt AreaNamePartWithLevelType gt lt ns2 SearchSByAByNameElement gt lt soap Body gt lt soap Envelope gt Office for National Statistics 2008 Page 24 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange Sample Response lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt env Header gt lt wsse Security xmIns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmins env http schemas xmlsoap org soap envelope env mustUnderstand 1 gt lt env Header gt lt env Body gt lt ns0 SearchSByAByNameResponseElement gt
83. ss wssecurity secext 1 0 xsd xmins env http schemas xmlsoap org soap envelope soap mustUnderstand 1 gt lt wsse UsernameToken xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd gt lt wsse Username gt gimme data stats com lt wsse Username gt lt wsse Password Type http docs oasis open org wss 2004 01 oasis 200401 wss username token profile 1 04 PasswordText gt Ima5tatto lt wsse Password gt lt wsse UsernameToken gt lt wsse Security gt lt soap Header gt lt soap Body xmlns ns2 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt ns2 AreaDetailElement gt lt Areald gt 276699 lt Areald gt lt ns2 AreaDetailElement gt lt soap Body gt lt soap Envelope gt Sample Response lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt env Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns env http schnemas xmlsoap org soap envelope env mu
84. sswordText gt Ima5tatto lt wsse Password gt lt wsse UsernameToken gt lt wsse Security gt lt soap Header gt lt soap Body xmlns ns2 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt ns2 SearchAreaByNameHierarchyElement gt lt AreaNamePartWithOptHierarchy gt lt AreaNamePart gt Waltham lt AreaNamePart gt lt HierarchyId gt 14 lt HierarchyId gt lt AreaNamePartWithOptHierarchy gt lt ns2 SearchAreaByNameHierarchyElement gt lt soap Body gt lt soap Envelope gt Sample Response lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt env Header gt lt wsse Security xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmins env http schemas xmlsoap org soap envelope env mustUnderstand 1 gt lt env Header gt lt env Body gt lt ns0 SearchAreaByNameHierarchyResponseElement gt lt AreaFallsWithins gt lt AreaFallsWithin gt lt Area gt lt Areald gt 6021674 lt Areald gt lt Name gt Walthamstow lt Name gt lt HierarchyId gt 14 lt HierarchyId gt lt LevelTypeld gt 27 lt LevelTypeld gt lt
85. stUnderstand 1 gt lt env Header gt lt env Body gt lt ns0 AreaDetailResponseElement gt lt AreaDetail gt lt Areald gt 276699 lt Areald gt lt Name gt United Kingdom lt Name gt lt HierarchyId gt 2 lt HierarchyId gt lt LevelTypeld gt 7 lt LevelTypeld gt lt Envelope gt 72 5003 655605 1218558 lt Envelope gt lt ExtCode gt 213 lt ExtCode gt lt MandatoryMetaData xsi nil 1 gt lt OptionalMetaData xsi nil 1 gt lt AreaDetail gt lt ns0 AreaDetailResponseElement gt lt env Body gt lt env Envelope gt 2 2 3 GetHierarchies Description This operation is called without parameters and yields a list of all the Geographic Hierarchies in the NeSS database This list is not static new hierarchies are added from time to time For an explanation of UK geographic hierarchies go to http www statistics gov uk geography beginners guide as Office for National Statistics 2008 Page 12 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange WSDL Definition lt operation name GetHierarchies gt lt input name HierarchiesReguest message tns HierarchiesRequest gt lt output name HierarchiesResponse message tns HierarchiesResponse gt lt fault name NeSSProcessingProblem message tns NeSSProcessingProblem gt lt operation gt Sample Query lt soap Envelope xmln
86. t lt faultstring gt validationFailure lt faultstring gt lt detail gt lt ns0 NeSSProcessingProblemElement gt lt message gt validationFailure lt message gt lt code gt typehelpers DSFamilyId validate ERROR_DATASET lt code gt lt detail gt Dataset not found lt detail gt lt ns0 NeSSProcessingProblemElement gt lt detail gt lt env Fault gt lt env Body gt lt env Envelope gt Client Fault XSD Validation Failure lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt env Body gt lt env Fault gt lt faultcode gt env Client lt faultcode gt lt faultstring gt Caught exception while handling reguest unexpected element name expected Postcode actual Postcoode lt faultstring gt lt env Fault gt lt env Body gt lt env Envelope gt Invalid XML lt HTML gt lt HEAD gt lt TITLE gt Web Service lt TITLE gt lt HEAD gt lt BODY gt lt Hi gt Bad Request lt H1 gt lt PRE gt Error parsing envelope 3 205 End tag does not match start tag ns2 SearchAreaByNameHierarchyElementipoos lt PRE gt lt BODY gt lt HTML gt Office for National Statistics 2008 Page 35 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc
87. t lt soap Header gt lt wsse Security xmIns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmIns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns env http schemas xmlsoap org soap envelope soap mustUnderstand 1 gt lt wsse UsernameToken xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd gt lt wsse Username gt gimme data stats com lt wsse Username gt lt wsse Password Type http docs oasis open org wss 2004 01 oasis 200401 wss username token profile 1 04PasswordText gt Ima5tatto lt wsse Password gt lt wsse UsernameToken gt lt wsse Security gt lt soap Header gt lt soap Body xmlns ns2 http neighbourhood statistics gov uk dissemination resources schemas v0 1 discoverystructs gt lt ns2 AreaAtLevelElement gt lt ArealdWithLevelType gt lt Areald gt 276704 lt Areald gt lt LevelTypeld gt 12 lt LevelTypeld gt lt AreaIdWithLevelType gt lt ns2 AreaAtLevelElement gt lt soap Body gt lt soap Envelope gt Office for National Statistics 2008 Page 10 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange Sample Response lt env Envelope xmins env http sc
88. t HierarchyId gt lt Name gt 1998 Administrative Hierarchy lt Name gt lt Hierarchy gt lt Hierarchy gt lt HierarchyId gt 7 lt HierarchyId gt lt Name gt 2003 Electoral Hierarchy lt Name gt lt Hierarchy gt lt Hierarchy gt lt HierarchyId gt 10 lt HierarchyId gt lt Name gt 2003 Education Hierarchy lt Name gt lt Hierarchy gt lt Hierarchy gt lt HierarchyId gt 12 lt HierarchyId gt lt Name gt New Deal for Communities Best fit lt Name gt lt Hierarchy gt lt Hierarchies gt lt ns0 HierarchiesResponseElement gt lt env Body gt lt env Envelope gt 2 2 4 GetLevelTypes Description This operation is called without parameters and returns a list of current level types on the NeSS database So what is a level type It is a general type of area about which data is held for example a Local Authority LA a level type can exist in more than one hierarchy but there is only one level type per level in each hierarchy In the sample response below a comment has been added to tell you what the letters stand for and those types for which large amounts of data are held are shown in bold type WSDL Definition lt operation name GetLevelTypes gt lt input name LevelTypesReguest message tns LevelTypesReguest gt lt output name LevelTypesResponse message tns LevelTypesResponse gt lt fault name NeSSProcessingProblem message tns NeSSProcessingProblem gt lt operation gt Sampl
89. t lgdx DataRoot gt lt ns0 getDataCubeResponseElement gt lt env Body gt lt env Envelope gt Explanations As example 1 but note that as we have multiple datasets the areas and times are repeated Office for National Statistics 2008 Page 52 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange 3 2 3 Latest Data Example Query 3 This example simply shows that you don t need to give a time It will yield just the latest version of the data Note that if a new version is released between two calls you will get different results lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmlns wsu http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity utility 1 0 xsd gt lt soap Header gt lt wsse Security xmIns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns env http schemas xmlsoap org soap envelope soap mustUnderstand 1 gt lt wsse UsernameToken xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd gt lt wsse Username gt gimme data stats com lt wsse Username gt lt wsse Password Type http
90. t 165381 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 488767 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 89692 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 488767 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 165381 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Polygon gt lt lgdx SpatialData gt lt lgdx Boundary gt lt lgdx Boundaries gt lt lgdx Topics gt lt lgdx Topic Commentary Unit Hours Title Average mean hours worked Male TopicId 13 gt lt lgdx Topic Commentary Unit Hours Title Average mean hours worked Female TopicId 14 gt lt lgdx Topics gt lt Igdx Periods gt lt lgdx Period To_Date 2001 04 29 From_Date 2001 04 29 PeriodId 1 gt lt lgdx Periods gt lt lgdx DatasetItems gt lt lgdx Dataltem Value 42 7 PeriodId 1 TopicId 13 BoundaryId 1 gt Office for National Statistics 2008 Page 51 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange lt lgdx Dataltem Value 42 77 PeriodId 1 TopicId 13 BoundaryId 2 gt lt lgdx Dataltem Value 30 53 PeriodId 1 TopicId 14 BoundaryId 1 gt lt lgdx Dataltem Value 30 86 PeriodId 1 TopicId 14 BoundaryId 2 gt lt lgdx DatasetItems gt lt lgdx DataSet gt lt lgdx DataSource gt l
91. t gt lt StatisticalUnit gt lt SUId gt 2 lt SUId gt lt Name gt Households lt Name gt lt StatisticalUnit gt lt VarFamily gt lt VarFamily gt lt VarFamilyId gt 2325 lt VarFamilyId gt lt Name gt In an Unshared Dwelling Flat Maisonette or Apartment Part of a Converted or Shared House lt Name gt lt MeasurementUnit gt lt MUId gt 1 lt MUId gt lt Name gt Count lt Name gt lt MeasurementUnit gt lt StatisticalUnit gt lt SUId gt 2 lt SUId gt lt Name gt Households lt Name gt lt StatisticalUnit gt lt VarFamily gt lt VarFamily gt lt VarFamilyId gt 2326 lt VarFamilyId gt lt Name gt In an Unshared Dwelling Flat Maisonette or Apartment In a Commercial Building lt Name gt lt MeasurementUnit gt lt MUId gt 1 lt MUId gt lt Name gt Count lt Name gt lt MeasurementUnit gt lt StatisticalUnit gt lt SUId gt 2 lt SUId gt lt Name gt Households lt Name gt lt StatisticalUnit gt lt VarFamily gt lt VarFamily gt lt VarFamilyId gt 2327 lt VarFamilyId gt lt Name gt In an Unshared Dwelling Caravan or Other Mobile or Temporary Structure lt Name gt lt MeasurementUnit gt lt MUId gt 1 lt MUId gt lt Name gt Count lt Name gt lt MeasurementUnit gt lt StatisticalUnit gt lt SUId gt 2 lt SUId gt lt Name gt Households lt Name gt lt StatisticalUnit gt lt VarFamily gt lt VarFamily gt lt VarFamilyId gt 2328 lt VarFamilyId gt lt Name gt In a Shared Dwelling lt
92. t lgdx Point gt lt lgdx XCoordinate gt 488767 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 89692 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Point gt lt lgdx XCoordinate gt 488767 lt lgdx XCoordinate gt lt lgdx YCoordinate gt 165381 lt lgdx YCoordinate gt lt lgdx Point gt lt lgdx Polygon gt lt lgdx SpatialData gt lt lgdx Boundary gt lt lgdx Boundaries gt lt lgdx Topics gt lt lgdx Topic Commentary Unit Count Title All people aged 16 74 TopicId 1 gt lt lgdx Topic Commentary Unit Count Title People aged 16 74 Full time students TopicId 2 gt lt lgdx Topics gt lt Igdx Periods gt lt lgdx Period To_Date 2001 04 29 From_Date 2001 04 29 PeriodId 1 gt lt lgdx Periods gt lt lgdx DatasetItems gt lt lgdx Dataltem Value 78202 PeriodId 1 TopicId 1 BoundaryId 1 gt Office for National Statistics 2008 Page 50 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange lt lgdx Dataltem Value 895199 PeriodId 1 TopicId 1 BoundaryId 2 gt lt lgdx Dataltem Value 3817 PeriodId 1 TopicId 2 BoundaryId 1 gt lt lgdx Dataltem Value 46828 PeriodId 1 TopicId 2 BoundaryId 2 gt lt lgdx DatasetItems gt lt lgdx DataSet gt lt lgdx DataSet gt lt Igdx Metadata gt lt Igdx ArtefactDescription gt This dataset is about H
93. tail gt lt ns0 NeSSProcessingProblemElement gt lt ndcf NeSSDataCubeFault xmins ndcf http neighbourhood statistics gov uk dissemination resources schemas datacubefault gt lt message gt validationFailure lt message gt lt code gt Datarender XMLQueryManager ProcessXMLQuery QueryFailedValidation lt code gt lt detail gt XML Document has Error true amp lt Line 1 Column 1045 amp gt XML 24534 Error Element SeriesGroping not expected lt detail gt lt ndcf NeSSDataCubeFault gt lt ns0 NeSSProcessingProblemElement gt lt detail gt lt env Fault gt lt env Body gt lt env Envelope gt Processing lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources wsdl deliveryservice gt lt env Body gt lt env Fault xsi type env Fault gt lt faultcode gt env Server lt faultcode gt lt faultstring xsi nil 1 gt lt detail gt lt ns0 NeSSProcessingProblemElement gt lt NeSSDataCubeFault xmlns http neighbourhood statistics gov uk dissemination resources schemas datacubefault gt lt message gt systemFailure lt message gt lt code gt Datarender XMLQueryFactory GetResponse InvalidRequest lt code gt lt detail gt NESS Dataset Not Found With Id 333367 lt detail gt lt NeSSDataCubeFault gt lt ns0 NeSSProcessingPro
94. ting all the variables from dataset 67 and just two of the variables from dataset 41 It is also requesting two variables from an unnamed dataset very flexible lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmlns wsu http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity utility 1 0 xsd gt lt soap Header gt lt wsse Security xmIns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmIns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns env http schemas xmlsoap org soap envelope soap mustUnderstand 1 gt lt wsse UsernameToken xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd gt lt wsse Username gt gimme data stats com lt wsse Username gt lt wsse Password Type http docs oasis open org wss 2004 01 oasis 200401 wss username token profile 1 0 PasswordText gt Iam5tatto lt wsse Password gt lt wsse UsernameToken gt lt wsse Security gt lt soap Header gt lt soap Body xmlns ns1 http neighbourhood statistics gov uk dissemination resources wsdl deliveryservice gt lt ns1 getDataCubeElement gt lt DataCubeQueryMessage xmlns xsi http www w3 org 2001 XMLSchema instance xmins http neighbourhood statistics gov uk dissemination resources schemas datacubequery xsi sch
95. ueryMessage gt lt nsi getDataCubeElement gt lt soap Body gt lt soap Envelope gt Explanations See example 1 plus the following Item code 125 note that this is a child of the variablefamily dimension not under one of the datasets The response will show the dataset name and id Response XML for query example 2 This is a large response containing all the variables in two datasets lt env Envelope xmins env http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns ns0 http neighbourhood statistics gov uk dissemination resources wsdl deliveryservice gt lt env Header gt lt wsse Security xmIns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmlns http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd xmins env http schemas xmlsoap org soap envelope env mustUnderstand 1 gt lt env Header gt lt env Body gt lt ns0 getDataCubeResponseElement gt lt lgdx DataRoot xmlns lgdx http www esd org uk LGDX gt lt lgdx DataSource DataSourceName NESS gt lt lgdx DataSet gt lt Igdx Metadata gt lt lgdx ArtefactDescription gt This dataset is about Usual Resident Population In the 2001 Census information was collected for usual residents A usual resident was generally defined as someone who spent most of their time at a specific address This
96. way from home TopicId 8 gt lt lgdx Topic Commentary Unit Percentage Title People living in households TopicId 9 gt lt lgdx Topic Commentary Unit Percentage Title People living in communal establishments TopicId 10 gt lt lgdx Topic Commentary Unit Count Title Area hectares TopicId 11 gt lt lgdx Topic Commentary Unit Rate Title 2001 Density number of people per hectare TopicId 12 gt lt lgdx Topics gt lt Igdx Periods gt lt lgdx Period To_Date 2001 04 29 From_Date 2001 04 29 PeriodId 1 gt lt lgdx Periods gt lt Igdx DatasetItems gt lt lgdx Dataltem Value 107977 PeriodId 1 TopicId 3 BoundaryId 1 gt lt lgdx Dataltem Value 1240103 PeriodId 1 TopicId 3 BoundaryId 2 gt lt lgdx Dataltem Value 52882 PeriodId 1 TopicId 4 BoundaryId 1 gt lt lgdx Dataltem Value 608043 PeriodId 1 TopicId 4 BoundaryId 2 gt lt lgdx Dataltem Value 55095 PeriodId 1 TopicId 5 BoundaryId 1 gt lt lgdx Dataltem Value 632060 PeriodId 1 TopicId 5 BoundaryId 2 gt lt lgdx Dataltem Value 105700 PeriodId 1 TopicId 6 BoundaryId 1 gt lt lgdx Dataltem Value 1214514 PeriodId 1 TopicId 6 BoundaryId 2 gt lt lgdx Dataltem Value 2277 PeriodId 1 TopicId 7 BoundaryId 1 gt lt lgdx Dataltem Value 25589 PeriodId 1 TopicId 7 BoundaryId 2 gt lt lgdx Dataltem Value 1210 PeriodId 1 TopicId 8 BoundaryId 1 gt lt lgdx Data
97. x Point gt lt lgdx Polygon gt Office for National Statistics 2008 Page 55 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange lt lgdx SpatialData gt lt lgdx Boundary gt lt lgdx Boundaries gt lt lgdx Topics gt lt lgdx Topic Commentary Unit Count Title All people aged 16 74 TopicId 1 gt lt lgdx Topic Commentary Unit Count Title People aged 16 74 Full time students TopicId 2 gt lt lgdx Topic Commentary Unit Hours Title Average mean hours worked Male TopicId 3 gt lt lgdx Topic Commentary Unit Hours Title Average mean hours worked Female TopicId 4 gt lt lgdx Topics gt lt Igdx Periods gt lt lgdx Period To_Date 2001 04 29 From_Date 2001 04 29 PeriodId 1 gt lt lgdx Periods gt lt lgdx DatasetItems gt lt lgdx Dataltem Value 895199 PeriodId 1 TopicId 1 BoundaryId 2 gt lt lgdx Dataltem Value 42 7 PeriodId 1 TopicId 3 BoundaryId 1 gt lt lgdx Dataltem Value 46828 PeriodId 1 TopicId 2 BoundaryId 2 gt lt lgdx Dataltem Value 42 77 Period d 1 TopicId 3 BoundaryId 2 gt lt lgdx Dataltem Value 3817 PeriodId 1 TopicId 2 BoundaryId 1 gt lt lgdx Dataltem Value 78202 PeriodId 1 TopicId 1 BoundaryId 1 gt lt lgdx Dataltem Value 30 53 PeriodId 1 TopicId 4 BoundaryId 1 gt lt lgdx
98. x Polygon gt lt lgdx SpatialData gt lt lgdx Boundary gt lt lgdx Boundaries gt lt lgdx Topics gt Office for National Statistics 2008 Page 42 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange lt lgdx Topic Commentary Unit Count Title Working Age Statistical Group Lone Parent TopicId 1 gt lt lgdx Topic Commentary Unit Count Title Working Age Statistical Group Carers and Others TopicId 2 gt lt lgdx Topic Commentary Unit Percentage Title Claimants Aged 16 24 TopicId 3 gt lt lgdx Topic Commentary Unit Percentage Title Claimants Aged 25 49 TopicId 4 gt lt lgdx Topic Commentary Unit Percentage Title Claimants Aged 50 59 TopicId 5 gt lt lgdx Topic Commentary Unit Percentage Title Claimants Aged 60 and Over TopicId 6 gt lt lgdx Topic Commentary Unit Percentage Title Male TopicId 7 gt lt lgdx Topic Commentary Unit Percentage Title Female TopicId 8 gt lt lgdx Topic Commentary Unit Percentage Title Single TopicId 9 gt lt lgdx Topic Commentary Unit Percentage Title Working Age Statistical Group Incapacity Benefits TopicId 10 gt lt lgdx Topic Commentary Unit Percentage Title Working Age Statistical Group Lone Parent TopicId 11 gt lt lgdx Topic Commentary Unit Percentage T
99. ypeld gt 144 lt LevelTypeld gt lt Name gt SPR lt Name gt lt Scottish Parliamentary Region gt lt LevelType gt lt LevelType gt lt LevelTypeld gt 28 lt LevelTypeld gt lt Name gt U lt Name gt lt Urban Area gt lt LevelType gt lt LevelType gt lt LevelTypeld gt 7 lt LevelTypeld gt lt Name gt UK lt Name gt lt England Scotland Wales Northern Ireland gt lt LevelType gt lt LevelType gt lt LevelTypeld gt 29 lt LevelTypeld gt lt Name gt USD lt Name gt lt Urban Subdivisions gt lt LevelType gt lt LevelType gt lt LevelTypeld gt 153 lt LevelTypeld gt lt Name gt USOA lt Name gt lt Super Ouput Area Upper Layer gt lt LevelType gt lt LevelType gt lt LevelTypeId gt 14 lt LevelTypeId gt lt Name gt WARD lt Name gt lt Ward gt Office for National Statistics 2008 Page 16 of 60 Issue No 0 3 Date 17 04 08 Status Draft File NeSS_Data_Exchange_User_Guide_v0 2 doc amp Office for User Guide National Statistics NeSS Data Exchange lt LevelType gt lt LevelType gt lt LevelTypeId gt 27 lt LevelTypeId gt lt Name gt WPC lt Name gt lt Westminster Parliamentary Constituency gt lt LevelType gt lt LevelTypes gt lt ns0 LevelTypesResponseElement gt lt env Body gt lt env Envelope gt 2 2 5 GetLevelTypesByHierarchy Description This operation is called with one parameter the hierarchyId the operation getHierarchies

NeSS Data Exchange User Guide v0.2

Contents

Download Pdf Manuals

Related Search

Related Contents