Примеры

 

Полный код примера можно найти на GitHub по данной ссылке.

 

 

 

Для использования продукта, достаточно загрузить ZIP архив продукта со страницы Downloads нашего сайта, распаковать его, и скопировать содержимое папки /PHP на ваш Web сервер. Данная папка представляет собой Web проект, который содержит все необходимые файлы и ресурсы для работы продукта, а также примеры по работе с вьювером и дизайнером.

 

Для установки продукта в уже существующий проект, достаточно из папки /PHP скопировать папку /vendor в корневую директорию проекта, либо воспользоваться менеджером зависимостей Composer, выполнив следующую консольную команду:

 

console

 

composer require stimulsoft/reports-php

 

 

 

При работе с продуктом, в большинстве случаев достаточно использовать только PHP код, который обеспечивает работу всех основных возможностей. Для более детальной настройки продукта и использования всех возможностей, необходимо использовать JavaScript код. Далее будет описано два варианта использования тех или иных возможностей – при помощи PHP функций и при помощи JavaScript функций. Можно использовать либо первый, либо второй вариант в зависимости от потребностей.

 

Для использования компонента HTML5 Designer (StiDesigner) в проекте, необходимо добавить скрипты в блок <head> на PHP странице. Это можно сделать при помощи PHP класса StiJavaScript, в конструкторе нужно указать тип компонента для развёртывания:

 

designer.php

 

<head>

<?php

$js = new \Stimulsoft\StiJavaScript(\Stimulsoft\StiComponentType::Designer);

$js->renderHtml();

?>

</head>

 

 

 

Также предусмотрена возможность подключения всех необходимых скриптов при помощи <script> блока. Все скрипты продукта нахотятся в директории vendor/stimulsoft/reports-php/scripts/:

 

designer.php

 

<head>

<script src="vendor/stimulsoft/reports-php/scripts/stimulsoft.reports.js" type="text/javascript"></script>

<script src="vendor/stimulsoft/reports-php/scripts/stimulsoft.viewer.js" type="text/javascript"></script>

<script src="vendor/stimulsoft/reports-php/scripts/stimulsoft.designer.js" type="text/javascript"></script>

<script src="vendor/stimulsoft/reports-php/scripts/stimulsoft.blockly.editor.js" type="text/javascript"></script>

</head>

 

 

 

Для работы дашбордов понадобится подключить следующий пакет:

 

console

 

composer require stimulsoft/dashboards-php

 

 

 

В случае использования PHP кода все необходимые скрипты будут подключены автоматически, изменение кода не требуется. В случае использования JavaScript кода понадобится добавить соответствующий файл скрипта, содержащий всё необходимое для работы с аналитическими панелями:

 

designer.php

 

<head>

<script src="vendor/stimulsoft/reports-php/scripts/stimulsoft.reports.js" type="text/javascript"></script>

<script src="vendor/stimulsoft/dashboards-php/scripts/stimulsoft.dashboards.js" type="text/javascript"></script>

<script src="vendor/stimulsoft/reports-php/scripts/stimulsoft.viewer.js" type="text/javascript"></script>

<script src="vendor/stimulsoft/reports-php/scripts/stimulsoft.designer.js" type="text/javascript"></script>

<script src="vendor/stimulsoft/reports-php/scripts/stimulsoft.blockly.editor.js" type="text/javascript"></script>

</head>

 

 

Информация

 

Возможные варианты оптимизаций по развертыванию находятся в разделе Уменьшение времени загрузки скриптов.

 

 

 

После этого, можно использовать PHP классы и функции для работы с дизайнером, которые необходимо разместить внутри <script> блока. Для отображения дизайнера на странице, достаточно создать объект компонента HTML5 Designer (StiDesigner), визуальная часть компонента будет развернута в том месте, где будет вызван данный скрипт:

 

designer.php

 

<script type="text/javascript">

<?php

$designer = new \Stimulsoft\Designer\StiDesigner();

$designer->renderHtml();

?>

</script>

 

 

 

Аргументы конструктора дизайнера

Конструктор объекта StiDesigner может принимать на вход необязательные аргументы, влияющие на его работу. Всего предусмотрено два аргумента:

 

designer.php

 

<script type="text/javascript">

<?php

$designer = new \Stimulsoft\Designer\StiDesigner($options, $designerId);

$designer->renderHtml();

?>

</script>

 

 

Наименование

Описание

options

Представляет собой набор опций, находящихся в классе StiDesignerOptions. Опции разделены на категории и содержат всё необходимое для настройки поведения и внешнего вида дизайнера. Подробное описание категорий и опций находится в разделе Настройки дизайнера.

designerId

Строковый идентификатор HTML элемента дизайнера, по умолчанию используется значение "StiDesigner".

 

 

Варианты отображение дизайнера

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

 

Для отображения дизайнера необходимо вызвать у созданного объекта специальную функцию renderHtml():

 

designer.php

 

<script type="text/javascript">

<?php

$designer = new \Stimulsoft\Designer\StiDesigner();

$designer->renderHtml();

?>

</script>

 

 

 

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

 

designer.php

 

<script type="text/javascript">

<?php

$designer = new \Stimulsoft\Designer\StiDesigner();

$designer->renderHtml('designerContent');

?>

</script>

 

<body>

<div id="designerContent"></div>

</body>