DeleteItems
The DeleteItems API removes multiple records from a specified IDO collection at one
time.
DELETE | /{responsetype}/{ido}/deleteitems |
---|---|
http://localhost/IDORequestService/MGRESTService.svc/xml/UserNames/deleteitems |
Parameters
Name | In | Required? | Description |
---|---|---|---|
responsetype | Path | Yes | Response request data format Specify any of these values:
|
ido | Path | Yes | The name of the IDO collection |
Headers
Name | Description |
---|---|
Authorization | If the API is called directly, then a Mongoose security token is obtained through a call to the
GetSecurityToken API. If the API is called through ION API, then a valid OAuth2.0 bearer token is provided by ION API. |
X-Infor-MongooseConfig | The name of a configuration that is available on the
application server This header is required only when using the Mongoose API through the ION API. |
Reqiest data in XML format
<?xml version="1.0"?> <ArrayOfIDOUpdateItem xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.infor.com"> <IDOUpdateItem> <Action>Delete</Action> <ItemId>PBT=[UserNames] UserNames.DT=[2019-07-24 13:58:55.860] UserNames.ID=[4b5b7da7-dd7c-47d7-8746-2ce193bfc43a]</ItemId> <Properties> <UpdateProperty> <IsNull>false</IsNull> <Modified>false</Modified> <Name>_ItemId</Name> </UpdateProperty> </Properties> </IDOUpdateItem> <IDOUpdateItem> <Action>Delete</Action> <ItemId>PBT=[UserNames] UserNames.DT=[2019-07-24 13:58:55.997] UserNames.ID=[3faaaaab-47ef-4643-8255-756976238911]</ItemId> <Properties> <UpdateProperty> <IsNull>false</IsNull> <Modified>false</Modified> <Name>_ItemId</Name> </UpdateProperty> </Properties> </IDOUpdateItem> </ArrayOfIDOUpdateItem>
Request data in JSON format
[ { "Action": 4, "ItemId": "PBT=[UserNames] UserNames.DT=[2019-07-24 13:58:55.860] UserNames.ID=[4b5b7da7-dd7c-47d7-8746-2ce193bfc43a]", "Properties": [ { "IsNull": false, "Modified": false, "Name": "_ItemId", "Value": null } ] }, { "Action": 4, "ItemId": "PBT=[UserNames] UserNames.DT=[2019-07-24 13:58:55.997] UserNames.ID=[3faaaaab-47ef-4643-8255-756976238911]", "Properties": [ { "IsNull": false, "Modified": false, "Name": "_ItemId", "Value": null } ] } ]
Response data in XML format
<MGRestUpdateResponse xmlns="http://schemas.datacontract.org/2004/07/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <Message>Delete successful.</Message> <MessageCode>202</MessageCode> </MGRestUpdateResponse>
Response data in JSON format
{ "Message": "Delete successful.", "MessageCode": 202 }
Example
This example code deletes multiple users that have the given _ItemID property values.
string xml = string.Empty; using ( HttpClient client = new HttpClient() ) { // optionally, you can use json as the response type string ido = "UserNames"; string requestUrl = $"http://server/IDORequestService/MGRESTService.svc/xml/{ido}/deleteitems"; // provide token in the Authorization header client.DefaultRequestHeaders.TryAddWithoutValidation( "Authorization", "b/XdI6IQzCviZOGJ0E+002DoKUFOPmVDkwpQDbQj…==" ); List<IDOUpdateItem> idoItems = new List<IDOUpdateItem>(); UpdateProperty itemId = new UpdateProperty { Name = "ItemId", Value = null, IsNull = false, Modified = false }; IDOUpdateItem idoItem = new IDOUpdateItem { Action = UpdateAction.Delete, Properties = new[] { itemId }, ItemId = "PBT=[UserNames] UserNames.DT=[2019-07-24 13:58:55.860] UserNames.ID=[4b5b7da7-dd7c-47d7-8746-2ce193bfc43a]" }; idoItems.Add( idoItem ); itemId = new UpdateProperty { Name = "ItemId", Value = null, IsNull = false, Modified = false }; idoItem = new IDOUpdateItem { Action = UpdateAction.Delete, Properties = new[] { itemId }, ItemId = "PBT=[UserNames] UserNames.DT=[2019-07-24 13:58:55.997] UserNames.ID=[3faaaaab-47ef-4643-8255-756976238911]" }; idoItems.Add( idoItem ); XDocument xdoc = new XDocument( new XDeclaration( "1.0", "utf-8", "yes" ) ); using ( XmlWriter writer = xdoc.CreateWriter() ) { DataContractSerializer serializer = new DataContractSerializer( idoItems.GetType() ); serializer.WriteObject( writer, idoItems ); } // pass the List<IDOUpdateItem> as the request data and send the delete request HttpResponseMessage response = client.PostAsync( requestUrl, new StringContent( xdoc.ToString(), Encoding.UTF8, "application/xml" ) ).Result; using ( HttpContent content = response.Content ) { Task<string> result = content.ReadAsStringAsync(); xml = result.Result; } }
You can use these classes to construct the Request Data as demonstrated in the previous code snippets:
public class IDOUpdateItem { public UpdateAction Action { get; set; } public string ItemId { get; set; } public int ItemNo { get; set; } public UpdateProperty[] Properties { get; set; } public UpdateLocking UpdateLocking { get; set; } } public class UpdateProperty { public string Name { get; set; } public string Value { get; set; } public string OriginalValue { get; set; } public bool Modified { get; set; } public bool IsNull { get; set; } } public enum UpdateAction { Insert = 1, Update = 2, Delete = 4 } public enum UpdateLocking { Row = 0, Property = 1 }