PROMPT - Revision history

Jim: clarity

2009-09-11T19:15:01Z

clarity

← Older revision		Revision as of 19:15, 11 September 2009
Line 57:		Line 57:
	P00%5%<br>		P00%5%<br>

-	As the report spec is interpreted, string fields are parsed for a %..% pair. If found, the #CPROMPT file will be read to see if there is a replacement defined for the %..% prompt name. If not found, the string will be used as is, thus allowing for data to actually contain % signs.	+	As the report spec is interpreted, string fields are parsed for a %..% pair. If found, the #CPROMPT file will be read to see if there is a replacement defined for the %..% prompt name. If not found, the string will be used as is, thus allowing for data to actually contain % signs.
		+
	The silent ENTER option provides a way to run a program without operator interface to provide the string substitution:		The silent ENTER option provides a way to run a program without operator interface to provide the string substitution:

	PROMPT %PromptName% ENTER program,dir,"message"		PROMPT %PromptName% ENTER program,dir,"message"

-	In this case a field for this substitution will not be included in the dynamically created dialog. The program will be ENTERed and its value saved for substitution later in the report. This can be useful for getting operator or other context-sensitive information that your application knows without having to ask the operator. Unlike ENTERed programs called from the dialog, silent ENTERed programs do not have a length specified for the return value. The value is returned in # buffer. If trailing blanks are an important part of the value, the value must be enclosed in quotes. ~~The~~ length of the replacement string will be the length of the value within the quotes. If not enclosed in quotes, the value will be stripped of trailing blanks and the resultant length of the string will be used for the replacement field length.	+	In this case a field for this substitution will not be included in the dynamically created dialog. The program will be ENTERed and its value saved for substitution later in the report. This can be useful for getting operator or other context-sensitive information that your application knows without having to ask the operator. Unlike ENTERed programs called from the dialog, silent ENTERed programs do not have a length specified for the return value. The value is returned in # buffer. If trailing blanks are an important part of the value, the value must be enclosed in quotes. In that case, the length of the replacement string will be the length of the value within the quotes. If not enclosed in quotes, the value will be stripped of trailing blanks and the resultant length of the string will be used for the replacement field length.

Barb at 17:12, 8 September 2009

2009-09-08T17:12:24Z

← Older revision		Revision as of 17:12, 8 September 2009
Line 12:		Line 12:
	One PROMPT statement is used for each value to be replaced. It is best to group all PROMPT statements for the report together. At runtime the Reporter collects the PROMPT statements and creates a dialog to prompt the operator for each of the replacement strings in the group. When a default value is specifed in the PROMPT the dialog is populated with that value.		One PROMPT statement is used for each value to be replaced. It is best to group all PROMPT statements for the report together. At runtime the Reporter collects the PROMPT statements and creates a dialog to prompt the operator for each of the replacement strings in the group. When a default value is specifed in the PROMPT the dialog is populated with that value.

-	The ENTER option expands the possibilities for prompting the operator for replacement strings. ENTER programs can popup date pickers, customer lists, etc. To assist you with two of the most popular uses of this statement Signature Systems has provided the source for a date picker (datepick.ibs) and printer picker (ptrpick.ibs)in the XTL folder.	+	The ENTER option expands the possibilities for prompting the operator for replacement strings. ENTER programs can popup date pickers, customer lists, etc. To assist you with two of the most popular uses of this statement Signature Systems has provided the source for a date picker (datepick.ibs) and printer picker (ptrpick.ibs) in the XTL folder so these programs may be customized to your needs. You will find the source in the XTL folder.
		+

	ENTERed programs are passed their messages in # buffer. Likewise, the ENTERed program passes its message back to the parent program in # buffer.		ENTERed programs are passed their messages in # buffer. Likewise, the ENTERed program passes its message back to the parent program in # buffer.
Line 50:		Line 51:
	[[image:PromptDlg3.jpg]]		[[image:PromptDlg3.jpg]]

-	After the operator clicks "OK" on the main dialog, the ~~Reporter runs~~ the ~~report~~. ~~For each statement it reads it scans the text looking for a %PromptName% and substitutes the associated text~~.	+	After the operator clicks "OK" on the main dialog, the responses are written to the #CPROMPT file on TMP. This file is keyed by PARTITION$ + PROMPT name. Such as:

		+	P00%product%<br>
		+	P00%company.name%<br>
		+	P00%5%<br>
		+
		+	As the report spec is interpreted, string fields are parsed for a %..% pair. If found, the #CPROMPT file will be read to see if there is a replacement defined for the %..% prompt name. If not found, the string will be used as is, thus allowing for data to actually contain % signs.
	The silent ENTER option provides a way to run a program without operator interface to provide the string substitution:		The silent ENTER option provides a way to run a program without operator interface to provide the string substitution:

	PROMPT %PromptName% ENTER program,dir,"message"		PROMPT %PromptName% ENTER program,dir,"message"

