ProcFormNoteAdd(
    int    processID,
    string processName,
    object Form 
)

Add Notes, including Notes For Staff, to a Form.

Request

Identifying the Form:
You can identify the Form to Edit in three different ways:

  • Form ID provide the Form ID inside the Form object.
  • Process Name + Form Number provide the process name and identify the form number inside the Form object.
  • Process ID + Form Number provide the process id and identify the form number inside the Form object.

Request Data:

  • (int) ProcessID or (string) ProcessName (optional) identify the process by Name or ID
    If both are provided the Name will be used.
  • (object) Form(required) – data that you want populated:
    • (string) Number (optional, required if ProcessID or ProcessName are provided) – unique number for this form.
      Used to identify the correct Form to Edit.
    • (string) FormID (optional, required if ProcessID or ProcessName are not provided) – unique ID number for this form.
      Used to identify the correct Form to Edit.
      If provided, then ProcessID, ProcessName and Form.Number will be ignored.
    • (string) Note (optional) note to add.
    • (string) NoteForStaff (optional) note for staff to add.
    • (string) NoteBy (optional) username of the user to get authorship of the note (by default, the note author is the user associated to the API key).

Request Body: these show the three different ways the Form can be identified.

Form ID

{
  "Key": <string>,
  "Form": {
    "FormID": <int>,
    "Note": <string>,
    "NoteForStaff": <string>,
    "NoteBy": <string>
  }
}

Process Name + Form Number

{
  "Key": <string>,
  "Process": <string>,
  "Form": {
    "Number": <string>,
    "Note": <string>,
    "NoteForStaff": <string>,
    "NoteBy": <string>
  }
}

Process ID + Form Number

{
  "Key": <string>,
  "ProcessID": <int>,
  "Form": {
    "Note": <string>,
    "NoteForStaff": <string>,
    "Number": <string>,
    "NoteBy": <string>
  }
}

Response

On success, the response will contain the complete Form, see the JSON Formatting for Forms.

Errors

  • “Process not found” – If the process Name or ID is not found
  • “Form not found” – If the form could not be identified through Process + Form.Number or FormID