Transaction Request

Request Parameters
Request Sample

Request Parameters

Transaction operation achieved through a POST request to insert, update and delete metadata. The request body is XML format. The main node elements are described as follows:

Table 1 the Node Elements of Transaction Operation Request

Request Parameters	O/M	Description
<Transaction>	Mandatory	A Transaction element include 0 or several <Insert>,<Update> or <Delete> element to insert, update or delete metadata. Allow <Transaction> element is empty, that is, this element does not contain other elements, then Transaction operation does not make sense.
<Insert>	No	O/M when inserting metadata. The catalog metadata to be inserted need to comply with encoding rules defined by ISO19139 standard or National Mapping Metadata Standard (SMMD2007) to describe. One <Insert>element could only insert one metadata.
<Update>	No	O/M when updating metadata. TypeName parameter is used to specify the information model object type to be updated. One <Update> element may contain one or more <RecordProperty>element to specify the metadata attributes (<Name>element) and attribute value (<Value>element) to be updated. Without <Value>element this attribute will be given a null value. The <Update> element includes one or more <Constraint>elements defining the scope of the metadata to be updated. See request sample.
<Delete>	No	O/M when deleting metadata. TypeName parameter is used to specify the information model object type to be deleted. E.g., Record model of csw ogc. Specify the metadata to be deleted using <Constraint> element. The metadata could be one or more.

Request Sample

In this example, operate three times Transaction for CSW services. First insert a new metadata, then update the metadata, and finally delete this metadata. That is, request the following address http://localhost:8090/iserver/services.csw?request=Transaction&version=2.0.2 by POST method, the following are the transmission request body:

Insert metadata

Execute POST request, the request body is:

