creatorextension/com.nokia.s60tools.creator.help/html/tasks/adding_components.htm
author Matti Hagman <ext-matti.hagman@nokia.com>
Wed, 15 Sep 2010 17:28:26 +0300
changeset 25 eb17a7f7f320
parent 0 61163b28edca
permissions -rw-r--r--
Creator Carbide Extension 1.3.0
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     2
<html>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     3
<head>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     4
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     5
<title>Adding components</title>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     6
<link href="../../book.css" type="text/css" rel="stylesheet">
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     7
</head>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     8
<body>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     9
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    10
<h2>Adding components</h2>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    11
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    12
<h5>Before you start</h5>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    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>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    14
<ul>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    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>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    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>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    17
</ul>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    18
<p>To add components to the script, follow these basic steps: </p>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    19
<ol>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    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>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    21
<li>Click <b>Add</b>. <p>The dialog for the selected component type is displayed.</p></li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    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
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    23
is created by default. </p></li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    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>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    25
<li>To enter the component values, do any of the following:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    26
<ul>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    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>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    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">
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    29
<ul>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    30
<li><b>Edit mode</b>: User can edit the field data</li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    31
<li><b>Random &ndash; Default length</b>: Random data, default length</li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    32
<li><b>Random &ndash; Custom length:</b> Random data, user edits the data length</li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    33
<li><b>Random &ndash; Max length:</b> Random data, maximum length for the data</li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    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>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    35
</ul>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    36
</li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    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>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    38
</ul>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    39
</li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    40
<li>To save the script, select <b>File > Save</b>. </li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    41
</ol>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    42
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    43
<h5>Useful to know</h5>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    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>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    45
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    46
<h5>Related tasks</h5>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    47
<ul>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    48
<li><a href="modifying_components.htm">Modifying components</a></li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    49
</ul>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    50
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    51
<h5>Related references</h5>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    52
<ul>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    53
<li><a href="../reference/generic_items.htm">Generic component reference</a></li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    54
<li><a href="../reference/contacts.htm">Contact components</a></li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    55
<li><a href="../reference/messages.htm">Message components</a></li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    56
<li><a href="../reference/calendar.htm">Calendar components</a></li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    57
</ul>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    58
25
eb17a7f7f320 Creator Carbide Extension 1.3.0
Matti Hagman <ext-matti.hagman@nokia.com>
parents: 0
diff changeset
    59
<div id="footer">Copyright &copy; 2007-2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. 
0
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    60
License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>.</div>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    61
</body>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    62
</html>