F1201GetItemMasterByAssetNumber

F1201 Validate Asset Number

Minor Business Rule

Object Name: X1202

Parent DLL: CAEC

Location: Client/Server

Language: C

Purpose:
Use this function to retrieve the asset numbers and descriptions from the Item Master Table (F1201) using the asset number.


Retrievals:

1.Fetch row from Item Master Table (F1201) using the Asset Number (NUMB) as the key.
2.If the fetch fails then sets error code 3275 - Asset Number Invalid.

3.Errors are set using jdeSetGBRError only if the SuppressErrorMessages is not equal to  '1'.



Returns:

Returns the pointer to the Item Master Record (F1201), if requested and any error messages.

Data Structure

DX1202B - F1201 Get Item Master By Asset Number

Parameter NameData ItemData TypeReq/OptI/O/Both
mnAssetItemNumberNUMBMATH_NUMERICREQINPUT

An 8-digit number that uniquely identifies an asset.

idF1201RecordPointerGENLNGIDOPTOUTPUT

General purpose ID variable.

cReturnPointerEV02charOPTINPUT

An option that specifies the type of processing for an event.

cSuppressErrorMessagesEV01charOPTINPUT

An option that specifies the type of processing for an event.

szErrorMessageIDDTAIcharOPTOUTPUT

A code that identifies and defines a unit of information. It is an alphanumeric code up to 8 characters long that does not allow blanks or 
special characters such as %, &, or +. You create new data items using system codes 55-59. You cannot change the alias.

Related Functions

None

Related Tables

F1201 Asset Master File
F1201GetItemMasterBySerialNumber

F1201GetItemMasterBySerialNumber

F1201 Validate Asset Number

Minor Business Rule

Object Name: X1202

Parent DLL: CAEC

Location: Client/Server

Language: C

Purpose:
Use this function to retrieve the asset numbers and descriptions from the Item Master Table (F1201) using the serial number.


Retrievals:

1.Fetch row from Item Master Table (F1201) using the Serial Number (ASID) as the key.
2.If the fetch fails then sets error code 3275 - Asset Number Invalid.

3.Errors are set using jdeSetGBRError only if the SuppressErrorMessages is not equal to  '1'.



Returns:

Returns the pointer to the Item Master Record (F1201), if requested and any error messages.



Data Structure

DX1202D - F1201 Get Item Master By Serial Number

Parameter NameData ItemData TypeReq/OptI/O/Both
szSerialNumberASIDcharREQINPUT

A 25-character alphanumeric number that you can use as an alternate asset identification number. You might use this number to track 
assets by the manufacturer's serial number. You are not required to use a serial number to identify an asset. Every serial number that you enter 
must be unique.

idF1201RecordPointerGENLNGIDOPTOUTPUT

General purpose ID variable.

cReturnPointerEV02charOPTINPUT

An option that specifies the type of processing for an event.

cSuppressErrorMessagesEV01charOPTINPUT

An option that specifies the type of processing for an event.

szErrorMessageIDDTAIcharOPTOUTPUT

A code that identifies and defines a unit of information. It is an alphanumeric code up to 8 characters long that does not allow blanks or 
special characters such as %, &, or +. You create new data items using system codes 55-59. You cannot change the alias.

Related Functions

None

Related Tables

F1201 Asset Master File
F1201GetItemMasterByUnitNumber

F1201GetItemMasterByUnitNumber

F1201 Validate Asset Number

Minor Business Rule

Object Name: X1202

Parent DLL: CAEC

Location: Client/Server

Language: C

Purpose:
Use this function to retrieve the asset numbers and descriptions from the Item Master Table (F1201) using the unit number.


Retrievals:

1.Fetch row from Item Master Table (F1201) using the Unit Number (APID) as the key.
2.If the fetch fails then sets error code 3275 - Asset Number Invalid.

3.Errors are set using jdeSetGBRError only if the SuppressErrorMessages is not equal to  '1'.



Returns:

Returns the pointer to the Item Master Record (F1201), if requested and any error messages.

Data Structure

DX1202C - F1201 Get Item Master By Unit Number

Parameter NameData ItemData TypeReq/OptI/O/Both
szUnitNumberAPIDcharREQINPUT

A 12-character alphanumeric code used as an alternate identification number for an asset. This number is not required, nor does the 
system assign a number if you leave the field blank when you add an asset. If you use this number, it must be unique. For equipment, this is 
typically the serial number.

idF1201RecordPointerGENLNGIDOPTOUTPUT

General purpose ID variable.

cReturnPointerEV02charOPTINPUT

An option that specifies the type of processing for an event.