-	In this case a field for this substitution will not be included in the dynamically created dialog. The program will be ENTERed and its value saved for substitution later in the report. This can be useful for getting operator or other context-sensitive information that your application knows without having to ask the operator.	+	In this case a field for this substitution will not be included in the dynamically created dialog. The program will be ENTERed and its value saved for substitution later in the report. This can be useful for getting operator or other context-sensitive information that your application knows without having to ask the operator. Unlike ENTERed programs called from the dialog, silent ENTERed programs do not have a length specified for the return value. The value is returned in # buffer. If trailing blanks are an important part of the value, the value must be enclosed in quotes. The length of the replacement string will be the length of the value within the quotes. If not enclosed in quotes, the value will be stripped of trailing blanks and the resultant length of the string will be used for the replacement field length.
-		+
-	~~Of course~~ the ~~datepick and ptrpick~~ programs ~~may~~ be ~~customized to your needs~~. ~~You~~ will ~~find~~ the ~~source~~ in the ~~XTL folder~~.	+

Barb at 17:08, 8 September 2009

2009-09-08T17:08:05Z

← Older revision		Revision as of 17:08, 8 September 2009
Line 13:		Line 13:

	The ENTER option expands the possibilities for prompting the operator for replacement strings. ENTER programs can popup date pickers, customer lists, etc. To assist you with two of the most popular uses of this statement Signature Systems has provided the source for a date picker (datepick.ibs) and printer picker (ptrpick.ibs)in the XTL folder.		The ENTER option expands the possibilities for prompting the operator for replacement strings. ENTER programs can popup date pickers, customer lists, etc. To assist you with two of the most popular uses of this statement Signature Systems has provided the source for a date picker (datepick.ibs) and printer picker (ptrpick.ibs)in the XTL folder.
		+
		+	ENTERed programs are passed their messages in # buffer. Likewise, the ENTERed program passes its message back to the parent program in # buffer.

Barb at 17:04, 8 September 2009

2009-09-08T17:04:07Z

Barb at 17:03, 8 September 2009

2009-09-08T17:03:03Z

← Older revision		Revision as of 17:03, 8 September 2009
Line 1:		Line 1:
	== PROMPT ==		== PROMPT ==
	'''Syntax:'''<br> The PROMPT statement has several variations:		'''Syntax:'''<br> The PROMPT statement has several variations:
-	PROMPT %PromptName% length prompt-string [default value]	+	PROMPT %PromptName% length prompt-string [default value]<br>
-	PROMPT %PromptName% length prompt-string [ENTER program,dir,"message"]	+	PROMPT %PromptName% length prompt-string [ENTER program,dir,"message"]<br>
-	PROMPT %PromptName% ENTER program,dir,"message"	+	PROMPT %PromptName% ENTER program,dir,"message"<br>
	PROMPT CAPTION caption-string		PROMPT CAPTION caption-string

Barb at 16:59, 8 September 2009

2009-09-08T16:59:34Z

← Older revision		Revision as of 16:59, 8 September 2009
Line 28:		Line 28:
	When the report runs, the Reporter pops up this dialog:		When the report runs, the Reporter pops up this dialog:

-	[[image:PromptDlg1.~~jpg~~]]	+	[[image:PromptDlg1.JPG]]

	Notice the caption string at the top of the dialog. This came from the statement		Notice the caption string at the top of the dialog. This came from the statement

Barb at 16:52, 8 September 2009

2009-09-08T16:52:05Z

← Older revision		Revision as of 16:52, 8 September 2009
Line 1:		Line 1:
-	PROMPT	+	== PROMPT ==
-	Syntax: The PROMPT statement has several variations:	+	'''Syntax:'''<br> The PROMPT statement has several variations:
	PROMPT %PromptName% length prompt-string [default value]		PROMPT %PromptName% length prompt-string [default value]
	PROMPT %PromptName% length prompt-string [ENTER program,dir,"message"]		PROMPT %PromptName% length prompt-string [ENTER program,dir,"message"]
Line 7:		Line 7:


