F1755CheckRequiredFields

Check Required Fields

Minor Business Rule

Object Name: B1702850

Parent DLL: CCRIN

Location: Client/Server

Language: C

Functional Description
This business function will check the F1759 for generic or specific queue for required fields for a maintenance request 

record.  


Purpose

The purpose of this function is to simplify code by reusing code. 


Setup Notes and Prerequisites


Special Logic

Error Return:  Use this parameter to determine which call map the error will be returned through.  For DD items on an 

interactive application, this will return the error to the available field to a user.  Typically, these are either address book, Time, 

Equipment, Item related fields.


Entitlement Check:  Use this parameter to determine which call map (Site or Customer) the error will be returned to.  This 

is related specifically to the W17501A that displays Customer and Site differently depending on the F17001 Constants.


Technical Specification


Determine F1759 Generic or Specific Queue and Set Selection Criteria for the F1759


Determine Error Map to use (For use with Interactive Applications vs. BSFN/UBE)


IF FIELD IS BLANK, NULL

Check by DD if this field is required (Queue, Document Type, Call type, Call Status, Error Map, Data item-hardcoded)


Repeat for all Data items.



Data Structure

D1702850 - F1755 Check Required Fields

Parameter NameData ItemData TypeReq/OptI/O/Both
mnCustomerNumberANCMATH_NUMERICOPTNONE

Client number in SAR records which corresponds to Address Book record.

szCallerContactNameWHO2charOPTNONE

The name of the caller, customer, or other contact.

szCallerPhonePrefixAR2charOPTNONE

The prefix for telephone number 2. The default format for the Phone Prefix data dictionary item is set to the United States prefix (area code). 
This format is three characters enclosed in parentheses. For example, (303). If you require an alternate format to accommodate a non-United 
States prefix, you must change the data display rules in the data dictionary.

szCallerPhoneNumberCPHC1charOPTNONE

Phone number of Customer Issue additional contact.

cRequestType1CT01charOPTNONE

A code that specifies the type of case.

szIssuePriorityPRIORcharOPTNONE

The values that indicate the severity of the customer issue.

cSecondRequestSCALLcharOPTNONE

A code that specifies multiple callbacks for a maintenance request. Enter a value from UDC 17/CB.

szRequestEMailAddress1CEML1charOPTNONE

The email address on the case.

szLanguagePreferenceLNGPcharOPTNONE

A user defined code (01/LP) that specifies the language to use on forms and printed reports. Before you specify a language, a code for that 
language must exist at either the system level or in your user preferences.

szGeographicRegionREGIONcharOPTNONE

The geographic region of the customer.

mnAssetItemNumberNUMBMATH_NUMERICOPTNONE

An 8-digit number that uniquely identifies an asset.

mnIdentifierShortItemITMMATH_NUMERICOPTNONE

An inventory item number. The system provides three separate item numbers plus an extensive cross-reference capability to other item 
numbers (see data item XRT) to accommodate substitute item numbers, replacements, bar codes, customer numbers, supplier numbers, and 
so forth. The item numbers are as follows:   o Item Number (short) - An eight-digit, computer-assigned item number     o 2nd Item Number - The 
25-digit, free-form, user defined alphanumeric item number     o 3rd Item Number - Another 25-digit, free-form, user defined alphanumeric item 
number

szBranchPlantMMCUcharOPTNONE

A code that represents a high-level business unit. Use this code to refer to a branch or plant that might have departments or jobs, which 
represent lower-level business units, subordinate to it. For example:     o Branch/Plant (MMCU)     o Dept A (MCU)     o Dept B (MCU)     o Job 123 
(MCU) Business unit security is based on the higher-level business unit.

szLotSerialLOTNcharOPTNONE

A number that identifies a lot or a serial number. A lot is a group of items with similar characteristics.

szProductModelPRODMcharOPTNONE

A code that classifies an inventory item into a model for customer service. Some examples include: Laser Printer, Inkjet or Fax.

