Release notes

Remediation: Update the pom.xml file manually if the Java SDK version has changed.

Remediation: If the role assignment is changed, you have to log out and log back in to activate the permissions. To reduce the time required to activate the new permissions, you can clear the cache manually by calling the appropriate API, for example, via the Swagger UI interface.

Remediation: If one of these schemas is used independently, the discriminator property must be set to #/components/schemas/<schema_localIdentifier> accordingly.

Remediation: Make sure that there are no properties in any of the schemas of a "oneOf-schema" that have the same name as the discriminator.

Remediation: In case of conflicts, delete the package-lock.json of the project and execute k5 pull.

Remediation: You can still configure and use multiple Message Hub service bindings at the project level.

Remediation: Manually configure the local debugging to connect to the Kafka cluster.

Remediation: Use schema for event payload or rename the property to a different naming

Remediation: When you have changed the configuration of the component, please save a copy of the content and then remove the component. Then click the "cog wheel" icon and click the "API Bindings/Theme Bindings" button. Finally, add the component back in the desired version and paste the configuration again.

Remediation: As a workaround, manually adjust the SwaggerConfiguration of your project.

1. Open your Java pro-code solution
2. Navigate to the path /src/main/java/ACRONYM/config/SwaggerConfiguration.java
3. Replace the configuration with the following sample
4. Commit and push your changes
5. Re-execute the pipelines of your project in solution designer

import org.springdoc.core.customizers.OpenApiCustomiser;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
  
import de.knowis.cp.common.environment.featureflag.condition.ConditionalOnFeatureFlag;
import de.knowis.cp.common.openapi.security.SecurityCustomizer;
import de.knowis.cp.common.openapi.ui.EnableOpenApiUi;
import de.knowis.cp.common.security.autoconfiguration.OidcConfiguration;
import de.knowis.cp.common.solution.autoconfiguration.SolutionConfigurationProperties;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.servers.Server;
  
@EnableOpenApiUi
@Configuration
@ConditionalOnFeatureFlag("feature.openapi.enabled")
public class SwaggerConfiguration {
  
  private final SolutionConfigurationProperties solutionConfiguration;
  private final OidcConfiguration oidcConfig;
  
  @Value("${de.knowis.cp.server.baseurl}")
  private String baseUrl;
  
  public SwaggerConfiguration(SolutionConfigurationProperties solutionConfiguration,
      OidcConfiguration oidcConfig) {
    this.solutionConfiguration = solutionConfiguration;
    this.oidcConfig = oidcConfig;
  }
  
  private static final String ACRONYM_GROUP_DESC = "";
  
  private static final String ACRONYM_GROUP_VERSION = "1.0.0";
  
  @Bean
  public OpenApiCustomiser securityCustomizer() {
    return new SecurityCustomizer(oidcConfig::getUserTokenUrl);
  }
  
  @Bean
  public OpenApiCustomiser serversCustomizer() {
    return openApi -> {
      openApi.getServers().clear();
      openApi.addServersItem(new Server().url(baseUrl));
    };
  }
  
  @Bean
  public OpenApiCustomiser infoCustomizer() {
    return openApi -> openApi.info(new Info().title(solutionConfiguration.getAcronym())
        .description(ACRONYM_GROUP_DESC).version(ACRONYM_GROUP_VERSION));
  }
  
}

Workaround: The missing converters have to be created manually for each enum class, which is affected:

1. Create a package web under your application package
2. Create for each affected enum class a converter similar to:

   package [MYAPP].web;
     
   import org.springframework.core.convert.converter.Converter;
   import [MYAPP].sdk.api.[MYAPI].model.[MYENUM];
     
   public class StringTo[MYENUM]Converter implements ConverterString, [MYENUM] {
     
     @Override
     public [MYENUM] convert(String source) {
       return [MYENUM].fromValue(source);
     }
   }

3. Register all converters by creating a class similar to:

   package [MYAPP].web;
     
   import org.springframework.context.annotation.Configuration;
   import org.springframework.format.FormatterRegistry;
   import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
     
   @Configuration
   public class WebConfig implements WebMvcConfigurer {
     
     @Override
     public void addFormatters(FormatterRegistry registry) {
         registry.addConverter(new StringTo[MYENUM]Converter());
         // one line per converter...
     }
   }