update_pr_header
update_pr_header_list
Public Function update_pr_header(ByVal hdr_num As String, _
ByVal first_name As String, ByVal last_name As String, _
ByVal phone_num As String, ByVal ship_site_id As String, _
ByVal bill_site_id As String, ByVal case_id As String, _
ByVal pay_method As String, ByVal pay_terms As String, _
ByVal priority_str As String, ByVal note_str As String, _
ByVal int_fld1 As String, ByVal int_val1 As Long, _
ByVal int_fld2 As String, ByVal int_val2 As Long, _
ByVal str_fld1 As String, ByVal str_val1 As String, _
ByVal str_fld2 As String, ByVal str_val2 As String, _
ByVal date_fld1 As String, ByVal date_val1 As String) _
As Integer
Public Function update_pr_header_list(ByVal hdr_num As String, _
ByVal first_name As String, ByVal last_name As String, _
ByVal phone_num As String, ByVal ship_site_id As String, _
ByVal bill_site_id As String, ByVal case_id As String, _
ByVal pay_method As String, ByVal pay_terms As String, _
ByVal priority_str As String, ByVal note_str As String, _
Optional fld_list As Variant, Optional type_list As Variant, _
Optional val_list As Variant) As Integer
Description
These APIs allow for the updating of part request headers. You must supply the header number, and any other attributes you wish to update. If an attribute is left blank, the API will not update the value. Two of the attributes allow you to clear the previous result. To clear the related case number, or to clear the header notes, put the string "CLEAR" for the argument. If you leave an argument blank, the value in the header record is not changed. If you want to change the contact for the part request, you must supply first name, last name, and phone number for the contact.
Parameters
| Parameter Name | Required? | Description |
|---|---|---|
| hdr_num | Yes | The part request to update |
| first_name | No | First name of contact for part request |
| last_name | No | Last name of contact for part request |
| phone_num | No | Phone number of contact for part request |
| ship_site_id | No | Site ID of shipping site for part request |
| bill_site_id | No | Site ID of billing site for part request |
| case_id | No | ID number of case related to the part request. To clear the case (have no case related to the part request), place "CLEAR" in this argument |
| pay_method | No | Payment method for the part request |
| pay_terms | No | Payment terms for the part request |
| priority_str | No | Priority of the part request |
| notes_str | No | Additional information about the part request. To clear the text, put the string "CLEAR" in this argument |
| int_fld1, int_fld2 str_fld1, str_fld2 date_fld1 |
No | Names of additional fields to write |
| int_val1, int_val2 str_val1, str_val2 date_val1 |
No | Values for the additional fields. These values are only used if the corresponding field name field is filled with a valid field name |
Returns
| Value | Meaning |
|---|---|
| 0 | No Errors |
| -1 | Cannot find the specified part request header |
| -2 | The specified contact could not be found |
| -3 | Cannot find the specified shipping site |
| -4 | Cannot find the specified billing site |
| -5 | The specified case ID is not found |
| -6 | The specified payment method is not found |
| -7 | The specified payment terms is not found |
| -8 | The specified priority is not found |
Examples
Update part request header '1'. Change the contact to Sara Grinch, change the billing site ID to 43, the case ID to 14, the payment terms and method, and one extra field.
Visual Basic:
Dim ret_int As Integer
ret_int = fccl.update_pr_header("1", "Sara", "Grinch", "555-1212", "", _
"43", "14", "Cash", "Net 10", "", "", "", 0, _
"",0, "x_extra_field", "a_value", "", "", "", _
"")
JavaScript:
var ret_int = fccl.update_pr_header("1", "Sara", "Grinch", "555-1212", "",
"43", "14", "Cash", "Net 10", "", "", "", 0,
"",0, "x_extra_field", "a_value", "", "", "",
"");
Update part request header '33'. Change the shipping site to '55', change the priority, and clear the notes for the header.
Visual Basic:
Dim ret_int As Integer
ret_int = fccl.update_pr_header("33", "", "", "", "55", "", _
"", "", "", "Priority 1", "CLEAR", "", _
0, "", 0, "", "", "", "", "", "")
JavaScript:
var ret_int = fccl.update_pr_header("33", "", "", "", "55", "",
"", "", "", "Priority 1", "CLEAR", "",
0, "", 0, "", "", "", "", "", "");