Страницы спецификаций

• Система - Сети
• Системные конфигурации

Система - Сети

Описание

Сети являются высшим уровнем категоризации в Cyclos. Краткое объяснение можно найти в разделе Сети в концепциях.

Бизнес-правила

Глобальные администраторы

• Управление сетями (например, создание, удаление) осуществляется пользователями, принадлежащими встроенной группе 'глобальные администраторы'.
• Когда сеть создается (глобальным или многосетевым администратором, или через API), будет создана одна встроенная группа под названием 'администраторы сети', эти администраторы сети имеют фиксированные разрешения (см. Группы пользователей).
• Глобальные администраторы могут переключаться на сеть. При переключении на сеть глобальный или многосетевой администратор будет иметь те же разрешения, что и группа 'администраторы сети'.

Многосетевые администраторы

• Администраторы, принадлежащие группе, созданной на глобальном уровне, являются частью группы 'Многосетевой администратор'. Обратите внимание, что эти многосетевые группы перечислены в том же списке, что и встроенная группа 'Глобальные администраторы'. Многосетевым администраторам могут быть предоставлены разрешения на управление определенными сетями. Им также могут быть предоставлены разрешения на создание новых сетей, и в этом случае они могут управлять ими автоматически.
• Многосетевые администраторы могут переключаться между сетями, которыми они управляют, из списка сетей или переключателя сети в меню статуса.

Область действия сети

• Все пользователи в системе, которые не входят в группу глобальных или многосетевых администраторов, будут автоматически работать в 'области действия' сети, сеть будет отображаться (и реагировать) как единая система (совместимость будет доступна через 'глобальные' сущности, как объясняется далее).
• 'Администраторы сети' могут создавать новые группы администраторов в своей сети. Вместе с этими группами 'администраторы сети' управляют сетью.

Локальные и глобальные сущности

• Большинство сущностей являются локальными, что означает, что ими можно управлять и даже просматривать только на локальном (сетевом) уровне. Примеры локальных сущностей: продукты, соглашения, типы записей, категории сообщений, категории объявлений и т.д.
• Примеры глобальных сущностей: Группы, языки, конфигурации, каналы, схемы телефонов, системные изображения и сущности, связанные с учетными записями (чтобы быстро получить обзор всех глобальных сущностей, вы можете просто войти как глобальный администратор).
• Помимо управления локальными сетевыми сущностями, локальный (сетевой) администратор может видеть и 'использовать' все глобальные сущности, но не может редактировать или удалять их. Глобальные сущности просто 'доступны' для локального использования. Например, поля профиля могут быть определены глобально. Сетевой администратор просто выберет поля профиля, которые он/она хочет использовать в локальном продукте. И добавит пользовательские поля профиля при необходимости.
• Группы и конфигурации, определенные на глобальном уровне, являются особыми случаями. Они глобальны, но не видны на сетевом уровне.
• В некоторых случаях глобальный администратор как сетевой администратор имеет доступ к той же функции (например, журналы ошибок). Но глобальный администратор увидит все ошибки в системе, а сетевой администратор - только ошибки, сгенерированные в пределах их сетевой области.

Примечание: Концепция локальных и глобальных сущностей может показаться сложной. Но для сетевого администратора это довольно просто. Для сетевого администратора будут просто некоторые сущности, которые он/она не может изменить. Они будут вести себя просто как 'встроенные' сущности. Которые можно либо использовать, либо нет.

Доступ

• Глобальный администратор может создавать сети и управлять ими через меню (Управление системой - Сети). На странице сведений о сети глобальный администратор может изменить свойства сети, например, имя и URL доступа.
• Чтобы глобальный администратор мог управлять самой сетью (например, создавать группы, учетные записи, продукты, пользователей и т.д.), глобальный администратор должен войти в сеть через единственный селектор 'переключатель' в правом верхнем меню (между вошедшим пользователем и опциями выхода). Выбор 'Глобальное администрирование' вернет администратора в режим глобального администрирования. (опция переключателя - это просто 'дополнительная' возможность, чтобы избежать необходимости глобальным администраторам создавать локальных администраторов для каждой сети, которой они хотят управлять)
• Сетевой администратор никогда не увидит никаких опций, касающихся других сетей. Сетевому администратору даже не нужно знать о существовании других сетей.

