Универсальный Python-коннектор к 1С - COM, HTTP, запросы, метаданные, поиск по GUID

```python

def execute_query(connection, query_text: str):

    """Выполнение запроса. Работает одинаково для COM и HTTP."""

    if isinstance(connection, Http1CConnection):

        cols, rows = connection.execute_query_http(query_text)

        return _HttpSelection(cols, rows)

    # COM: создаём запрос, выполняем, получаем выборку

    query = connection.NewObject("Query", query_text)

    result = query.Execute()

    return result.Choose()

def execute_query_unload(connection, query_text: str):

    """Выполнение запроса с выгрузкой в таблицу значений."""

    if isinstance(connection, Http1CConnection):

        cols, rows = connection.execute_query_http(query_text)

        return (cols, rows)

    query = connection.NewObject("Query", query_text)

    result = query.Execute()

    return result.Unload()

```

```python

class Http1CConnection:

    """Обёртка HTTP-подключения. Совместима по интерфейсу с COM."""

    def __init__(self, execute_url: str, auth: tuple):

        self._execute_url = execute_url

        self._auth = auth

    def _post(self, payload: dict) -> dict:

        headers = {"Content-Type": "application/json; charset=utf-8"}

        headers.update(_http_basic_auth_headers(*self._auth))

        body = json.dumps(payload, ensure_ascii=True)

        r = requests.post(self._execute_url,

                          data=body.encode("utf-8"),

                          headers=headers, timeout=120)

        if r.status_code != 200:

            raise RuntimeError(f"HTTP {r.status_code}: {r.text[:300]}")

        data = r.json()

        if "error" in data:

            raise RuntimeError(data["error"])

        return data

    def execute_query_http(self, query_text: str, params: dict = None):

        """Выполнить запрос, вернуть (columns, rows)."""

        data = self._post({"query": query_text, "params": params or {}})

        return data.get("columns", []), data.get("rows", [])

    def get_metadata(self) -> dict:

        """Получить метаданные через HTTP."""

        return self._post({"action": "metadata"})

```

• Справочники показывают элементы, реквизиты, табличные части и иерархию.

• Документы — заголовочные реквизиты, табличные части и движения.

• Регистры сведений — измерения, ресурсы и реквизиты.

• Регистры накопления — измерения, ресурсы и регистратор.

• Константы — значения с возможностью просмотра и записи.

• Планы счетов — счета с реквизитами.

• Перечисления — значения перечислений.

• Планы видов характеристик — виды характеристик.

• Бизнес-процессы и Задачи — объекты с реквизитами.

```python

def _export_csv(tree_widget, filepath):

    """Экспорт содержимого Treeview в CSV."""

    cols = list(tree_widget["columns"])

    rows = [[tree_widget.set(cid, col) for col in cols]

            for cid in tree_widget.get_children("")]

    with open(filepath, "w", newline="", encoding="utf-8-sig") as f:

        writer = csv.writer(f, delimiter=";")

        writer.writerow(cols)

        writer.writerows(rows)

```

• F5 — выполнить запрос / загрузить данные
• Ctrl+Q — окно прямого запроса
• Ctrl+F — фокус на поле фильтра
• Ctrl+R — обновить данные
• Ctrl+C — копировать таблицу в буфер
• F11 — развернуть на весь экран

py 1c_connector_gui.py

1. Запустить приложение

2. Указать путь к базе, логин, пароль

3. Нажать «Подключиться»

4. Ctrl+Q → ввести запрос → F5

5. Результат — в таблице. Ctrl+C — скопировать в Excel.

1. Подключиться к базе

2. Меню «Инструменты → Поиск по GUID»

3. Вставить GUID из лога

4. Нажать «Найти»

5. Увидеть: это Реализация товаров от 15.03.2025, контрагент ООО «Ромашка»

6. Двойной клик — открыть карточку документа

1. Подключиться

2. Выбрать тип «Справочники» → объект «Номенклатура»

3. Нажать «Загрузить»

4. Открыть фильтр (Ctrl+F) → выбрать поле «Наименование» → ввести «кабель»

5. Нажать «Применить» — отображаются только позиции с «кабель» в наименовании

6. Двойной клик по строке — карточка с реквизитами и табличными частями

1. Подключиться

2. Выполнить запрос: `ВЫБРАТЬ Наименование, Артикул, Цена ИЗ Справочник.Номенклатура`

3. Нажать «Экспорт CSV»

4. Выбрать путь сохранения

5. Открыть в Excel — данные готовы

1. Администратор настраивает HTTP-сервис в 1С (один раз)

2. Пользователь запускает EXE, выбирает тип «HTTP»

3. Вводит URL: `http://server.company.ru/erp`

4. Работает так же, как при COM — запросы, метаданные, экспорт

```python

def _format_value(val, connection=None):

    """Преобразование значения COM в строку для отображения."""

    if val is None:

        return ""

    if hasattr(val, "strftime"):

        return val.strftime("%Y-%m-%d %H:%M:%S")

    if isinstance(val, (int, float)):

        return str(val)

    if isinstance(val, bool):

        return "Да" if val else "Нет"

    s = str(val)

    if "comobject" in s.lower():

        if connection:

            # Попытка получить представление через COM-методы

            for attr in ("GetPresentation", "Представление",

                         "Наименование", "Name"):

                m = getattr(val, attr, None)

                if m and callable(m):

                    r = m()

                    if r and str(r).strip():

                        return str(r)

        return ""

    return s

```

```

_metadata_cache         → список объектов по типам

_metadata_attrs_cache   → реквизиты объектов

_metadata_table_cols_cache → колонки табличных частей

_metadata_ref_fullname_cache → полные имена типов ссылок

```