<< Click to Display Table of Contents >> Navigation: »No topics above this level« UpdateEntity |
Met behulp van de UpdateEntity webservice kan een record in een tabel worden aangepast. In het SOAP bericht moeten de volgende elementen worden meegegeven:
•De Cocon webservices login gegevens
•strEntity: de (technische) naam van de entiteit (tabel) waarvoor een record aangemaakt moet worden, zie hiervoor de Datadictionary.
•objConditions(): een array/lijst van FieldValue structuren welke het te wijzigen record identificeert (bijv. een ID of een naam).
•objValues(): een array/lijst van FieldValue structuren welke de in te voeren gegevens representeren. De ingevoerde waardes worden ook weer teruggegeven inclusief eventueel aangevude gegevens zoals een ID.
De webservice geeft het aantal aangemaakte records terug.
Indien er iets fout gaat zal er een SoapException optreden.
Endpoint : CoconServices/CRUD.asmx
WSDL : https://services.speerit.nl/CoconServices/CRUD.asmx?wsdl
Indien in een entiteit een verwijzing zit naar een andere entiteit kan de waarde hiervoor meegegeven worden op dezelfde wijze als voor andere velden (normaal gesproken een ID verwijzing) maar ook kan het voor de gebruikers unieke gegeven in de tabel waarnaar verwezen wordt meegegeven worden.
Bijv zijn deze 2 varianten mogelijk om bij het aanmaken van een klantcontract te verwijzen naar de klant waar het contract bij hoort:
<crud:FieldValue>
<crud:Field>KLANTCONTRACT.KLANTID</crud:Field>
<crud:Value xsi:type="xsd:long">822</crud:Value>
</crud:EntityValue>
<crud:FieldValue>
<crud:Field>KLANT.KLANTNAAM</crud:Field>
<crud:Value xsi:type="xsd:string">Van Hunnik</crud:Value>
</crud:EntityValue>
Een voorbeeld bericht is:
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:crud="http://www.speerit.nl/CoconServices/CRUD">
<soap:Header/>
<soap:Body>
<crud:UpdateEntity>
<crud:strCentralCoconFolder>COCON_PRODUCTIE</crud:strCentralCoconFolder>
<crud:strEnvironment></crud:strEnvironment>
<crud:strUserName>Gebruikersnaam</crud:strUserName>
<crud:strPassword>***</crud:strPassword>
<crud:strCulture>nl-NL</crud:strCulture>
<crud:strEntity>KLANT</crud:strEntity>
<crud:objConditions>
<crud:FieldValue>
<crud:Field>KLANT.KLANTNAAM</crud:Field>
<crud:Value xsi:type="xsd:string">Van Hunnik</crud:Value>
</crud:FieldValue>
</crud:objConditions>
<crud:objValues>
<crud:FieldValue>
<crud:Field>KLANT.PLAATSNAAM</crud:Field>
<crud:Value xsi:type="xsd:string">Rotterdam</crud:Value>
</crud:FieldValue>
</crud:objValues>
</crud:UpdateEntity>
</soap:Body>
</soap:Envelope>