Main Content

slreq.dngSetSessionConfig

Set configuration context for IBM DOORS Next session

Since R2023b

    Description

    slreq.dngSetSessionConfig(config) sets the configuration context to config for the IBM® DOORS® Next session.

    example

    slreq.dngSetSessionConfig(config,skipCheck) sets the configuration context without checking for configuration context consistency in IBM DOORS Next when check is true.

    example

    Examples

    collapse all

    This example shows how to get and set the configuration context in the current project for the IBM DOORS Next session.

    Specify the server address, requirements management service root, and the username.

    rmipref(OslcServerAddress="https://localhost:9443");
    rmipref(OslcServerRMRoot="rm");
    rmipref(OslcServerUser="jdoe");

    Establish the connection by specifying the project, configuration context, whether to test the connection from the system browser to MATLAB®, and the custom authentication callback function myPasswordHelperCallback. The function myPasswordHelperCallback gets the password. For more information, see setCustomLoginProvider.

    slreq.dngConfigure("My Project","My Project Initial Stream", ...
        true,"myPasswordHelperCallback")
    Performing default system browser message test.
    	If browser warns about a missing certificate for 127.0.0.1,
    	please allow the connection or add exemption for 127.0.0.1.
    	https://127.0.0.1:31515/matlab/oslc/inboundTest

    Get the available configuration contexts for the project.

    configs = slreq.dngGetProjectConfig
    configs = 
    
      1×8 struct array with fields:
    
        id
        name
        type
        url

    Set the configuration context to the first configuration context in the structure array.

    slreq.dngSetSessionConfig(configs(1))

    This example shows how to get and set the configuration context in the current project for the IBM DOORS Next session without checking for the configuration context consistency in IBM DOORS Next.

    Specify the server address, requirements management service root, and the username.

    rmipref(OslcServerAddress="https://localhost:9443");
    rmipref(OslcServerRMRoot="rm");
    rmipref(OslcServerUser="jdoe");

    Establish the connection by specifying the project, configuration context, whether to test the connection from the system browser to MATLAB, and the custom authentication callback function myPasswordHelperCallback. The function myPasswordHelperCallback gets the password. For more information, see setCustomLoginProvider.

    slreq.dngConfigure("My Project","My Project Initial Stream", ...
        true,"myPasswordHelperCallback")
    Performing default system browser message test.
    	If browser warns about a missing certificate for 127.0.0.1,
    	please allow the connection or add exemption for 127.0.0.1.
    	https://127.0.0.1:31515/matlab/oslc/inboundTest

    Get the available configuration contexts for the project.

    configs = slreq.dngGetProjectConfig
    configs = 
    
      1×8 struct array with fields:
    
        id
        name
        type
        url

    Set the configuration context to the first configuration context in the structure array. Do not check for configuration context consistency in IBM DOORS Next.

    slreq.dngSetSessionConfig(configs(1),true)

    Input Arguments

    collapse all

    Configuration context, specified as a string scalar, character vector, or a structure. You can enter the name of a configuration context by specifying a string scalar or character vector. Alternatively, you can enter the configuration context structure returned by the slreq.dngGetProjectConfig or slreq.dngGetSessionConfig functions.

    Data Types: char | string | struct

    Option to bypass the configuration context consistency check in the IBM DOORS Next server, specified as a numeric or logical 0 (false) or 1 (true). Set this value to true to bypass the check.

    Tip

    You can use this argument to set the configuration context for the IBM DOORS Next session when the MathWorks Requirements Toolbox widget is not installed on your IBM DOORS Next server, or if the widget is not communicating to Requirements Toolbox™.

    Data Types: logical

    Version History

    Introduced in R2023b