Prompt User for Info Functions

Function

SelectInsCoID

Location in PracticeScript

Functions->Prompt user for info

Purpose

To prompt the user to select a specific Insurance Company from the Insurance Company pick list. Allows certain PracticeWorks features (such as Contact Expert or Analysis Expert) to be designed so a single expert can be used generically. For example, A User Defined Roster that is a list of all patients who are connected to a particular company. SelectInsCoID() can be used to select WHICH company to use for the roster.

Format

SelectInsCoID(Prompt)
Prompt is a character string that is used for the title of the Insurance Company pick list when it is presented to the user. A given Prompt is presented to the user only once during analysis. Thus, multiple uses of SelectInsCoID() can be used to refer to the same company the user selected.

Evaluates to

The internal Insurance Company ID of the company that the user selected. The first time SelectInsCoID() is referenced with a given prompt, the Insurance Company pick list is displayed. The internal company ID of the company selected is returned for that value. Subsequent references to SelectInsCoID() with the same prompt return the same internal company ID without asking the user.

Example

PrimInsCo.InsCoID = SelectInsCoID("Select the Insurance Company to analyze")
Returns TRUE (1) if the patient is insured by the company that the user selected when presented with an Insurance Company pick list titled "Select the Insurance Company to analyze".

Function

SelectInsPlanID

Location in PracticeScript

Functions->Prompt user for info

Purpose

To prompt the user to select a specific Insurance Employer/Plan from the plan pick list. Allows certain PracticeWorks features (such as Contact Expert or Analysis Expert) to be designed so a single expert can be used generically. For example, A User Defined Roster that is a list of all patients who are connected to a particular Employer/Plan. SelectInsPlanID() can be used to select WHICH Employer/Plan to use for the roster.

Format

SelectInsPlanID(Prompt)
Prompt is a character string that is used for the title of the Employer/Plan pick list when it is presented to the user. A given Prompt is presented to the user only once during analysis. Thus, multiple uses of SelectInsPlanID() can be used to refer to the same Employer/Plan the user selected.

Evaluates to

The internal Employer/Plan ID of the plan that the user selected. The first time SelectInsPlanID() is referenced with a given prompt, the Employer/Plan pick list is displayed. The internal plan ID of the employer/plan selected is returned for that value. Subsequent references to SelectInsPlanID() with the same prompt return the same internal plan ID without asking the user.

Example

PrimInsPlan.InsPlanID = SelectInsPlanID("Select the Employer/Plan to analyze")
Returns TRUE (1) if the patient is insured by the Employer/Plan that the user selected when presented with an Employer/Plan pick list titled "Select the Employer/Plan to analyze."

Function

SelectPersonID

Location in PracticeScript

Functions->Prompt user for info

Purpose

To prompt the user to select a specific person from the Person Pick List to analyze. Allows certain PracticeWorks features (such as Contact Expert or Analysis Expert) to be designed so a single expert can be used generically. For example, A User Defined Roster that is a list of all patients referred by a particular referral source. SelectPersonID() can be used to select WHICH referral source to use for the roster.

Format

SelectPersonID(Prompt)
Prompt is a character string that is used for the title of the Person Pick List when it is presented to the user. A given Prompt is presented to the user only once during analysis. Thus, multiple uses of SelectPersonID() can be used to refer to the same person the user selected.

Evaluates to

The internal person ID of the person that the user selected. The first time SelectPersonID() is referenced with a given prompt, the Person Pick List is displayed. The ID of the person selected is returned for that value. Subsequent references to SelectPersonID() with the same prompt return the same internal person ID without asking the user.

Example

Patient.RefPersonID = SelectPersonID("Select the referral source to analyze")
Returns TRUE (1) if the patient was referred by the person that the user selected when presented with a list titled "Select the referral source to analyze".

Function

SelectStaffID

Location in PracticeScript

Functions->Prompt user for info

Purpose

To prompt the user to select a specific employee (staff member) from the Employee pick list. Enables certain PracticeWorks features (such as Contact Expert or Analysis Expert) to be designed so a single expert can be used generically. For example, A User Defined Roster that is a list of all patients who are owned by a particular staff member. SelectStaffID() can be used to select WHICH employee to use for the roster.

Format

SelectStaffID(Prompt)
Prompt is a character string that is used for the title of the Employee pick list when it is presented to the user. A given Prompt is presented to the user only once during analysis. Thus, multiple uses of SelectStaffID() can be used to refer to the same staff member the user selected.

Evaluates to

The ID of the staff member that the user selected. The first time SelectStaffID() is referenced with a given prompt, the Employee pick list is displayed. The ID of the staff member selected is returned for that value. Subsequent references to SelectStaffID() with the same prompt return the same ID without asking the user.

Example

Patient.ProvEmpID = SelectStaffID("Select the staff member to analyze")
Returns TRUE (1) if the patient's production owner is the staff member that the user selected when presented with an Employee pick list titled "Select the staff member to analyze".