Getting Started

Below are the 4 major Sentence (or “Entry”) types. To create these types of entries, go to the Main Menu, and click on Developer Center. Pick a template that seems to correspond to what you desire to accomplish. Below is specific information on entering the 4 main types of entries in their simpler forms.

CS – (Complete Sentence or Concatenated Sentence) 

COMPLETE SENTENCES:

Complete sentences have no variables nor special selectors, therefore can easily be imported via Excel or files with tables, or can be entered using Template #1 in the Developer Center. These complete sentences will show up on exports such as talent recording scripts, database studies, and auto-generated code if desired.

CS AS CONCATENATED SENTENCE

This CS contain variables such as dates, times, telephone numbers, and other numbers that are not associated with plurals. In this CS, there is only one sentence that is not multiple choice (e.g. menu) nor is associated with a singular/plural that is multiple choice based upon numeric value.

DO NOT USE CS TEMPLATES FOR:
<numberBefNoun> (numbers that appear before a noun create singular/plural, also do not use for ordinals e.g. first, second, third)
If entry is <numberBefNoun> dependent, use Singular/Plural Template for PLURAL. Example: You have <numberBefNoun> message/s
For entries with multiple lines (or “multiple choice”) use Template for CV. Example: menus with different associated selectors for each option.

BASICS:
Each sentence must be stand-alone, each prompt with an associated prompt name.
No prompt can cover multiple rows. If a prompt contains multiple lines, place all lines within same cell. Alternatively, replace Return characters with backslash \ and the software will create returns for you for all purposes.
Prompts may contain any variable listed below except <numberBefNoun>, because <numberBefNoun> designates a singular/plural construction.

======================COLUMNS===================%%%%%
LANGUAGE
CS_NAME    e.g. StaticPrompt1
CS_KEYWORD    (2nd related name, 25 chars or less, no spaces, e.g. Welcome1)
CS_CONCEPT    (overall idea, e.g. Welcome prompt)
MASTER_NOTES    Here notes to translator to clarify use and meaning.
==================================================’%%%%%

ACCEPTABLE VARIABLES FOR CS BELOW:

NUMBERS
<numberTelephone> (local or long distance telephone number. How this plays will vary with the programming of the system and the country)
<numberAftNounDoubleDigit> (a number that generally appears after a noun and would be spoken as 42 not 4-2 e.g. Message 42)
<numberAftNounDigitByDigit> (a number absolutely spoken digit by digit, such as serial number. Careful! Do not impose your culture on others. A telephone number, for example, is not spoken digit by digit around the world.)

PASS THROUGHS
<Spoken_Name> (applies only to persons, never names of lists or directories, etc)
<List_Name>

C.V.s (CRITERIA VARIABLES, AKA MULTIPLE-CHOICE)
<reflMONTH>
<reflDOM>
<reflDOW>
Others available upon request, such as <LanguageNames>

NUMBERS
The way the following are spoken varies around the world. Available to the system only upon request and initiation:
<numberExtension>
<numberRoom>
<numberStreet>
<numberStreetName> e.g. 195th Street

DATES (SEE DATES LEGEND)
<onDateWDowMDo>
<onDateNoDowMDo>
<onDateWDowYrMDo>
<onDateNoDowYrMDo>

<isDateWDowMDo>
<isDateNoDowMDo>
<isDateWDowYrMDo>
<isDateNoDowYrMDo>

<onDateWDowMDn>
<onDateNoDowMDn>
<onDateWDowYrMDn>
<onDateNoDowYrMDn>

<isDateWDowMDn>
<isDateNoDowMDn>
<isDateWDowYrMDn>
<isDateNoDowYrMDn>

<onDateWDowMDto>
<onDateNoDowMDto>
<onDateWDowYrMDto>
<onDateNoDowYrMDto>

<isDateWDowMDto>
<isDateNoDowMDto>
<isDateWDowYrMDto>
<isDateNoDowYrMDto>

<onDateWDowDMo>
<onDateNoDowYrDMo>
<onDateWDowYrDMo>
<onDateNoDowYrDMo>

<isDateWDowDMo>
<isDateNoDowDMo>
<isDateWDowYrDMo>
<isDateNoDowYrDMo>

<atTimeAmPm>
<atTime24Hr>
<isTimeAmPm>
<isTime24Hr>

<fromTimeAmPm>
<fromTime24Hr>
<toTimeAmPm>
<toTime24Hr>

Other formats available

PLCCAT – PLURAL CONCATENATED SENTENCES

Example: You have <#> messages. Plural Template applies only to PLURAL concatenated sentences in which the number of an item determines which version of the sentence will display or play. The number variable of this nature is represented as <numberBefNoun> (number before a noun). Example: <3> messages. Other types of numbers may appear in these entries, as well, but at least one <numberBefNoun> must appear for this entry to be called a “PLURAL SENTENCE”.
This document is programmed to import correctly. Do not convert to Excel.
Only 1 plural concatenated sentence per file.
Some of the below seem different than ordinarily expected. The software will split and organize each sentence.

RULES:
All variables must match approved variables exactly, no deviation. To add new variables email: support@InternationalServices.com

Only numeric variable values are accepted in Selector 1 column. For non-numeric variables use Selectors 2, 3 or 4.

Acceptable math examples:

NUMBER=5 (exact number)
NUMBER=5-8    (5 through 8 inclusive)
Advanced math available through other templates.

================= COLUMNS=================%%%%%
LANGUAGE
ENTRY_NAME    MSG500
PLURAL_KEYWORD    KeywordForThisSentence
PLURAL_CONCEPT    Short clarification of this sentence
MASTER_NOTES    Here notes to translator to clarify use and meaning.
=======================================================%%%%%