Совместимость

(эта функция очень сложна и еще не реализована, поскольку ее можно легко выполнить в пределах одной сети, статус - по требованию)

В деталях сети будет опция 'доступные сети'. Это должно показывать двухуровневый вариант выбора, сети и группы внутри сетей. (аналогично множественному выбору groupset/group). Таким образом, глобальный администратор может разрешить группам из определенных сетей выполнять операции (например, платежи) между ними. Конечно, администратору сначала нужно будет создать глобальную валюту, учетную запись и т.д. Сетевому администратору нужно будет добавить учетную запись и межсетевой тип транзакции в локальный продукт.

Примечание: Глобальные учетные записи будут работать немного иначе, чем локальные. Например, комиссии за транзакции по глобальным счетам не могут применяться к конкретным пользователям и группам (как в локальных счетах), а только к сетям.

Уведомления

При создании новой сети будет отправлено уведомление. Идея в том, что в будущем системным администраторам можно будет назначать определенные сети для управления, а также предоставлять разрешение на создание новых сетей, которыми они, очевидно, могут управлять. Эти системные администраторы, вероятно, будут 'провайдерами услуг Cyclos', которые не будут иметь 'полных' прав системного администратора, таких как создание новых каналов и типов паролей. При создании новой сети полный системный администратор может захотеть быть проинформированным о создании новой сети.

Страницы

Страница поиска (фильтры)

Поля	Тип	Правила
Название	Текст	Позволяет администратору искать сеть с определенным именем.
Внутреннее имя	Текст	Позволяет администратору искать сеть с определенным внутренним именем.
Показывать только по умолчанию	Логический	Позволяет администратору искать сеть, помеченную как сеть по умолчанию.
Управляется группой	Одиночный выбор с группами глобальных администраторов	Позволяет администратору показывать сети, назначенные определенной группе глобальных администраторов Значение по умолчанию "все".
Создать	Кнопка действия	Переходит на страницу сведений о сети для добавления новой сети выбранного типа. Отображается слева (первый элемент). Доступные варианты: Пустая сеть: Открывает страницу редактирования для ручного создания новой Сети Мастер сети: Запускает мастер для辅助ственного создания новой Сети
Сортировать по	Кнопка действия	Позволяет выбрать порядок списка результатов. Доступные варианты: Дата создания (по умолчанию) Имя

Результаты поиска (список)

* Автоматически показывает все сети, отсортированные по умолчанию по дате создания.
* Над списком слева находится кнопка сортировки (аналогично поиску пользователей) с опцией сортировки по дате создания или по алфавиту.
Отключенные сети отображаются зачеркнутыми в списке результатов поиска.

Поля	Тип	Правила
Название	Текст	Название сети.
Внутреннее имя	Текст	Внутреннее имя сети.
Переключиться	Иконка	Позволяет (по клику) переключиться на указанную сеть.
По умолчанию	Иконка	Показывает, какая сеть является сетью по умолчанию. Может быть только одна сеть по умолчанию. Эта сеть не перейдет в глобальный режим при доступе по основному URL. Например, communities.cyclos.org попадет в сеть 'communities', потому что она определена как сеть по умолчанию. Если бы это было не так, она попала бы в глобальный URL (communities.cyclos.org/global).
Удалить	Иконка	Удаляет эту Сеть. Возможно только если Сеть никогда не использовалась (не имеет данных).

Страница сведений

