Merge branch 'release/24.12'

bia-technologies · Dec 9, 2024 · cc85031 · cc85031
2 parents 4f28d25 + 8b12403
commit cc85031
Show file tree

Hide file tree

Showing 108 changed files with 4,604 additions and 1,137 deletions.
diff --git a/.github/ISSUE_TEMPLATE/doc-feature.yaml b/.github/ISSUE_TEMPLATE/doc-feature.yaml
@@ -0,0 +1,36 @@
+name: '📖 Документация'
+description: 'Предложения по доработке документации'
+title: '[Doc]: '
+labels: ['documentation']
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: '📖 Описание предложения'
+      description: 'Общее описание необходимых доработок по документации'
+    validations:
+      required: true
+
+  - type: input
+    id: page
+    attributes:
+      label: Страница/раздел
+      description: Ссылка на страницу или наименование раздела
+
+  - type: textarea
+    id: problems
+    attributes:
+      label: 'Неучтенные кейсы документации'
+      description: |
+        * Нераскрытые в документации вопросы (можно ссылками на обсуждение).
+        * Примеры неправильного использования
+        * Прочие, желательно реальные, примеры проблем связанных с документацией
+
+  - type: textarea
+    id: tasks
+    attributes:
+      label: Перечень необходимых доработок
+      value: |
+        - [ ] Описать то-то
+        - [ ] Исправить опечатку там то
+        - [ ] Дополнить примерами такой то раздел
diff --git a/.github/workflows/build-release.yml b/.github/workflows/build-release.yml
@@ -28,7 +28,7 @@ jobs:
 
     steps:
       - name: Установка 1С:Предприятие 8.3.21.1895
-        uses: alkoleft/onec-setup-build-env-action@develop
+        uses: 1CDevFlow/onec-setup-action@main
         with:
           type: onec
           onec_version: 8.3.21.1895

diff --git a/.github/workflows/sonar-qube-analysis.yml b/.github/workflows/sonar-qube-analysis.yml
@@ -6,64 +6,9 @@ on:
 
 jobs:
   SonarQualityGate:
-    runs-on: ubuntu-latest
-    steps:
-    - name: Извлечение исходников PR
-      if: github.event_name == 'pull_request_target' || github.event_name == 'pull_request'
-      uses: actions/checkout@v4
-      with:
-        ref: refs/pull/${{ github.event.number }}/merge # Для поддержки pull_request и pull_request_target
-        fetch-depth: 0 # Получение полной истории (все тэги и ветки)
-
-    - name: Извлечение исходников ветки ${{ github.ref_name }}
-      if: github.event_name == 'push'
-      uses: actions/checkout@v4
-      with:
-        fetch-depth: 0 # Получение полной истории (все тэги и ветки)
-
-    - name: Извлечение версии проекта
-      uses: ./.github/actions/extract-version
-      with:
-        path: ./exts/yaxunit/src
-      id: extract_version
-
-    # Анализ проекта в SonarQube (ветка)
-    - name: Анализ в SonarQube (${{ github.ref_name }})
-      if: github.event_name == 'push'
-      uses: sonarsource/[email protected]
-      env:
-          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
-          LC_ALL: "ru_RU.UTF-8"
-      with:
-        args: >
-          -Dsonar.host.url=https://sonar.openbsl.ru
-          -Dsonar.branch.name=${{ github.ref_name }}
-          -Dsonar.projectVersion=${{ steps.extract_version.outputs.version }}
-          -Dsonar.qualitygate.wait=true
-          -Dsonar.qualitygate.timeout=300
-
-    # Анализ проекта в SonarQube (PR)
-    # https://docs.sonarqube.org/latest/analysis/pull-request/
-    - name: Анализ в SonarQube (pull-request ${{ github.event.number }})
-      if: github.event_name == 'pull_request_target' || github.event_name == 'pull_request'
-      uses: sonarsource/[email protected]
-      env:
-          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
-      with:
-        args: >
-          -Dsonar.host.url=https://sonar.openbsl.ru
-          -Dsonar.pullrequest.key=${{ github.event.pull_request.number }}
-          -Dsonar.pullrequest.branch=${{ github.event.pull_request.head.ref }}
-          -Dsonar.pullrequest.base=${{ github.event.pull_request.base.ref }}
-          -Dsonar.scm.revision=${{ github.event.pull_request.head.sha }}
-          -Dsonar.qualitygate.wait=true
-          -Dsonar.qualitygate.timeout=300
-
-    - name: Публикация результата проверки PR
-      if: github.event_name != 'push' && (success()||failure())
-      uses: 1CDevFlow/sonar-review-action@main
-      with:
-        sonar_branch_plugin: true
-      env:
-        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    uses: "1CDevFlow/workflows/.github/workflows/sonar-analysis-with-openbsl.yml@main"
+    with:
+      root-project-path: ./exts/yaxunit/src
+    secrets:
+      SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
 
