Поделиться через


SP. Метод List.getRelatedFields (sp.js)

Возвращает коллекцию полей подстановки, использующих данный список как источник данных, у которых FieldLookup.IsRelationship значение true.

Дата последнего изменения: 22 ноября 2013 г.

Область применения: apps for SharePoint | SharePoint Foundation 2013 | SharePoint Server 2013

SP.List.getRelatedFields()

Возвращаемое значение

Тип: SP. RelatedFieldCollection

Пример

В следующем примере создается кнопку ввода на страницу приложения, которое отображает идентификатор все поля, связанные со списком задач на текущем веб-сайте.

<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>

Конечная точка ресурса REST

Дополнительные сведения см. в разделе Ресурс в виде списка.

Структура URI конечной точки

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

Запросы HTTP

Этот ресурс поддерживает следующие команды HTTP:

  • POST

Синтаксис POST

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