カスタム選択フィールド定義の<MAPPINGS> CAML要素の目的

このトピックに対する明確な答えはまだ見つかっていないので、誰かが私の目標を達成するための正しい方法を説明してくれることを願って、この質問を書いています。 また、すべてのテストがSharePoint 2007で行われたことを追加する必要があり ますが 、私が知る限り、2010バージョンを使用した場合の動作は同じである必要があります。 編集：SP 2010でいくつかのテストを実施しましたが、動作が同じように見えることを確認できました。

前提：ローカリゼーションをサポートするカスタム選択フィールドを構築しようとしていました。選択ラベルは現在のロケールに基づいて変更されるため（SP 2010多言語を少し忘れて、1言語のWebサイトのみが使用されていると仮定します）、カスタムフィールドにロケールに依存しない値を実装する方法を探し始めました。 、従来のASP選択コントロールで使用される古典的な「id-value」概念のようなもの。

このページ（ここにもリンクされています）で<MAPPINGS>、FieldCAML要素スキーマによって定義されたタグへの参照を見つけました。このページには、「Choiceフィールド内に表示される選択肢への値のマッピングが含まれています」というタグが記載されています。

ここでの参照として、リンクされたページから取得したサンプルフィールド定義を示します。

<Field ID="{c15b34c3-ce7d-490a-b133-3f4de8801b76}" Type="Choice" Name="Status" DisplayName="$Resources:core,Tasks_Status;" SourceID="http://schemas.microsoft.com/sharepoint/v3" StaticName="Status"> <CHOICES> <CHOICE>$Resources:core,Tasks_NotStarted;</CHOICE>
   <CHOICE>$Resources:core,Tasks_InProgress;</CHOICE> <CHOICE>$Resources:core,Tasks_Completed;</CHOICE>
   <CHOICE>$Resources:core,Tasks_Deferred;</CHOICE> <CHOICE>$Resources:core,Tasks_Waiting;</CHOICE>
</CHOICES>
<MAPPINGS>
   <MAPPING Value="1">$Resources:core,Tasks_NotStarted;</MAPPING> <MAPPING Value="2">$Resources:core,Tasks_InProgress;</MAPPING>
   <MAPPING Value="3">$Resources:core,Tasks_Completed;</MAPPING> <MAPPING Value="4">$Resources:core,Tasks_Deferred;</MAPPING>
   <MAPPING Value="5">$Resources:core,Tasks_Waiting;</MAPPING> </MAPPINGS> <Default>$Resources:core,Tasks_NotStarted;</Default>

ご覧のとおり、サンプルではローカライズされる5つの選択肢を定義してから、それらを1から5までの値にマップします。

問題は、カスタムコードからマップされた値を読み取ることができなかったことです。フィールド読み取りメソッドのいずれも期待値を返しませんでした。CAMLフィールド定義によって定義されたすべてのマッピングは単に無視されているように思われます。

一部の情報源によると、タグは開発者側には実際の影響はなく、SharePointによってコンテンツデータベースに保存されている値にのみ影響します。 編集：さらにいくつかの発掘の後、コンテンツデータベースにはマップされていないデータのみが含まれているように見えるので、このオプションは使用できないようです

他の人はそれをあなたの特徴ファイルの宇宙エネルギーの流れを強化するために使用できる風水の形として示していますが、誰も具体的な答えを持っていないようです。

このタグの用途を知っている人はいますか？

PS：SPFieldMultiChoice.Mappingsプロパティの使用を検討し、拡張メソッドを構築して、フィールド選択の「テキスト」をマップされた値にデコードするロジックを実装しました（これができるはずです。プロパティには完全なxmlマッピングノードが含まれています）フィールド定義から取得）が、このソリューションを試す前に、タグの使用法を誤解していないかどうかを知りたいと思います。

編集：私はこのトピックについてさらに調査を行いました。具体的な答えは見つかりませんでしたが（誰かがmsdnで同じ質問をしているようですが、運が悪かったようです...）、タグは確かに洗練された形の風水である可能性があると信じ始めています。

HealtRuleScopeフィールドのOOB定義を見てください。

