SP. RelatedField object (sp.js)

Статья
02/03/2016

Задает отношение для поля подстановки.

Дата последнего изменения: 9 марта 2015 г.

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

var object = new SP.RelatedField()

Элементы

Объект RelatedField содержит следующие элементы.

Конструктор

Объект RelatedField имеет следующий конструктор.

Конструктор	Описание
RelatedField	Инициализирует новый экземпляр объекта SP.RelatedField.

Свойства

Объект RelatedField имеет следующие свойства.

Свойство	Описание
fieldId	Инициализирует расширенные свойства, связанные с полями.
listId	Определяет назначения ролей защищаемого объекта для пользователя или группы у веб-сайта, списка или элемента списка.
lookupList	Строковое представление значения идентификатора.
relationshipDeleteBehavior	Получает значение, указывающее действие, которое выполняется системой для элементов в списке, указанномlistId, при удалении элемента в текущем списке.
webId	Получает или задает значение, указывающее тип поля.

Пример

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

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

    var relatedFieldCollection = null;

    function runCode() {

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

            this.web = clientContext.get_web();
            var listCollection = web.get_lists();
            var item = listCollection.getByTitle("Tasks");
            // Get a collection of lookup fields that use this list as a data source 
            // and that have FieldLookup.IsRelationship set to true.
            this.relatedFieldCollection = item.getRelatedFields();

            clientContext.load(this.relatedFieldCollection);

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

    function onQuerySucceeded(sender, args) {
        var fieldInfo = '';
        var fieldEnumerator = this.relatedFieldCollection.getEnumerator();
        while (fieldEnumerator.moveNext()) {
            var relatedField = fieldEnumerator.get_current();
            // Get the GUID that identifies the related lookup field.
            fieldInfo += 'Related Field ID: ' + relatedField.get_fieldId().toString() + '\n';
        }
        alert(fieldInfo);
    }

    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()/GetByFieldId(fieldid)

Запросы HTTP

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

POST

Синтаксис POST

POST http://<sitecollection>/<site>/_api/web/lists(listid)/GetRelatedFields()/GetByFieldId(fieldid)

Share via