====== Отчёт "Электронная таблица" ======
===== Что такое "Электронная таблица" =====
{{:product:reports:excel_illustration.png?nolink&150 |}} Интерфейс электронной таблицы, как привычный MS Excel, встроен в ADVANTA.

Отчёт "Электронная таблица" -- это инструмент **для сбора информации** из других отчётов или из объектов. В нём можно:
  * собирать информацию, 
  * делать вычисления, 
  * использовать данные для последующего вывода их в [[product:dashboard|дашборды]].

Сам по себе отчёт "Электронная таблица" -- это пустая таблица с возможностями формул как в Excel. Вся его сила и функциональность в том, что он умеет:
  * собирать данные из объектов ADVANT'ы;
  * держать в себе константы (см. [[product/reports/excel_table_report/template|использование шаблонов]] в электронной таблице);
  * делать вычисления с помощью формул Excel.

<grid>
<col sm="8">
<callout type="warning" icon="true">Корректная навигация в отчете «Электронная таблица» для масштаба браузера **отличного от 100% НЕ** гарантируется.</callout>

<callout type="danger" title="Обратите внимание"> Выгрузки из ADVANTA через компонент в форматы XLS, XLSX, RTF, DOC совместимы только с продуктами **Microsoft Office**. \\ Мы не гарантируем совместимость форматов выгрузок с офисными пакетами других производителей. \\ Файлы в них могут открываться с искажениями форматирования, либо, в отдельных случаях, могут не открываться вообще. \\ Это не является ошибкой системы. </callout>

</col>
</grid>

===== Принцип создания отчёта =====
  - **Создайте** отчёт с типом "Электронная таблица" (модуль на рабочем столе "Мои отчёты" -> "Добавить отчёт" или из [[product/objects/admin/reports|настроек типа объекта]] -> "Показать отчёт").
  - Добавьте в отчет **источники данных**: объекты, справочники и отчеты других типов.
  - **Сохраните** отчёт в системе.
  - **Выгрузите** (экспортируйте) отчёт в в формат MS Excel.
  - В файле **MS Excel** выполните все необходимые операции с данными и настройки. Воспользуйтесь формулами, расчётами и проч.
  - В исходный отчет в системе **загрузите обновленный файл**. 

{{ :product:reports:dashboard_illustration_4_rus.png?nolink&450 |}}

<grid>
<col lg="8" md="6">
<callout type="success" icon="glyphicon glyphicon-refresh">
Исходные данные в источнике (объект или отчёт) изменились -- они изменятся и в отчёте "Электронная таблица". 

=> Итоговые данные отчета пересчитаются по заданным в MS Excel формулам.
</callout>
</col>
</grid>
<callout type="primary" icon="true">
Если:
  * отчёт используется как источник данных для [[product:dashboard|дашборда]] -- [[product/reports/excel_table_report/update_mode|задайте для него режим обновления]];
  * отчёт должен быть на Рабочем столе или на странице проекта -- [[product/reports/widget|выведите его превью]];
  * отчёт будет формой для печати -- [[product:reports:excel_table_report:template|включите в нём режим шаблона и создайте в нём заготовку страницы для печати]].
</callout>

===== Источники отчёта =====