diff --git a/.github/workflows/step-build-artifacts-windows.yml b/.github/workflows/step-build-artifacts-windows.yml
@@ -30,7 +30,7 @@ jobs:
     steps:
 
     - name: Установка 1С:Предприятие
-      uses: alkoleft/onec-setup-build-env-action@develop
+      uses: 1CDevFlow/onec-setup-action@main
       with:
         type: onec
         onec_version: ${{ inputs.v8_version }}

diff --git a/.github/workflows/step-export-xml.yml b/.github/workflows/step-export-xml.yml
@@ -58,7 +58,7 @@ jobs:
       id: extract_smoke_version
 
     - name: Установка 1C:EDT
-      uses: alkoleft/onec-setup-build-env-action@develop
+      uses: 1CDevFlow/onec-setup-action@main
       with:
         type: edt
         edt_version: ${{ inputs.edt_version }}

diff --git a/.github/workflows/step-run-tests.yml b/.github/workflows/step-run-tests.yml
@@ -62,7 +62,7 @@ jobs:
         Write-Output "substring=$('${{ inputs.locale }}'.Substring(0, 2))" >> $Env:GITHUB_OUTPUT
 
     - name: Установка 1С:Предприятие
-      uses: alkoleft/onec-setup-build-env-action@develop
+      uses: 1CDevFlow/onec-setup-action@main
       with:
         type: onec
         onec_version: ${{ inputs.v8_version }}
@@ -79,19 +79,19 @@ jobs:
       timeout-minutes: 5
 
     - name: Загрузка расширения c тестами
-      uses: alkoleft/yaxunit/.github/actions/load-extension@develop
+      uses: 1CDevFlow/workflows/actions/load-extension@main
       with:
         name: tests
         path: binary/tests.cfe
 
     - name: Загрузка расширения c дымовыми тестами
-      uses: alkoleft/yaxunit/.github/actions/load-extension@develop
+      uses: 1CDevFlow/workflows/actions/load-extension@main
       with:
         name: Smoke
         path: binary/smoke.cfe
 
     - name: Загрузка расширения YAxUnit
-      uses: alkoleft/yaxunit/.github/actions/load-extension@develop
+      uses: 1CDevFlow/workflows/actions/load-extension@main
       with:
         name: YAXUNIT
         path: binary/yaxunit.cfe

diff --git a/README.md b/README.md
@@ -1,15 +1,14 @@
-# ![Logo](documentation/static/img/logo.png) YAxUnit. Расширение для запуска тестов
+# ![Logo](documentation/static/img/logo.svg) YAxUnit. Расширение для запуска тестов
 
 ----
 
