We are implementing a Java plugin with batch/command-line execution to automate the following workflow in CATIA Magic (3DEXPERIENCE Power By):

• Launch CATIA Magic in batch mode
• Login to the 3DEXPERIENCE platform
• Create a project (Update Model)
• Save and commit the project to the server for transition activities

We are following the official documentation for command-line launchers and batch mode:

https://docs.nomagic.com/DEVG/2026x/implementing-command-line-launchers-254437340.html
https://docs.nomagic.com/DEVG/2026x/specifying-batch-mode-program-classpath-and-required-system-properties-254437301.html

Environment Details : 

CATIA Magic Version: 2024x (System of Systems Architect)

Operating System: Windows

3DEXPERIENCE Tenant: Private Cloud – R2026x FD01

We evaluated multiple approaches to authenticate to the 3DEXPERIENCE platform from CATIA Magic when launched in batch mode:

 1. TeamworkService (Cloud) via CommandLineAction

 API: ITeamworkService.login(ServerLoginInfo)

 Result: Connection failure

 Error indicates inability to resolve/connect to the 3DEXPERIENCE server (:443), even though the same server URL works in GUI mode.

 2. TeamworkService (Cloud) via CommandLineActionLauncher :

 API: ITeamworkService.login(ServerLoginInfo)

 Result: NullPointerException

 Stack trace points to TeamworkOptionsGroup.setMUUserPasswordAndEncrypt() during login

 Suggests missing or uninitialized teamwork context in batch mode

 3. DSClientProvider via ProjectCommandLineAction

 API: DSClientProvider.INSTANCE.connect(UsernamePasswordData)

 Result: Plugin not initialized

 Error: Local Project not found

 Login does not occur because project context is required before plugin execution

 4. DSClientProvider via CommandLineAction (Deprecated API)

 API: DSClientProvider.INSTANCE.connect(UsernamePasswordData)

 Result:  Successful

   Application launches

   Login succeeds

   Project is created successfully

 Issue: DSClientProvider is deprecated, and we want to avoid using unsupported APIs

Main Question

What is the recommended and supported Java API for logging into the 3DEXPERIENCE platform from CATIA Magic in batch/command-line mode?

Specifically:

1. Is there a replacement for DSClientProvider for batch login?
2. Is there any official documentation or example for 3DEXPERIENCE authentication via Java plugins in command-line execution?

Any guidance, best practices, or references would be greatly appreciated.

scriptbatchplugin