001/*
002 * The MIT License
003 * Copyright (c) 2012 Microsoft Corporation
004 *
005 * Permission is hereby granted, free of charge, to any person obtaining a copy
006 * of this software and associated documentation files (the "Software"), to deal
007 * in the Software without restriction, including without limitation the rights
008 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
009 * copies of the Software, and to permit persons to whom the Software is
010 * furnished to do so, subject to the following conditions:
011 *
012 * The above copyright notice and this permission notice shall be included in
013 * all copies or substantial portions of the Software.
014 *
015 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
016 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
017 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
018 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
019 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
020 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
021 * THE SOFTWARE.
022 */
023
024package microsoft.exchange.webservices.data.core.enumeration.service;
025
026import microsoft.exchange.webservices.data.attribute.EwsEnum;
027import microsoft.exchange.webservices.data.attribute.RequiredServerVersion;
028import microsoft.exchange.webservices.data.core.enumeration.misc.ExchangeVersion;
029
030/**
031 * Defines the way the FileAs property of a contact is automatically formatted.
032 */
033public enum FileAsMapping {
034  // No automatic formatting is used.
035  /**
036   * The None.
037   */
038  None,
039
040  // Surname, GivenName
041  /**
042   * The Surname comma given name.
043   */
044  @EwsEnum(schemaName = "LastCommaFirst")
045  SurnameCommaGivenName,
046
047  // GivenName Surname
048  /**
049   * The Given name space surname.
050   */
051  @EwsEnum(schemaName = "FirstSpaceLast")
052  GivenNameSpaceSurname,
053
054  // Company
055  /**
056   * The Company.
057   */
058  Company,
059
060  // Surname, GivenName (Company)
061  /**
062   * The Surname comma given name company.
063   */
064  @EwsEnum(schemaName = "LastCommaFirstCompany")
065  SurnameCommaGivenNameCompany,
066
067  // Company (SurnameGivenName)
068  /**
069   * The Company surname given name.
070   */
071  @EwsEnum(schemaName = "CompanyLastFirst")
072  CompanySurnameGivenName,
073
074  // SurnameGivenName
075  /**
076   * The Surname given name.
077   */
078  @EwsEnum(schemaName = "LastFirst")
079  SurnameGivenName,
080
081  // SurnameGivenName (Company)
082  /**
083   * The Surname given name company.
084   */
085  @EwsEnum(schemaName = "LastFirstCompany")
086  SurnameGivenNameCompany,
087
088  // Company (Surname, GivenName)
089  /**
090   * The Company surname comma given name.
091   */
092  @EwsEnum(schemaName = "CompanyLastCommaFirst")
093  CompanySurnameCommaGivenName,
094
095  // SurnameGivenName Suffix
096  /**
097   * The Surname given name suffix.
098   */
099  @EwsEnum(schemaName = "LastFirstSuffix")
100  SurnameGivenNameSuffix,
101
102  // Surname GivenName (Company)
103  /**
104   * The Surname space given name company.
105   */
106  @EwsEnum(schemaName = "LastSpaceFirstCompany")
107  SurnameSpaceGivenNameCompany,
108
109  // Company (Surname GivenName)
110  /**
111   * The Company surname space given name.
112   */
113  @EwsEnum(schemaName = "CompanyLastSpaceFirst")
114  CompanySurnameSpaceGivenName,
115
116  // Surname GivenName
117  /**
118   * The Surname space given name.
119   */
120  @EwsEnum(schemaName = "LastSpaceFirst")
121  SurnameSpaceGivenName,
122
123  // Display Name (Exchange 2010 or later).
124  /**
125   * The Display name.
126   */
127  @RequiredServerVersion(version = ExchangeVersion.Exchange2010)
128  DisplayName,
129
130  // GivenName (Exchange 2010 or later).
131  /**
132   * The Given name.
133   */
134  @RequiredServerVersion(version = ExchangeVersion.Exchange2010)
135  @EwsEnum(schemaName = "FirstName")
136  GivenName,
137
138  // Surname GivenName Middle Suffix (Exchange 2010 or later).
139  /**
140   * The Surname given name middle suffix.
141   */
142  @RequiredServerVersion(version = ExchangeVersion.Exchange2010)
143  @EwsEnum(schemaName = "LastFirstMiddleSuffix")
144  SurnameGivenNameMiddleSuffix,
145
146  // Surname (Exchange 2010 or later).
147  /**
148   * The Surname.
149   */
150  @RequiredServerVersion(version = ExchangeVersion.Exchange2010)
151  @EwsEnum(schemaName = "LastName")
152  Surname,
153
154  // Empty (Exchange 2010 or later).
155  /**
156   * The Empty.
157   */
158  @RequiredServerVersion(version = ExchangeVersion.Exchange2010)
159  Empty
160}