Modificar un archivo de configuración de Reporting Services (RSreportserver.config)Modify a Reporting Services Configuration File (RSreportserver.config)

Reporting ServicesReporting Services almacena la configuración de la aplicación en un conjunto de archivos de configuración.stores application settings in a set of configuration files. La instalación crea los archivos de configuración para cada instancia del servidor de informes que instala.Setup creates the configuration files for each report server instance you install. Dentro de cada archivo, los valores se establecen durante la instalación o al usar herramientas y aplicaciones para configurar un servidor para la operación.Within each file, values are either set during installation or when you use tools and applications to configure a server for operation. En algunos casos, debe modificar directamente un archivo para agregar o configurar la configuración avanzada.In some cases, you must modify a file directly to add or configure advanced settings. Los parámetros de configuración se especifican como atributos o elementos XML.Configuration settings are specified as either XML elements or attributes. Si comprende XML y los archivos de configuración, puede utilizar un editor de texto o de código para modificar las opciones de configuración definibles por el usuario.If you understand XML and configuration files, you can use a text or code editor to modify user-definable settings.

Algunos valores de configuración solo se pueden establecer a través de una herramienta.Some configuration settings can be set only through a tool. La configuración que contiene valores cifrados se debe modificar a través de la herramienta de configuración de Reporting Services, el programa de instalación o la utilidad de línea de comandos rsconfig .Settings that contain encrypted values must be modified through the Reporting Services Configuration tool, the Setup program, or the rsconfig command line utility. Debe ser miembro del grupo local de administradores para ejecutar estas herramientas.You must be a member of the local Administrators group to run these tools.'

Importante

Tenga cuidado al modificar los archivos de configuración.Use caution when modifying configuration files. Si modifica un parámetro reservado para uso interno, es posible que deshabilite la instalación.If you modify a setting that is reserved for internal use, you may disable your installation. En general, no se recomienda modificar los parámetros de configuración a no ser que esté intentando resolver un problema específico.Generally, modifying configuration settings is not recommended unless you are trying to solve a specific problem. Para obtener más información sobre qué valores de configuración se pueden cambiar con seguridad, vea El archivo de configuración RSReportServer.config o Archivo de configuración RSReportDesigner.For more information about which settings are safe to change, see RsReportServer.config Configuration File or RSReportDesigner Configuration File. Para más información sobre los archivos de configuración, consulte la documentación del producto de MicrosoftMicrosoft.NET Framework.NET Framework .For more information about configuration files, see the MicrosoftMicrosoft.NET Framework.NET Framework product documentation.

En este tema:In this topic:

Leer y usar valores de configuraciónReading and Using Configuration Values

Un servidor de informes lee los archivos de configuración cuando se inicia el servicio y siempre que se guarda el archivo de configuración.A report server reads the configuration files when the service starts and whenever the configuration file is saved. Los valores nuevos y revisados surten efecto en un nuevo dominio de aplicación cuando expira el dominio de aplicación actual.New and revised values take effect in a new application domain after the current application domain expires. Siempre que es posible, se permite que se completen las solicitudes que todavía se están procesando en el dominio de aplicación actual.Whenever possible, requests that are still processing in the current application domain are allowed to complete. Sin embargo, algunos valores requieren una operación inmediata de reciclaje de dominio de aplicación.However, a few settings require an immediate application domain recycle operation. En este caso, todas las solicitudes que se encuentran en proceso se reinician en un nuevo dominio de aplicación.In this case, all requests that are in process are restarted in a new application domain.

Si el servidor de informes detecta un valor no válido, registra un error en el registro de aplicación Windows y, o bien no puede iniciarse, o bien usa un valor predeterminado, dependiendo del error:If the report server detects an invalid value, the report server logs an error to the Windows application log and either fails to start or uses a default value, depending on the error:

  • Si el error se debe a XML con formato incorrecto, el servidor de informes no se iniciará.If the error is malformed XML, the report server will not start. Si el servidor de informes se está ejecutando cuando se incluye el error, pasará por alto el archivo de configuración no válido hasta que se reinicie o hasta que el dominio de aplicación se recicle.If the report server is running when you introduce the error, the report server ignores the invalid configuration file until the report server restarts or the application domain is recycled. Una vez detectado el error, no se iniciará el servidor de informes.Once the error is detected, the report server will no longer start.

  • Si el error es un valor de configuración no válido, el servidor usará valores predeterminados internos y registrará un error en los archivos de registro de seguimiento.If the error is an invalid configuration value, the server will use internal default values and log an error to the trace log files. En los pocos casos en los que los valores predeterminados internos no estén disponibles, el servidor devolverá el error rsServerConfigurationError si el valor de configuración no válido es vital para las operaciones del servidor.In the few cases where internal default values are not available, the server will return the rsServerConfigurationError error if the invalid configuration setting is critical to server operations. Los errores en los que se indica que la configuración crítica no es válida o que falta, se devuelven a la aplicación cliente en una página de error HTML y se anotan en el registro de eventos.Errors about missing or invalid critical settings are returned to the client application in an HTML error page and logged to the event log.

