Learning to RAP
The End-User’sGuide to Building Reports
Copyright © 2004 - 2007 by Digital Metaphors Corporation
i
INTRODUCTION TORAP
OVERVIEW Welcome .................................................................. 5
The Calc Workspace ................................................ 6
CALISTHENICS FORRAP-ERS Overview ................................................................ 11
Getting Started ....................................................... 11
Build the Report Layout .......................................... 12
EXPLORING THECALC
WORKSPACE Viewing the Report Code ....................................... 15
Browse the Code Toolbox ...................................... 17
Learn About Types of Events ................................. 18
Event Creation ....................................................... 19
RAP TUTORIALS
CONFIGURINGREPORTCOMPONENTS
Concatenation
Overview ................................................................ 27
Build the report ....................................................... 28
Add the Code ......................................................... 30
Preview and Finish ................................................. 32
Set Font Color and Style
Overview ................................................................ 33
Build the Report ..................................................... 33
Load Address Lines Into Memo
Overview ................................................................ 37
Build the Report ..................................................... 38
Add the Code ......................................................... 38
ii
Print Description of AutoSearch Criteria
Overview ................................................................ 41
Build the Report ..................................................... 42
Preview and Finish ................................................. 44
CALCULATIONS Conditional Group Totals
Overview ................................................................ 47
Build the Report ..................................................... 47
Add the Code ......................................................... 49
Conditional Grand Totals
Overview ................................................................ 51
Build the Report ..................................................... 51
GLOBALDECLARATIONS, OBJECTS, & PROGRAMS
Global String
Overview ................................................................ 55
Build the Report ..................................................... 55
Add the Code ......................................................... 56
Global StringList
Overview ................................................................ 57
Build the Report ..................................................... 57
Add the Code ......................................................... 58
Global Function
Overview ................................................................ 59
Build the Report ..................................................... 59
Add the Code ......................................................... 60
LEARNINGTORAP
INTRODUCTION TORAP
RAP TUTORIALS
INTRODUCTION TORAP
Overview 5
Calisthenics for RAP-ers 11
Exploring the Calc Workspace 15
5
OVERVIEW
WELCOME
Welcome to Learning to RAP, a series of tutorials
designed to teach you how to use the Report
Designer’s Calc Workspace to perform calculations
and control visual aspects of the report while it is
generating. For example you might want to calculate the number of stocks in a portfolio whose share
price exceeds $50.00. In addition you might decide
to conditionally display the share price of each
stock in either black or red, depending upon
whether its share price exceeds $50.00.
RAP stands for Report Application Pascal and is
used to refer to the Report Designer's Calc Workspace. The Calc Workspace provides an eventbased scripting environment in which you can
implement blocks of code that are executed in
response to specific events that occur during the
report generation process.
RAP is also used to refer to the scripting language
itself. RAP is powerful, yet easy to learn and read.
The RAP scripting language is based upon Object
Pascal, a modern version of the Pascal programming language that has historically been used to
teach introductory programming courses.
The Report Designer, shown below, is the application you will use to code reports. Learning to RAP
is written for the end user who is already familiar
with ReportBuilder. If you are unfamiliar with the
data, design, or preview tabs, then the Learning
ReportBuilderguide is where to start.
6
THE CALC WORKSPACE
The Calc workspace provides an event-based
scripting environment that can be used to perform
calculations and dynamically control visual aspects
of the report layout while the report is generating.
Scripts that respond to events are called event-handlers.
The Report Designer’s Calc Workspace is divided
into four main areas as shown in the diagram
below. Each of these areas is covered in detail on
the following pages.
The Calc Workspace
A Code Explorer: Used to organize and manage C The Code Toolbox: Visual code repository,
a report’s scripts supports drag-and-drop script creation
BCode Editor: Used to edit scripts DMessage Window: Dislays messages from
the script compiler that checks your code
D
B
A
C
7
Code Explorer
The Code Explorer is contained in the upper left
and right panes of the Calc workspace.
The left pane contains a tree view - use this to navigate your report’s code. The right pane contains a
list view - it will display a variety of items depending on what is selected in the tree view. By rightclicking on the tree you can display a context menu
that allows you to control the behavior of the Code
Explorer.
Views
The Calc tab allows you to manage the report code
using three different views. By selecting the View
menu or by right-clicking over the white space of
the left pane:
•Variables
•Events
• Module
The series of screen shots below illustrate how the
same report looks with each view.
You can select a view by using the View menu or
by positioning the mouse over the white space of
the left pane and pressing the right mouse button to
display a context menu.
Variables View
This view allows you to see the Variables within a
report. Variables allow you to perform calculations. Notice that only the bands are displayed in
the left pane. The only component visible from
this view is the Variable. All other components in
the report are hidden in this view.
Events View
This view displays a tree view of all components
contained within the report. The right pane displays any events associated with the currently
selected component. Selecting an event will display the event script, if one exists.
8
Module View
This view displays a global view of the entire calc
module. It lists all declarations, events, programs,
and event handlers. This view is useful when you
want to examine all of the report’s code.
This view displays items, which are visible to all
event handlers of the report:
Declarations– These are variables and constants
that are globally visible throughout the report.
Events –These are, in essence, the report's events.
In the case where the preview window is displayed,
OnCreate and OnDestroy fire when the window is
opened and closed, respectively. This is different
from Report.BeforePrint and AfterPrint in that
those methods will fire each time Report.Print is
called. OnCreate and OnDestroy are good places
for initialization and finalization code such as creating and freeing objects and initializing variables.
Programs– These are procedures and functions
that are globally visible throughout the report and
can therefore be called from any event handler.
Event Handlers– These are all event handlers that
have been implemented in the report.
Code Toolbox
The Code Toolbox is a visual code repository. It
contains most of the identifiers and code elements
that the RAP compiler recognizes.
Notice that the Code Toolbox has three tabs: Data,
Objects, and Language. Each tab consists of a treeview and a list of identifiers.
Data Tab
The Data tab of the Code Toolbox displays data
pipelines and fields, allowing you to drag and drop
field references into the Code Editor.
Selecting a pipeline from the list will display all the
fields in that pipeline as well as data type and size
information for the fields.
To insert a field value into the code editing window, select the field and drag it into the Code Editor. The code necessary to retrieve the field value
from the pipeline will be generated. For example,
dragging the 'City' field from the Code Toolbox
pictured above would result in this code:
Value := Clients[’City’]
9
Objects Tab
The Objects tab of the Code Toolbox displays
report objects and their properties, allowing you to
drag and drop properties into the Code Editor.
Selecting an object from the tree will display a list
of that object's properties.
To insert a property into the Code Editor, select the
property and drag it into the Code Editor. The code
necessary to retrieve the value of the property or
call the method will be generated. For example,
dragging the 'AutoSize' property from the Code
Toolbox pictured above would result in the following code:
Label1.AutoSize
Language Tab
The Language tab of the Code Toolbox displays
RAP language elements, allowing you to drag and
drop elements into the Code Editor.
Selecting a category from the tree will display a list
of elements for that category.
To insert an element into the Code Editor, select
the element and drag it to the Code Editor. The
code necessary to reference or use the element will
be generated. Note that when you drop an item
such as a function call, the function's parameter list
is provided. For instance, if you drag Copy into the
Code Editor, it will expand as:
Copy(S, Index, Co
เรียนรู้การสร้างรายงาน end-user'sguide แร็พ
ลิขสิทธิ์ สงวนลิขสิทธิ์ 2547 - 2550 โดย บริษัท ดิจิตอล อุปมา
ผม
ยินดีต้อนรับ .................................................................. torap ภาพรวมเบื้องต้น 5
................................................ คำนวณงาน 6
forrap-ers ภาพรวมของ ................................................................ 11
การเริ่มต้น ....................................................... 11
สร้างรายงานรูปแบบ .......................................... สำรวจพื้นที่ thecalc 12
ดู ....................................... รายงานรหัส โค้ดกล่อง ...................................... 15
เรียกดู 17
เรียนรู้เกี่ยวกับชนิดของ ................................. เหตุการณ์
เหตุการณ์สร้าง…… 18.......................................... 19 สอน
เคาะ configuringreportcomponents เรียงต่อกัน
ภาพรวม ................................................................ 27
สร้างรายงาน ....................................................... 28
เพิ่มรหัส ......................................................... ตัวอย่างและ ................................................. 30
เสร็จตั้งค่าสีแบบอักษรและรูปแบบ 32
ภาพรวม ................................................................ สร้างรายงาน .....................................................
33 33
โหลดสายที่อยู่ในบันทึก
ภาพรวม ................................................................ 37
สร้างรายงาน ..................................................... 38
เพิ่มรหัส ......................................................... 38
ii
พิมพ์รายละเอียดของเกณฑ์ autosearch
ภาพรวม ................................................................ 41
สร้างรายงาน ..................................................... ตัวอย่างและ ................................................. 42
เสร็จ 44
.................................................. เงื่อนไขการคำนวณผลรวมของกลุ่มข้อมูลยกระดับ 47
สร้างรายงาน ..................................................... 47
เพิ่มรหัส ......................................................... 49
ภาพรวม ................................................................ เงื่อนไขผลรวมทั้งหมด 51
สร้างรายงาน ..................................................... 51
globaldeclarations , วัตถุ , โปรแกรม
) &สตริงภาพรวม ................................................................ 55
..................................................... สร้างรายงาน 55
......................................................... เพิ่มรหัส
ภาพรวม ................................................................ stringlist 56 ) 57
สร้างรายงาน ..................................................... 57
เพิ่มรหัส ......................................................... 58
ภาพรวม ................................................................ ) ฟังก์ชัน 59
สร้างรายงาน ..................................................... 59
เพิ่มรหัส ......................................................... 60
เคาะ torap learningtorap เบื้องต้นสอน
แนะนำ torap
-
5เพาะกายเพื่อเตือน ERS 11
สำรวจ Calc พื้นที่ 15
5
-
ยินดีต้อนรับ
ยินดีต้อนรับสู่การเรียนรู้ที่จะเคาะชุดของ tutorials
ออกแบบมาเพื่อสอนให้คุณใช้รายงาน
ดีไซเนอร์ Calc งาน เพื่อทำการคำนวณและควบคุมลักษณะของภาพ
รายงานในขณะที่มันถูกสร้าง ตัวอย่างเช่นคุณอาจต้องการที่จะคำนวณจำนวนหุ้นในพอร์ตที่แบ่งปัน
ราคาเกิน $ 50.00 . นอกจากนี้คุณอาจตัดสินใจ
เพื่อเงื่อนไขแสดงราคาหุ้นของหุ้นในแต่ละ
สีดำหรือแดง ขึ้นอยู่กับว่าราคาหุ้นของเกิน $ 50.00 .
เคาะยืนรายงาน โปรแกรมปาสคาลและ
ใช้อ้างถึงรายงานของผู้ออกแบบคำนวณพื้นที่ทำงาน ในงานมี eventbased Calc สภาพแวดล้อมการเขียนสคริปต์ที่คุณสามารถ
ใช้บล็อกของรหัสที่จะดำเนินการในการตอบสนองต่อเหตุการณ์ที่เกิดขึ้นโดยเฉพาะ
สร้างรายงานในกระบวนการ .
Rap นอกจากนี้ยังใช้เพื่ออ้างถึงภาษาสคริปต์
นั่นเอง แร็พเป็นที่มีประสิทธิภาพยังง่ายต่อการเรียนรู้และการอ่าน
แร็พภาษาสคริปต์ขึ้นอยู่กับวัตถุ
ปาสคาล , รุ่นปัจจุบันของโปรแกรมภาษาปาสคาลที่มีในอดีตถูกใช้
สอนวิชาการเขียนโปรแกรมเบื้องต้น .
ออกแบบรายงานที่แสดงด้านล่างเป็นโปรแกรมที่คุณจะใช้ในการรายงานรหัส การเรียนรู้แร็ป
เขียนสำหรับผู้ใช้ที่คุ้นเคยกับ reportbuilder
. ถ้าคุณไม่คุ้นเคยกับ
ข้อมูล ออกแบบ หรือตัวอย่างแท็บ แล้ว reportbuilderguide การเรียนรู้
เป็นจุดเริ่มต้น .
6
Calc Calc พื้นที่พื้นที่มีกิจกรรมตาม
สคริปต์สิ่งแวดล้อมที่สามารถใช้เพื่อแสดงและควบคุมด้านการคำนวณแบบไดนามิก
ของรายงานรูปแบบในขณะที่รายงานสร้าง
สคริปต์ที่ตอบสนองต่อเหตุการณ์ที่เรียกว่าตัวจัดการเหตุการณ์ .
รายงาน Calc ออกแบบพื้นที่แบ่งเป็นสี่พื้นที่หลักเป็น
แสดงในแผนภาพด้านล่าง แต่ละพื้นที่เหล่านี้จะครอบคลุมในรายละเอียดในหน้าต่อไป
.ช่วง Calc 2.0
รหัส Explorer : ใช้เพื่อจัดระเบียบและจัดการ C รหัสกล่องเครื่องมือ : เก็บโค้ดภาพ
สคริปต์ของรายงานสนับสนุนลากและวางสคริปต์สร้าง
bcode บรรณาธิการ : ใช้เพื่อแก้ไขสคริปต์ dmessage หน้าต่าง : dislays ข้อความจากบทเรียบเรียงที่การตรวจสอบของคุณ
D
B
เป็นรหัส C
7
รหัส Explorer รหัส Explorer อยู่ในด้านบนซ้ายและขวาบาน
ของ Calc พื้นที่ทำงาน
บานหน้าต่างด้านซ้ายประกอบด้วยมุมมองต้นไม้ - ใช้เพื่อนำทางรหัสรายงานของคุณ . บานหน้าต่างด้านขวาประกอบด้วยวิว -
รายการจะแสดงความหลากหลายของรายการขึ้นอยู่กับสิ่งที่เลือกในมุมมองต้นไม้ โดย rightclicking บนต้นไม้คุณสามารถแสดงเมนูบริบท
ที่ช่วยให้คุณสามารถควบคุมพฤติกรรมของรหัส
แท็บมุมมอง Explorer Calc ช่วยให้คุณสามารถจัดการรายงานรหัส
ใช้สามมุมมองที่แตกต่างกัน โดยเลือกเมนูมุมมอง
หรือโดยการคลิกขวาบนพื้นที่ว่างสีขาวของบานหน้าต่างด้านซ้าย :
-
- ตัวแปร - เหตุการณ์โมดูล
ชุดของภาพหน้าจอด้านล่างนี้แสดงให้เห็นวิธีการรายงานเดียวกันลักษณะแต่ละมุมมอง
คุณสามารถเลือกมุมมองโดยใช้เมนูหรือ
โดยตำแหน่งเมาส์ ผ่านช่องว่างของ
บานหน้าต่างด้านซ้ายและกดปุ่มเมาส์ขวา
แสดงเมนูบริบท .
รีวิวตัวนี้ช่วยให้คุณสามารถเห็นตัวแปรในรายงาน . ตัวแปรที่ช่วยให้คุณสามารถทำการคำนวณ . สังเกตที่วงแสดงใน
บานหน้าต่างด้านซ้าย ส่วนประกอบเท่านั้นที่สามารถมองเห็นได้จาก
มุมมองนี้ตัวแปร ส่วนประกอบอื่น ๆทั้งหมดใน
รายงานซ่อนอยู่ในมุมนี้ มุมนี้ดู
เหตุการณ์แสดงมุมมองต้นไม้ขององค์ประกอบทั้งหมด
ที่มีอยู่ในรายงาน บานหน้าต่างด้านขวาจะแสดงเหตุการณ์ที่เกี่ยวข้องกับในปัจจุบัน
ส่วนประกอบที่เลือก การเลือกกิจกรรมจะแสดงเหตุการณ์สคริปต์หากมีอยู่ .
8
มุมมองนี้จะแสดงโมดูลรีวิวทั่วโลกของโมดูล Calc
ทั้งหมด รายการประกาศทั้งหมด , กิจกรรม , โปรแกรม ,
เหตุการณ์และผู้ดูแล รีวิวนี้จะเป็นประโยชน์เมื่อคุณต้องการที่จะตรวจสอบทั้งหมดของรหัส
ของรายงานมุมมองนี้จะแสดงรายการ ซึ่งจะปรากฏให้เห็นทุกตัวจัดการเหตุการณ์รายงาน :
ประกาศ และเหล่านี้คือตัวแปรและค่าคงที่
ที่มองเห็นทั่วโลกตลอดทั้งรายงาน
เหตุการณ์–เหล่านี้เป็นในสาระสำคัญ , เหตุการณ์ของรายงาน
ในกรณีที่หน้าต่างแสดงตัวอย่างจะปรากฏขึ้น
oncreate ondestroy และไฟเมื่อหน้าต่าง
เปิด และ ปิด ตามลำดับ นี่มันต่างกัน
จากรายงานและใน beforeprint afterprint
วิธีการเหล่านั้นจะยิงแต่ละครั้ง รายงาน พิมพ์
เรียกว่า และ oncreate ondestroy เป็นสถานที่ที่ดีสำหรับการเริ่มต้นและ
200 รหัส เช่นการสร้างและเพิ่มวัตถุและการเริ่มต้นตัวแปร
โปรแกรม–เหล่านี้และขั้นตอนการทำงานที่สามารถมองเห็นได้ทั่วโลกตลอด
จึงสามารถเรียกรายงานจากเหตุการณ์ใด ๆผู้จัดการ
ตัวจัดการเหตุการณ์–เหล่านี้เป็นผู้ดูแลเหตุการณ์ทั้งหมดที่
ได้ถูกนําไปใช้ในรายงาน
รหัสรหัสกล่องเครื่องมือกล่องเครื่องมือเป็นเก็บรหัสภาพ มัน
ประกอบด้วยส่วนใหญ่ของตัวระบุและองค์ประกอบรหัส
ที่แร็พคอมไพเลอร์รู้จัก
สังเกตว่ารหัสกล่องมี 3 แท็บ : ข้อมูล
วัตถุ และภาษา แต่ละเม็ดประกอบด้วยเพลงและรายการของแท็บ
ข้อมูลระบุ .แท็บข้อมูลโค้ดกล่องแสดงท่อข้อมูล
และเขตข้อมูลที่ช่วยให้คุณสามารถลากและวาง
ฟิลด์อ้างอิงเป็นรหัสบรรณาธิการ
เลือกท่อจากรายการจะแสดงเขตข้อมูลทั้งหมด
ในท่อ รวมทั้งประเภทของข้อมูลและข้อมูลสำหรับเขตข้อมูลขนาด
.
ใส่ค่าในเขตข้อมูลในรหัสแก้ไขหน้าต่างเลือกสนามและลากลงในรหัสแก้ไขรหัสที่จำเป็นเพื่อดึงข้อมูลค่า
จากท่อจะถูกสร้าง ตัวอย่างเช่น
ลาก ' เมือง ' สนามจากรหัสกล่อง
ภาพข้างต้นจะส่งผลในรหัสนี้ :
: = [ ค่าลูกค้า 'city ' ]
9
วัตถุวัตถุแท็บแท็บของรหัสเครื่องมือจะแสดงรายงานวัตถุและคุณสมบัติที่ช่วยให้คุณสามารถลากและคุณสมบัติลดลง
ในรหัส
กองบรรณาธิการการเลือกวัตถุจากต้นไม้จะแสดงรายการคุณสมบัติของวัตถุนั้น
.
แทรกคุณสมบัติเป็นรหัส Editor เลือก
คุณสมบัติและลากลงในรหัสแก้ไข รหัส
ต้องเรียกค่าของทรัพย์สินหรือ
เรียกวิธีการจะถูกสร้าง ตัวอย่างเช่น
ลาก ' autosize ทรัพย์สินจากรหัส
กล่องเครื่องมือภาพข้างต้นจะส่งผลในรหัสต่อไปนี้ :
label1 . autosize
ภาษาภาษาแท็บแท็บของรหัสเครื่องมือแสดง
องค์ประกอบภาษาแร็พ , ช่วยให้คุณสามารถลากและวางองค์ประกอบ
เป็นรหัสบรรณาธิการ
เลือกประเภทจากต้นไม้จะแสดงรายการ
องค์ประกอบสำหรับประเภทที่ แทรกเป็นองค์ประกอบในรหัส Editor เลือก
องค์ประกอบและลากไปยังรหัสบรรณาธิการ
รหัสที่จำเป็นเพื่ออ้างอิงหรือใช้องค์ประกอบจะ
ถูกสร้างขึ้น ทราบว่าเมื่อคุณปล่อยสินค้า
เช่น ฟังก์ชันเรียกรายชื่อพารามิเตอร์ของฟังก์ชันที่ให้ไว้ ตัวอย่างเช่น ถ้าคุณลากคัดลอกลงใน
แก้ไขรหัส มันก็จะขยายเป็น :
คัดลอก ( s , ดัชนี , CO
การแปล กรุณารอสักครู่..