szErrorMessageIDDTAIcharOPTOUTPUT

A code that identifies and defines a unit of information. It is an alphanumeric code up to 8 characters long that does not allow blanks or 
special characters such as %, &, or +. You create new data items using system codes 55-59. You cannot change the alias.

cSuppressErrorMessagesEV01charOPTINPUT

An option that specifies the type of processing for an event.

Related Functions

None

Related Tables

F1201 Asset Master File
F1201ReturnPrimaryAssetNumber

F1201ReturnPrimaryAssetNumber

F1201 Validate Asset Number

Minor Business Rule

Object Name: X1202

Parent DLL: CAEC

Location: Client/Server

Language: C

Purpose:
This function will determine which of the three numbers passed is the primary asset number based on the symbols.  If the three symbols are not 

passed in, then they are retrieved from the Company Constants table (F0010).


Retrievals:

1.If all three symbols are blank, retrieve the symbols from the Company Constants (F0010) using Company '00000'.


Returns:

Primary Asset Number (ASII).  The symbol that has a blank value identifies the primary asset number.  The corresponding number is loaded and 

returned in the primary asset number field.


The symbol identifier is loaded with the value that identifies which number was primary.

1 = Asset Item Number (NUMB) is primary.

2 = Unit Number (APID) is primary.

3 = Serial Number (ASID) is primary.


Returns the pointer to the Item Master Record (F1201), if requested and any error messages.


Data Structure

DX1202E - F1201 Return Primary Asset Number

Parameter NameData ItemData TypeReq/OptI/O/Both
mnAssetItemNumberNUMBMATH_NUMERICREQINPUT

An 8-digit number that uniquely identifies an asset.

szUnitNumberAPIDcharREQINPUT

A 12-character alphanumeric code used as an alternate identification number for an asset. This number is not required, nor does the 
system assign a number if you leave the field blank when you add an asset. If you use this number, it must be unique. For equipment, this is 
typically the serial number.

szSerialNumberASIDcharREQINPUT

A 25-character alphanumeric number that you can use as an alternate asset identification number. You might use this number to track 
assets by the manufacturer's serial number. You are not required to use a serial number to identify an asset. Every serial number that you enter 
must be unique.

cAssetNumberSymbolSMIcharOPTINPUT

A value that identifies an asset. You can assign one of three different types of numbers:   o  Asset Number - an eight digit, system assigned 
number   o  Serial Number - a 25 digit model or serial number   o  Unit Number - a 12 digit, alphanumeric, user defined number  When you enter 
an asset number, you may use a prefix or symbol to designate the type of number you enter. For the type of asset number you use most 
often, you should use no prefix, so that you just need to enter the number. For the other two types of asset numbers, you should define a symbol 
for each, such as / or *, that you will enter as a prefix before the number to identify which type of number you are representing. For example, if 
you enter serial numbers most often, you should use no prefix for serial numbers. Then you might use / as a prefix for asset numbers and * 
as a prefix for unit numbers.  Note: You can leave only one type of asset number with no prefix. The other two must have a symbol so that all 
three numbers are unique. Verify that the symbols that you use are not significant for any other purposes of data entry, for example, a period or 
comma.

cUnitNumberSymbolSMUcharOPTINPUT

A value that identifies an asset. You can assign one of three different types of numbers:   o  Asset Number - an eight digit, system assigned 
number   o  Serial Number - a 25 digit model or serial number   o  Unit Number - a 12 digit, alphanumeric, user defined number  When you enter 
an asset number, you may use a prefix or symbol to designate the type of number you enter. For the type of asset number you use most 
often, you should use no prefix, so that you just need to enter the number. For the other two types of asset numbers, you should define a symbol 
for each, such as / or *, that you will enter as a prefix before the number to identify which type of number you are representing. For example, if 
you enter serial numbers most often, you should use no prefix for serial numbers. Then you might use / as a prefix for asset numbers and * 
as a prefix for unit numbers.  Note: You can leave only one type of asset number with no prefix. The other two must have a symbol so that all 
three numbers are unique. Verify that the symbols that you use are not significant for any other purposes of data entry, for example, a period or 
comma.

cSerialNumberSymbolSMScharOPTINPUT

A value that identifies an asset. You can assign one of three different types of numbers:   o  Asset Number - an eight digit, system assigned 
number   o  Serial Number - a 25 digit model or serial number   o  Unit Number - a 12 digit, alphanumeric, user defined number  When you enter 
an asset number, you may use a prefix or symbol to designate the type of number you enter. For the type of asset number you use most 
often, you should use no prefix, so that you just need to enter the number. For the other two types of asset numbers, you should define a symbol 
for each, such as / or *, that you will enter as a prefix before the number to identify which type of number you are representing. For example, if 
you enter serial numbers most often, you should use no prefix for serial numbers. Then you might use / as a prefix for asset numbers and * 
as a prefix for unit numbers.  Note: You can leave only one type of asset number with no prefix. The other two must have a symbol so that all 
three numbers are unique. Verify that the symbols that you use are not significant for any other purposes of data entry, for example, a period or 
comma.