^ ^  [[#файл|Файл .xls(x)]]  ^  [[#данные_системы|Данные из системы ADVANTA]]  ^
^  Какие данные содержит|Которых может не быть в системе -- для подстановки в шаблоне, сопоставления, вычислений и т.п.|Данные объектов, справочников, отчётов, системных справочников, -- для последующей обработки и вычислений|
^  Как можно добавить|На втором шаге создания отчёта: загрузить файл|Меню -> Задать источник данных -> указать ID источников|
^:::|Когда отчёт уже создан: меню -> Изменить -> Электронная таблица -> загрузить файл|:::|
^  Особенность данных|Константы или формулы Excel. \\ Значения, которые не меняются в зависимости от изменений в системе.|Переменные значения, которые таблица собирает из системы.|

<callout type="warning" icon="fa fa-users">
Для загрузки данных из проекта в отчет необходимо обладать соответствующими [[product:access:about|правами]]. 

Выгруженные данные из отчетов отфильтрованы в соответствии с правами пользователя.</callout>

==== Файл ====

<callout title="Расширение файла -- только маленькими буквами!" type="danger" icon="fa fa-text-height">
Расширение загружаемой таблицы должно быть прописными буквами!

Например, файл с названием ''REPORT_test_1.XLSX'' не загрузится. А файл ''REPORT_test_1.xlsx'' загрузится нормально.
</callout>

=== На втором шаге формирования отчёта ===

Вторым шагом создания отчёта "Электронная таблица" система предлагает вам загрузить файл -- именно это и есть возможный источник для отчёта -- файл  с расширением ''.xsl(x)'' (формат MS Excel). \\ 
//Если загружать данные из файла на этом этапе вам не нужно, пропустите загрузку.//

<image shape="thumbnail">{{ :product:reports:report_excel_table_1.png?nolink |Выбор файла для загрузки данных в отчет}}</image>

=== Из существующего отчёта ===

На любом этапе жизни отчёта вы можете загрузить файл в отчёт "Электронная таблица".

<callout type="danger" title="Важно!" icon="true">
При импорте файла в уже сформированный отчёт, все данные, все вкладки затрутся -- они заменятся содержимым загружаемой таблицы.

Это также актуально, если используются **данные из системы**, затем **выгружаются** в файл, который вы **правите**, дополняете расчётами, листами и проч., -- и после **загружаете обратно**. \\ 
Т.е. фактически для любого процесса, в котором вы первоначально формируете отчёт нужного вида.
</callout>

Чтобы загрузить файл: 
  - меню (три точки) -> "Изменить";
  - поле "Электронная таблица" -> "Выберите файл" -> выберите файл и загрузите его.

<image shape="thumbnail">{{ :product:reports:report_excel_table_3.png?nolink |Выбор файла для загрузки данных в отчет}}</image>
==== Данные системы ====
Подробно о том, как добавить в Электронную таблицу [[product/reports/excel_table_report/system_source|в качестве источника данных данные самой системы]]

=====Параметры отчета=====

Чтобы зайти в параметры отчёта: **меню (три точки) -> "Изменить"**.

<image shape="thumbnail">{{ :product:reports:report_excel_table_3.png?nolink |Параметры отчета}}</image>

==== "Использовать шаблон" ====
Инструмент позволяет добавить в отчёт шаблон для вывода данных или для печати. 

Вы можете сделать заготовку, которая будет подтягивать и отображать данные из системы в нужном вам порядке, представлении и проч. -- на вашем визуальном шаблоне.

Подробно о том, [[product/reports/excel_table_report/template|как настроить шаблон]].

==== "Скрытые вкладки недоступны пользователям" ====

Отчёт может содержать до нескольких десяток вкладок, причём большая их часть -- служебные, а для пользователя представляет ценность одна или две вкладки.

Скройте вспомогательные вкладки в [[product:reports:public_reports|публичном отчёте]].

===Если "Скрытые вкладки..." включены ===
  * Пользователю [[product:reports:public_reports|публичного отчета]] опция не видна и изменить ее значение он не может.
  * При активации опции ранее скрытые в отчете вкладки не видны и их невозможно отобразить, выбрав в меню «Отобразить лист». Справедливо для всех пользователей, включая администратора и автора отчета.
  * При экспорте отчета скрытые вкладки не видны и их невозможно отобразить (для всех пользователей, включая администратора и автора отчета).
  * При копировании отчета владельцу копии отчета опция «Скрытые вкладки недоступны пользователям» доступна и все скрытые вкладки доступны для отображения.

==== "Включить адрес системы для создания ссылок" ====

При включении опции в отчёте появляется еще одна вкладка ''BaseUrl'', где в ячейке A1 отображается адрес этой системы ADVANTA.

==== "Режим расчёта" ====

  * "Рекурсивный" -- до [[releases:start|версии системы]] 3.18 включительно установлен по умолчанию. Более быстрый способ расчёта. НО может давать сбой в случае сложных вычислений, множества формул на страницах электронной таблицы.  \\  Когда надо переключиться с рекурсивного режима? -- Только если отчёт работает некорректно и/или файл отчёта не выгружается из системы.
  * "Основанный на цепочках (повышенное потребление памяти)" -- способ расчёта для отчёта с большим количеством формул. Начиная с [[releases:start|версии]] 3.19 установлен как режим по умолчанию.  \\  Когда стоит переключиться с "Основанного на цепочках"? -- Если отчёт работает слишком медленно.

<callout icon="fa fa-cog" color="#9954BB">
Переключатель доступен только для администратора системы.
</callout>

===== Экспорт отчёта =====
По умолчанию доступен только экпорт в Excel-формате. Но можно дополнительно включить экспорт и в текстовые форматы:
  * .rtf
  * .doc
  * .pdf

[[product/reports/excel_table_report/export|Настройка и экспорт отчёта "Электронная таблица"]]

=====Расписание обновления данных=====

[[product/reports/excel_table_report/update_mode|Как и зачем настраивать расписание обновления отчёта]].

===== Превью отчёта =====

Отчёт "Электронная таблица" можно вывести на карточку объекта [[product:reports:public_reports|как ярлык-ссылку]] или [[product/reports/widget|в качестве превью]].

[[product/reports/public_reports|Как вывести отчёт на карточку объекта или в модуль на Рабочий стол]]

---------------------

<callout type="success" title="См. также по теме «Электронные таблицы»">
  * [[product/objects/admin/reports|Отчёты на карточке объекта]]
  * [[product/reports/excel_table_report/template|Кейс: Электронная таблица с шаблоном]]
  * [[product:reports:excel_table_report:case_selected_period|Кейс: Электронная таблица за произвольный период]]
</callout>

<html>
<!--
=====Пример =====

<btn collapse="case">Развернуть пример отчёта "Электронная таблица"</btn>
<collapse id="case" collapsed="true">
<well>
  - Выгрузите данные по проекту в отчет с типом «Электронная таблица», сохраните файл (Рисунок 9).  \\  <image shape="thumbnail">{{ :product:reports:report_excel_table_9.png?nolink |}}</image>  \\  <TEXT align="center">**Рисунок 9** -- Работа с электронной таблицей: вкладка "Structure"</text>
  - В MS Excel, на вкладку ''Лист1'' cкопируйте требуемые данные и настройте формулы. <callout type="info">Рекомендуем использовать формулы вместо арифметических операций, т.к формулы умеют игнорировать некорректные значения, которые могут быть выгружены из отчетов других типов. \\ Пример: ''=A1+A2+A3'' -- **не** рекомендуется использовать; \\ ''=SUM(A1;A2;A3)'' -- **рекомендуется**.</callout>
  - Зайдите снова в отчет «Электронная таблица»:
    - Меню (три точки) → «Изменить».
    - В открывшемся окне вкл чек-бокс «Использовать шаблон» и выберите отредактированный файл.
    - Проверьте, что на вкладке ''Лист1'' значения сформированы формулами (Рисунок 10). При изменении данных в проекте, они автоматически обновятся и на этой вкладке.  \\  <image shape="thumbnail">{{ :product:reports:report_excel_table_10.png?nolink |}}</image>  \\  <TEXT align="center">**Рисунок 10** -- Работа с электронной таблицей: вкладка «Лист1»</text>
  - На вкладке «Template» создаем нужный нам шаблон будущего документа для печати (Рисунок 11). При это используем одну из указанных выше функций. После создания шаблона нажимаем кнопку «Обновить результаты».  \\  <image shape="thumbnail">{{ :product:reports:report_excel_table_11.png?nolink |}}</image>  \\  <TEXT align="center">**Рисунок 11** -- Работа с электронной таблицей: вкладка «Template»</text>
  - На вкладке «Result» получаем документ, готовый к печати (Рисунок 12). \\ <image shape="thumbnail">{{ :product:reports:report_excel_table_12.png?nolink |}}</image>  \\ <TEXT align="center">**Рисунок 12** -- Работа с электронной таблицей: вкладка «Result»</text>
</well>
</collapse>
-->
</html>