Kontakt

Ansicht
Dokumentation

SCTS_GCTS_SYNC_COLLAB - gCTS: Synchronize Collaborators and Teams of Repository

SCTS_GCTS_SYNC_COLLAB - gCTS: Synchronize Collaborators and Teams of Repository

Fill RESBD Structure from EBP Component Structure   BAL Application Log Documentation  
This documentation is copyright by SAP AG.
SAP E-Book

Purpose

Use this program to synchronize collaborators and teams, and their collaboration permissions in the remote Git repository with those of the local repository on the ABAP system. The remote repository is the single source of truth.

Integration

For GitHub, the program uses the Collaborators API available at github.com:
https://docs.github.com/en/rest/reference/collaborators

Prerequisites

  • You have a personal access token for the Git server where the remote repository is hosted.
  • To synchronize teams on repository level, the precondition is that the teams exist on system level in gCTS. The report can create teams on system level if the user running the report has authorization role Z_S_GCTS_SYS.

Features

The program checks which teams and collaborators are part of the organization of the remote repository, and synchronizes them with the collaborators and teams assigned to the local repository. The users´ permissions are synchronized at the same time.

Procedure

  1. Select a repository from the dropdown list.
  2. Enter your personal access token for the Git server.
  3. Optional: Specify the following options:
  • Run Simulation: By default, the program executes a simulation run of the synchronization. The program displays a summary of actions that will take place during synchronization with the options specified. No data will be changed. Deselect this option after you have made sure that the result of the synchronization meets your expectations.

  • Synchronize Teams: To synchronize the teams of the repository, select the checkbox. By default, the checkbox is selected.

  • Synchronize Collaborators: To synchronize individual collaborators of the repository, select this checkbox. By default, the checkbox is selected.

  • One-Way: Collaborators and/or teams will be synchronized only from the remote repository to the local repository.

If the local repository has collaborators or teams assigned that are not part of the remote repository, they will not be changed.
  • Two-Way: Collaborators and/or teams will be synchronized both ways.

CAUTION: If the local repository have collaborators or teams assigned that are not part of the remote repository, they will be removed from the local repository.
  • Permissions Only: Only permissions will be synchronized. No team or collaborator will be added or removed.

  1. To start the synchronization with the specified options, choose Execute.

Result

The program displays a log.

If you have executed a simulation run, a message is displayed informing you about this. To execute the synchronization, deselect the checkbox.

In the following situations, the program displays warning messages:

  • If the users cannot be found in the system.
  • For all teams assigned to the organization of the repository, the program checks whether they are also assigned to the repository. Teams that are not assigned to the repository cannot be synchronized.
  • If you´ve selected the two-way scope: If collaborators and teams are assigned to the local repository, but not to the remote repository, their assignments will be removed.






ABAP Short Reference   CL_GUI_FRONTEND_SERVICES - Frontend Services  
This documentation is copyright by SAP AG.

Length: 4200 Date: 20240601 Time: 212029     sap01-206 ( 76 ms )