-	Placement: The PROMPT statements need to be defined before their use as a replacement string. It is recommended that they be located at the top of the report spec.	+	'''Placement:'''<br> The PROMPT statements need to be defined before their use as a replacement string. It is recommended that they be located at the top of the report spec.
-	Discussion: The PROMPT statement is used to prompt the operator at runtime for a value to be used to replace text in a Reporter command. For example, the operator can be prompted for a printer name, a range of dates, or the text for a TITLE statement.	+
		+	'''Discussion:'''<br> The PROMPT statement is used to prompt the operator at runtime for a value to be used to replace text in a Reporter command. For example, the operator can be prompted for a printer name, a range of dates, or the text for a TITLE statement.
	One PROMPT statement is used for each value to be replaced. It is best to group all PROMPT statements for the report together. At runtime the Reporter collects the PROMPT statements and creates a dialog to prompt the operator for each of the replacement strings in the group. When a default value is specifed in the PROMPT the dialog is populated with that value.		One PROMPT statement is used for each value to be replaced. It is best to group all PROMPT statements for the report together. At runtime the Reporter collects the PROMPT statements and creates a dialog to prompt the operator for each of the replacement strings in the group. When a default value is specifed in the PROMPT the dialog is populated with that value.

Line 14:		Line 15:


-	Examples: PROMPT CAPTION Invoices for Specified Date Range	+	'''Examples:'''<br> PROMPT CAPTION Invoices for Specified Date Range
	PROMPT %startdate% 8 From date: [ENTER datepick,,"YY/MM/DD,Enter from date"]		PROMPT %startdate% 8 From date: [ENTER datepick,,"YY/MM/DD,Enter from date"]
	PROMPT %enddate% 8 To date: [ENTER datepick,,"YY/MM/DD,Enter to date"]		PROMPT %enddate% 8 To date: [ENTER datepick,,"YY/MM/DD,Enter to date"]
Line 27:		Line 28:
	When the report runs, the Reporter pops up this dialog:		When the report runs, the Reporter pops up this dialog:

		+	[[image:PromptDlg1.jpg]]

	Notice the caption string at the top of the dialog. This came from the statement		Notice the caption string at the top of the dialog. This came from the statement

Barb at 16:47, 8 September 2009

2009-09-08T16:47:47Z

← Older revision		Revision as of 16:47, 8 September 2009
Line 34:		Line 34:
	Each of the prompts in this example is associated with an ENTER program invoked when the control for the prompt gets the focus. When the operator clicks on the "From Date:" field, the Reporter ENTERs the datepick subprogram:		Each of the prompts in this example is associated with an ENTER program invoked when the control for the prompt gets the focus. When the operator clicks on the "From Date:" field, the Reporter ENTERs the datepick subprogram:

-	[[PromptDlg2.jpg]]	+	[[image:PromptDlg2.jpg]]

	The caption on the date picker comes from the PROMPT statement:		The caption on the date picker comes from the PROMPT statement:
Line 44:		Line 44:
	When the printer prompt gets the focus, the ptrpick program is ENTERed:		When the printer prompt gets the focus, the ptrpick program is ENTERed:

-	[[PromptDlg3.jpg]]	+	[[image:PromptDlg3.jpg]]

	After the operator clicks "OK" on the main dialog, the Reporter runs the report. For each statement it reads it scans the text looking for a %PromptName% and substitutes the associated text.		After the operator clicks "OK" on the main dialog, the Reporter runs the report. For each statement it reads it scans the text looking for a %PromptName% and substitutes the associated text.

