com.atlassian.bamboo.configuration.external

Interface PlanConfigImportService

All Known Implementing Classes:

PlanConfigImportServiceImpl

@ExperimentalApi
public interface PlanConfigImportService

Service to import plan configurations from human readable format.

Since:

5.15

Method Summary

Modifier and Type	Method and Description
TopLevelPlanProperties	convertYamlToPlan(String yaml) Converts data from a YAML document to top level plan properties.
ImmutableTopLevelPlan	importPlan(TopLevelPlanProperties planProperties, com.atlassian.user.User user) Validates exported top level plan properties within Bamboo context (e.g.

Method Detail

convertYamlToPlan

@NotNull
TopLevelPlanProperties convertYamlToPlan(@NotNull
                                                  String yaml)
                                           throws PropertiesValidationException,
                                                  YamlValidationException

Converts data from a YAML document to top level plan properties. This method performs validation of YAML types and of the properties without Bamboo context (e.g. no database integrity is verified).

Parameters:

yaml - YAML String containing definition of top level plan

Returns:

top level plan properties after contextless validation

Throws:

YamlValidationException - if the format of the YAML file is invalid

PropertiesValidationException - if the imported properties were not valid

importPlan

@NotNull
ImmutableTopLevelPlan importPlan(@NotNull
                                          TopLevelPlanProperties planProperties,
                                          @NotNull
                                          com.atlassian.user.User user)
                                   throws PropertiesValidationException

Validates exported top level plan properties within Bamboo context (e.g. verifying database integrity), then imports the data into the database.

Parameters:

planProperties - top level plan properties to import

user - invoking the import

Returns:

saved top level plan entity

Throws:

PropertiesValidationException - if data validation fails