Class DesignerSessionThickClientLauncher
- java.lang.Object
-
- com._1c.g5.v8.dt.platform.services.core.runtimes.execution.impl.AbstractRuntimeComponentExecutor
-
- com._1c.g5.v8.dt.platform.services.core.runtimes.execution.impl.DesignerSessionThickClientLauncher
-
- All Implemented Interfaces:
IDesignerSessionThickClientLauncher
,IRuntimeClientLauncher
,IRuntimeComponentExecutor
,IThickClientLauncher
public class DesignerSessionThickClientLauncher extends AbstractRuntimeComponentExecutor implements IDesignerSessionThickClientLauncher
Implementation ofIThickClientLauncher
based on 1C:Enterprise Designer SSH agent usage.
-
-
Constructor Summary
Constructors Constructor Description DesignerSessionThickClientLauncher()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
canApplyConfigurationExtension(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, String extensionName)
Check an ability of configuration to apply extensions.void
closeDesignerSession(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments)
Closes 1C:Enterprise Designer agent session infobase connection for the provided infobase.void
createInfobase(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, CreateInfobaseArguments arguments, boolean addReference)
Create new instance of infobase, using given create command (that parameterizes this creation) and the given 1C:Enterprise runtime thick client.void
createInfobaseUsingTemplate(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, CreateInfobaseArguments arguments, Path templateLocation, boolean addReference)
Create new instance of infobase, using given create command (that parameterizes this creation) and the given 1C:Enterprise runtime thick client using the given template.void
deleteConfigurationExtension(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, String extensionName)
Deletes configuration extensions.void
disableDistributionSupport(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, boolean force)
Disable distribution configuration support.void
dumpExternalDataToFiles(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, Path rootSourceFile, Path extarnalDataFile)
Dumps an external report or data processor to a set of platfom XML files.void
dumpInfobase(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, Path destinationFile)
Dump given infobase to the given target file using the given 1C:Enterprise runtime installation thick client.void
exportConfigurationToFile(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, String extensionName, Path destinationFile)
Export configuration or configuration extension from the giveninfobase
to the given*.cf
or*.cfe
file respectively.void
exportConfigurationToMobileXml(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, boolean update, Path destinationFile)
Export configuration as single XML file from giveninfobase
to the given target file using the given 1C:Enterprise runtime installation thick client.Path
exportConfigurationToXml(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, ConfigurationFilesFormat format, ConfigurationFilesKind kind, RuntimeExecutionArguments arguments, Path destinationFolder)
Export configuration as XML files from giveninfobase
to the given folder directory using the given 1C:Enterprise runtime installation thick client.Path
exportObjectsToXml(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, ConfigurationFilesFormat format, ConfigurationFilesKind kind, RuntimeExecutionArguments arguments, Path destinationFolder, Collection<String> platformQualifiedNames)
Exports metadata objects with the provided collection of platform qualified object names as XML files from the providedinfobase
} to the provided folder directory.void
getChanges(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, Path destinationFile)
Exports changes of the provided infobaase since last infobase interaction according to provided infobase configuratuin dump info file inarguments
.Optional<DebugServerInfo>
getDebugServerUrl(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments)
Returns the started 1C:Enterprise debug server for the provided thick client and infobase.void
importConfigurationFromCf(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, Path sourceFile)
Import configuration to the giveninfobase
from the given*.cf
file using the given 1C:Enterprise runtime installation thick client.boolean
importConfigurationFromXml(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, ConfigurationFilesFormat format, RuntimeExecutionArguments arguments, Path source)
Import configuration as XML files to giveninfobase
from given folder directory using the given 1C:Enterprise runtime installation thick client.boolean
importObjectsFromXml(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, ConfigurationFilesFormat format, RuntimeExecutionArguments arguments, Path source, Collection<Path> sourceFiles)
Import configuration as XML files to giveninfobase
from given folder directory using the given 1C:Enterprise runtime installation thick client.List<String>
listConfigurationExtensions(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments)
Returns a collection of infobase configuration extension names.boolean
needComponent()
Returns whether instance of 1C:Enterprise component is needed for execution.Path
openDesignerSession(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, IDesignerAgentConnectionListener listener, RuntimeExecutionArguments arguments)
Opens 1C:Enterprise Designer agent session infobase connection for the provided infobase.Path
openDesignerSession(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments)
Opens 1C:Enterprise Designer agent session infobase connection for the provided infobase.void
restoreExternalDataFromFiles(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, Path rootSourceFile, Path extarnalDataFile)
Loads an external report or data processor from a set of platfom XML files.void
restoreInfobase(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, Path sourceFile)
Restore given infobase from the given source file using the given 1C:Enterprise runtime installation thick client.Process
runClient(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments)
Runs a 1C:Enterprise runtime platform client on the given infobase using the provided 1C:Enterprise runtime platform client component.Process
runDesigner(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments)
Runs 1C:Enterprise Designer on the provided infobase using the given 1C:Enterprise runtime thick client component.Process
runDesignerAgent(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, Path baseLocation, Integer port)
Runs local 1C:Enterprise Designer agent process with this 1C:Enterprise runtime thick client component.boolean
updateInfobase(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, com._1c.g5.designer.ssh.client.operation.IDbUpdateConfirm confirm, RuntimeExecutionArguments arguments)
Update the given infobase database using the given 1C:Enterprise runtime installation thick client.-
Methods inherited from class com._1c.g5.v8.dt.platform.services.core.runtimes.execution.impl.AbstractRuntimeComponentExecutor
appendClientArguments, appendExtensionCustomization, appendInfobaseAccess, appendRuntimeClientArguments, createTempFile, executeRuntimeProcessCommand, readRuntimeLog, splitInfobaseConnection
-
-
-
-
Method Detail
-
needComponent
public boolean needComponent()
Description copied from interface:IRuntimeComponentExecutor
Returns whether instance of 1C:Enterprise component is needed for execution. Some of executor implementations requires compoment for execution actions: for example, executable files launching.- Specified by:
needComponent
in interfaceIRuntimeComponentExecutor
- Overrides:
needComponent
in classAbstractRuntimeComponentExecutor
- Returns:
- whether instance of 1C:Enterprise component is needed for execution
-
runClient
public Process runClient(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments) throws RuntimeExecutionException
Description copied from interface:IRuntimeClientLauncher
Runs a 1C:Enterprise runtime platform client on the given infobase using the provided 1C:Enterprise runtime platform client component. Returns the started process.- Specified by:
runClient
in interfaceIRuntimeClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable client component, cannot benull
infobase
- the infobase reference to launch client on, cannot benull
arguments
- the execution arguments, can benull
, then will not be used- Returns:
- a process handle of launched 1C:Enterprise client, never
null
- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
runDesignerAgent
public Process runDesignerAgent(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, Path baseLocation, Integer port) throws RuntimeExecutionException
Description copied from interface:IDesignerSessionThickClientLauncher
Runs local 1C:Enterprise Designer agent process with this 1C:Enterprise runtime thick client component. Launched Designer agent can be used for infobase configuring. Returns the started process.- Specified by:
runDesignerAgent
in interfaceIDesignerSessionThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, cannot benull
arguments
- execution arguments, can benull
, then will not be usedbaseLocation
- a base directory for the SFTP server and for the dump and restore configuration commands, cannot benull
port
- the port to start the 1C:Enterprise Designer agent on ornull
to start on default port- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
runDesigner
public Process runDesigner(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Runs 1C:Enterprise Designer on the provided infobase using the given 1C:Enterprise runtime thick client component. Returns the started process.- Specified by:
runDesigner
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, cannot benull
arguments
- execution arguments, can benull
, then will not be used- Returns:
- a pair of launched 1C:Enterprise Designer name and process, never
null
- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
openDesignerSession
public Path openDesignerSession(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments) throws RuntimeExecutionException, RuntimeVersionRequiredException
Description copied from interface:IDesignerSessionThickClientLauncher
Opens 1C:Enterprise Designer agent session infobase connection for the provided infobase. After session open all configuration thick client operations will be perfromed through this opened session thus these operations will be performed faster. Returns the base directory of the connected 1C:Enterprise Designer agent session.Clients must close session when no longer needed.
- Specified by:
openDesignerSession
in interfaceIDesignerSessionThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance, cannot benull
arguments
- execution arguments, can benull
, then will not be used- Returns:
- the base directory of the connected 1C:Enterprise Designer agent session, never
null
- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution failsRuntimeVersionRequiredException
- if 1C:Enterprise runtime installation with provided version and build is required for the operation execution
-
openDesignerSession
public Path openDesignerSession(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, IDesignerAgentConnectionListener listener, RuntimeExecutionArguments arguments) throws RuntimeExecutionException, RuntimeVersionRequiredException
Description copied from interface:IDesignerSessionThickClientLauncher
Opens 1C:Enterprise Designer agent session infobase connection for the provided infobase. After session open all configuration thick client operations will be perfromed through this opened session thus these operations will be performed faster. Returns the base directory of the connected 1C:Enterprise Designer agent session.Clients must close session when no longer needed.
- Specified by:
openDesignerSession
in interfaceIDesignerSessionThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance, cannot benull
listener
- of the designer agent session, cannot benull
arguments
- execution arguments, can benull
, then will not be used- Returns:
- the base directory of the connected 1C:Enterprise Designer agent session, never
null
- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution failsRuntimeVersionRequiredException
- if 1C:Enterprise runtime installation with provided version and build is required for the operation execution
-
closeDesignerSession
public void closeDesignerSession(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments) throws RuntimeExecutionException
Description copied from interface:IDesignerSessionThickClientLauncher
Closes 1C:Enterprise Designer agent session infobase connection for the provided infobase. After session close all configuration thick client operations will be perfromed through common 1C:Enterprise thick client batch mode.- Specified by:
closeDesignerSession
in interfaceIDesignerSessionThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance, cannot benull
arguments
- execution arguments, can benull
, then will not be used- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
createInfobase
public void createInfobase(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, CreateInfobaseArguments arguments, boolean addReference) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Create new instance of infobase, using given create command (that parameterizes this creation) and the given 1C:Enterprise runtime thick client.Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
createInfobase
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to create, cannot benull
arguments
- arguments that parameterizes creation, cannot benull
addReference
- whether to add reference to created infobase to infobases configuration file- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
createInfobaseUsingTemplate
public void createInfobaseUsingTemplate(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, CreateInfobaseArguments arguments, Path templateLocation, boolean addReference) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Create new instance of infobase, using given create command (that parameterizes this creation) and the given 1C:Enterprise runtime thick client using the given template.Template file location must be provided and have extension
*.cf
,*.cfu
or*.dt
.Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
createInfobaseUsingTemplate
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to create, cannot benull
arguments
- arguments that parameterizes creation, cannot benull
templateLocation
- location of the infobase template, must have extension*.cf
,*.cfu
or*.dt
, cannot benull
addReference
- whether to add reference to created infobase to infobases configuration file- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
exportConfigurationToXml
public Path exportConfigurationToXml(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, ConfigurationFilesFormat format, ConfigurationFilesKind kind, RuntimeExecutionArguments arguments, Path destinationFolder) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Export configuration as XML files from giveninfobase
to the given folder directory using the given 1C:Enterprise runtime installation thick client.Export may be performed for configuration extension to export configuration extension to XML files if provided runtime execution arguments specifies specific extension or all extensions flag.
Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
exportConfigurationToXml
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, cannot benull
format
- the format of XML files - plain or hierarchical, cannot benull
kind
- the kind of files - whether need to create plain files or archive file, cannot benull
; note that archive configuration files kind ability depens on 1C:Enterprise platform capabilitiesarguments
- execution arguments, can benull
, then will not be useddestinationFolder
- destination folder to export configuration to, cannot benull
- Returns:
- returns a path to an actual XML files result, may be destination folder or an archive file inside the destination folder if 1C:Enterprise platform support this
- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
exportObjectsToXml
public Path exportObjectsToXml(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, ConfigurationFilesFormat format, ConfigurationFilesKind kind, RuntimeExecutionArguments arguments, Path destinationFolder, Collection<String> platformQualifiedNames) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Exports metadata objects with the provided collection of platform qualified object names as XML files from the providedinfobase
} to the provided folder directory.Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
exportObjectsToXml
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, cannot benull
format
- the format of XML files - plain or hierarchical, cannot benull
kind
- the kind of files - whether need to create plain files or archive file, cannot benull
arguments
- execution arguments, can benull
, then will not be useddestinationFolder
- destination folder to export objects to, cannot benull
platformQualifiedNames
- a collection of platform qualified object names to export, cannot benull
or empty- Returns:
- returns a path to an actual XML files result, may be destination folder or an archive file inside the destination folder if 1C:Enterprise platform support this
- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
exportConfigurationToMobileXml
public void exportConfigurationToMobileXml(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, boolean update, Path destinationFile) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Export configuration as single XML file from giveninfobase
to the given target file using the given 1C:Enterprise runtime installation thick client. Target XML file will contain entire configuration in a format that can be understood by the 1C:Enterprise mobile runtime.Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
exportConfigurationToMobileXml
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, cannot benull
arguments
- execution arguments, can benull
, then will not be usedupdate
- whether need to update infobase before configuration content exportdestinationFile
- destination file to export configuration to, cannot benull
- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
importConfigurationFromXml
public boolean importConfigurationFromXml(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, ConfigurationFilesFormat format, RuntimeExecutionArguments arguments, Path source) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Import configuration as XML files to giveninfobase
from given folder directory using the given 1C:Enterprise runtime installation thick client. Performs full configuration XML import.If
update
istrue
, infobase configuration will be updated after XML import execution, otherwiseupdate infobase
is intended to be executed for actual changes applying.Import may be performed for configuration extension to import configuration extension from XML files if provided runtime execution arguments specifies specific extension or all extensions flag.
Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
importConfigurationFromXml
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, cannot benull
format
- formal of XML files - plain or hierarchical, cannot benull
arguments
- execution arguments, can benull
, then will not be usedsource
- the XML to import configuration from, may be plain files folder or zip-file, cannot benull
- Returns:
- whether infobase configuration was successfully loaded,
false
if load was aborted - Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
importObjectsFromXml
public boolean importObjectsFromXml(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, ConfigurationFilesFormat format, RuntimeExecutionArguments arguments, Path source, Collection<Path> sourceFiles) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Import configuration as XML files to giveninfobase
from given folder directory using the given 1C:Enterprise runtime installation thick client. Performs incremental XML import:sourceFiles
defines, which files to load.If
update
istrue
, infobase configuration will be updated after XML import execution, otherwiseupdate infobase
is intended to be executed for actual changes applying.Import may be performed for configuration extension to import configuration extension from XML files if provided runtime execution arguments specifies specific extension or all extensions flag.
Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
importObjectsFromXml
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, cannot benull
format
- formal of XML files - plain or hierarchical, cannot benull
arguments
- execution arguments, can benull
, then will not be usedsource
- the XML to import object from, may be plain files folder or zip-file, cannot benull
sourceFiles
- a list of exporting files for incremental XML load, cannot be empty- Returns:
- whether infobase objects was successfully loaded,
false
if load was aborted - Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
getChanges
public void getChanges(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, Path destinationFile) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Exports changes of the provided infobaase since last infobase interaction according to provided infobase configuratuin dump info file inarguments
.Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
getChanges
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, cannot benull
arguments
- execution arguments, cannot benull
, must contain configuratuin dump info file propertydestinationFile
- the file to write changes to, cannot benull
- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
exportConfigurationToFile
public void exportConfigurationToFile(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, String extensionName, Path destinationFile) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Export configuration or configuration extension from the giveninfobase
to the given*.cf
or*.cfe
file respectively. IfextensionName
is null, the configuration will be exported. Otherwise, the given extension will be exported.Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
exportConfigurationToFile
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, cannot benull
arguments
- execution arguments, can benull
, then will not be usedextensionName
- extension to export ornull
destinationFile
- destination file to export configuration to, cannot benull
- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
importConfigurationFromCf
public void importConfigurationFromCf(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, Path sourceFile) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Import configuration to the giveninfobase
from the given*.cf
file using the given 1C:Enterprise runtime installation thick client.Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
importConfigurationFromCf
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, cannot benull
arguments
- execution arguments, can benull
, then will not be usedsourceFile
- source file to import configuration from, cannot benull
- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
updateInfobase
public boolean updateInfobase(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, com._1c.g5.designer.ssh.client.operation.IDbUpdateConfirm confirm, RuntimeExecutionArguments arguments) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Update the given infobase database using the given 1C:Enterprise runtime installation thick client. All previously loaded configuration objects will be persisted to the infobase configuration.Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
updateInfobase
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, cannot benull
confirm
- the callback executed by 1C:Enteprise when database structure changes are received, cannot benull
; note that callback may not be executed if confirm is not supported by 1C:Enterprisearguments
- execution arguments, can benull
, then will not be used- Returns:
- whether infobase configuration was successfully updated,
false
if update was aborted - Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
dumpInfobase
public void dumpInfobase(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, Path destinationFile) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Dump given infobase to the given target file using the given 1C:Enterprise runtime installation thick client.Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
dumpInfobase
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, cannot benull
arguments
- execution arguments, can benull
, then will not be useddestinationFile
- destination file to dump infobase to, cannot benull
- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
restoreInfobase
public void restoreInfobase(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, Path sourceFile) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Restore given infobase from the given source file using the given 1C:Enterprise runtime installation thick client.Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
restoreInfobase
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, cannot benull
arguments
- execution arguments, can benull
, then will not be usedsourceFile
- source file to restore infobase from, cannot benull
- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
dumpExternalDataToFiles
public void dumpExternalDataToFiles(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, Path rootSourceFile, Path extarnalDataFile) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Dumps an external report or data processor to a set of platfom XML files. External report and data processor are represented as*.epf
or*.erf
files.Infobase may be provided to dump execution. If the external data processor includes external references, they are resolved relative to the specified infobase. If the
infobase
is not specified, external references will be erased.Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
dumpExternalDataToFiles
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, can benull
to dump external data without infobase usage; if external data contains references to external configuration, these references will be erasedarguments
- execution arguments, can benull
, then will not be usedrootSourceFile
- the root file of platform XML etxernal data presentation, cannot benull
extarnalDataFile
- the external data dump file, cannot benull
- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
restoreExternalDataFromFiles
public void restoreExternalDataFromFiles(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, Path rootSourceFile, Path extarnalDataFile) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Loads an external report or data processor from a set of platfom XML files. External report and data processor are represented as*.epf
or*.erf
files.Infobase may be provided to dump execution. If the external data processor includes external references, they are resolved relative to the specified infobase. If the
infobase
is not specified, external references will be erased.Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
restoreExternalDataFromFiles
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, can benull
to restore external data without infobase usage; if external data contains references to external configuration, these references will be erasedarguments
- execution arguments, can benull
, then will not be usedrootSourceFile
- the root file of platform XML etxernal data presentation, cannot benull
extarnalDataFile
- the external data dump file, cannot benull
- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
canApplyConfigurationExtension
public void canApplyConfigurationExtension(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, String extensionName) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Check an ability of configuration to apply extensions. If extension name is provided then method checks only provided extension, ifnull
is provided asextensionName
then method check all configuration extensions.Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
canApplyConfigurationExtension
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, cannot benull
arguments
- execution arguments, can benull
, then will not be usedextensionName
- the name of configuration extension to check ornull
to check all configuration extensions- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
deleteConfigurationExtension
public void deleteConfigurationExtension(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, String extensionName) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Deletes configuration extensions. If extension name is provided then method deletes only provided extension, ifnull
is provided asextensionName
then method deletes all configuration extensions.Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
deleteConfigurationExtension
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, cannot benull
arguments
- execution arguments, can benull
, then will not be usedextensionName
- the name of configuration extension to delete ornull
to delete all configuration extensions- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
listConfigurationExtensions
public List<String> listConfigurationExtensions(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Returns a collection of infobase configuration extension names.Started
Process
is consumed during method execution to read entire process execution log (method is waiting for process termination).- Specified by:
listConfigurationExtensions
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, cannot benull
arguments
- execution arguments, can benull
, then will not be used- Returns:
- a collection of infobase configuration extension names, never
null
, may be empty if there are no extensions in infobase configuration - Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
disableDistributionSupport
public void disableDistributionSupport(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments, boolean force) throws RuntimeExecutionException
Description copied from interface:IThickClientLauncher
Disable distribution configuration support.- Specified by:
disableDistributionSupport
in interfaceIThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance to use, cannot benull
arguments
- execution arguments, can benull
, then will not be usedforce
- whether need to disable configuration support even if changing the configuration is not allowed- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
getDebugServerUrl
public Optional<DebugServerInfo> getDebugServerUrl(ILaunchableRuntimeComponent thickClient, InfobaseReference infobase, RuntimeExecutionArguments arguments) throws RuntimeExecutionException
Description copied from interface:IDesignerSessionThickClientLauncher
Returns the started 1C:Enterprise debug server for the provided thick client and infobase. May return nothing if the provided infobase is not a client-server or if infobase is not connected to debug agent.- Specified by:
getDebugServerUrl
in interfaceIDesignerSessionThickClientLauncher
- Parameters:
thickClient
- the 1C:Enterprise runtime launchable component with thick client, cannot benull
infobase
- the infobase reference instance, cannot benull
arguments
- execution arguments, can benull
, then will not be used- Returns:
- the started 1C:Enterprise debug server info
- Throws:
RuntimeExecutionException
- if 1C:Enterprise runtime process execution fails
-
-