<?xml version="1.0" encoding="utf-16"?>
<Field ID="{E59F08C9-FA34-4f94-A00A-F6458B1D3C56}" Name="HealthRuleScope" DisplayName="Scope" Type="Choice" Description="..." Group="_Hidden" SourceID="http://schemas.microsoft.com/sharepoint/v3/fields" StaticName="HealthRuleScope" AllowDeletion="FALSE" Required="TRUE">
   <CHOICES>
      <CHOICE>All Servers</CHOICE>
      <CHOICE>Any Server</CHOICE>
   </CHOICES>
   <MAPPINGS>
      <MAPPING Value="1">All Servers</MAPPING>
      <MAPPING Value="2">Any Server</MAPPING>
   </MAPPINGS>
   <Default>Any Server</Default>
</Field>

この定義は、SharePoint Managerツールを使用して中央管理Webサイトのサイト列から取得されました（カスタムアプリケーションでも同じことができますが、何も再発明する必要はありません）。ご覧のとおり、14フォルダーのfield.xml機能定義に従って、MAPPINGセクションはまだ存在しています。

サーバーの全体管理の[ヘルスルール]リストの同じフィールドを見ると（SharePoint Manager 2010などのツールを使用）、マッピングセクション全体が欠落していることがわかります。この場合、マッピングISNはリストインスタンスの子フィールドに伝播されていないように見えます。一方、マッピングセクションを使用するフィールドのカスタム機能を構築しようとしましたが、情報をリストに伝達することができました（マップされた値を取得することはできませんでした）。SharePointオブジェクトモデルで必要なときにマッピング情報が親フィールドから読み取られる可能性はありますが、今のところ、この機能は単に実装されていないと思い始めています... LinqToSharePointマッピングでさえ使用されていないようですそれ：

public enum Scope : int {   
   None = 0,    
   Invalid = 1,

   [Microsoft.SharePoint.Linq.ChoiceAttribute(Value="All Servers")]
   AllServers = 2,  
   [Microsoft.SharePoint.Linq.ChoiceAttribute(Value="Any Server")]
   AnyServer = 4,
}

編集：アミットが彼の答えで示唆したように、私は公式の「コラボレーティブアプリケーションマークアップ言語（CAML）構造仕様」ドキュメントをざっと見ました。ドキュメントの最新バージョンがスキーマ要素への参照を削除したことは確かに疑わしいです-それは要素が実際に未使用/実装されていないことを示している可能性があります。反対に、HealthRuleScopeフィールドはマッピング宣言を使用します-そして私が知る限り、それはSP2010でのみ導入されました...

詳細について<Mappings>は、[MS-WSSCAML]：Collaborative Application Markup Language（CAML）Structure SpecificationV0.1を参照してください。

" MAPPINGS：MAPPING要素で指定された値を持つ対応するCHOICEの正規の言語に依存しない識別子を表すMAPPING文字列要素のセット。Type属性がChoiceまたはMultiChoiceでない場合、リーダーはMAPPINGSを無視する必要があります。ライターはMAPPINGSを省略すべきです。 Type属性はChoiceまたはMultiChoiceではありません。」

"2.3.2.13MAPPINGDEFINITIONSタイプMAPPINGDEFINITIONSタイプは1つ以上のMAPPINGSのコンテナです
。ChoiceまたはMultiChoice以外のフィールドにはMAPPINGSを定義しないでください。ChoiceフィールドにMAPPINGDEFINITION要素を定義してはいけません。対応する各CHOICE要素」

仕様の最新（およびすべて）バージョンはここにあります： http://msdn.microsoft.com/en-us/library/cc313121(v=office.12).aspx。しかし、最新バージョンには情報がありません<Mappings>!!

結局、私はStuartによって提案された指示に従い、これをさらに別のSharePointブラックホールとしてマークしたので、このCAMLタグを最後に使用するという希望を今のところ残しました。

調査中にフレームワークの多くのクラスを調べましたが、マッピングの「属性」の使用に関連するものが見つからないため、未完成の機能であると推測できます。SP2013で変更されるかどうかを確認します。

そうは言っても、FieldオブジェクトのMappingsプロパティを利用して、マッピングxmlを手動で解析し、期待される動作をシミュレートする代替ソリューションをテストしました。MUIのサポートが開始されると、それはすぐに手に負えなくなったので、結局私もその道を離れました（ダイアログなどに関連する問題があるようですが、それは私が当時経験していた他の問題に依存している可能性があります一部のCUは間違った順序で適用されているため、これを一粒の塩と一緒に使用してください）。

複数選択が許可されていないSPFieldChoice "Status"でリスト "Resources"（objList）の例を使用します。objItemは、Statusフィールドのインデックスを知りたいobjList内のアイテムです。

int i;
i = ((SPFieldChoice)objList.Fields["Status"])Choices.IndexOf(objItem["Status"].ToString());