szProductFamilyPRODFcharOPTNONE

A code that classifies an inventory item into a group for customer service. Some examples include: Laser Printer, Inkjet, or Fax.

szProductComponentPRODCcharOPTNONE

The components that make an equipment number or components associated with a customer site.

szEnvironmentENVcharOPTNONE

The operating environment of the user. Some examples include Windows 95, Windows NT, UNIX or AS/400.

mnAssigneeAN8MATH_NUMERICOPTNONE

A number that identifies an entry in the Address Book system, such as employee, applicant, participant, customer, supplier, tenant, or 
location.

szACDNumberPH1charOPTNONE

A number without the prefix or special characters, such as hyphens or periods, that makes up the telephone number for an entity. You can 
use any applicable telephone number format for a country. This field is used in conjunction with the Prefix field (AR1), where you enter the first 
segment of the telephone number, which is called the area code in the United States. When you search for an address using a phone 
number, you must enter the number exactly as it is set up in the Address Book system, including any special characters.

jdDateExecutionDXJDEDATEOPTNONE

The date a job is executed

mnTimeReturnedINRTMATH_NUMERICOPTNONE

The time, noted in hours, minutes, and seconds, when the call was initially returned.

jdOnSiteDateONSDTJDEDATEOPTNONE

The date the service provider arrived at the customer site.

mnOnSiteHhMmSsONSTMMATH_NUMERICOPTNONE

The time that the service provider arrived at the customer site.

jdDateEndingENDJDEDATEOPTNONE

The date when an asset was removed or returned from a particular location.

mnEndingHhMmSsPETMMATH_NUMERICOPTNONE

A field that is used to enter the ending time of the operation sequence for the work center operation on the routing.

szTimeZoneTIMEZONEScharOPTNONE

Choose the time zone for which you want to view the date and time.

jdDateCommitmentCDATEJDEDATEOPTNONE

The commitment date that the system calculates for returning the maintenance request or work order.

mnCommitTimeCTIMEMATH_NUMERICOPTNONE

The duration specified in minutes, that were committed to the customer. For example:  A commitment to call back in 3 hours would have a 
commit time entry of 180 (minutes).

mnResponseTimeRSTMMATH_NUMERICOPTNONE

The guaranteed time during which service will be completed, as provided by a service contract, from the time that a provider logs a 
maintenance request or work order. This unit of time relates to the service type in the Service Contract Services table (F1725). Enter the response 
time in hours.

mnCommitDurationCOMDMATH_NUMERICOPTNONE

The length of time (stored in minutes as an integer) that was committed to the customer.  This length of time is used to set due dates/times 
and escalation dates/times.

mnParentRequestNumberPARCALLMATH_NUMERICOPTNONE

The number of the parent case for a case.

cRequestType2CT02charOPTNONE

A code that specifies the source of a case. Valid values are: Blank  No source W Warranty  R Response line

szDescriptionDESCcharOPTNONE

A description, remark, name, or address.

mnSiteNumberLANOMATH_NUMERICOPTNONE

The address book number for the lessor, renter, or lending institution.

szServiceWarrantyClaimCSCLcharOPTNONE

The number linking a claim that an end user of a product submits. Claim numbers are often found on pre-printed forms.

mnDocumentNumberDOCMATH_NUMERICOPTNONE

A number that identifies the original document, such as a voucher, invoice, or journal entry. On entry forms, you can assign the document 
number or let the system assign it using the Next Numbers program (P0002). Matching document numbers (DOCM) identify related documents 
in the Accounts Receivable and Accounts Payable systems. Examples of original and matching documents are: Accounts Payable     o 
Original document - voucher     o Matching document - payment  Accounts Receivable     o Original document - invoice     o Matching document - 
receipt  Note: In the Accounts Receivable system, the following transactions simultaneously generate original and matching documents: 
deductions, unapplied receipts, chargebacks, and drafts.

jdDateEffectiveDEFJDEDATEOPTNONE

