Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Basic Concepts
Overview Tutorial Tips
This Basic Concepts tutorial introduces you to Keyboard icons specify values that you enter
EnterpriseTenFold SOA. We recommend that you to complete a step.
complete Basic Concepts before other tutorials.
Information icons highlight additional
Each tutorial contains focused, brief lessons to instructions and concepts related to a step.
explain an important TenFold technology concept. Question icons help you make informed
During this tutorial you: decisions and understand what is happening.
Before you build an application, we want you to experience an application that we built,
called SuperCRM, to see just some of the features of every TenFold-powered
application. Therefore, Lesson 1 imports a SuperCRM description into the TenFold
Dictionary so that, in Lesson 2, you can run and experience SuperCRM.
Double click the EnterpriseTenFold SOA icon (if you are using Personal Edition your icon
reads Personal Edition).
With Personal Edition, your desktop computer is acting as your client computer, your applications server,
your database server, and your web server. (In a more typical enterprise installation, these would all be
separate computers.) Therefore, clicking the desktop icon starts these programs:
• TenFoldClient (tfcli), TenFold MessageServer, TenFold ServerManager (tfsrvmgr and tftskmst)
• EnterpriseDB RDBMS (edb-postmaster and edb-postgres)
If you have Windows Firewall enabled, unblock these programs when the option to unblock appears.
Clicking the icon starts the TenFold applications building tool set called TenFoldTools. You use
TenFoldTools to create, import, or export an application.
If you are missing an EnterpriseTenFold or Personal Edition icon, you might be running an older version of
EnterpriseTenFold or might not have EnterpriseTenFold installed. You can download Personal Edition here
1. User name = Business
2. Password = Business
Throughout this tutorial we use [] brackets to describe buttons. If the [Import] button is gray, there are
several potential reasons. Right click on [Import] and choose help to see how to enable [Import].
4. Click the folder symbol to the right of the Import file field.
5. Choose Insert (Use Insert to pick a file instead of typing its name.)
6. Pick the SuperCRM+2007v3.10F file.
7. Click [Open]
If you are using Personal Edition installed in suggested directories,
SuperCRM+2007.10F is in C:\Program files\TenFold\TenFoldPE\Export
You should have these two icons on your desktop. If you are missing the
BrowserClient icon, check that you have IIS installed. If you need to install
IIS, do so now, and then click [Register] to create the BrowserClient icon.
IIS is a Microsoft Web Server, see System Requirements link at the top of the
tutorial for more details.
EnterpriseTenFold SOA works with popular RDMSs like Oracle, DB2, SQL Server,
Sybase, EnterpriseDB, and MySQL. EnterpriseTenFold SOA Personal Edition includes a
fully configured EnterpriseDB installation to make your Personal Edition experience
easy and not require that you install an RDBMS. Read more about EnterpriseDB here.
EnterpriseTenFold SOA coupled with your RDBMS provides you an architecture with
which you can create new applications and transform your legacy applications into
SOA compliant applications . As you use SuperCRM, realize that it uses the identical
EnterpriseTenFold SOA that TenFold customers use to trade billions of dollars in
equities, manage hospitals, and rate insurance policies, with thousands of simultaneous
end-users daily. TenFold customers like these use high-volume, scalable, production
TenFold-powered applications today:
1. Double-click the SuperCRM browser icon (it looks like this, if Internet
Explorer is your web browser)
EnterpriseTenFold SOA includes a robust application server (TenFold ServerManager) that manages end-
user sessions, server clustering, authentication, and more. You can learn how to configure TenFold
ServerManager by reading Administering TenFold ServerManager.
Personal edition includes EnterpriseDB, a powerful relational database. Read more about EnterpriseDB
here.
Personal Edition Windows and BrowserClient icons start and stop the database and application servers.
2. User name = Sales
3. Password = Sales
SuperCRM passwords are case-sensitive. SuperCRM comes with sample user names (if you were using
SuperCRM in production, you would provide each employee an individual user name such as jsmith):
• Marketing (password = Marketing)
• Sales (password = Sales)
• Admin (password = Admin)
• Support (password = Support)
• SalesMgr (password = Manager)
The first time you sign on to an application in a brand new environment, EnterpriseTenFold preprocesses
your applications definition and stores it in a shared-persistent cache so that the next time you run the
application it is much faster. Look for this automatic performance improvement as you explore the
SuperCRM application.
HoverFrame is a feature for any web page. HoverFrames can retrieve data without refreshing a page.
Changing a page without refreshing it is a powerful feature that the IT community calls AJAX. Without
EnterpriseTenFold SOA it takes a team of seasoned developers to program AJAX behavior into each web
page. In EnterpriseTenFold SOA, a checkbox enables HoverFrame AJAX.
TenFold refers to your application web pages and Windows screens as transactions. TenFold-powered
transactions come standard with SmartNavigation features. SmartNavigation provides navigation features
that your end-users need – without programming or any development work.
9. Click [Next] and [Prior] to move through accounts.
10. Click [Multiple] to see accounts in a grid-style list.
11. Click an account in the grid and click [Single] to view it only.
12. Click [Multiple] and let's explore some ways to query your data
13. Click [Query],type c* in Account Name
14. Click [Run Query]. You see only accounts that start with C (or c, as
querying is case insensitive.)
We call our query metaphor with wild-cards QueryByExample. Without programming or development
work, QueryByExample makes each transaction a powerful, standardized query engine. End-users become
QueryByExample experts because it always lets them find the data they need in a few keystrokes.
15. Click [Query] and type *In* in Account Name. Click [Run Query].
16. Click [Single] and [Query].
17. Do a query entering >200000000 in the Annual revenue field to see
companies with annual review greater than $200,000,000.
18. Do a query entering <100 in the Number of employees field.
19. Experiment with your own queries. You can query using any field.
20. Click [Close] to close the Account detail screen.
Using EnterpriseTenFold SOA, you can build a thousand-user, policy-management, web-enabled
application without writing a single line of SQL. We call TenFold’s powerful SQL-generation capability
SmartSQL. Many applications-performance problems result from inefficient database operations. While
writing some SQL is easy, writing efficient and complex SQL is difficult. Some SQL is so complex that few
programmers can correctly write it. SmartSQL generates different SQL for each version of each vendor
RDBMS. EnterpriseTenFold SOA consistently generates optimal SQL for your application.
References to click [Add] in BrowserClient throughout this tutorial also mean clicking the Add
graphic found in the top of the region or tab.
31. Relation = And
32. Field prompt = Annual revenue
33. Operator = >=
34. Value = 200000000.
35. Click [Save].
36. Click [Run].
We call these saved queries PowerQueries. PowerQueries are like live reports; use PowerQuery to store
your most frequent queries and run them any time you choose. End-users can create as many
PowerQueries as they need, share them with others, or keep them private. In our example, you can run
your new PowerQuery to find all large accounts in California in real time.
37. Click [Close].
38. Click Arratria Corporation to view the Account details screen.
39. Click the drop-down arrow for Industry and notice the size of the list.
40. Type N in the Industry field (replacing the value already there) and click
the drop-down arrow. Note only Industries starting with N appear.
41. Type G in Industry and tab out of the field. Since G is unique, it auto-
filled the proper value. (QueryByExample works for drop-down
SmartPick fields to limit values in a pick list)
42. Enter a non-number value (like XXX) in the Number of employees
records field and click [Save].
43. Notice the returned messages
44. Enter a valid value, tab out, and click [Save].
45. Click the Incomplete activities tab and click [Add]
46. In the new row, Click the calendar icon for Due date. Using the
CalendarControl, pick a date.
47. Click the note pad icon for Activity and enter data in the Pop-up edit
window.
48. Click on the drop down SmartPick for Status, and select Planned.
SuperCRM protects fields from your edits because of a simple business rule: you cannot edit an incomplete
activity that does not belong to you, or unless you are an administrator. We call this data-protection feature
SecurityByValue, which means data values can drive your data security.
Rule-driven security to decide who can see what data and who can change it – without any applications
development expense.
You have just used an AnyFile field when you entered an Attachment. AnyFile fields provide easy access
to files (such as images, text documents, web pages, et cetera) that you store on a local disk or network. You
uploaded the file from the local client to the application server and stored in the applications database. In
this case, you added a supporting document as an attachment to this Case.
With AnyFile, you can build applications that store files like documents or pictures as part of your
applications database. These types of applications can warehouse tremendous amounts of information in
any file formats that you choose.
66. Click [OK]
67. Click [Save]
68. Modify the case.
69. Priority = High
70. Click [Save].
71. Click [Changes] and choose History (top of the screen).
72. SuperCRM highlights your most recent change in green
73. Click [Close details] to close the History screen.
74. Make some more changes and click [Save].
75. Click [History] again.
76. Click each change date and time to review changes.
77. Click [Close details]
78. Click [Close]
79. Click [Logout].
You have just experienced a power feature called TimeRelation. TimeRelation automatically stores your
applications-data changes. You can view all changes over time. You can query as-of a particular date.
EnterpriseTenFold SOA comes with many power features: Actual TimeRelation, Valid TimeRelation,
AuditTrail, Event TimeRelation, SecurityByValue, and thousands more.
TimeRelation is activated by table. If you changed a field in Case details that stores data in a separate table
from the table in the parent view, these changes will not be reflected in History. For example, changes made
on the Attachments tab are not reflected in History.
1. The SuperCRM Windows client icon looks like this – double click it to
start administering SuperCRM. (You can use the still-running
SuperCRM if you followed Lesson 2 and did not close SuperCRM. If so,
choose Options…Signon to sign on as a different user.)
1. The SuperCRM Windows icon looks like this – double click the icon to
start SuperCRM via Windows. (Start a second session - leave the
administrator window open, we'll come back to it later).
QuickExport is an EnterpriseTenFold SOA power feature that makes end-user jobs easier. QuickExport and
other query facilities make it easy to create a spreadsheet to satisfy any ad hoc reporting needs.
QuickExport is available in every transaction grid. For even tighter integration with existing Excel
spreadsheets, choose BuildExcel-It from the Action menu to explore how easy it is to create existing-
spreadsheet exports, and you can import too!
18. Click [Close] on Account Details to return to the Accounts screen.
19. Click [Create new account].
20. Click F1 to view OnLineHelp or right-click on the field and select
FieldHelp
21. Click [Close] to close OnLineHelp.
22. Click [Close] to close Account details.
OnLineHelp is available for every transaction and field. Click [F1] and OnLineHelp pops up with help in
context of what you were doing when you clicked F1. End-users get help when and where they need it.
23. From the Tools menu, choose AutoDocument..Menus.
24. Review your applications documentation.
25. In Microsoft Word, choose File..Close.
26. From the Tools menu, choose Exit.
Because EnterpriseTenFold SOA stores the entire applications description in the TenFold Dictionary, that
description is available to generate great documentation. Documentation always precisely matches your
application, since TenFold renders your application from the same description. We call this feature
AutoDocument.
WindowsClient has many other powerful features that every application includes. To learn more about
EnterpriseTenFold SOA capabilities read WindowsClient, AutoDocument, and BuildExcel-It transaction.
Ensure that you chose Exit. Why? Because EnterpriseTenFold SOA logs end-user activity after you sign off
and we want to see end-user activity history and response-time measurements.
If you can avoid programming while increasing quality and providing all the power
features your end-users seek, your IT strategies change dramatically. EnterpriseTenFold
SOA empowers IT to build better applications at 10% of traditional applications
development cost. Further, you can maintain those applications at a fraction of the cost
of traditional maintenance while delivering on every business need.
Remember, EnterpriseTenFold SOA is 100% compatible with .NET and J2EE web
services and supports all Enterprise Service Bus technologies.
EntepriseTenFold SOA avoids programming and, instead, lets you describe services
and applications features. Once described, you do Try-it-Improve-it until your business
people are delighted. We call this process XRAD (Extremely Rapid Applications
Development). XRAD lets you build a working, tested, usable application in less time
During Lesson 3, we walk through application changes in minutes that would take
weeks or months with traditional programming approaches. Using TenFoldTools you:
1. Double click the EnterpriseTenFold SOA icon. (If you are using Personal Edition
your icon reads Personal Edition)
Your transaction is fully functional. In the first step you built a screen that reads data from the
ContactAdresss table. In the next step, we use the data from this screen to display a map.
6. Prompt = Map
7. Invisible = <checked>
8. Transaction=SCRMMap
9. Brief help = View address with Google maps
10. Click [Save].
11. Click [Close].
At this point, you created a new menu entry on the Sales responsibility and attached the transaction you
just built to that menu entry, however, it is invisible. In Step 4, you will add a zoom to link your application
to your new transaction.
Step 4 – Add a zoom from contact address to cleverly invoke your new transaction
2. Click [Query].
3. Transaction name = SCRMContacts
4. Click [Run query].
5. Choose ContactAddressMain from the Layout region.
6. Click the Fields tab.
7. Right click on the field with prompt ‘<No prompt>
ContactAddressMap’.
8. Click [Edit field details].
9. Click Advanced tab.
10. Delete pop-up map from Prompt field (In ActionCorner region)
and press <Tab>.
11. Add Prompt = Pop-up map
12. Zoom to Transaction = SCRMMap
13. Run with one click = <checked>
14. Copy from field = ContactAddressID
15. Copy to field = ContactAddressID
16. Copy direction = BothWays
17. Click [Save and return].
18. Click [Save].
The BuilderWorkbench displays applications objects that you changed most recently. You can see your
SCRMMap transaction here. Click once on the transaction and you are ready to edit it.
Applications developers love BuilderWorkbench because it automatically references pretty much anything
you wish to work on by remembering your prior activities.
In this scenario, business users need SuperCRM to store the planned date for new
solutions. In this step, we add Planned date to the solutions database table and
automatically propagate that change to already-working transactions.
2. User name = IT
10. Password = IT
11. From the WelcomeMenu, choose DesignDatabase.
12. Click the SCRMCustomerContact group tab.
13. Choose the SCRMSolution table.
14. Click the Columns Tab.
15. Click in the first available row (just after LastUpdatingProcess), or
click [New].
16. Column = PlannedDate
17. Data type = Date
18. Region = Solution
19. Click [Save].
20. Right click or choose the ActionCorner on PlannedDate column
name and choose AddFields.
Summary
You have experienced a unique technology, EnterpriseTenFold SOA, which used a
model-driven approach to render and publish SuperCRM from its description. You also
made several changes to the SuperCRM application by modifying its description
without writing or compiling code.
SuperCRM used a Microsoft MapPoint Web Service that you changed to GoogleMaps, a
different type of web-based applications service. EnterpriseTenFold SOA can connect to
any service without coding. That’s not all. Without code, you can also expose any part
of a TenFold-powered application as a Web Service.
With EnterpriseTenFold SOA, you avoid writing code and build better applications 90%
faster on your first project. Once you complete an application, EnterpriseTenFold SOA
makes it easy to go into production, manage your application, support your end-users,
and change the application as your business changes.