creatorextension/com.nokia.s60tools.creator.help/html/tasks/adding_components.htm
changeset 0 61163b28edca
child 25 eb17a7f7f320
equal deleted inserted replaced
-1:000000000000 0:61163b28edca
       
     1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
       
     2 <html>
       
     3 <head>
       
     4 <meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
       
     5 <title>Adding components</title>
       
     6 <link href="../../book.css" type="text/css" rel="stylesheet">
       
     7 </head>
       
     8 <body>
       
     9 
       
    10 <h2>Adding components</h2>
       
    11 
       
    12 <h5>Before you start</h5>
       
    13 <p>In general, you can add as many components (for example, contacts, messages, to-dos, appointments and so on) to the script as needed. Note the following things: </p>
       
    14 <ul>
       
    15 <li>Working with contact sets is a special case compared to other component items. For more information, see <a href="../concepts/contact_set.htm">Contact set</a>. </li>
       
    16 <li>Selecting random values for component items can save you a lot of time in the creation of the script. For a description, see <a href="../concepts/components.htm#random">Random component values</a>.</li>
       
    17 </ul>
       
    18 <p>To add components to the script, follow these basic steps: </p>
       
    19 <ol>
       
    20 <li>From the <b>Select component to add</b> list box, select the item of your choice. <p></p><p><img src="screenshots\adding_comp.png"></p></li>
       
    21 <li>Click <b>Add</b>. <p>The dialog for the selected component type is displayed.</p></li>
       
    22 <li>In the <b>Amount</b> field, type in the amount of entries you want to create of this component type. <p>If you leave this field empty, one entry
       
    23 is created by default. </p></li>
       
    24 <li>(Optional), add new contact set by clicking the <b>Add new Contact-set</b> button. <p><b>Note:</b> Dialogs for components that can have reference to Contact-set has this button for creating Contact-Sets. Those components are: Contact, Messages (SMS, MMS, AMS, Email, Smart Message, IR message, BT message), Appointment, and Contact Group.</p></li>
       
    25 <li>To enter the component values, do any of the following:
       
    26 <ul>
       
    27 <li>Enter the values of your choice in the <b>Item value</b> field, and how many of these items should be created in the <b>Amount</b> field. <p><b>Note:</b> When filling in the values manually, follow the instructions in the dialogs to enter the data in correct format. </p></li>
       
    28 <li><p>The length of an entry for random values can be selected from the <b>Mode</b> drop-down list as follows: </p><img src="screenshots\mode1.png">
       
    29 <ul>
       
    30 <li><b>Edit mode</b>: User can edit the field data</li>
       
    31 <li><b>Random &ndash; Default length</b>: Random data, default length</li>
       
    32 <li><b>Random &ndash; Custom length:</b> Random data, user edits the data length</li>
       
    33 <li><b>Random &ndash; Max length:</b> Random data, maximum length for the data</li>
       
    34 <li><b>Increase for each copy:</b> applied only with phone number fields in contacts, messages and logs. This mode is used together with the "amount" attribute. When the Increase for each copy mode is selected, phone number will increase for each copy of component created. For example, if phone number "12300" is given, the first copy will have phone number "123000", and the second copy will have "12301", third "12302" and so on. If the Amount attribute of Phone number is used, each copy will have a different phone number.</li>
       
    35 </ul>
       
    36 </li>
       
    37 <li>Generate random values for all items at once: select either <b>Default</b> or <b>Max</b>, and click <b>Set random</b>.<p><img src="screenshots\random_.png"></p></li>
       
    38 </ul>
       
    39 </li>
       
    40 <li>To save the script, select <b>File > Save</b>. </li>
       
    41 </ol>
       
    42 
       
    43 <h5>Useful to know</h5>
       
    44 <p>The <i>.creatorxml</i> file is used as input for the S60 Creator tool that works on an S60 device or an emulator. You can transfer the Creator file into the device in the same way as any other file, for example, via a USB cable or a Bluetooth connection. On the device, the default location of the file is in <i>c:\data</i>, or at the root of the memory card. </p>
       
    45 
       
    46 <h5>Related tasks</h5>
       
    47 <ul>
       
    48 <li><a href="modifying_components.htm">Modifying components</a></li>
       
    49 </ul>
       
    50 
       
    51 <h5>Related references</h5>
       
    52 <ul>
       
    53 <li><a href="../reference/generic_items.htm">Generic component reference</a></li>
       
    54 <li><a href="../reference/contacts.htm">Contact components</a></li>
       
    55 <li><a href="../reference/messages.htm">Message components</a></li>
       
    56 <li><a href="../reference/calendar.htm">Calendar components</a></li>
       
    57 </ul>
       
    58 
       
    59 <div id="footer">Copyright &copy; 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. 
       
    60 License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>.</div>
       
    61 </body>
       
    62 </html>