The date on which this transaction takes effect. The effective date is used generically. It can be the date of the next raise, a lease effective 
date, a price or cost effective date, a currency effective date, a tax rate effective date, a change in well status, or any other date that is 
appropriate.

szTicklerDescriptionDL01charOPTNONE

A user defined name or remark.

szEquipmentCategoryCode01ZE01charOPTNONE

A user defined reporting code for equipment.

szEquipmentCategoryCode02ZE02charOPTNONE

A user defined reporting code for equipment.

szEquipmentCategoryCode03ZE03charOPTNONE

A user defined reporting code for equipment.

szEquipmentCategoryCode04ZE04charOPTNONE

A user defined reporting code for equipment.

szEquipmentCategoryCode05ZE05charOPTNONE

A user defined reporting code for equipment.

szEquipmentCategoryCode06ZE06charOPTNONE

A user defined reporting code for equipment. Enter a value from UDC 17/B6.

szEquipmentCategoryCode07ZE07charOPTNONE

A user defined reporting code for equipment.

szEquipmentCategoryCode08ZE08charOPTNONE

A user defined reporting code for equipment.

szEquipmentCategoryCode09ZE09charOPTNONE

A user defined reporting code for equipment.

szEquipmentCategoryCode10ZE10charOPTNONE

A user defined reporting code for equipment.

szCategoryCode01JC01charOPTNONE

User defined code associated with the team a customer issue is assigned to.

szCategoryCode02JC02charOPTNONE

User defined reporting code for assigning customer issues.

szCategoryCode03JC03charOPTNONE

User defined reporting code used when assigning customer issues.

szCategoryCode04JC04charOPTNONE

User defined reporting code used when assigning customer issues.

szCategoryCode05JC05charOPTNONE

User defined category code used when assigning customer issues.

szCategoryCode06JC06charOPTNONE

User defined category code used when assigning customer issues.

szCategoryCode07JC07charOPTNONE

User defined category codes used when assigning customer issues.

szCategoryCode08JC08charOPTNONE

User defined reporting code used when assigning customer issues.

szCategoryCode09JC09charOPTNONE

User defined reporting code used when assigning customer issues.

szCategoryCode10JC10charOPTNONE

User defined reporting code used when assigning customer issues.

szRequestReasonCALLRNcharOPTNONE

The underlying reason for the customer issue.

mnDocumentOrderAltDOCZMATH_NUMERICOPTNONE

The original document number.  This can be a voucher, an invoice, unapplied cash, a journal entry number, etc.  Matching document 
numbers are also used to identify related documents in the Accounts Receivable and Accounts Payable systems.  See matching document 
(DOCM).  This document number (DOCO) is always the original document number, and the matching document number (DOCM) is the check, 
adjustment, or credit to be applied against the original document. For example: A/P Automated/Manual Payment: Original (DOCO) - Voucher; 
Matching Document (DOCM) - Payment  A/R Original Invoice: Original (DOCO) - Invoice  Receipt Application: Original (DOCO) - Invoice; Matching 
Document (DOCM) - Receipt Credit Memo/Adjustment: Original (DOCO) - Invoice; Matching Document (DOCM) -Credit Memo  Unapplied 
Case: Original (DOCO) - Receipt

szRelatedOrderTypeRCTOcharOPTNONE

A user defined code (system 00, type DT) that indicates the document type of the secondary or related order. For example, a purchase 
order might be document type OP and might have been created to fill a related work order with document type WO.

szCompanyKeyRelatedRKCOcharOPTNONE

The key company that is associated with the document number of the related order.

mnLineNumberLNIDMATH_NUMERICOPTNONE

A number that identifies multiple occurrences, such as line numbers on a purchase order or other document. Generally, the system assigns 
this number,but in some cases you can override it.

szContractChangeNumCOCHcharOPTNONE

The change number of the contract. The change order number of the base contract is always initialized to 000. Each time you enter a 
change order for a contract, the system automatically increases the change order number by one. For example, the base contract is the change 
order number 000, the first change order is 001, the second is 002, and so on.