Поля	Тип	Правила
Название	Текст	Здесь можно указать название сети. Максимум 50 символов. Обязательное.
Внутреннее имя	Текст	Здесь можно указать внутреннее имя сети. Это необходимо для веб-сервисов. Внутреннее имя может быть определено только на глобальном уровне (не сетевым администратором). К сети всегда можно получить доступ через глобальный URL и внутреннее имя как путь. Даже если корневой URL в конфигурации по умолчанию сети был изменен. Максимум 50 символов. Обязательное.
Описание	Текст
URL по умолчанию	Только для чтения	Видимо только при редактировании (скрыто при создании).
Дата создания	Только для чтения	Видимо только при редактировании (скрыто при создании).
Включено	Логический	Позволяет администратору отключить/включить группу. По умолчанию отмечено как включено; Если отключено, никакие связанные сущности/информация о сети недоступны в Cyclos.
По умолчанию	Логический	Позволяет администратору установить сеть как сеть по умолчанию. См. правила сопоставления сетей в разделе Бизнес-правила. Когда сеть устанавливается как сеть по умолчанию, у предыдущей сети по умолчанию (если таковая была) флаг по умолчанию снимается. Видимо только для глобальных администраторов (многосетевые администраторы не могут изменять, только просматривать это значение).
Родительская конфигурация	Одиночный выбор	Определяет конфигурацию, которая будет родительской для конфигурации по умолчанию сети. В качестве опций должны отображаться все глобальные конфигурации. Обязательное и редактируемое при вставке. Только для чтения при редактировании.
Управляется группами	Ссылки	Показывает ссылку для каждой из групп, которые управляют этой сетью.
Переключиться на эту сеть	Кнопка действия	Позволяет переключиться на сеть. Видимо после сохранения и включения сети.
Сохранить	Кнопка действия	Сохраняет сеть.

Системные конфигурации

Описание

Конфигурация определяет, как Cyclos выглядит, ощущается и ведет себя для групп вошедших пользователей или для гостей. Некоторые примеры параметров, которые можно установить в конфигурации: язык, адрес, макет адреса, формат чисел, почтовый сервер и многое другое.

Также большинство элементов управления контентом привязаны к теме. Например, для каждой конфигурации вы можете редактировать видимые баннеры. Однако эти элементы управления контентом редактируются через меню контента:

• Баннеры
• Логотипы
• Меню и страницы
• Мобильные страницы
• Статический контент
• Темы

Бизнес-правила

Конфигурации определяются иерархическим образом. Существует одна, встроенная конфигурация, которая является системной по умолчанию. Эта системная конфигурация по умолчанию всегда является корнем любого дерева конфигураций. При создании новой конфигурации необходимо выбрать существующую «родительскую» конфигурацию, это может быть системная конфигурация по умолчанию или любая другая конфигурация, которой администратор имеет право управлять. Это означает, что все конфигурации происходят прямо или косвенно от (встроенной) системной конфигурации по умолчанию. Администратор может выбрать наследование параметров от соответствующей «родительской» конфигурации или настроить их (выбрав значок редактирования). Также можно «заблокировать» параметры (выбрав значок блокировки), когда параметры заблокированы, конфигурации нижнего уровня не могут их больше изменять. Конфигурации, имеющие дочерние конфигурации, не могут быть удалены. Кроме того, конфигурации могут быть установлены для определенных гостей (соответствующих параметру URL) и/или для конкретных пользователей (через группу и/или набор групп).

Во время выполнения всегда используется наиболее специфичная конфигурация для гостей:

• Специфичный гость (соответствующий параметру URL), если есть
• Системная по умолчанию

Для вошедших пользователей группа определяет конфигурацию, которая будет применена. Группа имеет свойство конфигурации; конфигурация не имеет свойства группы. Группа может иметь только одну конфигурацию и должна иметь конфигурацию - она не может быть нулевой. Наборы групп также имеют конфигурацию. Конфигурация набора групп определяет только то, какой будет конфигурация по умолчанию в форме для создания новой группы. Однако администратор может просто выбрать другую конфигурацию для этой новой группы. Конфигурация по умолчанию при создании нового набора групп всегда системная по умолчанию.

