Skip to main content
Version: 2.2.2

newItem

This import template makes it possible to insert/edit items or item families.

caution
  • The item ID # is automatically generated when the IDOBJECT field is left empty during the insertion of a new item.
  • To insert a released item, the DTREVISION field must be completed.
  • Date fields must be completed in the YYYY/MM/DD format.
  • The item type must be configured to allow customized identifiers so that the value entered in the IDREVISION field can be applied.
  • For numeric fields, use . as a decimal separator.

To insert each of these items, it is necessary to follow the standard documented below.

Java class
Requestweb\wwwroot\ws\java\item\NewItemRequestType.java
Returnweb\wwwroot\ws\java\item\NewItemResponseType.java

Request:

ID #RequiredDescription
IDOBJECTX¹Object ID #
NMOBJECTXObject name
IDOBJECTTYPEXObject type ID #
IDTEAMXResponsible team ID #
IDMEASUNITYXMeasurement unit
FGPHYSICALSTATEPhysical state:
1 - Solid;
2 - Liquid;
3 - Gas;
4 - Sludge.
IDODOROdor ID #
NMCOLORColor name
IDONUCODEUN code
IDDANGEROUSNESSHazard ID #
IDCLASSIFICATIONClassification ID #
IDABNTCODEABNT code
DTREVISIONRevision date, in the YYYY/MM/DD format
IDREVISIONRevision ID #
FGTEMPLATEIndicates whether the record is a family:
"1" for family and null for item
IDTEMPLATEID # of the family with which the item will be associated
IDUSERX²User ID.
DSCONSTITUENTSGeneral description of composition
VLCOSTItem cost value
IDDRAWINGNRDrawing ID #
info

X¹ - Required for EDITING an item; X² - Required for INSERTING an item when the type has revision control.

Request structure:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:item">
<soapenv:Header/>
<soapenv:Body>
<urn:newItem>
<!--You may enter the following 20 items in any order-->
<urn:IDOBJECT>?</urn:IDOBJECT>
<urn:NMOBJECT>?</urn:NMOBJECT>
<urn:IDOBJECTTYPE>?</urn:IDOBJECTTYPE>
<urn:IDTEAM>?</urn:IDTEAM>
<urn:IDMEASUNITY>?</urn:IDMEASUNITY>
<urn:FGPHYSICALSTATE>?</urn:FGPHYSICALSTATE>
<urn:IDODOR>?</urn:IDODOR>
<urn:NMCOLOR>?</urn:NMCOLOR>
<urn:IDONUCODE>?</urn:IDONUCODE>
<urn:IDDANGEROUSNESS>?</urn:IDDANGEROUSNESS>
<urn:IDCLASSIFICATION>?</urn:IDCLASSIFICATION>
<urn:IDABNTCODE>?</urn:IDABNTCODE>
<urn:DTREVISION>?</urn:DTREVISION>
<urn:IDREVISION>?</urn:IDREVISION>
<urn:IDUSER>?</urn:IDUSER>
<urn:FGTEMPLATE>?</urn:FGTEMPLATE>
<urn:IDTEMPLATE>?</urn:IDTEMPLATE>
<urn:VLCOST>?</urn:VLCOST>
<urn:IDDRAWINGNR>?</urn:IDDRAWINGNR>
<urn:DSCONSTITUENTS>?</urn:DSCONSTITUENTS>
</urn:newItem>
</soapenv:Body>
</soapenv:Envelope>

Return:

ID #Description
StatusSUCCESS or FAILURE
CodeSuccess (1) or failure (-1)
DetailMessage about addition, editing, or error found