szPrimaryAssetNumberASIIcharOPTOUTPUT

An identification code that represents an asset. You enter the identification code in one of the following formats: 1 Asset number (a 
computer-assigned, 8-digit, numeric control number)   2 Unit number (a 12-character alphanumeric field)   3 Serial number (a 25-character alphanumeric 
field) Every asset has an asset number. You can use unit number and serial number to further identify assets. If this is a data entry field, the first 
character you enter indicates whether you are entering the primary (default) format that is defined for your system, or one of the other two 
formats. A special character (such as / or *) in the first position of this field indicates which asset number format you are using. You assign special 
characters to asset number formats on the fixed assets system constants form.

cSymbolIdentifierSYMIDcharOPTOUTPUT

cSuppressErrorMessagesEV02charOPTINPUT

An option that specifies the type of processing for an event.

szErrorMessageIDDTAIcharOPTOUTPUT

A code that identifies and defines a unit of information. It is an alphanumeric code up to 8 characters long that does not allow blanks or 
special characters such as %, &, or +. You create new data items using system codes 55-59. You cannot change the alias.

Related Functions

None

Related Tables

F1201 Asset Master File
F1201ValidateAssetNumber

F1201ValidateAssetNumber

F1201 Validate Asset Number

Minor Business Rule

Object Name: X1202

Parent DLL: CAEC

Location: Client/Server

Language: C

Purpose:
Use this function to verify one of the three numbers; item, unit, or serial are valid in the Item Master Table (F1201).  If the number is not found in the 

F1201, this function will return an error.  On the other hand, if the number is valid, the system will retrieve the record and return the pointer to the 

record (if requested).  It will also determine which number is used, the item, unit, or serial and return that number.


This function accepts the following input parameters:


szAssetNumber_1= Asset Number

cSymbolIdentifier= Format of Asset Number Input

      ' '= Unknown Format

      '1'= Asset Item Number

      '2'= Unit Number

      '3'= Serial Number

idF1201RecordPointer= Pointer to the record Retrieved

It will return the following parameters:


szPrimaryAssetNumber_1= Primary Number or Asset Number w/ Symbol Identifier (if no 

   Primary exists)

cSymbolIdentifier= Format of Asset Number Output

   '1' = Asset Item Number

   '2' = Unit Number
   '3' = Serial Number

mnAssetNumber= Asset Item Number

szUnitNumber= Unit Number

szSerialNumber= Serial Number

cAssetItemNumberSymbol= Asset Number Symbol

cUnitNumberSymbol= Unit Number Symbol

cSerialNumberSymbol= Serial Number Symbol

szDescription= Description

szDescription02= Description 02

szDescription03= Description 03

idF1201RecordPointer= Pointer to the record Retrieved, if requested.
szErrorMessageID= Four digit number representing error encountered in function.


Note - Load the szSymbolIdentifier only if the format of the asset number passed is known.  If the number format is unknown, pass in a blank ' '.


Note - If this function is called and the F1201RecordPointer is not null, SymbolIdentifier is not blank, and the PrimaryAssetNumber passed in equal 

to the number identified by the symbol, this function will not validate the number again.


Note -  If requesting the F1201RecordPointer to be returned, the calling application/function must free the memory.


Data Structure

DX1202A - F1201 Validate Asset Number

Parameter NameData ItemData TypeReq/OptI/O/Both
szPrimaryAssetNumberASIIcharREQBOTH

An identification code that represents an asset. You enter the identification code in one of the following formats: 1 Asset number (a 
computer-assigned, 8-digit, numeric control number)   2 Unit number (a 12-character alphanumeric field)   3 Serial number (a 25-character alphanumeric 
field) Every asset has an asset number. You can use unit number and serial number to further identify assets. If this is a data entry field, the first 
character you enter indicates whether you are entering the primary (default) format that is defined for your system, or one of the other two 
formats. A special character (such as / or *) in the first position of this field indicates which asset number format you are using. You assign special 
characters to asset number formats on the fixed assets system constants form.

szDescriptionDL01charOPTOUTPUT

A user defined name or remark.

szDescription02DL02charOPTOUTPUT

Additional text that further describes or clarifies a field in the system.