szEntitlementCheckENTCKcharOPTNONE

A user defined code (17/ER) to indicate the results of an entitlement check. Valid values are:    0   Not entitled    1   Transaction entitled    2   
Contract found, but no existing service type    3   Contract found, but no day and date assigned    4   Covered under default warranty

szCoverageGroupCOVGRcharOPTNONE

A user defined code that specifies the Coverage Group. The Coverage Group consists of unlimited cost codes and the percentage 
covered for each cost code.

szBusinessUnitMCUZcharOPTNONE

Identifies a separate entity within a business for which you wish to track costs, for example, a warehouse location, job, project, work center, 
or branch/plant. The business unit field is alphanumeric. You can assign a business unit to a voucher, invoice, fixed asset, and so forth, for 
responsibility reporting.  The system provides reports of open A/P and A/R by business unit, for example, to track equipment by responsible 
department. Business Unit Security can prevent you from inquiring on business units for which you have no authority.

szCompanyCOcharOPTNONE

A code that identifies a specific organization, fund, or other reporting entity. The company code must already exist in the Company 
Constants table (F0010) and must identify a reporting entity that has a complete balance sheet. At this level, you can have intercompany 
transactions. Note: You can use company 00000 for default values such as dates and automatic accounting instructions. You cannot use company 00000 
for transaction entries.

szGLCategoryCoveredGLCCVcharOPTNONE

A user defined code (41/9) that identifies the G/L Offset to use when the system is searching for the account to which it will post the covered 
portion (by warranty or contract) of the accounting transaction. If you do not want to specify a G/L Offset, you can enter four asterisks in this 
field or you can leave this field blank. If you leave this field blank, the system uses the G/L Offset from Inventory.

szGLCategoryNonCoveredGLCNCcharOPTNONE

A user defined code (41/9) that identifies the G/L Offset to use when the system is searching for the account to which it will post the 
non-covered portion of the accounting transaction. If you do not want to specify a G/L Offset, you can enter four asterisks in this field or you can leave 
this field blank. If you leave the field blank, the system uses the G/L Offset from Inventory.

szServicePackageSERPcharOPTNONE

A combination of service order type and coverage type used to define service support to which the customer is contractually entitled. A 
service package also contains response time and coverage group.

mnRequestQueueICALLQMATH_NUMERICOPTNONE

The address number of the case provider group. To resolve customer problems, the system or a person can assign case to provider 
groups. A provider group might be that of a specific service person, or it might be a group that is used to monitor and assign requests to the 
provider groups of service personnel.

szDocumentTypeIDCTOcharOPTNONE

A user defined code (00/DT) that identifies the type of document. This code also indicates the origin of the transaction. J.D. Edwards has 
reserved document type codes for vouchers, invoices, receipts, and time sheets, which create automatic offset entries during the post 
program. (These entries are not self-balancing when you originally enter them.) The following document types are defined by J.D. Edwards and 
should not be changed: P Accounts Payable documents   R Accounts Receivable documents   T Payroll documents   I Inventory documents  
O Purchase Order Processing documents   J General Accounting/Joint Interest Billing documents   S Sales Order Processing documents

cRequestTypICT01charOPTNONE

A code that specifies the type of case.

szStatusCodeICLSTcharOPTNONE

A code that specifies the status of a case.

cModeProcessingMODEcharOPTNONE

Not currently used

cGenericSpcecificEV01charOPTNONE

Not currently used

cSuppressErrorsEV02charOPTNONE

Valid Values:
1 - Suppress Errors

cErrorCodeERRCcharOPTNONE

Output:  If the error flag is '1', there was at least 1 required fields error.

szDataItemDTAIcharOPTNONE

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.

cErrorReturnEV03charOPTNONE

Valid Values:
0 - Return Errors to default Math_Numeric parameters

1 - Return Errors to String Parameters, for use with Interactive applications

