Skip to content

Commit

Permalink
Merge pull request #3284 from 1c-syntax/translations_cb8aedc9617757e7…
Browse files Browse the repository at this point in the history
…24c1c96a722d1045_en

Updates for file docs/diagnostics/ExternalAppStarting.md in en
  • Loading branch information
theshadowco authored May 27, 2024
2 parents 8a1578b + 0e6756b commit 1171ce7
Showing 1 changed file with 64 additions and 2 deletions.
66 changes: 64 additions & 2 deletions docs/en/diagnostics/ExternalAppStarting.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,76 @@
<!-- Блоки выше заполняются автоматически, не трогать -->
## Description
<!-- Описание диагностики заполняется вручную. Необходимо понятным языком описать смысл и схему работу -->
To improve the quality and security of 1C solutions, it is necessary to control the launch of external applications from 1C code.

This rule applies to all methods of launching external programs, including:
- System
- RunSystem
- RunApp
- BeginRunningApplication
- RunAppAsync
- GotoURL or FileSystems.OpenURL
- FileSystemsClient.RunApp (for client side) and FileSystems.RunApp (for server side)
- FileSystemClient.OpenExplorer
- FileSystemClient.OpenFile

## Examples
<!-- В данном разделе приводятся примеры, на которые диагностика срабатывает, а также можно привести пример, как можно исправить ситуацию -->
```bsl
Процедура Метод()
СтрокаКоманды = "";
ТекущийКаталог = "";
ДождатьсяЗавершения = Истина;
ОписаниеОповещения = Неопределено;
ПараметрыКоманды = Новый Структура;
КомандаСистемы(СтрокаКоманды, ТекущийКаталог); // есть замечание
ЗапуститьПриложение(СтрокаКоманды, ТекущийКаталог); // есть замечание
ЗапуститьПриложение(СтрокаКоманды, ТекущийКаталог, Истина); // есть замечание
НачатьЗапускПриложения(ОписаниеОповещения, СтрокаКоманды, ТекущийКаталог, ДождатьсяЗавершения); // есть замечание
ПерейтиПоНавигационнойСсылке(СтрокаКоманды); // есть замечание
ФайловаяСистемаКлиент.ОткрытьНавигационнуюСсылку(СтрокаКоманды); // есть замечание
ФайловаяСистемаКлиент.ОткрытьНавигационнуюСсылку(СтрокаКоманды, ОписаниеОповещения); // есть замечание
ФайловаяСистемаКлиент.ЗапуститьПрограмму("ping 127.0.0.1 -n 5", ПараметрыКоманды); // есть замечание
ФайловаяСистемаКлиент.ЗапуститьПрограмму(СтрокаКоманды, ПараметрыКоманды); // есть замечание
ФайловаяСистема.ЗапуститьПрограмму(СтрокаКоманды); // есть замечание
ФайловаяСистема.ЗапуститьПрограмму(СтрокаКоманды, ПараметрыКоманды); // есть замечание
ФайловаяСистемаКлиент.ОткрытьПроводник("C:\Users"); // есть замечание
ФайловаяСистемаКлиент.ОткрытьФайл(СтрокаКоманды); // есть замечание
ФайловаяСистемаКлиент.ОткрытьФайл(СтрокаКоманды, ОписаниеОповещения); // есть замечание
КонецПроцедуры
&НаКлиенте
Асинх Процедура Подключить()
СтрокаКоманды = "";
ТекущийКаталог = "";
ДождатьсяЗавершения = Истина;
Ждать ЗапуститьПриложениеАсинх(СтрокаКоманды, ТекущийКаталог, ДождатьсяЗавершения); // есть замечание
КонецПроцедуры
&НаКлиенте
Процедура ПроверкаЗапуститьСистему(ДополнительныеПараметрыКоманднойСтроки, КодВозврата)
ДождатьсяЗавершения = Истина;
ЗапуститьСистему(); // есть замечание
ЗапуститьСистему(ДополнительныеПараметрыКоманднойСтроки); // есть замечание
ЗапуститьСистему(ДополнительныеПараметрыКоманднойСтроки, ДождатьсяЗавершения); // есть замечание
ЗапуститьСистему(ДополнительныеПараметрыКоманднойСтроки, ДождатьсяЗавершения, КодВозврата); // есть замечание
КонецПроцедуры
```

## Sources
<!-- Необходимо указывать ссылки на все источники, из которых почерпнута информация для создания диагностики -->
<!-- Примеры источников
* Источник: [Стандарт: Тексты модулей](https://its.1c.ru/db/v8std#content:456:hdoc)
* Полезная информация: [Отказ от использования модальных окон](https://its.1c.ru/db/metod8dev#content:5272:hdoc)
* Source: [Standard: Modules (RU)](https://its.1c.ru/db/v8std#content:456:hdoc)
* Useful information: [Refusal to use modal windows (RU)](https://its.1c.ru/db/metod8dev#content:5272:hdoc)
* Источник: [Cognitive complexity, ver. 1.4](https://www.sonarsource.com/docs/CognitiveComplexity.pdf) -->
- [Standard: Application launch security (RU)](https://its.1c.ru/db/v8std#content:774:hdoc)
- Standard: [Restriction on the execution of "external" code (RU)](https://its.1c.ru/db/v8std/content/669/hdoc)

0 comments on commit 1171ce7

Please sign in to comment.