Как указано выше, группа пользователей может иметь только одну конфигурацию. Однако конфигурация всегда является частью иерархического дерева конфигураций. Новая конфигурация всегда должна расширять конфигурацию более высокого уровня. Это означает, что все конфигурации в системе являются частью иерархического дерева конфигураций. Встроенная конфигурация 'глобальная по умолчанию' является вершиной иерархии.

Применимость конфигурации

При просмотре Cyclos как гость (не вошедший в систему) конфигурация, которая будет применена, определяется URL (доменом или путем), к которому пользователь обращается. URL/путь определен в конфигурации.
Когда пользователь входит в Cyclos, будет применена конфигурация, привязанная к группе пользователя. Обратите внимание, что при этом не учитывается URL/путь доступа, определенный в конфигурации группы пользователя.
Пользователь может войти по URL/пути, определенному в конфигурации на более высоком уровне. Но единственная разница в том, что он входит по другому URL. То, что он видит (макет, страницы и т.д.), берется из конфигурации, привязанной к его группе пользователей.
Пример, система со следующими двумя конфигурациями:
* Config1: привязана к group1, URL: www.mybank.com
* Config2: привязана к group2, расширяет config1, путь: www.mybank.com/city
* Пользователь из group2 может получить доступ к обоим доменам, www.mybank.com/city и www.mybank.com. И получит тот же результат после входа в систему.
* Пользователь из group1 может получить доступ только по URL www.mybank.com

Ограничения

• Также можно установить в конфигурации 'доступ только по URL/пути'. Это означает, что пользователи могут входить только по пути (не по URL/путям, определенным на более высоком уровне). Преимущество этого в том, что вы можете ограничить特定ный доступ (например, для глобальных администраторов или доступа к веб-сервисам) путем, который может быть труднонаходимым, например www.domain.com/sdlf893knd9234rd.
• Ограничения 'доступ только по URL/пути', а также ограничения белого списка применяются при установлении сеанса.
• Если у глобального администратора есть сеанс, он может переключаться на конфигурации нижнего уровня без применения ограничений. Поэтому при реализации ограничений по IP и URL важно, чтобы группы глобальных администраторов высшего уровня имели аналогичные или более строгие разрешения.

Правила для полей

• По умолчанию для каждого поля отображается значение конфигурации более высокого уровня, справа от поля отображается значок редактирования, чтобы настроить поле.
• Когда поле не настроено (т.е. унаследовано), отображается значок редактирования.
• Когда поле не отредактировано (не настроено), значок блокировки не отображается.
• Когда поле настроено, отображается значок возврата к унаследованному значению.
• Когда поле настроено и не заблокировано, отображается зеленый значок разблокировки.
• Когда поле настроено и заблокировано, отображается желтый значок блокировки.
• Когда поле заблокировано в конфигурации более высокого уровня, отображается серый значок блокировки.
• В случае наследования от конфигурации более высокого уровня выбранных опций в поле множественного выбора есть только два варианта:
  • Когда поле настроено и заблокировано на уровне конфигурации более высокого уровня, все дочерние элементы должны следовать определениям в родительской конфигурации.
  • Когда поле настроено и не заблокировано, каждая последующая конфигурация может выбирать среди доступных опций до тех пор, пока на одном уровне поле не будет заблокировано.

Разрешения

• <permission id="SYSTEM_CONFIGURATION_VIEW"/> - Позволяет администратору видеть все конфигурации.
• <permission id="SYSTEM_CONFIGURATION_MANAGE"/> - Позволяет администратору управлять всеми конфигурациями.
• <permission id="SPECIFIC_CONFIGURATION_MANAGE"/> - Позволяет администратору управлять конкретными конфигурациями, выбранными в его разрешениях.
• <permission id="SPECIFIC_CONFIGURATION_MANAGE_CONTENT"/> - Позволяет администратору управлять только контентом конкретных конфигураций, выбранных в его разрешениях, администратору не разрешено вносить изменения в саму конфигурацию.

