Activar el registro en SMath Studio

Si encuentra un problema o un comportamiento inesperado en SMath Studio, activar el registro integrado ayuda a diagnosticarlo. El archivo de registro recoge información de traza detallada que usted (o su distribuidor de software) puede usar para identificar la causa.

Requisitos previos

Averigüe dónde está instalado SMath Studio:

• Instalación para todo el equipo: C:\Program Files (x86)\SMath\ (o similar)
• Instalación por usuario: la carpeta de su perfil de usuario (p. ej., C:\Users\<SuNombre>...)

Activar el registro

1. Cierre todas las instancias de SMath Studio. Asegúrese de que todos los procesos de SMath Studio están cerrados antes de editar el archivo de configuración.
2. Vaya a la carpeta de instalación de SMath Studio y abra el archivo Solver.exe.config con un editor de texto (p. ej., el Bloc de notas). Nota: si SMath Studio se instaló para todo el equipo, puede que necesite permisos de administrador para modificar este archivo. Haga clic con el botón derecho en su editor de texto y elija Ejecutar como administrador.

3. Quite los comentarios de los bloques de registro. El archivo contiene dos bloques comentados de forma predeterminada. Hay que eliminar los marcadores de comentario XML (<!-- y -->) para que la configuración se active.

   Este es el contenido predeterminado (comentado): tanto los elementos <source> como el elemento de escucha <add> están dentro de comentarios:

   <?xml version="1.0" encoding="utf-8"?>
   <configuration>
     <system.diagnostics>
       <sources>
         <!--
           The name attribute of <source> element is split by dot in order to build the hierarchy of sources for loggers.
           The source with name="root" defines the root in the hierarchy.
           Use attribute newSwitch="true" in order to redefine the switch for the related source and its descendants.
           Use attribute newListeners="true" in order to redefine the listeners for the related source and its descendants.
           Supported values of attribute switchValue in order of verbosity: "Off" (default), "Critical", "Error", "Warning", "Information", "Verbose"
         -->
         <!--
         <source name="root">
           <listeners>
             <add name="file" />
           </listeners>
         </source>
         <source name="SMath.Controls" newSwitch="true" switchValue="Error" />
         <source name="SMath.Environment" newSwitch="true" switchValue="Error" />
         <source name="SMath.Document" newSwitch="true" switchValue="Error" />
         <source name="SMath.Manager" newSwitch="true" switchValue="Error" />
         <source name="SMath.UI" newSwitch="true" switchValue="Error" />
         -->
       </sources>
       <sharedListeners>
         <!-- Writes trace to file -->
         <!--
         <add name="file"
              type="SMath.Manager.Logging.FileTraceListener, SMath.Manager"
              traceOutputOptions="DateTime,ProcessId,ThreadId"
              initializeData="%APPDATA%\SMath\Solver.log"/>
         -->
       </sharedListeners>
       <trace autoflush="true" indentsize="4" />
     </system.diagnostics>
   </configuration>
   

   Quite los comentarios de los dos bloques XML que contienen la configuración real (los elementos <source> y el elemento de escucha <add>), pero conserve el comentario descriptivo (el primer bloque de comentario, con texto explicativo). Después, el archivo debería quedar así:

   <?xml version="1.0" encoding="utf-8"?>
   <configuration>
     <system.diagnostics>
       <sources>
         <!--
           The name attribute of <source> element is split by dot in order to build the hierarchy of sources for loggers.
           The source with name="root" defines the root in the hierarchy.
           Use attribute newSwitch="true" in order to redefine the switch for the related source and its descendants.
           Use attribute newListeners="true" in order to redefine the listeners for the related source and its descendants.
           Supported values of attribute switchValue in order of verbosity: "Off" (default), "Critical", "Error", "Warning", "Information", "Verbose"
         -->
         <source name="root">
           <listeners>
             <add name="file" />
           </listeners>
         </source>
         <source name="SMath.Controls" newSwitch="true" switchValue="Error" />
         <source name="SMath.Environment" newSwitch="true" switchValue="Error" />
         <source name="SMath.Document" newSwitch="true" switchValue="Error" />
         <source name="SMath.Manager" newSwitch="true" switchValue="Error" />
         <source name="SMath.UI" newSwitch="true" switchValue="Error" />
       </sources>
       <sharedListeners>
         <!-- Writes trace to file -->
         <add name="file"
              type="SMath.Manager.Logging.FileTraceListener, SMath.Manager"
              traceOutputOptions="DateTime,ProcessId,ThreadId"
              initializeData="%APPDATA%\SMath\Solver.log"/>
       </sharedListeners>
       <trace autoflush="true" indentsize="4" />
     </system.diagnostics>
   </configuration>
   

   Consejo: quite los comentarios solo de los elementos XML que contienen estructuras XML anidadas (los elementos <source> y <add>). El texto puramente descriptivo debe seguir como comentario.

4. Guarde el archivo Solver.exe.config modificado y cierre el editor de texto.

5. Abra SMath Studio y repita los pasos que provocaron el problema. La aplicación escribirá ahora la traza en el archivo de registro.
6. Recupere el archivo de registro. Vaya a la carpeta de registros (no requiere permisos de administrador): %APPDATA%\SMath\ (pulse Win+R, escriba la ruta y pulse Enter para abrirla rápidamente). El archivo de registro es Solver.log.
7. Examine el registro. Abra Solver.log en un editor de texto y vaya a las últimas líneas: las entradas más recientes son donde suele quedar recogido el problema. Identifique usted mismo el mensaje de error o excepción, o adjunte el archivo de registro (o su parte relevante) a una solicitud de soporte a su distribuidor de software.

Desactivar el registro

Una vez resuelto el problema o enviado el registro, se recomienda volver a desactivar el registro:

1. Cierre SMath Studio.
2. Vuelva a comentar los dos bloques XML de Solver.exe.config (restaure el estado original mostrado arriba).
3. Guarde el archivo.
4. Si lo desea, elimine %APPDATA%\SMath\Solver.log para limpiar.

Nota: si deja el registro activo, el archivo Solver.log crecerá sin control con el tiempo, ocupando espacio en disco y pudiendo ralentizar las operaciones con archivos. Restaurar el estado predeterminado (comentado) al terminar el diagnóstico es una buena práctica.