cEntitleByENTBYcharOPTNONE

F17001.CSENTBY

szLongCustomerALKYcharOPTNONE

A user-defined name or number that identifies an address book record.  You can use this number to locate and enter information about the 
address book record. If you enter a value other than the address book number (AN8), such as the long address or tax ID, you must precede 
it with the special character that is defined in the Address Book constants. When the system locates the record, it returns the address book 
number to the field. For example, if address book number 4100 (Total Solutions) has a long address TOTAL and an * distinguishes it from 
other entries (as defined in the Address Book constants), you could type *TOTAL into the field, and the system would return 4100.

szLongSiteALKYcharOPTNONE

A user-defined name or number that identifies an address book record.  You can use this number to locate and enter information about the 
address book record. If you enter a value other than the address book number (AN8), such as the long address or tax ID, you must precede 
it with the special character that is defined in the Address Book constants. When the system locates the record, it returns the address book 
number to the field. For example, if address book number 4100 (Total Solutions) has a long address TOTAL and an * distinguishes it from 
other entries (as defined in the Address Book constants), you could type *TOTAL into the field, and the system would return 4100.

szLongAssigneeALKYcharOPTNONE

A user-defined name or number that identifies an address book record.  You can use this number to locate and enter information about the 
address book record. If you enter a value other than the address book number (AN8), such as the long address or tax ID, you must precede 
it with the special character that is defined in the Address Book constants. When the system locates the record, it returns the address book 
number to the field. For example, if address book number 4100 (Total Solutions) has a long address TOTAL and an * distinguishes it from 
other entries (as defined in the Address Book constants), you could type *TOTAL into the field, and the system would return 4100.

szLongCallerALKYcharOPTNONE

A user-defined name or number that identifies an address book record.  You can use this number to locate and enter information about the 
address book record. If you enter a value other than the address book number (AN8), such as the long address or tax ID, you must precede 
it with the special character that is defined in the Address Book constants. When the system locates the record, it returns the address book 
number to the field. For example, if address book number 4100 (Total Solutions) has a long address TOTAL and an * distinguishes it from 
other entries (as defined in the Address Book constants), you could type *TOTAL into the field, and the system would return 4100.

szAssetNumberInputASIIcharOPTNONE

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.

szItemNoUnknownFormatUITMcharOPTNONE

A number that the system assigns to an item. It can be in short, long, or third item number format.

szFormattedReturnTimeFTIMEcharOPTNONE

A time value displayed in the format of hours, minutes, and seconds (for example, 08:30:15).

szFormattedOnSiteTimeFTIMEcharOPTNONE

A time value displayed in the format of hours, minutes, and seconds (for example, 08:30:15).

szFormattedEndTimeFTIMEcharOPTNONE

A time value displayed in the format of hours, minutes, and seconds (for example, 08:30:15).

szFormattedCommitTimeFTIMEcharOPTNONE

A time value displayed in the format of hours, minutes, and seconds (for example, 08:30:15).

szFormattedComDurationFTIMEcharOPTNONE

A time value displayed in the format of hours, minutes, and seconds (for example, 08:30:15).

mnCallerAddressNumberAN8CT1MATH_NUMERICOPTNONE

The address number of the person reporting a customer issue.

szFileNameFILEcharOPTNONE

Table Name:  F1755

Related Functions

None

Related Tables

None
F1757CheckRequiredFields

F1757CheckRequiredFields

Check Required Fields

Minor Business Rule

Object Name: B1702850

Parent DLL: CCRIN

Location: Client/Server

Language: C

Functional Description
This business function will check the F1759 for generic or specific queue for required fields for a Task  record.  


Purpose

The purpose of this function is to simplify code in the P17504 by reusing code and reuse internal functions created for 

checking any required field. 


Setup Notes and Prerequisites


Special Logic

Error Return:  Use this parameter to determine which call map the error will be returned through.  For DD items on an 

interactive application, this will return the error to the available field to a user.  Typically, these are either address book, Time, 

