Здравствуй Google API! Или делаем из DIRECTUM'а конфетку.

    Не так давно, просматривая наработки одной системы на С#, я подумал – “Красиво, однако”. Но сразу возникла мысль, что реализация подобных графиков на C# довольно таки трудозатратна, а ведь это не что то новое, это, по сути, все тот же велосипед, только в различных представлениях – Pie chart, Donut chart и т.д. И к тому же подобные вещи можно встретить где только можно, так почему бы не использовать одно какое то универсальное средство которое подошло бы всем.

    Эта тема меня заинтересовала и начался поиск уже готового универсального решения. Поисковые запросы в гугл падали пачками – “Красивые графики”, “графики для различных систем”, “цветные пироги”, “Charts”, “Настраиваемые графики”, “API”… Стоп, “API”? Тут то я понял что нашел то что искал, вот только то, что предлагал мне интернет было каким то… Скажем так – сварщику освоить сложно :)

    В общем, каким-то волшебным образом я добрался до библиотеки Google API. Библиотеки того что мне и было нужно в самом простом представлении и еще и с детальным описанием всех возможностей настройки и функций. После изучения возможностей я решил попробовать поиграться с найденным. Простые HTML’ки, небольшие настройки. “Ну вроде понятно” – подумал я, и лег спать… Но, через 10 минут я резко вскочил и подумал – а почему бы не засунуть это в DIRECTUM! И пошла работа (конечно, ведь 2 часа ночи это самое время творить :) )

    Начал я с создания простой функции, которая формировала мне те самые маленькие HTML’ки, с которыми я игрался в начале. Простой вызов функции создавал HTML, экспортировал его как документ, и открывал в браузере. После небольших корректировок HTML’ки она стала выдавать результат, основанный на данных которые я ей передавал:

RitPieChart()

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

        REQ – Строка, реквизит справочника по которому собираем статистику
        TITLE – Строка, заголовок графика
        WebBrowserControl – Строка, имя веб-контрола карточки в котором будем отображать график
        Is3D – Логический, будет ли график иметь “3D вид”

    Ну а теперь давайте поиграемся с новой игрушкой. Для начала обозначим задачу:

        “Вывести статистику по исполнению заявок в Service Desk'е.”

    Данные будем брать из реквизита “Состояние” (в данном реквизите указывается статус выполнения заявки) карточки справочника. 

  Выводить их будем в предварительно подготовленный веб-контрол с именем “STWebBrowserControl1”. Называться наш график будет “Статистика выполнения заявок”. А формироваться данные будут по кнопке “Обновить статистику”, на которую мы повесим следующее вычисление:

RITPieGraph('ClaimState'; "Статистика выполнения заявок"; 'STWebBrowserControl1')

    И вот результат:

    Стоит отметить что Google API работает только при наличии подключения к интернету на пользовательской машине и при настройке разрешения запускать ActiveX компоненты в браузерах. Можно воспользоваться другими – так же бесплатными API, которые могут работать и локально, но тогда необходимо будет подгружать ява-скрипты на пользовательские машины. Я же себе ставил цель использования именно компонент Google, т.к. они наиболее просты и очень гибки в настройке. С полным перечнем настроек, которые можно использовать в данном графике можете ознакомиться на официальном сайте:

    https://google-developers.appspot.com/chart/interactive/docs/gallery/piechart

    Полный перечень интерактивных графиков и т.д. от Google по ссылке ниже:

    https://developers.google.com/chart/interactive/docs/gallery

    Так же стоит отметить, что компоненты Google предоставляются бесплатно и не подлежат перепродаже! При использовании внимательно ознакомьтесь с лицензионным соглашением!

    P.S. В данной функции разобран только базовый функционал, подогнанный под конкретную задачу. Вы же можете донастраивать и добавлять параметры в функцию под все ваши нужды. Я лишь показал вам как это просто сделать ;)

    P.P.S. Во вложении данная функция, версия системы - 4.9.1, но можно импортировать в любую версию системы если в файлах разработки изменить версию платформы. (проверено на 4.8)

    RITPieGraph.rar (3,62 Кб)