[NUMBER=0]
Insert here what should play if the number is zero, or blank if n/a. No variable insertions allowed for [NUMBER=0]. And because there is no variable, insert the placeholder <numberDefiningOnly> that informs the system that this line is part of a PLURAL construction. With <numberDefiningOnly>, a number will not be inserted at runtime, rather <numberDefiningOnly> influences the proper creation of localized code. e.g.

You have no messages. <numberDefiningOnly>
or
You have five messages. <numberDefiningOnly>

[NUMBER=1]
Insert what should play if number is 1. Choice of approach:
Option #1:
You have one message. <numberDefiningOnly>
Will play as <You have one message>
or
Option #2:
You have <numberBefNoun> message.
Will play as <You have><one><message>

If there are 2 <numberBefNoun> variables, include only the singular of each. e.g.
Option #1:
You have one message and <numberDefiningOnly> one fax <numberDefiningOnly>.

Result: <You have one message and … one fax (or <two><faxes>)
or
Option #2:
You have <numberBefNoun> message and <numberBefNoun> fax.
Result: <You have><one><message and> <one> <fax>

For most natural results, the software will include the “and” with prompt #1. For the few languages that would need the “and” to coordinate with the second half, there is another command available.

[NUMBER=OTHER]
Insert what should play if number is not 1 and not 0.
You have <numberBefNoun> message.
Result: <You have><two><messages>

If there are 2 <numberBefNoun> variables, include only the plural of each. e.g.

You have <numberBefNoun> message and <numberBefNoun> faxes.
Result: <You have><two><messages and><two><faxes> (or <one><fax>)

For most natural results, the software will include the “and” with prompt #1. For the few languages that would need the “and” to coordinate with the second half, there is another command available.

CV – CRITERIA VARIABLE SENTENCES

Example: Menus, option lists, prompts selected by criteria (alpha or numeric).

These templates apply to lists of possible results, one or more of which will be selected at runtime based upon alpha or numeric criteria. Use as many choices as desired. No limitations. The programmer of the application is responsible for setting the criteria.

RULES:
All variables must match approved variables exactly, no deviation. To add new variables email: support@InternationalServices.com
Add as many rows as you like, in any order, but if there is a [default], must be last on the list.

Acceptable math examples for use in selector:
5 (exact match)
5-8    (5 through 8 inclusive)
!N=2    (any number that is not 2)
Advanced math available.

Can contain any variable EXCEPT <numberBefNoun>

IMPORTANT: Note that whereas Selector 1 numeric values in plurals are “NUMBER=”, with Criteria Variables, numeric values have no “NUMBER=”.

======================COLUMNS===================%%%%%
LANGUAGE
CV_NAME    e.g. MENU44
CV_KEYWORD    (2nd related name, 25 chars or less, no spaces, e.g. MainMenuOper)
CV_CONCEPT    (overall idea, e.g. Operator’s menu list)
MASTER_NOTES    Here notes to translator to clarify use and meaning.
==================================================’%%%%%

[0]
(insert what should play if the number is zero, can contain any variable EXCEPT <numberBefNoun>

[1]
(insert what should play if number is 1, can contain any variable EXCEPT <numberBefNoun>

[5]   Selector 2 example: [french]
(insert what should play if the letters f-r-e-n-c-h are the result, or french is the language chosen.
Any row can contain return characters.

[default]
Programmers may desire to use default, to initiate if none of the above are selected

COLUMNS (FIELDS) AVAILABLE TO DEVELOPERS

Many other columns are available for use with a variety of purposes.

Selector 1: the major numeric selector field.

Selector 2: the main text selector field (alpha-numeric)

Selector 3: additional alpha-numeric filter

Selector 4: additional alpha-numeric filter

Text Entry: this is the main field expected to hold the appropriate text or voice prompt content.

Web Text: a field for text that may correspond to web text and is related to the Text Entry that may, for example, be used for voice prompts.

Screen text: Text that is expected to appear on a computer screen or monitor and is related in some way to the Text Entry text.

Min/Max: optional minimum/maximum length. Often used in translated software interfaces and limiting character length. Can also be used by developers to set requirements for user response lengths and similar. Example: 2:10 where a minimum of 2 characters is required, maximum of 10. Other examples: :5 (max 5), 5: (min 5).

GCResult: GC result can actually contain code or results or other engineering type data that the developer’s code will use to determine a reaction. For a web application, and example could be:

[1] For French, press here.

GCResult field: index_French.html   In this case, the code could have been pre-prepared to forward the user to whatever page is found in the GCResult field.

Defining Variable: The defining variable is the variable that determines whether a particular row will be selected or not at runtime. The defining variable is associated with Selector 1 above. The other selectors 2,3,4 are used as filters for further refining.

Plural Build: the plural build will generally be auto-assigned by the software and helps developers understand the function of individual rows in a plural construction. PluralBuild_0 means that this line or entry is associated when there is 0 of the value being passed, such as “You have no message in your inbox”.

Image: Images can be assigned to each row of an entry. So, one sentence (entry) can have a different picture for each row, if desired. Images are used either for the translators to view and clarify the subject of the translation, or image data can be used by the developers to determine what picture will display on the web or handheld at that point in the application. From this position, images can also be localized or changed for the translation language.

Movies: Movies can also be assigned to each row of an entry. So, one sentence (entry) can have a different movie for each row, if desired. Movies are used either for the translators to view and clarify the subject of the translation, or movie data can be used by the developers to determine what movie will display on the web or handheld at that point in the application. From this position, movies can also be localized or changed for the translation language.

Audio: The software can be used to test audio files such as voice prompts or used to assign audio that will be played at that point in the code.

Master notes: Developers can insert notes for the translators or general notes regarding the entry.

Translator notes: Translators can also leave notes.

There are a more fields that apply to the higher level Templates.