eudc: Query Form

 
 3.2 Query Form
 ==============
 
 The simplest way to query your directory server is to use the query
 form.  You display the query form with the ‘Query with Form’ menu item
 or by invoking the command ‘M-x eudc-query-form’.  The attribute names
 presented in this form are defined by the ‘eudc-query-form-attributes’
 variable (unless a non-‘nil’ argument is supplied to ‘eudc-query-form’).
 
    Since the different directory protocols to which EUDC interfaces may
 use different names for equivalent attributes, EUDC defines its own set
 of attribute names and a mapping between these names and their
 protocol-specific equivalent through the variable
 ‘eudc-protocol-attributes-translation-alist’.  Names currently defined
 by EUDC are ‘name’, ‘firstname’, ‘email’ and ‘phone’.
 
  -- Variable: eudc-query-form-attributes
      A list of attributes presented in the query form.  Attribute names
      in this list should be either EUDC attribute names or valid
      attribute names.  You can get a list of valid attribute names for
      the current protocol with the ‘List Valid Attribute Names’ menu
      item or the ‘M-x eudc-get-attribute-list’ command.  Defaults to
      ‘name’, ‘email’ and ‘phone’.
 
  -- Command: eudc-query-form get-fields-from-server
      Display a form to query the directory server.  If given a non-‘nil’
      argument the function first queries the server for the existing
      fields and displays a corresponding form.  Not all protocols may
      support a non-‘nil’ argument here.
 
    Since the names of the fields may not be explicit enough or adapted
 to be directly displayed as prompt strings in the form, the variable
 ‘eudc-user-attribute-names-alist’ lets you define more explicit names
 for directory attribute names.  This variable is ignored if
 ‘eudc-use-raw-directory-names’ is non-‘nil’.
 
  -- Variable: eudc-user-attribute-names-alist
      This is an alist of user-defined names for the directory attributes
      used in query/response forms.  Prompt strings for attributes that
      are not in this alist are derived by splitting the attribute name
      at underscores and capitalizing the individual words.
 
  -- Variable: eudc-use-raw-directory-names
      If non-‘nil’, use attributes names as defined in the directory.
      Otherwise, directory query/response forms display the user
      attribute names defined in ‘eudc-user-attribute-names-alist’.