SP へList.getRelatedFields 方法 (sp.js)

データ ソースとしてこのリストを使用して、 FieldLookup.IsRelationshiptrueに設定であること、ルックアップ フィールドのコレクションを返します。

**適用対象:**apps for SharePoint | SharePoint Foundation 2013 | SharePoint Server 2013

SP.List.getRelatedFields()

戻り値

[Type]:の SPRelatedFieldCollection

例

次の例では、現在の Web サイトのタスク リストに関連するすべてのフィールドの識別子を表示するアプリケーション ページの [入力] ボタンを作成します。

<asp:Content ID="Main" ContentPlaceHolderID="PlaceHolderMain" runat="server">
<script type="text/ecmascript" language="ecmascript">

var relatedFieldCollection;
function runCode() {

    var clientContext = new SP.ClientContext.get_current()
    if (clientContext != undefined && clientContext != null) {

        var web = clientContext.get_web();

        var listCollection = web.get_lists();

        var list = listCollection.getByTitle("Tasks");

        // Get the collection of lookup fields that use this list as a data source and 
        // that have FieldLookup.IsRelationship set to true.
        this.relatedFieldCollection = list.getRelatedFields();

        clientContext.load(this.relatedFieldCollection);

        clientContext.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceeded), Function.createDelegate(this, this.onQueryFailed));
    }
}

function onQuerySucceeded(sender, args) {
    var relatedFieldInfo = '';
    var relatedFieldEnumerator = this.relatedFieldCollection.getEnumerator();
    while (relatedFieldEnumerator.moveNext()) {
        var relatedField = relatedFieldEnumerator.get_current();
        relatedFieldInfo += 'Related Field ID: ' + relatedField.get_fieldId().toString() + '\n';
    }
    alert(relatedFieldInfo);
}

function onQueryFailed(sender, args) {
    alert('Request failed. ' + args.get_message() + '\n' + args.get_stackTrace());
}

</script>

    <input id="Button1" type="button" value="Run Code" onclick="runCode()" />

</asp:Content>

他のリソースのエンドポイント

詳細については、リストのリソースを参照してください。

エンドポイント URI 構造

http://<sitecollection>/<site>/_api/web/lists(listid)/getRelatedFields()

HTTP 要求

このリソースには、次の HTTP コマンドがサポートしています。

• 投稿

投稿の書式

POST http://<sitecollection>/<site>/_api/web/lists(listid)/getRelatedFields()