Настройка основных параметров карточки

  1. Выберите карточку в списке карточек.

  2. Откройте настройки карточки (Edit  Card Properties).

    CardManager — Описание карточки
    Рисунок 1. CardManager — Описание карточки
  3. Выберите корневой узел в схеме карточки (название совпадает с названием карточки).

  4. Введите псевдоним карточки в поле Псевдоним.

  5. Введите локализованные названия карточки в таблице Названия.

  6. Введите идентификатор COM-компонента карточки в поле Строка активизации.

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

  7. Введите полное название класса, реализующего интерфейс (и связанную логику) карточки, в поле Имя типа.

    Для .NET-карточек следует указывать Имя типа вместо ProgID и строки активации.

  8. Введите путь к иконке карточки в поле Путь к файлу с иконкой, или выберите иконку нажав на кнопку Три точки.

    Рекомендуется указывать относительные пути.
  9. Выберите режим чтения данных карточки в списке Режим чтения данных:

    • FETCH_CARD (карточка целиком) — при обращении к карточке все её данные будут переданы клиенту.

    • FETCH_SECTION (секция) — при обращении к данным карточки будет прочитана целиком соответствующая секция.

    • FETCH_SUBSECTION (подсекция) — чтение только данных подсекций.

    • FETCH_LEVEL (уровень) — чтение только данных одного уровня дерева (при работе с иерархическими секциями).

    • FETCH_ROW — чтение только данных одной строки.

  10. Настройте дополнительные атрибуты карточки:

    • Do not mark card as unread — включает и выключает режим, при котором новая карточка не будет помечаться как непрочитанная.

    • Card can be marked as template by user — разрешает пользователям конвертировать карточку в шаблон.

    • Instances can be copied — разрешает или запрещает копирование карточки.

    • Card needs custom XML export procedure — указывает, что карточка использует нестандартную процедуру выгрузки в XML (стандартные пункты меню будут недоступны).

    • Dictionary (only one instance allowed) — включает и выключает режим, при котором в БД может существовать единственный экземпляр карточки данного типа (используется для справочников).

    • Can work as folder card — указывает, что карточка реализует функциональность папки (такую функциональность реализует системная карточка папок, которую разработчик может подменить собственной).

    • Items can be selected from this card — указывает, что карточку можно использовать для выбора её элементов (запускать в режиме выбора).

    • Do not create hard shortcuts — запрещает создавать сильный ярлык на карточку.

    • Do not lock the card when opened — отключает блокировку карточки при открытии (разработчик должен самостоятельно организовать механизм блокирования карточки).

    • Non-archival — запрещает архивировать карточку.

    • System (user cannot create instance) — запрещает пользователям создавать карточки данного типа. Используется для карточек без пользовательского интерфейса. Экземпляры таких карточек могут быть созданы только программно.

    • User cannot delete card instances — запрещает пользователям удалять карточки данного типа.

    • Card cannot be replicated — запрещает реплицировать экземпляры карточек данного типа.

    • Non-searchable — указывает, что карточка не участвует в поиске и не индексируется.

    • Hidden — скрывает экземпляры карточек данного типа от пользователей.

    • Replicate only card templates — указывает, что в процессе репликации будут участвовать только те карточки данного типа, которые помечены в качестве шаблонов.

    • Allow to open as linked card — разрешает или запрещает открытие карточек данного типа из других карточек.

    • Card is securable — включает и выключает расширенные возможности настройки прав на данные карточки. Если флаг установлен, права могут быть назначены на все структурные элементы карточки: секции, строки секций. Если флаг снят, действует упрощённый режим — права выдаются только на карточку целиком.

      Для повышения производительности крайне не рекомендуется устанавливать признак Card is securable для карточек без особой необходимости.

    • Provides UI Extension — указывает, что карточка предоставляет расширение Windows-клиента.

    • High changes rate — включает и выключает режим, при котором штамп времени карточки вычисляется по штампам времени секций карточки (иначе штамп времени будет обновляться при изменении карточки). Рекомендуется устанавливать данный признак для карточек с высокой частотой изменения (например, он установлен у системной карточки папок).

    • Use server extension when checking access to the card — указывает, что для проверки прав доступа к карточке используется ролевая модель безопасности.

    • Client-side data caching on disk is restricted — запрещает кэширование данных карточки на клиенте.

  11. Введите дескриптор безопасности, определяющий набор прав, назначаемых по умолчанию при создании экземпляров карточки, в поле Default security descriptor.

    В дескрипторе можно использовать только константные идентификаторы объектов (well-known security identifiers), т.к. экземпляры карточки будут создаваться в другом домене чем тот, где она разрабатывается.