szDescription03DL03charOPTOUTPUT

Additional text that further describes or clarifies an element.

cSymbolIdentifierSYMIDcharOPTNONE

idF1201RecordPointerGENLNGIDOPTNONE

General purpose ID variable.

mnAssetItemNumberNUMBMATH_NUMERICOPTOUTPUT

An 8-digit number that uniquely identifies an asset.

szUnitNumberAPIDcharOPTOUTPUT

A 12-character alphanumeric code used as an alternate identification number for an asset. This number is not required, nor does the 
system assign a number if you leave the field blank when you add an asset. If you use this number, it must be unique. For equipment, this is 
typically the serial number.

szSerialNumberASIDcharOPTOUTPUT

A 25-character alphanumeric number that you can use as an alternate asset identification number. You might use this number to track 
assets by the manufacturer's serial number. You are not required to use a serial number to identify an asset. Every serial number that you enter 
must be unique.

cReturnPointerEV01charOPTINPUT

An option that specifies the type of processing for an event.

cSuppressErrorMessagesEV02charOPTINPUT

An option that specifies the type of processing for an event.

szErrorMessageIDDTAIcharOPTOUTPUT

A code that identifies and defines a unit of information. It is an alphanumeric code up to 8 characters long that does not allow blanks or 
special characters such as %, &, or +. You create new data items using system codes 55-59. You cannot change the alias.

cAssetItemNumberSymbolSMIcharOPTOUTPUT

A value that identifies an asset. You can assign one of three different types of numbers:   o  Asset Number - an eight digit, system assigned 
number   o  Serial Number - a 25 digit model or serial number   o  Unit Number - a 12 digit, alphanumeric, user defined number  When you enter 
an asset number, you may use a prefix or symbol to designate the type of number you enter. For the type of asset number you use most 
often, you should use no prefix, so that you just need to enter the number. For the other two types of asset numbers, you should define a symbol 
for each, such as / or *, that you will enter as a prefix before the number to identify which type of number you are representing. For example, if 
you enter serial numbers most often, you should use no prefix for serial numbers. Then you might use / as a prefix for asset numbers and * 
as a prefix for unit numbers.  Note: You can leave only one type of asset number with no prefix. The other two must have a symbol so that all 
three numbers are unique. Verify that the symbols that you use are not significant for any other purposes of data entry, for example, a period or 
comma.

cUnitNumberSymbolSMUcharOPTOUTPUT

A value that identifies an asset. You can assign one of three different types of numbers:   o  Asset Number - an eight digit, system assigned 
number   o  Serial Number - a 25 digit model or serial number   o  Unit Number - a 12 digit, alphanumeric, user defined number  When you enter 
an asset number, you may use a prefix or symbol to designate the type of number you enter. For the type of asset number you use most 
often, you should use no prefix, so that you just need to enter the number. For the other two types of asset numbers, you should define a symbol 
for each, such as / or *, that you will enter as a prefix before the number to identify which type of number you are representing. For example, if 
you enter serial numbers most often, you should use no prefix for serial numbers. Then you might use / as a prefix for asset numbers and * 
as a prefix for unit numbers.  Note: You can leave only one type of asset number with no prefix. The other two must have a symbol so that all 
three numbers are unique. Verify that the symbols that you use are not significant for any other purposes of data entry, for example, a period or 
comma.

cSerialNumberSymbolSMScharOPTOUTPUT

A value that identifies an asset. You can assign one of three different types of numbers:   o  Asset Number - an eight digit, system assigned 
number   o  Serial Number - a 25 digit model or serial number   o  Unit Number - a 12 digit, alphanumeric, user defined number  When you enter 
an asset number, you may use a prefix or symbol to designate the type of number you enter. For the type of asset number you use most 
often, you should use no prefix, so that you just need to enter the number. For the other two types of asset numbers, you should define a symbol 
for each, such as / or *, that you will enter as a prefix before the number to identify which type of number you are representing. For example, if 
you enter serial numbers most often, you should use no prefix for serial numbers. Then you might use / as a prefix for asset numbers and * 
as a prefix for unit numbers.  Note: You can leave only one type of asset number with no prefix. The other two must have a symbol so that all 
three numbers are unique. Verify that the symbols that you use are not significant for any other purposes of data entry, for example, a period or 
comma.

cF0911ReturnFormatEV03charOPTINPUT

A radio button that specifies the level at which trace/track result is to be displayed.  Select the Detail to display all transactions except IB, IX, 
and IZ types.  Or, select Derivative Lots Only to display only those transactions that may have created new derivative lot. 

Related Functions

None

Related Tables

F1201 Asset Master File