Equipment, Item related fields.




Technical Specification

Determine F1759 Generic or Specific Queue and Set Selection Criteria for the F1759


Determine Error Map to use (For use with Interactive Applications vs. BSFN/UBE)


IF FIELD IS BLANK, NULL

Check by DD if this field is required (Queue, Document Type, Call type, Call Status, Error Map, Data item-hardcoded)


Repeat for all Data items.




Data Structure

D1702850A - F1757 Check Required Fields

Parameter NameData ItemData TypeReq/OptI/O/Both
szNameAlphaALPHcharOPTNONE

The text that names or describes an address. This 40-character alphabetic field appears on a number of forms and reports. You can enter 
dashes, commas, and other special characters, but the system cannot search on them when you use this field to search for a name.

szPhoneAreaCodeAR1charOPTNONE

The first segment of a telephone number. In the United States, the prefix is the three-digit area code.

szPhoneNumberCPHcharOPTNONE

The phone number of the individual who is sending the message.

szRemark1REM1charOPTNONE

A 40-character field that you can use to enter text.

mnAssigneeAN8MATH_NUMERICOPTNONE

A number that identifies an entry in the Address Book system, such as employee, applicant, participant, customer, supplier, tenant, or 
location.

szIssuePriorityPRIORcharOPTNONE

The values that indicate the severity of the customer issue.

jdDateEndingENDJDEDATEOPTNONE

The date when an asset was removed or returned from a particular location.

szOrderTypeDCTOcharOPTNONE

A user defined code (00/DT) that identifies the type of document. This code also indicates the origin of the transaction. J.D. Edwards has 
reserved document type codes for vouchers, invoices, receipts, and time sheets, which create automatic offset entries during the post 
program. (These entries are not self-balancing when you originally enter them.) The following document types are defined by J.D. Edwards and 
should not be changed: P Accounts Payable documents   R Accounts Receivable documents   T Payroll documents   I Inventory documents  
O Purchase Order Processing documents   J General Accounting/Joint Interest Billing documents   S Sales Order Processing documents

mnRequestQueueCALLQMATH_NUMERICOPTNONE

The address number of the case provider group. To resolve customer problems, the system or a person can assign case to provider 
groups. A provider group might be that of a specific service person, or it might be a group that is used to monitor and assign requests to the 
provider groups of service personnel.

cRequestTypeCT01charOPTNONE

A code that specifies the type of case.

szStatusCLSTcharOPTNONE

A code that specifies the status of a case.

cErrorReturnEV01charOPTNONE

Use this parameter if the field you are checking contains a math_numeric to 
string routine with hidden fields.  This will allow the error to be returned to the 

field the user has control of.

Valid Values:

0/blank - return error to default Math_Numeric parameters

1-Return errors to String parameters, for use with interactive applications

cErrorCodeERRCcharOPTNONE

This field is used to identify error codes retrieved from the function.
Valid Error Codes are:

0 - No required fields error exist

'1'-  At least 1 required fields error

szDataItemDTAIcharOPTNONE

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.

cSuppressErrorsEV01charOPTNONE

Valid Values:
1-Suppress Errors

szFileNameFILEcharOPTNONE

File name of the table to be checked.  F1757 should be used in this parameter.

szLongAssigneeALKYcharOPTNONE

A user-defined name or number that identifies an address book record.  You can use this number to locate and enter information about the 
address book record. If you enter a value other than the address book number (AN8), such as the long address or tax ID, you must precede 
it with the special character that is defined in the Address Book constants. When the system locates the record, it returns the address book 
number to the field. For example, if address book number 4100 (Total Solutions) has a long address TOTAL and an * distinguishes it from 
other entries (as defined in the Address Book constants), you could type *TOTAL into the field, and the system would return 4100.

cGenericSpecificEV01charOPTNONE

Future Use

cModeProcessingMODEcharOPTNONE

Future Use

Related Functions

None

Related Tables

None