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    
024    package microsoft.exchange.webservices.data.core.enumeration.service;
025    
026    import microsoft.exchange.webservices.data.attribute.EwsEnum;
027    import microsoft.exchange.webservices.data.attribute.RequiredServerVersion;
028    import microsoft.exchange.webservices.data.core.enumeration.misc.ExchangeVersion;
029    
030    /**
031     * Defines the way the FileAs property of a contact is automatically formatted.
032     */
033    public 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    }