Страницы

Поиск (фильтры)

Поля	Тип	Правила
Фильтр по группам	Множественный выбор	Позволяет фильтровать по группам
Название	Текст	Позволяет фильтровать по названию конфигурации
URL	Текст	Позволяет фильтровать по URL (определенному в конфигурации) Видимо только в режиме расширенного поиска
Создать	Мульти-кнопка действия	При создании новой конфигурации необходимо выбрать существующую «родительскую» конфигурацию, это может быть системная конфигурация по умолчанию или любая другая конфигурация, которой администратор имеет право управлять. При нажатии на выбранную опцию открывается пустая страница сведений для создания новой конфигурации на основе выбранной «родительской» конфигурации.
Расширенный	Кнопка действия	Переключиться в расширенный режим Видимо только в режиме простого поиска
Простой	Кнопка действия	Переключиться в простой режим Видимо только в режиме расширенного поиска

Результаты поиска (список)

* Автоматически показывает все конфигурации, отображаемые иерархически и отсортированные по алфавиту по имени.

Поля	Тип	Правила
Название	Текст (только чтение)	Показывает название конфигурации и значок стрелки перед названием, указывающий на местоположение в иерархии конфигураций.
URL	Текст (только чтение)	URL конфигурации.
Предпросмотр	Иконка	Отображает настройки выбранных конфигураций в режиме только для просмотра. Он показывает «активную» конфигурацию, то есть объединяет все примененные настройки (включая унаследованные от конфигураций более высокого уровня).
Удалить	Иконка	Позволяет администратору удалить конфигурацию. Видимо только если администратор имеет разрешение <permission id="SYSTEM_CONFIGURATION_MANAGE"/>. Конфигурация может быть удалена только если она не используется и/или если у нее нет дочерних элементов.

 

Страница сведений