Barb: New page: PROMPT Syntax: The PROMPT statement has several variations: PROMPT %PromptName% length prompt-string [default value] PROMPT %PromptName% length prompt-string [ENTER program,dir,"message...

2009-09-08T16:47:00Z

New page: PROMPT Syntax: The PROMPT statement has several variations: PROMPT %PromptName% length prompt-string [default value] PROMPT %PromptName% length prompt-string [ENTER program,dir,"message...

New page

PROMPT
Syntax: The PROMPT statement has several variations:
PROMPT %PromptName% length prompt-string [default value]
PROMPT %PromptName% length prompt-string [ENTER program,dir,"message"]
PROMPT %PromptName% ENTER program,dir,"message"
PROMPT CAPTION caption-string

Placement: The PROMPT statements need to be defined before their use as a replacement string. It is recommended that they be located at the top of the report spec.
Discussion: The PROMPT statement is used to prompt the operator at runtime for a value to be used to replace text in a Reporter command. For example, the operator can be prompted for a printer name, a range of dates, or the text for a TITLE statement.
One PROMPT statement is used for each value to be replaced. It is best to group all PROMPT statements for the report together. At runtime the Reporter collects the PROMPT statements and creates a dialog to prompt the operator for each of the replacement strings in the group. When a default value is specifed in the PROMPT the dialog is populated with that value.

The ENTER option expands the possibilities for prompting the operator for replacement strings. ENTER programs can popup date pickers, customer lists, etc. To assist you with two of the most popular uses of this statement Signature Systems has provided the source for a date picker (datepick.ibs) and printer picker (ptrpick.ibs)in the XTL folder.

Examples: PROMPT CAPTION Invoices for Specified Date Range
PROMPT %startdate% 8 From date: [ENTER datepick,,"YY/MM/DD,Enter from date"]
PROMPT %enddate% 8 To date: [ENTER datepick,,"YY/MM/DD,Enter to date"]
PROMPT %printer% 3 Printer name: [ENTER ptrpick]
PRINTER %printer%
TITLE Invoice from %startdate% thru %enddate%
INPUT invoice.header
REPORT
SELECTING inv.date ge %startdate% and inv.date le %enddate%
PRINT ivh.no;cust.no;inv.total

When the report runs, the Reporter pops up this dialog:

Notice the caption string at the top of the dialog. This came from the statement

PROMPT CAPTION Invoices for Specified Date Range

Each of the prompts in this example is associated with an ENTER program invoked when the control for the prompt gets the focus. When the operator clicks on the "From Date:" field, the Reporter ENTERs the datepick subprogram:

[[PromptDlg2.jpg]]

The caption on the date picker comes from the PROMPT statement:

PROMPT %startdate% 8 From date: [ENTER datepick,,"YY/MM/DD,Enter from date"]

The other parameter passed to datepick is the format specifying that the date will be returned in (YY/MM/DD) format.

When the printer prompt gets the focus, the ptrpick program is ENTERed:

[[PromptDlg3.jpg]]

After the operator clicks "OK" on the main dialog, the Reporter runs the report. For each statement it reads it scans the text looking for a %PromptName% and substitutes the associated text.

The silent ENTER option provides a way to run a program without operator interface to provide the string substitution:

PROMPT %PromptName% ENTER program,dir,"message"

In this case a field for this substitution will not be included in the dynamically created dialog. The program will be ENTERed and its value saved for substitution later in the report. This can be useful for getting operator or other context-sensitive information that your application knows without having to ask the operator.

Of course the datepick and ptrpick programs may be customized to your needs. You will find the source in the XTL folder.

← Older revision		Revision as of 17:04, 8 September 2009
Line 1:		Line 1:
	== PROMPT ==		== PROMPT ==
-	'''Syntax:'''<br> The PROMPT statement has several variations:	+	'''Syntax:'''<br> The PROMPT statement has several variations: <br>
	PROMPT %PromptName% length prompt-string [default value]<br>		PROMPT %PromptName% length prompt-string [default value]<br>
	PROMPT %PromptName% length prompt-string [ENTER program,dir,"message"]<br>		PROMPT %PromptName% length prompt-string [ENTER program,dir,"message"]<br>
Line 15:		Line 15:


-	'''Examples:'''<br> PROMPT CAPTION Invoices for Specified Date Range	+	'''Examples:'''<br> PROMPT CAPTION Invoices for Specified Date Range<br>
-	PROMPT %startdate% 8 From date: [ENTER datepick,,"YY/MM/DD,Enter from date"]	+	PROMPT %startdate% 8 From date: [ENTER datepick,,"YY/MM/DD,Enter from date"]<br>
-	PROMPT %enddate% 8 To date: [ENTER datepick,,"YY/MM/DD,Enter to date"]	+	PROMPT %enddate% 8 To date: [ENTER datepick,,"YY/MM/DD,Enter to date"]<br>
-	PROMPT %printer% 3 Printer name: [ENTER ptrpick]	+	PROMPT %printer% 3 Printer name: [ENTER ptrpick]<br>
-	PRINTER %printer%	+	PRINTER %printer%<br>
-	TITLE Invoice from %startdate% thru %enddate%	+	TITLE Invoice from %startdate% thru %enddate%<br>
-	INPUT invoice.header	+	INPUT invoice.header<br>
-	REPORT	+	REPORT<br>
-	SELECTING inv.date ge %startdate% and inv.date le %enddate%	+	SELECTING inv.date ge %startdate% and inv.date le %enddate%<br>
-	PRINT ivh.no;cust.no;inv.total	+	PRINT ivh.no;cust.no;inv.total<br>

	When the report runs, the Reporter pops up this dialog:		When the report runs, the Reporter pops up this dialog: