Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Page Properties
hiddentrue
idPROGRESSDONE

Product Version2021 Summer
Report Note
AssigneeAntje

Resources & Remarks

Modification History

NameDateProduct VersionAction
Antje21 MAY 20212021 Summercreated
Antje17 JUN 20212021 SummerAdded to Web-API: update of the app schema 'clientsystem' if sothook is needed.

Hi Antje, wir sollten noch eine Emfpehlung einbauen. Es betrifft das Schema Clientsystem. Für das Property 'leadingTypeId' sollte das Attribut 'required' auf 'true' gesetzt werden, damit im Fall des inaktiven Sotwebhooks gleich beim Create und Update Object eine Fehlermeldung kommt, dass das Property nicht mit einem Value kommt.

App Schema Modification

The property leadingTypeId in the app schema for the app clientsystem should be required now in order to immediately recognize any failure of the SOTHOOK.

  • Retrieve the app schema for the app clientsystem via the endpoint GET /api/system/apps/{app}/schema.
  • In the definition of the string property leadingTypeId, set the boolean value for the required attribute to true.

    Code Block
    <required>true</required>
    Update the app schema for the app clientsystem via the endpoint POST /api/system/apps/{app}/schema. Pass your modified XML in the request body.


    Excerpt

    When updating your yuuvis® Momentum installation to version 2021 Summer, manual configuration changes are required for some services.


    Section
    bordertrue


    Column

    Table of Contents

    Table of Contents
    exclude(Table of Contents|Read on|Another Tutorial|Another Concept Article|Another interesting Tutorial|Ressources|Remarks|Authentication against the Core API|Graphical Overview \/ Use Cases \(Flows\)|Login to the Core API \(Java\)|yuuvis® Momentum Services|Basic Use Case Flows)


    Web-API Gateway

    Renaming of Endpoints

    As of Release Candidate Alpha5: As described in the Breaking Changes, the endpoint URLs of the Web-API Gateway were modified. Thus, the entries for the API-WEB service endpoints in the section authorization.accesses of  section of the profile  authentication-prod.yml profile have to be adjusted as follows:

    Code Block
    ### api-web
      - endpoints: /api-web/swagger-ui.html/**,/api-web/**/springfox-swagger-ui/**,/api-web/**/swagger-resources/**,/api-web/**/v2/api-docs/**
      - endpoints: /api-web/api/resources/**,/api-web/api/users/**,/api-web/api/bpm/**,/api-web/api/dms/**
      - endpoints: /api-web/api/system/**
        access: hasAuthority('YUUVIS_SYSTEM_INTEGRATOR')
      - endpoints: /api-web/api/admin/**
        access: hasAuthority('YUUVIS_TENANT_ADMIN')
    

    App Schema Modification

    If the service SOTHOOK is running in your system and the clientsystem app schema exists, it is recommended to do the following adjustment. The leadingTypeId property in the app schema for the clientsystem app should be required now in order to immediately recognize any failure of the SOTHOOK.

    • Retrieve the app schema for the clientsystem ap via the GET /api/system/apps/{app}/schema endpoint.
    • In the definition of the leadingTypeId string property, set the boolean value for the required attribute to true.

      Code Block
      <required>true</required>


    • Update the app schema for the clientsystem app via the POST /api/system/apps/{app}/schema endpoint. Pass your modified XML in the request body.

    Tenant Management API

    The service providing the Tenant Management API was renamed from API-TM into to TENANT-MANAGEMENT. Thus, the entries for the Tenant Management API endpoints in the section authorization.accesses of  section of the profile  authentication-prod.yml profile have to be adjusted as follows:

    ...