Todos los cambios del archivo de configuración, incluidos los cambios correctos, se registran en el archivo de registro de seguimiento del servidor de informes.All configuration file changes, including successful changes, are recorded in the report server trace log file. Solo los errores se registran en el registro de eventos de la aplicación.Only errors are logged to the application event log.

Sobre los valores predeterminadosAbout Default Values

La mayoría de los valores de configuración tienen valores predeterminados especificados internamente en el servidor de informes.Most configuration settings have default values that are specified internally in the report server. El servidor de informes usará estos valores si un valor definido por el usuario no es válido o no está especificado.The report server will use these values if a user-defined value is invalid or not specified. Si hay que usar un valor predeterminado debido a un valor de configuración no válido, se escribe un error en el archivo de registro de seguimiento.If a default value must be used due to an invalid configuration setting, an error is written to the trace log file.

Eliminar los parámetros de configuraciónDeleting Configuration Settings

Quitar del archivo de configuración las opciones de configuración con valores predeterminados no tiene ningún efecto.For configuration settings that have default values, removing the setting from the configuration file has no effect. La mayor parte de las opciones de configuración en realidad se definen y se configuran internamente.Most configuration settings are actually defined and configured internally. Si elimina un elemento del archivo de configuración, la copia interna todavía está disponible y se utiliza el valor predeterminado que se define para él.If you delete an item from the configuration file, the internal copy is still available and uses the default value that is defined for it.

Para editar un archivo de configuración de Reporting ServicesTo Edit a Reporting Services Configuration File

  1. Busque el archivo de configuración que desea editar:Find the configuration file you want to edit:

    • RSReportServer.config se encuentra en la siguiente carpeta:RSReportServer.config is located in the following folder:

      C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\ReportServer  
      
      Se aplica a:Applies to: Versión preliminar técnica de informes de Power BI en SQL Server Reporting Services de enero de 2017Se aplica a:Applies to: January 2017 Technical Preview of Power BI reports in SQL Server Reporting Services
      C:\Program Files\Microsoft SQL Server Reporting Services\RSServer\ReportServer
      
    • RSReportServerServices.exe.config se encuentra en la siguiente carpeta:RSReportServerServices.exe.config is located in the following folder:

      Nota

      En la versión de enero de 2017 de los informes de Power BI (Technical Preview) en SQL Server Reporting Services, esto no está disponible.This is not available with the January 2017 Technical Preview of Power BI reports in SQL Server Reporting Services.

      C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\ReportServer\bin  
      
    • RSReportDesigner.config se encuentra en la siguiente carpeta:RSReportDesigner.config is located in the following folder:

      C:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE\PrivateAssemblies  
      
  2. Guarde una copia del archivo en caso de que necesite revertir sus cambios.Save a copy of the file in case you need to roll back your changes.

  3. Abra el archivo original en el Bloc de notas o en un editor de código.Open the original file in Notepad or a code editor. No use Textpad; establece la longitud del archivo antes guardarlo, lo que hace que se escriba un error de carácter no válido en el archivo de registro de seguimiento.Do not use Textpad; it sets the file length before the file is saved, causing an invalid character error to be written to the trace log file.

  4. Escriba el elemento o valor que desea agregar o usar.Type the element or value that you want to add or use. Los elementos distinguen entre mayúsculas y minúsculas.Elements are case-sensitive. Si va a agregar un elemento, asegúrese de que usa las mayúsculas y minúsculas correctas.If you are adding an element, be sure to use the correct upper and lower case letters. Dispone de instrucciones concretas para editar archivos de configuración a la hora de personalizar extensiones de representación, de autenticación o de procesamiento de datos:Specific instructions for editing configuration files are available if you are customizing rendering extension, authentication extensions, or data processing extensions:

  5. Guarde el archivo.Save the file.

  6. Compruebe los archivos de registro de seguimiento para ver que no se produjeron errores.Check the trace log files to verify that errors did not occur. Si observa condiciones de error es porque una opción de configuración o su valor se especificó incorrectamente.If you see error conditions, a setting or its value is specified incorrectly. Examine El archivo de configuración RSReportServer.config para ver los valores válidos para cualquier configuración que esté produciendo un error.Review the RsReportServer.config Configuration File for valid values for any setting that is causing an error. Para obtener más información sobre cómo ver el registro de seguimiento, vea Registro de seguimiento del servicio del servidor de informes.For more information about how to view the trace log, see Report Server Service Trace Log.

Consulte tambiénSee Also

El archivo de configuración RSReportServer.config RsReportServer.config Configuration File
Archivo de configuración ReportingServicesService ReportingServicesService Configuration File
Archivo de configuración RSReportDesigner RSReportDesigner Configuration File
Implementación de una extensión de procesamiento de datos Deploying a Data Processing Extension
Implementación de una extensión de entrega Deploying a Delivery Extension
Implementación de una extensión de representación Deploying a Rendering Extension
Archivos de configuración de Reporting ServicesReporting Services Configuration Files