Поля	Тип	Правила
Родительская	Текст (только чтение)	Указывает, какая конфигурация является непосредственным родителем, от которого происходит новая конфигурация. Все конфигурации расширяются непосредственно от другой конфигурации, являющейся либо основной конфигурацией, которая является частью базы данных по умолчанию (системная по умолчанию), либо любой другой конфигурацией нижнего уровня. Не видима для системной по умолчанию. Определение реализовано на верхнем уровне, когда зафиксировано, не может быть изменено в нисходящей конфигурации.
Название	Текст	Название конфигурации. Обязательное. Должно быть уникальным. Максимальная длина 100 символов.
Описание	Текст	Здесь можно поместить пояснительный текст для конфигурации.
Основной URL	Текст	Корневой URL. Должен быть действительным URL. Либо URL основного веб-приложения, включая внутреннее имя сети (например, commmunities.cyclos.org/network1), либо «собственный» домен, разрешаемый на IP-адрес домена основного веб-приложения (например, http://www.mydomain.org, указывающий на communities.cyclos.org). Не должно существовать 2 конфигураций с одинаковой комбинацией корневого URL. Редактируется только глобальными администраторами.
URL путь	Текст	Путь от корневого URL для区分ния этой конфигурации от других в той же сети. Например, если корневой путь глобальной конфигурации по умолчанию - http://www.server.org, а внутреннее имя сети - 'England', то путь 'London' будет соответствовать запросам к http://www.server.org/england/london. Не может содержать: Может содержать только буквы, цифры, точки, дефисы или знаки плюс Максимум 50 символов. Следующие зарезервированные слова нельзя использовать как имя пути: cyclos, js, images, content, web-rpc, java-rpc Нет опции 'путь' в конфигурации сети по умолчанию или Глобальной конфигурации по умолчанию.
Используется группами	Ссылки	Показывает группы, currently использующие эту конфигурацию, со ссылками на страницу сведений Пользователи, которые не вошли в систему (гости), обращающиеся с Корневым URL или Путем (см. выше), получат текущую конфигурацию Вошедшие пользователи могут получить доступ только к конфигурациям, в которых указана их группа. Нет опции 'Используется группами' в Глобальной конфигурации по умолчанию.
Данные пользователя
Поля профиля с контролем конфиденциальности	Множественный выбор	Выбранные поля будут включены в списки контроля конфиденциальности (см.: Конфигурация системы - Конфигурация пользователя - Списки контроля конфиденциальности)
Требовать e-mail	Логический	Определяет, требуется ли электронная почта для пользователей с этой конфигурацией.
Уникальный e-mail	Логический	Определяет, должен ли e-mail быть уникальным. Появляется только в конфигурациях верхнего уровня (глобальная, сетевая по умолчанию) Примечание Отмена уникальности e-mail effectively отключает e-mail как метод идентификации для доступа или выполнения/получения платежей в этой конфигурации и ее受影响ных дочерних конфигурациях. Пожалуйста, действуйте осторожно.
Проверять e-mail при	Множественный выбор	Определяет, когда e-mail должен быть подтвержден пользователем видимо только когда выбран "Требовать e-mail" Доступные опции: Публичная регистрация Регистрация администраторами Регистрация брокерами Регистрация участником Регистрация оператора участником Изменение email самим пользователем Изменение email администратором Изменение email брокером Импортированные пользователи
Настройка конфиденциальности email по умолчанию	Одиночный выбор	Когда пользователь регистрируется или изменяет свой профиль, он может определить, скрывать или показывать свой email для других. Здесь администратор может выбрать значение по умолчанию для этой настройки. Как правило, для бизнесов это значение будет видимым, а для потребителей - скрытым. Опции: Приватный (Скрыт для других пользователей) Видим для других пользователей
Требовать изображение профиля	Логический	Когда выбрано, пользователь должен загрузить изображение профиля при регистрации.
Изображение по умолчанию для новых зарегистрированных пользователей	Изображение	Когда пользователи регистрируются без загрузки изображения профиля, показывается изображение по умолчанию для всей системы. С помощью этой настройки можно иметь настроенные изображения профиля по умолчанию для каждой конфигурации/группы.
Генерируемое имя для входа	Логический	Определяет, будут ли новые пользователи с этой конфигурацией иметь автоматически сгенерированные имена пользователей (когда отмечено) или им нужно будет предоставить имя пользователя вручную (когда не отмечено). Когда имя пользователя генерируется автоматически, длина будет максимальной, установленной в поле "Длина генерируемого имени для входа". Имя пользователя будет целым числом, когда будет достигнуто максимальное количество цифр, будет добавлена еще одна цифра.
Длина генерируемого имени для входа	Целое число	Длина генерируемых имен пользователей. Видимо только когда отмечен checkbox "Генерируемое имя для входа".
Регулярное выражение для имени для входа	Текст	Определяет регулярную маску, используемую для проверки введенных вручную имен пользователей. Видимо только когда checkbox "генерируемое имя для входа" не отмечен (имя пользователя вводится вручную). Использует стандартные регулярные выражения Java http://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html Если используются веб-сервисы, пожалуйста, не разрешайте использование двоеточия ":", потому что оно используется для разделения имени пользователя и пароля. Так что не добавляйте "\p" или "\:".
Длина имени пользователя	Диапазон целых чисел	Определяет минимальное и максимальное количество символов для имен пользователей. Видимо только когда checkbox "Генерируемое имя для входа" не отмечен.
Индивидуальная директория документов	Одиночный выбор	Конфигурация менеджера контента, в свойствах cyclos

Каналы (Вкладка)

Каналы описаны на выделенной вики-странице.