Pathagoras Help System

Creating *Alias* Lists

Creating *Alias* Lists

Previous topic Next topic No directory for this topic  

Creating *Alias* Lists

Previous topic Next topic Topic directory requires JavaScript JavaScript is required for the print function Mail us feedback on this topic!  

Creating/Augmenting MultiChoice *Lists*

   To assign, augment, edit, delete or otherwise modify a MultiChoice *List*:

1.Click the Pathagoras drop down features menu.
2.Click 'Editing Tools'.
3.Select the *Alias* element from the sub-list. You will see this screen:

 

Click to Reduce
The Alias editing screen

(accessed through the entry titled Editing Tools|MultiChoice *Lists* in the Pathagoras Features Menu).

 The following bullets describe the action of the three options presented in the upper left corner of the screen:

The 'Edit/Add' option:

   When you click Next>>, Pathagoras will take you to a screen like the following:

 

Click to Reduce
The List of Aliases

 

  This table contains all of your current *Aliases*. Select the Alias you wish to edit.

  To add a new variable and an associated list of choices, click Add New *Variable*. The screen will expand, providing you room to type the variable name and the list.

Click to expand.

1. Click 'Add New *Variable*
2.Type name of new *variable*
3. Type list of choices, separating each with a '/' (slash).
4. Click Add/Save to complete action.

 When you have finished adding new variables, close the screen.

The "Quick Add" option:  You can add a list (typically a short list, since you will be manually typing the entries) of multiple choices directly from the keyboard. When you select the Quick Add option and press Next>>, Pathagoras will ask you for the name you want to assign to the variable and then ask you to type up to 10 choices that you want the variable to represent. When done, click OK and Pathagoras will save the choices into your MultiChoice *List* collection.
The "Add prepared 'on-screen' list" option: Pathagoras can add several kinds of 'prepared lists'.
Before starting, type a simple list of terms onto your editing screen. Separate each term by a slash ('/').

E.g. red/green/purple/orange/navy blue/light blue/burnt orange/pink/chartreuse
 
After your list is prepared, highlight the collection of terms. (You have to tell Pathagoras what section of your on-screen document you want to add). Display the MultiChoice screen and select the "Add prepared 'on-screen' list" option. Press Next. Pathagoras will ask you for the alias you want to assign to the choices. It will then save the list in your MultiChoice *List* file.

A table of terms, with the top row reflecting the aliases

shareholder

number of shares

price

Robert Jones

100

10

Samantha Peters

200

15.50

Andrea Munoz

200

16

A table of terms, with the left-most column reflecting the aliases

shareholder

Robert Jones

Samantha Peters

Andrea Munoz

number of shares

100

200

200

price

10

15.50

16

One of Pathagoras multi-dimentional Cascading Options Charts (discussed elsewhere).

 

With regard to any of the above  'tables' options, make sure your cursor is inside the table before trying to 'Add prepared 'on-screen' list'.


   Regardless of which of the above techniques you used to create your *Lists*, when you insert your *listname* into a document, the terms in your list will appear when you run an Instant Database or GotForms? scan, or process a document when the *List* is presented as an options block via: {*listname*} or <<*Options**listname*>>.

 

  information'Natural slashes': Let's say your MultiChoice *List* text will contain 'natural slashes'.  Perhaps you want to present the end users with a series of dates in the format 00/00/0000 from which to choose or  an address contains an unavoidable 'slash'. You must use '/OR' as the separator between choices.(e.g., "01/28/1953/OR07/07/1988/OR6/22/99"). You must check the 'Use /OR' switch found in the Instant Database settings screen (Utilities/Settings|All Settings|Instant Database).

Visual Depictions of a *List* in action.

   Just in case you haven’t tried any of the above examples on your own computer, but you would like a quick peek at the [*states*] Multichoice *Lists*, here is a ‘look-see’ of what the results would be:

 

Click to Reduce
 Instant Database display of the [*states*] variable list.

Note also the Multi-choice possibilities at the bottom of the screen.
You can select one, some or all of the list elements.
You can also indicate the separator, if any.

 

   Here is the rendition of [*states*] in the GotForms? module:

 

multichoice4

Figure 4. GotForms? rendition of the Multichoice variable list "*states*".

   Only the first five elements in the list will show on buttons. To show more, click the “Next 5>>” button. To insert a choice, just click on a button.

 

   The use of MultiChoice *Lists* with Options is particularly useful when a fluctuating number of variables needs to be brought into the document under construction. For example, in a Will, there might be several children, and a variable (e.g., [Name and Birthday of ChildX]) needs to be provided for each child. You could create a MultiChoice *List* called "children" and the values in the list might be:

[first child]/[first child] and [second child]/[first child], [second child] and [third child]/[first child], [second child], [third child] and [fourth child]/[first child], [second child], [third child], [fourth child] and [fifth child]/[first child], [second child], [third child], [fourth child], [fifth child] and [sixth child]

   Here is how the above might render when {*children*} is encountered during document assembly. (The same result would obtain using <<*Options**children*>>).

 

Click to enlarge.

Figure 5. {*Children*} /<<*Options**Children*>> rendition in Pathagoras' options module.

 

Can I create Addresses (or other multi-line) MultiChoice items?

Yes. Pathagoras handles multi-line items without a problem. If you plan to use the MultiChoice list in an Instant Database screen (which does not allow true 'Enters', you must represent 'Enter' with "<P>". Pathagoras will 'decode' the <P>s at replacement time. See <P>aragraph Functions

E.g,:

Big Store<P>123 Main Street<P>Anytown, PA 23454/Little Store<P>324 Oak Lane<P>My Town, VA 43234/etc.

 

Can I create a *List* from an existing external database?

Yes. See this page. This is a really 'cool' tool.

 

tipA final way to add a new *List* to your collection exists. Let's assume that you have a reference to a [*list* variable] in your source document. That *List*  does not currently exist in your Multichoice *List* collection.  If you process the form with an Instant Database call, Pathagoras will notify you that the [*list* variable] does not exist and offer you the opportunity to create it on the fly. This is not a 'best practice' way to add to your collection, but it definitely works.