aboutsummaryrefslogtreecommitdiffstats
path: root/help/C/usage-contact.sgml
blob: aff3da93fee8194ee068bf497e103665b714bfdf (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
<!--
<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN">
-->
<chapter id="usage-contact">
  <title>Working with Your Contacts</title>
      <para>
        This chapter will show you how to use the
        <application>Evolution</application> addressbook to organize
        any amount of contact information, share addresses over a
        network, and several ways to save time with everyday tasks. To
        learn about configuring the addressbook, see <xref
        linkend="config-prefs-contact">. You can import contacts from
        other contact management tools with the Import tool by
        selecting
        <menuchoice><guimenu>File</guimenu><guimenuitem>Import</guimenuitem></menuchoice>,
        or by mailing them to yourself as vCard attachments.
      </para>

    <para>
       The toolbar for the addressbook is quite simple.
       <itemizedlist>
    <listitem><para>
      Click <guibutton>New Contact</guibutton> to create a new card, or double-click 
      in a blank space in the contact list. 
    </para></listitem>

    <listitem><para>
           Click <guibutton>New List</guibutton> to create a new card, or double-click 
           in a blank space in the contact list. 
    </para></listitem>

    <listitem><para> The <guiicon>printer</guiicon> icon sends one
        or more of your cards to the printer.  </para></listitem>

        <listitem><para> The <guiicon>stop sign</guiicon> icon stops loading
           contact data from the network.  This button is only
           relevant if you are looking at contact information on a
           network.  </para></listitem>
      </itemizedlist>
    </para>

    <para>
       Your contact information fills the rest of the display.  Move
       through the cards alphabetically with the buttons and the
       scrollbar to the right of the window. Of course, if you have
       more than a few people listed, you'll want some way of finding
       them more quickly, which is why there's a search feature.
    </para>

  <sect1 id="usage-contact-cards">
    <title>The Contact Editor</title>
    <para>
      To delete a contact:
      <orderedlist numeration="arabic">
    <listitem>
      <para>
        Click once on the contact.
      </para>
    </listitem>
    <listitem>
      <para>
        Press the <guibutton>Delete</guibutton> button.
      </para>
    </listitem>
      </orderedlist>
    </para>
    <para>
       If you want to add or change cards, you'll use the contact
       editor.  To change a card that already exists, double click on
       it to open the contact editor window.  If you want to create a new
       card, clicking the <guibutton>New</guibutton> button in the
       toolbar will open the same window, with blank entry boxes for
       you to fill in.
    </para>
    
    <para>
      The contact editor window has two tabs,
      <guilabel>General</guilabel>, for basic contact information, and
      <guilabel>Details</guilabel>, for a more specific description of
      the person.  In addition, it contains a <guimenu>File</guimenu>
      menu and a toolbar with three items: <guilabel>Save and
      Close</guilabel>, <guilabel>Print</guilabel>, and
      <guilabel>Delete</guilabel>.
      </para>
    
    <figure id="usage-contact-editor-fig">
      <title>Evolution Contact Editor</title>
      <screenshot>
    <screeninfo>Evolution Contact Editor</screeninfo>
    <mediaobject><imageobject><imagedata
    fileref="figures/contact-editor" format="png" srccredit="Aaron
    Weber">
    </imageobject></mediaobject>
      </screenshot>
    </figure>
    
    <para> The <guilabel>General</guilabel> tab has seven sections,
      each with an icon: a face, for name and company; a telephone
      for phone numbers; an envelope for email address; a globe for
      web page address; a house for postal address; a file folder
      for contacts, and a briefcase for categories. 
    </para>
    <para>
     <variablelist>
    
    <varlistentry>
      <term>Full Name</term>
      <listitem>
        <para>
              The <guilabel>Full Name</guilabel> field has two
              major features:
              <itemizedlist>
        <listitem>
          <para>
                    You can enter a name into the <guibutton>Full
                    Name</guibutton> field, but you can also click the
                    <guibutton>Full Name</guibutton> button to bring
                    up a small dialog box with a few text boxes
                    <variablelist>
              <varlistentry>
            <term><guilabel>Title: </guilabel></term>
            <listitem> <para>
                      Enter an honorific or select one from the menu.
                    </para></listitem>
              </varlistentry>
              <varlistentry>
            <term><guilabel>First: </guilabel></term>
            <listitem> <para>
                    Enter the first, or given, name.
             </para></listitem> 
              </varlistentry>
              <varlistentry>
            <term><guilabel>Middle: </guilabel></term>
            <listitem> <para>
              Enter the middle name or initial, if any.
            </para></listitem>
              </varlistentry>
              <varlistentry>
            <term><guilabel>Last: </guilabel></term>
            <listitem> <para>
               Enter the last name (surname).
             </para></listitem>
              </varlistentry>
              <varlistentry>
            <term><guilabel>Suffix: </guilabel></term>
            <listitem> <para>
               Enter suffixes such as "Jr." or "III."
            </para></listitem>
              </varlistentry>
            </variablelist>
                   </para>
        </listitem>
          </itemizedlist>
          </para>
        <para>
          The <guilabel>Full Name</guilabel> field also
          interacts with the <guilabel>File As</guilabel>
          box to help you organize your contacts.
        </para>
        <para>
          To see how it works, type a name in the
          <guilabel>Full Name</guilabel> field. As an example,
          we'll use the Ximian mascot, <userinput>Rupert
          T. Monkey</userinput>.  You'll notice that the
          <guilabel>File As</guilabel> field also fills in,
          but in reverse: <computeroutput>Monkey,
          Rupert</computeroutput>.  You can pick
          <computeroutput>Rupert Monkey </computeroutput> from
          the drop-down, or type in your own, such as
          <userinput> T. Rupert Monkey </userinput>.
        </para>
        <tip>
          <title>Filing Suggestion</title>
          <para>
         Don't enter something entirely different from the
         actual name, since you might forget that you've filed
         Rupert's information under "F" for "Fictitious Ximian
         Employee."
              </para>
        </tip>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>Multiple Values for Fields:</term>
            <listitem>
          <para>
                If you click on the downward pointing triangle buttons
                next to the <guilabel>Primary Email</guilabel> field,
                you can also choose <guilabel>Email 2</guilabel> and
                <guilabel>Email 3</guilabel>.  Although the contact
                editor will only display one of those at any given
                time, <application>Evolution</application> will store
                them all.  Entries that have information in them have
                a check mark next to them.  The buttons next to the
                telephone and postal address fields work in the same
                way.
              </para>
          </listitem>
    </varlistentry>
      </variablelist>
     </para>
     <para>
      The last item in the <guilabel>General</guilabel> tab is the
       <guilabel>Categories</guilabel> organization tool; for
       information on that, read <xref
       linkend="usage-contact-organize">.
     </para>
     <para>
       The <guilabel>Details</guilabel> tab is much simpler:
      <itemizedlist>
    <listitem>
      <para>
        The briefcase - Describes the person's professional life
      </para>
    </listitem>
    <listitem>
      <para>
        The face - Describes the person's personal life
      </para>
    </listitem>
    <listitem>
      <para>
        The globe - Miscellanious notes
      </para>
    </listitem>
      </itemizedlist>

      <tip>
    <title>Contact Shortcuts</title>
    <para>
      You can add cards from within an email message or calendar
      appointment.  While looking at an email, right-click on
      any email address or message, and choose
      <guimenuitem>Create Card for this Address</guimenuitem> or
      <guimenuitem>Create Card for this Sender</guimenuitem>
      from the menu.
    </para>
      </tip>
    </para>
  </sect1>

  <sect1 id="contact-search">
    <title>Searching for Contacts</title>
    <para>
      <application>Evolution</application> allows searching through contacts
      quickly and easily.
    </para>
    <para>
      To search through contacts:
      <orderedlist numeration="arabic">
    <listitem>
      <para>
        Select your search focus in the search bar.
      </para>
    </listitem>
    <listitem>
      <para>
        Enter your query.
      </para>
    </listitem>
    <listitem>
      <para>
        Press return to search.
      </para>
    </listitem>
      </orderedlist>
    </para>
    <para>
      You can refine searches by doing several in
      succession, or start over by pressing the <guibutton>Show
    All</guibutton> button.
    </para>
    <para>
      If there are no matches, the card display will be
      blank. When you'd like to see all the cards again, press
      <guilabel>Show All</guilabel>.
    </para>
    <example id="contact-quicksearch-ex">
      <title>Refining a Quick Search</title>
      <para>
    Tom comes back from lunch and finds a note on his
    keyboard: "Curtis in sales called for you, but he didn't
    leave a number, and I forgot to write down the name of the
    company he works for. He said it was important, though."
    Tom is not at all annoyed.
      </para>
      <para>
    He opens his contacts folder, and runs a quick search for
    "Curtis." There are eighteen different people with that name
    in the file. He then enters "Sales," and
    <application>Evolution</application> narrows it down to the
    right Curtis. He only becomes annoyed when he discovers that
    the call was not actually important.
      </para>
    </example>
    
    <para>
      To perform a complex search through your contacts:
      <orderedlist numeration="arabic">
    <listitem>
      <para>
        Open
        <menuchoice>
          <guimenu>Tools</guimenu>
          <guimenuitem>Search for contacts</guimenuitem>
        </menuchoice>
      </para>
    </listitem>
    <listitem>
      <para>
        Name the rule in the <guilabel>Rule Name</guilabel> field.
      </para>
    </listitem>
    <listitem>
      <para>
        Setup your criteria information in the <guilabel>If</guilabel> section.
      </para>
    </listitem>
    <listitem>
      <para>
        If you want to add more critera, click the <guibutton>Add
        Criterion</guibutton> button.
      </para>
    </listitem>
    <listitem>
      <para>
        Click <guibutton>Search</guibutton>.
      </para>
    </listitem>
      </orderedlist>
    </para>
    <para>
      To show all your contacts, select <guibutton>Show All</guibutton> in the
      <guilabel>Search Bar</guilabel> or search with an empty query.
    </para>

  </sect1>

  <sect1 id="usage-contact-organize">
    <title>Organizing your Addressbook</title>
    <para>
       Organizing your addressbook is a lot like organizing your
       mail.  You can have folders and searches the same way you can
       with mail, but the addressbook does not allow Virtual Folders.  It
       does, however, allow each card to fall under several
       categories, and allow you to create your own categories.  To
       learn about categories, read <xref
       linkend="usage-contact-organize-group-category">.
    </para>

<!-- UNIMPLEMENTED FEATURE
    <para>
      Another useful <application>Evolution</application> feature is
      its ability to recognize when people live or work together.  If
      several people in your addressbook share an address, and you
      change the address for one of them,
      <application>Evolution</application> will ask you if you wish to
      change the address for all of them, or just for one.
    </para>
-->

    <sect2 id="usage-contact-organize-group">
      <title>Groups of contacts</title>
      <para>
         <application>Evolution</application> offers two ways for you
         to organize your cards.  The first way is to use folders;
         this works the same way mail folders do.  For more
         flexibility, you can also mark contacts as elements of
         different categories.  To better integrate with email tools,
         you can also create lists of contacts that you can send mail
         to as a single person.
      </para>

      <sect3 id="usage-contact-organize-group-folder">
    <title>Grouping with Folders</title>
    <para>
       The simplest way to group address cards is to use folders.
       By default, cards start in the
       <guilabel>Contacts</guilabel> folder.  If you've read <xref
       linkend="usage-mainwindow"> then you already know that you
       can create a new folder by selecting 
           <menuchoice>
           <guimenu>File</guimenu>
       <guisubmenu>New</guisubmenu>
       <guimenuitem>Folder</guimenuitem>
           </menuchoice>
           and that you can put new folders anywhere you like. Just
       like with mail, cards must be in a card folder, and no card
       can be in two places at once.  If you want more
       flexibility, try <xref
       linkend="usage-contact-organize-group-category">.
     </para>
    <para>
          To put a card into a folder, just drag it there from the
          folder view.  Remember that contact cards can only go in
          contact folders, just like mail can only go in mail folders,
          and calendars in calendar folders.
         </para>
      </sect3>
      
      <sect3 id="usage-contact-organize-group-category">
    <title>Grouping with Categories</title>
    <para>
           The other way to group cards is to mark them as belonging
           to different categories.  
           That means that you
           can mark a card as being in several categories or no
           category at all.  For example, I put my friend Matthew's
           card in the "Business" category, because he works with me,
           the "Friends" category, because he's also my friend, and
           the "Frequent" category, because I call him all the time
           and can never remember his phone number.  
        </para>
    <para>
           To mark a card as belonging to a category, click the
           <guibutton>Categories</guibutton> button at the lower
           right.  From the dialog box that appears, you can check as
           many or as few categories as you like.
        </para>

       <!-- Feature Not Implemented
    <para>

           If the master list of categories doesn't suit you, you can
           add your own.  Just enter the new category's name in the
           text box, then click <guibutton>Categories</guibutton> and
           choose <guilabel>Add to Master List</guilabel> in the
           window that appears. 
         </para>
       -->

      </sect3>

      <sect3 id="usage-contact-organize-group-list">
    <title>Creating a List of Contacts</title>
    <para>
           To create a list of contacts:

         <orderedlist numeration="arabic">
        <listitem>
          <para>
                Open the list creation dialog box by clicking the
                <guibutton>New List</guibutton> button or selecting
                 <menuchoice>
          <guimenu>
                     File
                  </guimenu>
          <guisubmenu>
                      New
                   </guisubmenu>
          <guimenuitem>
                     Contact List
                   </guimenuitem>
        </menuchoice>.
               </para>
        </listitem>
        
        <listitem>
          <para>
                Enter a name for the list.
              </para>
        </listitem>
        <listitem>
          <para>
                Enter names or email addresses of contacts, or just
            drag contacts from the main window into the list.
              </para>
        </listitem>

        <listitem>
          <para>
                 Choose whether you would like to hide the email
                 addresses when you send a message to the list.
                 Unless it is a very small list, it is recommended
                 that you leave the addresses hidden.  This is the
                 same thing as using the "Bcc:" feature discussed in
                 <xref linkend="usage-mail-getnsend-send-to-types">.
              </para>
        </listitem>
        
      </orderedlist>
        </para>
    <para>
           When you are done, click <guibutton>OK</guibutton>. The
           list will appear as a contact card, which you can use as
           you would any other. That includes emailing the list to
           another person, and, of course, sending email to the list.
        </para>
    <para>
           To mail the list, open a new email and type the name you
           chose for the list. Ximian Evolution will address the
           message to the entire list when you send it. You can also
           right-click on the list's address card in the Addressbook
           and select <guimenuitem>Send Message to List</guimenuitem>.
        </para>
      </sect3>


    </sect2>
  </sect1>
  
<!-- we need a LDAP server up for me to test this -->
  <sect1 id="usage-contact-sharing">
    <title>Sharing your Cards</title>
    <para>
      The <glossterm linkend="ldap">LDAP</glossterm> protocol was
      created to let users share contact information over a network.
      LDAP allows for users to browse other people's addressbooks, or
      maintain a shared set of contact information for a company or
      department.  This feature comes in handy if you are in a group
      where there are lots of people using the same contacts.  Such an
      example would be the sales department of a company with their
      client list.
    </para>

     <example id="usage-contact-sharing-ex">
    <title>Sharing Address Cards and Calendar Data</title>
      <para>
        Rich wants to schedule a meeting with Company X, so he
        checks the network for the Company X address card so he
        knows whom to call there.  Since his company also shares
        calendars, he then learns that his co-worker Deanna has
        already scheduled a meeting with Company X next Thursday.
        He can either go to the meeting himself or ask Deanna to
        discuss his concerns for him.  Either way, he avoids
        scheduling an extra meeting with Company X. 
     </para>
      </example>

    <para>
       Of course, you don't want to share all of your cards&mdash; why
       overload the network with a list of babysitters or tell
       everyone in the office you're talking to new job prospects?  If
       you keep cards on your own computer, you can decide which items
       you want to make accessible to others.
    </para>
    <para>
       To learn how to add a remote directory to your available
       contact folders, see <xref linkend="config-prefs-contact">.
       Once you have a LDAP connection, the network contacts folder or
       folders will appear inside the <guilabel>External
       Directories</guilabel> folder in the folder bar.  It will work
       exactly like a local folder of cards, with the following
       exceptions:
       <itemizedlist>
      
          <listitem>
        <para>
              Network folders are only available when you are
              connected to the network.  If you use a laptop or have a
              modem connection, you may wish to copy or cache the
              network directory.  You do this by dragging and dropping
              your desired contacts into the local contacts list.
        </para>
      </listitem>
      
          <listitem>
        <para>
              To prevent excess network traffic,
              <application>Evolution</application> will not normally
              load the contents of LDAP folders immediately upon
              opening.  You must click <guilabel>Display
              All</guilabel> before LDAP folder cards will be loaded
              from the network. You can change this behavior in the
              <interface>Contact Preferences</interface> window.
        </para>
      </listitem>
      <listitem>
        <para>
              Your ability to view, change, add, and delete contacts
              depends on the settings of the LDAP server. 
        </para>
      </listitem>
    </itemizedlist>
    </para>
    <sect2 id="usage-contact-sharing-setup">
      <title>Configuring Evolution to use LDAP</title>
      <para>
    For information about setting up
    <application>Evolution</application> to use LDAP, please refer
    to <xref linkend="config-prefs-contact-ldap-add" />
      </para>
    </sect2>
  </sect1>

  <sect1 id="contact-automation-basic">
    <title>Send me a Card: Adding New Cards Quickly</title>
    <para>
      As noted before, when you get information about a person in
      the mail or in a calendar entry, you can add it to an address
      card.  To do so, right click on any email address or email
      message, and select <guimenuitem>Add Address
    Card</guimenuitem> from the menu that appears.
      <application> Evolution</application> can also add cards from a
      hand-held device during HotSync operation.  For more
      information about that, see <xref linkend="usage-sync">.
    </para>
  </sect1>
  
<!-- Unimplemented features:
      <para>
         You can also use the addressbook to print postal addresses
     on mailing labels.  Future versions of
     <application>Evolution</application> will allow you to you
     export a group of cards to a spreadsheet, database, or word
     processor so you can print address labels or prepare large
     mailings.
      </para>
  <para>
    Need a map or directions? Click <guibutton>MapIt</guibutton> from
  within the addressbook, and <application>Evolution</application>
  will map the address for you online.
  </para>
  -->
</chapter>