-[![Actions Status](https://github.com/bia-technologies/yaxunit/actions/workflows/sq.yml/badge.svg)](https://github.com/bia-technologies/yaxunit/actions)
-[![Download](https://img.shields.io/github/release/bia-technologies/yaxunit.svg?label=download&style=flat)](https://github.com/bia-technologies/yaxunit/releases/latest)
-[![GitHub Releases](https://img.shields.io/github/downloads/bia-technologies/yaxunit/latest/total?style=flat-square)](https://github.com/bia-technologies/yaxunit/releases)
+[![Проверка Sonar](https://github.com/bia-technologies/yaxunit/actions/workflows/sonar-qube-analysis.yml/badge.svg)](https://github.com/bia-technologies/yaxunit/actions/workflows/sonar-qube-analysis.yml)
 [![Quality Gate](https://sonar.openbsl.ru/api/project_badges/measure?project=yaxunit&metric=alert_status)](https://sonar.openbsl.ru/dashboard?id=yaxunit)
-[![Maintainability](https://sonar.openbsl.ru/api/project_badges/measure?project=yaxunit&metric=sqale_rating)](https://sonar.openbsl.ru/dashboard?id=yaxunit)
-
-[![Build and test](https://github.com/bia-technologies/yaxunit/actions/workflows/main-build.yml/badge.svg)](https://github.com/bia-technologies/yaxunit/actions/workflows/main-build.yml)
-[![Build ocumentation](https://github.com/bia-technologies/yaxunit/actions/workflows/deploy-documentation.yml/badge.svg)](https://github.com/bia-technologies/yaxunit/actions/workflows/deploy-documentation.yml)
+[![Maintainability](https://sonar.openbsl.ru/api/project_badges/measure?project=yaxunit&metric=sqale_rating)](https://sonar.openbsl.ru/dashboard?id=yaxunit)  
+[![Тестирование](https://github.com/bia-technologies/yaxunit/actions/workflows/perform-tests.yml/badge.svg)](https://github.com/bia-technologies/yaxunit/actions/workflows/perform-tests.yml)
+[![Сборка документации](https://github.com/bia-technologies/yaxunit/actions/workflows/deploy-documentation.yml/badge.svg)](https://github.com/bia-technologies/yaxunit/actions/workflows/deploy-documentation.yml)  
+[![Download](https://img.shields.io/github/release/bia-technologies/yaxunit.svg?label=download&style=flat)](https://github.com/bia-technologies/yaxunit/releases/latest)
+[![GitHub Releases](https://img.shields.io/github/downloads/bia-technologies/yaxunit/latest/total?style=flat-square)](https://github.com/bia-technologies/yaxunit/releases)  
 
 Обсудить в [Telegram чате](https://t.me/BIAOpenTools/12)
 

diff --git a/documentation/docs/features/mocking/mocking.md b/documentation/docs/features/mocking/mocking.md
@@ -147,6 +147,41 @@ sequenceDiagram
   * `ЮТест.Данные().ADORecordSet` - принимает информацию о колонках
   * `Добавить()` - добавляет новую строку значений
 
+### `СообщениеСервисаИнтеграции`
+
+При тестировании интеграций с помощью 1С:Шина есть потребность тестировать сбор/разбор сообщений сервисов интеграции.
+
+У `СообщениеСервисаИнтеграции` отсутствует конструктор, поэтому был добавлен [`ЮТест.Данные().СообщениеСервисаИнтеграции`](/api/ЮТТестовыеДанные#IntegrationServiceMessage) реализующий интерфейс `СообщениеСервисаИнтеграции`
+
+Возможности:
+
+* Реализует методы `СообщениеСервисаИнтеграции`
+  * Свойства
+    * `ДатаОтправки`
+    * `ДатаУстаревания`
+    * `Идентификатор`
+    * `ИдентификаторСообщенияЗапроса`
+    * `КодОтправителя`
+    * `КодПолучателя`
+    * `Параметры`
+    * `РазмерТела`
+  * Методы
+    * `ПолучитьТелоКакПоток()`
+* Имеет методы настройки, реализованные в виде [текучих выражений](/docs/getting-started/fluent-api.md)
+  * Установка тела
+    * `УстановитьТелоКакДвоичныеДанные()`
+    * `УстановитьТелоКакСтроку()`
+    * `УстановитьТелоКакСтрокуJSON()`
+  * Методы установки свойств
+    * `ДобавитьПараметр()`
+    * `ДатаОтправки()`
+    * `ДатаУстаревания()`
+    * `Идентификатор()`
+    * `ИдентификаторСообщенияЗапроса()`
+    * `КодОтправителя()`
+    * `КодПолучателя()`
+    * `РазмерТела()`
+
 ### Создание своих моков
 
 При возникновении подобных ситуаций, когда для тестов вам нужны объекты с какой-то логикой/методами, по аналогии с примерами выше вы без проблем сможете создать нужные вам моки.