ForeExec

Синтаксис

ForeExecResult ForeExec(ForeId tFore, ForeExecArg tArg)

Параметры

tFore. Моникёр объекта среды разработки, содержащего реализацию выполняемого метода.

tArg. Параметры выполнения операции.

Описание

Операция ForeExec выполняет методы, реализованные в Fore или Fore.NET модулях/сборках.

Комментарии

Для выполнения операции необходимо в поле tFore указать моникёр модуля/сборки/.NET-сборки, содержащего реализацию выполняемого метода. Моникёр может быть получен при выполнении операции GetObjects. В поле tArg.methodName укажите наименование выполняемого метода, а в поле tArg.args значения входных параметров метода. Если метод находится в Fore модуле/сборке, то его реализация должна располагаться в глобальном пространстве имен. В качестве значения поля tArg.methodName указывается наименование выполняемого метода. Если метод находится в Fore.NET сборке, то его реализация должна располагаться в классе. Выполняемый метод должен иметь модификаторы доступа Public и Shared. В качестве значения поля tArg.methodName указывается наименование метода в формате «класс».«метод».

Сигнатура метода должна содержать параметры простых типов и возвращать значение простого типа. Если метод возвращает какое-либо значение, то оно будет доступно в результате выполнения операции.

Если выполняемый метод содержит параметры с типом Object, то в качестве значения этих параметров должны передаваться строковые представления моникёров каких-либо объектов. При выполнении операции по моникёру будет получен и передан в выполняемый метод соответствующий объект репозитория. Для работы с этим объектом приведите его к интерфейсу, который описывает его структуру. Например, при передаче моникёра соединения с репозиторием параметр в методе будет иметь тип IMetabase, при передаче моникёра экспресс-отчета - IEaxAnalyzer и так далее.

Если передаётся моникёр бинарного объекта, сохранённого на сервере с помощью операции PutBin/PutBinary, то в выполняемом методе такой объект может быть приведён к интерфейсу IBinary.

Особенности работы

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

При выполнении Fore.NET-метода возникает ошибка об отсутствии зарегистрированного COM-класса

При выполнении Fore.NET-метода возникает ошибка «Catastrophic failure»

Работа с ярлыками

Рекомендации по использованию

При разработке веб-приложения, из которого предполагается запуск на выполнение различных Fore/Fore.NET методов, используйте следующие рекомендации:

Запрет выполнения операции ForeExec

Ввиду возможного использования операции ForeExec для выполнения кода, к которому конкретный пользователь не должен иметь доступа, существует ряд возможностей запрета выполнения операции:

Примечание. Более подробно о месте расположения параметров читайте в описании соответствующих файлов конфигурации.

<html>
<body>
    <script language="javascript" type="text/javascript">
    <!--...Предыдущий код приложения...-->
    <!--...-->
    <!--Функция для отправки JSON-запроса-->
    function PostRequest(url, request) {
        <!--...-->
        var xhr = new XMLHttpRequest();
        <!--...-->
        xhr.setRequestHeader('p-h', '1');
        <!--...-->
        xhr.send(JSON.stringify(request));
        <!--...-->
    }
    </script>
</body>
</html>

Пример

Различные варианты использования операции приведены в следующих примерах:

Наименование примера

См. также:

Специфические операции