List Positions (ListPositions) - Intergraph Smart Materials - Version 2017 R1 (2.1) - Help - Hexagon

Intergraph Smart Materials Web API Help 2017 R1 (2.1)

Language
English
Product
Intergraph Smart Materials
Subproduct
Web API
Search by Category
Help
Version Smart Materials Web API
2017 R1 (2.1)

This API retrieves the list positions of a project from Smart Materials. You can either retrieve a single list position using list position Id or all the list positions of a project.

Required Privilege: API_READONLY

Headers

Header Name

Description

Required

Values

Authorization

Access token

Required

Bearer <access_token>

Content-Type

Request type format

Required

application/JSON

Body

URL Format: GET https://{host}/Smat/V1/Projects(‘:project’)/Disciplines(‘:discipline’)/Nls(‘:language’)/ListPositions({key})

Specify values for the project, discipline, language, and key parameter in the URL. The project, discipline, and language together, define the project environment and the key parameter defines the list positions Id (LpId).

To retrieve all the list positions of a project, use the following URL:

GET https://{host}/Smat/V1/Projects(‘:project’)/Disciplines(‘:discipline’)/Nls(‘:language’)/ListPositions

Sample Code

GET https://{host}/Smat/V1/Projects(‘RS’)/Disciplines(‘PIPING’)/Nls(‘English’)/ListPositions(9782)

Success Response

Status: 200 OK

Content:

{

"@odata.context": "https://{host}/Smat/V1/$metadata#Projects('RS')/Disciplines('PIPING')/Nls('English')/ListPositions",

"value":[

{

"LpId":9782,

"LnId":5945,

"StatId":5565,

"ProjId":"RS",

"LstId":5021,

"DpId":5020,

"ListPosition":"10",

"Quantity":10,

"RequisitionInd":"N",

"LoadInd":"Y",

"ParentLpId":null,

"CommodityId":4507598,

"PartId":500244,

"UnitId":500127,

"Ident":14640871,

"ShortCode":null,

"ItyId":500018,

"ListSubPosition":null,

"Input1":"A10",

"Input2":"B2",

"Input3":"S-20",

"Input4":"S-STD",

"Input5":"0",

"ResvQty":0,

"TagNumber":null,

"FahId":null,

"GroupId":500054,

"IssueQty":0,

"Weight":null,

"WeightUnitId":null,

"PlateId":null,

"LockInd":"N"

}]

}

Element

Description

Type

LpId

Unique ID of the retrieved list position

Integer

LnId

Unique ID of the list node. Retrieved list position belongs to this node.

Integer

StatId

Unique ID of the associated issue status

Integer

ProjId

Unique ID of the Project. Retrieved list positions belong to this Project.

String

LstId

Unique ID of the list status

Integer

DpId

Unique ID of the Discipline. Retrieved list positions belong to this Discipline.

Integer

ListPosition

Unique position with this structure-element

String

Quantity

Ident - quantity of the list position

Decimal

RequisitionInd

Allowed values are Y and N.

  • If value Y is passed, quantity of the list position is included in MTO.

String

LoadInd

Allowed values are Y and N.

  • If value Y is passed, the Open MTO Interface (OMI) can update the corresponding record.

String

ParentLpId

Unique ID of the parent list position

Integer

CommodityId

Unique ID of the commodity code

Integer

PartId

Unique ID of the commodity part

Integer

UnitId

Unique ID of the unit

Integer

Ident

Ident number

Integer

ShortCode

Specifies the short code

String

ItyId

Unique ID of the item type

Integer

ListSubPosition

Sub positions of the list position

String

Input (1-5)

Value for size 1 to 5

String

ResvQty

Reserved quantity set by the Forecast Run

Decimal

TagNumber

Tag number

String

FahId

Unique ID of the Forecast header

Integer

GroupId

Unique ID of the commodity group

Integer

IssueQty

Issued quantity

Decimal

Weight

Specifies weight for position of current node

Decimal

WeightUnitId

Specifies unit of weight for position of current node

Integer

PlateId

Unique ID of the plate

Integer

LockInd

String