Tema anterior: Eliminación de escenarios: remove_scenario()Tema siguiente: Sincronización en la ejecución de escenarios: synchronize()


Importación de escenarios: import_scenario()

La función de API import_scenario permite importar escenarios al servicio de control.

Argumentos

La función de API import_scenario incluye los argumentos descritos en la tabla siguiente:

Tipo

Nombre

Descripción

session_id

uint

El ID de sesión que se ha devuelto llamando a la API create_session.

group_id

uint

El ID de grupo de escenarios que desee importar. Si no está seguro del ID del grupo, establézcalo como 0xFFFFFFFF.

scenario_id

out uint

Recupera el ID de escenario cuando la API haya finalizado correctamente.

scenario_data

cadena

Los datos sobre el escenario. Normalmente, se recupera la cadena de datos del escenario desde un archivo de escenario. Los datos están en formato XML.

why_not_reason

out string

Contiene el motivo del error cuando se produce un error en esta API.

Valores de retorno

Los valores de retorno proporcionan datos al escenario en el formato de xml.

Ejemplo

public bool import_scenario_example()
        {
            try
            {
                uint scenario_id = 0;
                string why_not_reason = "";
                string scenario_data = "load the data from a scenario file.";
                uint group_id = 0xFFFFFFFF;
                return get_mng().import_scenario(_session_id, group_id,scenario_data,out scenario_id,out why_not_reason);
            }
            catch (Exception ex)
            {
                System.Windows.Forms.MessageBox.Show(ex.Message);
            }
            return false;
        }