Transaction Request

Request parameters
Request example

Request parameters

Transaction operation realizes three functions of inserting metadata, updating metadata and deleting metadata through POST request, and the request body adopts in XML format, the main node elements are described as follows:

Table 1 Transaction Operation Request Body Node Element

Request parameters	Whether it is required	Description
<Transaction>	Yes	A transaction element includes 0 or more <Insert>, <Update>, or <Delete> elements used for inserting, updating, or deleting metadata. Allowing the <Transaction> element to be empty, meaning it does not contain any other elements, rendering the transaction operation meaningless.
<Insert>	No	Required for inserting metadata. The catalog metadata to be inserted needs to be described in accordance with the encoding rules defined by ISO19139 standard or the national mapping metadata standard (SMMD2007). Only one metadata can be inserted into an <Insert> element.
<Update>	No	Required for metadata update. The typeName parameter specifies the type of information model object that needs to be updated. An <Update> element can contain one or more <RecordProperty> elements that specify the attributes (< Name > elements) and attribute values (< Value > elements) of the metadata to be updated. In the absence of a < Value > element, the attribute is assigned a null value. The < Update > element also contains the < Constraint > element, which is used to limit the scope of the metadata to be updated. There can be one or more. See the Request Example for details.
<Delete>	No	Required when performing metadata deletion operation. Among them, the typeName parameter is used to specify the type of information model object that needs to be deleted, such as the Record model of csw ogc The metadata to be deleted is specified through the < Constraint > element, which can be one or more.

Request example

In this example, three Transaction operations are performed on the CSW service. First, a new piece of metadata is inserted, then the metadata is updated, and finally the metadata is deleted. That is, yes Http://localhost:8090/iserver/services.csw?SERVICE=CSW&request=Transaction&version=2.0.2, execution POST requests, which respectively transmit the following request bodies:

Insert metadata

Execute the POST request with the following request body:

<?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>https://www.supermap.com.cn</smmd:linkage> <smmd:orDesc>Online instructions</smmd:orDesc> <smmd:orFunct>Online instructions</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>Specification for metadata content of geographic information network distribution service</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>Complete 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>complete</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>Surveying and mapping benchmark data</smmd:resType> <smmd:resSubType></smmd:resSubType> <smmd:tpCat>Geodetic survey results</smmd:tpCat> <smmd:refTheme> <smmd:theme>theme</smmd:theme> </smmd:refTheme> <smmd:resConst> <smmd:SecConsts> <smmd:class>unrated</smmd:class> <smmd:userNote>unrated</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>[Projection name]</smmd:projection> <smmd:ellipsoid>[Name of ellipsoid used]</smmd:ellipsoid> <smmd:datum>Global reference frame</smmd:datum> <smmd:vertCRS>Independent elevation reference</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>Get instructions</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>https://www.supermap.com.cn</smmd:linkage> <smmd:orDesc>Online instructions</smmd:orDesc> <smmd:orFunct>Online instructions</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 the POST request with the following request body:

<?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 the metadata

Execute the POST request with the following request body:

<?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>