<?xml version="1.0" encoding="utf-8"?> <csw:Transaction requestId="" verboseResponse="false" xmlns:csw="http://www.opengis.net/cat/csw/2.0.2"> <csw:Insert handle=""> <smmd:Metadata xmlns:smmd="http://data.sbsm.gov.cn/smmd/2007" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" createdBy="0"> <smmd:mdFileID>ID1</smmd:mdFileID> <smmd:mdLang>zh_CN</smmd:mdLang> <smmd:mdChar>GB2312</smmd:mdChar> <smmd:mdContact> <smmd:rpIndName/> <smmd:rpOrgName>SuperMap Software Co. ,Ltd</smmd:rpOrgName> <smmd:rpPosName/> <smmd:rpCntInfo> <smmd:cntAddress> <smmd:delPoint>Building 201 No A10,Jiuxianqiao North Road</smmd:delPoint> <smmd:city>Beijing</smmd:city> <smmd:adminArea>Chaoyang District</smmd:adminArea> <smmd:postCode>100015</smmd:postCode> <smmd:country>PR China</smmd:country> <smmd:eMailAdd>support@supermap.com</smmd:eMailAdd> </smmd:cntAddress> <smmd:cntOnLineRes> <smmd:linkage>http://www.supermap.com.cn</smmd:linkage> <smmd:orDesc>Online Help</smmd:orDesc> <smmd:orFunct>Online Help</smmd:orFunct> </smmd:cntOnLineRes> <smmd:voiceNum>+86-10-59896655</smmd:voiceNum> <smmd:faxNum>+86-10-59896666</smmd:faxNum> </smmd:rpCntInfo> <smmd:role>Data provider</smmd:role> </smmd:mdContact> <smmd:mdDateSt>2012-09-19</smmd:mdDateSt> <smmd:mdStanName>Geographic Information Network Distribution Service Metadata Content Specification</smmd:mdStanName> <smmd:mdStanVer>1.0</smmd:mdStanVer> <smmd:dataIdInfo> <smmd:DataIdent> <smmd:idCitation> <smmd:resTitle>Terrain vector data</smmd:resTitle> <smmd:resRefDate> <smmd:refDate>2008-02-16</smmd:refDate> <smmd:refDateType>Completion of the production</smmd:refDateType> </smmd:resRefDate> <smmd:resEd></smmd:resEd> </smmd:idCitation> <smmd:idAbs></smmd:idAbs> <smmd:idPurp></smmd:idPurp> <smmd:dataLang>zh_CN</smmd:dataLang> <smmd:idStatus>Finish</smmd:idStatus> <smmd:idPoC> <smmd:rpOrgName>SuperMap Software Co. ,Ltd</smmd:rpOrgName> <smmd:role>Data Provider</smmd:role> </smmd:idPoC> <smmd:graphOver> <smmd:bgFileName>name</smmd:bgFileName> <smmd:bgFileDesc>name</smmd:bgFileDesc> <smmd:bgFileType>name</smmd:bgFileType> </smmd:graphOver> <smmd:resType>Mapping baseline data</smmd:resType> <smmd:resSubType></smmd:resSubType> <smmd:tpCat>Geodetic result</smmd:tpCat> <smmd:refTheme> <smmd:theme>theme</smmd:theme> </smmd:refTheme> <smmd:resConst> <smmd:SecConsts> <smmd:class>Not classified</smmd:class> <smmd:userNote>Not classified</smmd:userNote> </smmd:SecConsts> </smmd:resConst> <smmd:dataExt> <smmd:geoEle> <smmd:GeoBndBox> <smmd:westBL>0</smmd:westBL> <smmd:eastBL>0</smmd:eastBL> <smmd:southBL>0</smmd:southBL> <smmd:northBL>0</smmd:northBL> </smmd:GeoBndBox> </smmd:geoEle> </smmd:dataExt> <smmd:spatRpType>Vector</smmd:spatRpType> <smmd:dataScale> <smmd:equScale>0.006</smmd:equScale> </smmd:dataScale> <smmd:dataChar>GB2312</smmd:dataChar> </smmd:DataIdent> </smmd:dataIdInfo> <smmd:dqInfo> <smmd:dqStatement></smmd:dqStatement> <smmd:linStatement></smmd:linStatement> </smmd:dqInfo> <smmd:refSysInfo> <smmd:MdCoRefSys> <smmd:projection>[Project name]</smmd:projection> <smmd:ellipsoid>[Ellipsoid name]</smmd:ellipsoid> <smmd:datum>Global reference system</smmd:datum> <smmd:vertCRS>Independent vertical datum</smmd:vertCRS> <smmd:projParas/> <smmd:ellParas> <smmd:semiMajAx>text</smmd:semiMajAx> <smmd:axisUnits>text</smmd:axisUnits> <smmd:denFlatRat>text</smmd:denFlatRat> </smmd:ellParas> </smmd:MdCoRefSys> </smmd:refSysInfo> <smmd:distInfo> <smmd:onLineSrc> <smmd:linkage>http://localhost:8090/iserver/services</smmd:linkage> <smmd:orDesc>text</smmd:orDesc> <smmd:orFunct>Getting instruction</smmd:orFunct> </smmd:onLineSrc> <smmd:distributor> <smmd:distorCont> <smmd:rpIndName/> <smmd:rpOrgName>SuperMap Software Co. ,Ltd</smmd:rpOrgName> <smmd:rpPosName/> <smmd:rpCntInfo> <smmd:cntAddress> <smmd:delPoint>Building 201 No A10,Jiuxianqiao North Road</smmd:delPoint> <smmd:city>Beijing</smmd:city> <smmd:adminArea>Chaoyang District</smmd:adminArea> <smmd:postCode>100015</smmd:postCode> <smmd:country>PR China</smmd:country> <smmd:eMailAdd>support@supermap.com</smmd:eMailAdd> </smmd:cntAddress> <smmd:cntOnLineRes> <smmd:linkage>http://www.supermap.com.cn</smmd:linkage> <smmd:orDesc>Online help</smmd:orDesc> <smmd:orFunct>Online help</smmd:orFunct> </smmd:cntOnLineRes> <smmd:voiceNum>+86-10-59896655</smmd:voiceNum> <smmd:faxNum>+86-10-59896666</smmd:faxNum> </smmd:rpCntInfo> <smmd:role>Data provider</smmd:role> </smmd:distorCont> <smmd:ordInstr>text</smmd:ordInstr> <smmd:resFees>text</smmd:resFees> </smmd:distributor> </smmd:distInfo> </smmd:Metadata> </csw:Insert> </csw:Transaction>

Update metadata

Execute POST request, the request body is:

<?xml version="1.0" encoding="utf-8"?> <csw:Transaction requestId="" verboseResponse="false"> <csw:Update handle=""> <csw:RecordProperty> <csw:Name>dc:title</csw:Name> <csw:Value>newTitle</csw:Value> </csw:RecordProperty> <csw:Constraint version="1.1.0"> <ogc:Filter> <ogc:PropertyIsEqualTo> <ogc:PropertyName>dc:id</ogc:PropertyName> <ogc:Literal>ID1</ogc:Literal> </ogc:PropertyIsEqualTo> </ogc:Filter> </csw:Constraint> </csw:Update> </csw:Transaction>

Delete metadata

Execute POST request, the request body is:

<?xml version="1.0" encoding="utf-8"?> <csw:Transaction requestId="" verboseResponse="false"> <csw:Delete typeName="Records" handle=""> <csw:Constraint version="1.1.0"> <ogc:Filter> <ogc:PropertyIsEqualTo> <ogc:PropertyName>dc:identifier</ogc:PropertyName> <ogc:Literal>ID1</ogc:Literal> </ogc:PropertyIsEqualTo> </ogc:Filter> </csw:Constraint> </csw:Delete> </csw:Transaction>