One moment please...
Untitled Document

How-to: Consume ProductionHourRealization entity

General

This document describes how to consume the ProductionHourRealization entity to perform labor/machine hour realization for a production order in Exact Globe Next.

The functionality provided in this entity is very close to the functional behavior when performing a production labor hour realization in the standard Exact Globe Next application (at Projects ? Entries ? Authorise). For machine hour realization, the functionality is similar to issuing machine hour in the standard production issue application.

The entity supports the following actions:

  • RetrieveSet — Return a set of records of production machine/labor planned lines (including those already realized i.e. ActualQuantity > 0 ) for you to perform a production hour realization.
  • Retrieve — Retrieve a single record of production machine/labor planned lines (including those already realized i.e. ActualQuantity > 0 ) for you to perform a production hour realization.
  • Create — Process the production hour line. Actual labor/machine hour line will be created. Standard validation shall be performed. Production hour budget line will be updated or extra budget line will be created.

Properties

Property

Description

ActualQuantity

 

 

Optional field (Long)

In retrieve set, this field indicates the actual quantity already realized for the production hour line. If the value is greater than 0, this means the line has been realized.

For entity, this field indicates the actual quantity to be realized for the production hour line. If no value is provided or the value is 0, then the value will be calculated based on Starttime and EndTime.

 

This value is based on hour unit.

This field is only required upon performing the Create action.

BackFlush

 

Read only field (Boolean True/False)

The field indicates whether the item is back flush for the production hour line.

Condition

 

Read only field (String)

The field indicates the condition of the production issue line.

The following are the descriptions of the values:

N – Always

S - Once per production Order

F - Phantom

W – Waste

U - Once per production order

O – Optional

P - Packaging

EndTime

 

Labor item - Mandatory field (date)

This field indicates the end time for the production labor hour line.

Actual quantity to be realized will be calculated based on this field if the actual quantity is not provided.

A value must be provided for this field.

 

Machine item - Optional field (date)

This field indicates the end time for the production machine hour line.

This field is optional.

ID

Mandatory field (Long)

This field refers to the ID of the production issue hour line.

Use this ID to retrieve a single production hour line from the entity.

This ID should be provided upon performing the Create action. If the ID matches the production hour plan line, then the plan line will be updated based on the ID provided. Else, the plan lines in the production order will be updated based on following priority logics:

1.     Consume plan line that matches the resource ID provided.

2.     Consume plan line with the earliest start time.

3.     Consume plan line with the largest plan quantity.

4.     If no match, create an extra budget line.

ItemCode

 

Mandatory field (String)

This field indicates the item (labor/machine) that needs to be realized. The value must match the item code in the planned hour line.

ItemType

 

Read only field (String)

This field indicates the item type of the production issue line’s item.

The following are the descriptions of the values:

S – Standard

P – Phantom

B - Bulk issue

H - Labor hour

M - Machine hour

ItemDescription

 

Read only field (String)

This field indicates the item description of the item in the planned hour line.

Modified

 

Read only field (String)

This field indicates the last modified date for the planned hour line.

Operation

 

Read only field (String)

This field shows the operation value of the planned hour line.

PlannedQuantity

 

Read only field (Double)

This field indicates the original planned quantity for the production hour line that needs to be realized.

ProductionOrder

 

Mandatory field (String)

This field indicates the production order that needs to be issued.

This field is mandatory for the Create and Update actions.

Resource

 

Mandatory field (String)

A valid resource ID must be provided for this field upon performing the Create action.

Sequence

 

Read only field (Double)

This field shows the step value of the planned hour line.

SerialBatchNumber

 

Optional field (String)

This field is applicable to machine hour item only.

This field refers to the machine item.

If the value is provided, the actual line for the machine hour item will be created with this value.

StartTime

 

Labor item - Mandatory field (date)

This field indicates the start time for the production labor hour line.

Actual quantity to be realized will be calculated based on this field if the actual quantity is not provided.

A value must be provided for this field.

 

Machine item - Optional field (date)

This field indicates the start time for the production machine hour line.

This field is optional.

Modified

 

Read only field (String)

The field indicates the last modified date of the planned production issue line.

How do I consume production hour realization with entity?

To create a production labor/machine hour realization with the ProductionHourRealization entity, user should consume the entity in following sequence:

  1. Retrieve the planned production hour lines for realize with RetrieveSet (entities).
  2. Retrieve each single production hour line with entity Retrieve action.
  3. Enter the actual issue quantity (machine hour) or start time and end time (labor hour).
  4. Perform the entity Create action.
  5. Capture the error in case there is any error thrown due to incorrect data when processing production issue.

 

Examples

Please refer to document 22.148.798 for the general guideline on how to consume Exact Entity.

Step 1: Retrieve set

 

 

Step 2: Retrieve single production hour line (Optional)

 

Step 3: Realize production labor/Machine line

 

 

Main Code

Supported release

The ProductionHourRealization entity is available from product update 406 onwards.

Related documents

 

Document Number: 23.796.442

Disclaimer
Despite the continued efforts of Exact to ensure that the information in this document is as complete and up-to-date as possible, Exact can not be held accountable for the correctness and/or completeness and/or specific applicability of the published and/or requested information in this document. Exact shall not be liable for any direct, indirect, incidental, special or consequential damages, lost profits or for business interruption arising out of the use of this document. The extraction and use of information from this document remains at all times completely within the user's own risk.


Attachments
How to consume ProductionHourRealization Entity.docx 182.1 KB View Download
ProductionRealizationEntityTestApp.zip 282.0 KB Download