> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexagon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PeopleSoft Tutorial

> The PeopleSoft plugin for FlexDeploy simplifies the process of migrating PeopleSoft projects between different environments, creating SQL build files,

The PeopleSoft plugin for FlexDeploy simplifies the process of migrating PeopleSoft projects between different environments, creating SQL build files, and comparing project definitions on target locations.

## Objective

1. Support for PeopleTools 8.40+

2. Allows sourcing customizations from SCM repositories or development PeopleSoft instances.

3. Explore [PeopleSoft Package Object Types - FlexDeploy 8.0 - Confluence (atlassian.net)](https://docs.flexagon.com/flexdeploy-11-2-documentation/flexdeploy-plugin-guides/flexdeploy-peoplesoft-plugin-guide/appendix-peoplesoft/peoplesoft-package-object-types.md) Reference for detailed information on supported types.

4. Benefit from automated change detection during deployment.

5. Enable Continuous Integration capabilities.

6. Utilize flexible build options tailored for PeopleSoft.

7. Seamlessly integrate with FlexDeploy Pipeline & Release features for enhanced project management.

## Create a PeopleSoft Project using Blueprint

The assumption is that you have FlexDeploy installed and ready for use. When logged into the FlexDeploy, you will see the Home page. Click on the **+** icon top and click **“Create Project”** to create a new project.

![image-20240424-172537.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931910.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=37fe450341756bcda3f98a0d8fa7ad9f)

The screen displays the list of blueprints supported by the FlexDeploy. Select the blueprint from the list or you can search for the blueprint in the search filter present at the top. In our case, we will select the **PeopleSoft or PeopleSoft Package based** on our needs.

![image-20240530-222746.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590932000.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=aedbbf88fcda7aa8e83a6d67ad6c1a57)

Scroll through this guide to fill in the blueprint properties where the Source Control, Build, and Deploy options are auto-selected, enter Project Info first.

![image-20240424-173006.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931907.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=81d168137ac7e58e07f57e48a3a2409e)

In the Source Control Option on the screen, enter the Source Repository and in the Sparse Checkout Folders Script enter the name of the folder from the repository in which you are looking for package files. If files are in the root folder of the repository, then leave this value empty.

![image-20240425-145515.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931997.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=19ea98bb6db9a961a0c03cc3a3b3a159)

### Gather Build and Deployment Information

Enter values for any workflow properties that are required for the build and deployment.  In the image below, the properties required for the build need to be filled. Select the target endpoint that the build and deployment should execute on. The below image shows the Build-Development Fields.

![image-20240424-174258.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931913.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=ed356b4b30fc1f2b3a7e24b879240cf4)

The image below shows the Deploy - Development fields.

![image-20240424-174809.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931919.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=146a1060d2441801690e287dc796fe56)

Clicking on the **confirm** button will ask for confirmation to create the PeopleSoft Package-based Project.

![image-20240424-180027.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931916.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=e78d39db8af77ace31f7d334b5e0600c)

### General Configuration

After successful configuration, open the created project, click on "Configuration," and select "General Configuration."

![image-20240424-180423.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931922.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=f6c951c974909088fd687c1c92d8f5e7)

#### Build and Deploy Workflows

![image-20240424-180625.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931925.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=9fe777da1af9c664b61861131804f863)

### Project Properties

![image-20240424-180949.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931931.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=6addcf1743e6e8b5fc492a17e26539d4)

### Source Control

Click on the source repository dropdown. If you have already created a connection to your source code repository, select it from the list. Enter the sparse checkout folder, if any.

![image-20240530-224334.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931994.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=43deb25493e83c60485fa9a281763138)

Otherwise, add one by clicking on “**Create new Source Repository**”. Enter the sparse checkout folders script, if any.

![image-20240424-181610.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931928.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=2ed6e459dbd4a172fecaed933c3f8f10)

Enter the sparse checkout folder value, if any. The sparse checkout folder is a Folder in your repository where your PeopleSoft files are located. If files are in the root folder of the repository, then leave this value empty. For SCM configuration refer to the link [SCM Instance](https://docs.flexagon.com/flexdeploy-11-2-documentation/flexdeploy-users-guide/integrations/scm-instance.md)

![image-20240304-181230.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931898.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=202744b2bf91bac7b80000bde6d7aca9)

#### Branch Name

![image-20240530-225452.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590932006.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=ff1f2345ffd9c80e8238b5eb271eaa7a)

Change the branch name to the git repositories branch name. Click on **Save**.

![image-20240424-182439.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931934.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=c5a2672223a81655181c3689ae973eeb)

## Topology

Navigate to the **Topology** from the Menu. The Page with the [Target Groups](https://docs.flexagon.com/flexdeploy-11-2-documentation/flexdeploy-users-guide/topology/target-groups.md), [Environments](https://docs.flexagon.com/flexdeploy-11-2-documentation/flexdeploy-users-guide/topology/environments.md), and [Endpoints](https://docs.flexagon.com/flexdeploy-11-2-documentation/flexdeploy-users-guide/topology/endpoints.md) sections will be displayed. Choose a Target Group on the left. You will see a list of Environments on the right with colored circles representing each [Target](https://docs.flexagon.com/flexdeploy-11-2-documentation/flexdeploy-users-guide/topology/target-groups.md). 

![image-20240305-171030.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931904.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=c46cf81ba5549a311a541562fff8a413)

Click on **PeopleSoft** Target Group and click on the Development Environment

**Color coding represents:**

* RED - The Endpoint is not configured

* YELLOW - some of the required properties are not set,

* GREEN - all required properties are set and the Endpoint is configured.

![image-20240530-230452.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590932003.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=107b47179c3ad201be26ade2c70ef244)

## Targets Properties

Clicking the environment row for Development allows modifying the Endpoint and properties. We can select the endpoint from the Map Endpoint option and Resource Types from the Resource Types option from the below screen.

![image-20240424-183600.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931940.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=e3cb2493ca99c750b08c0f9f18fcd05c)

![image-20240305-181546.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931901.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=d23a079e48228033c8c0f53d0200675c)

## Endpoint Properties

![image-20240425-165129.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931991.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=1969e929c6349e5bc9f3d433d0b1caaf)

### Populate the files

For the package-based project click on File Catalog under the Package screen. In the File Catalog, there is a discover files option which helps to fetch files from the SCM repository,

![image-20240424-184607.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931937.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=11ee0cc561286567dd05aa3c294d2050)

Click on “**Show new Files**” to see the list of files on the file catalog screen.

![image-20240424-185958.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931949.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=c14d205a408686e4d9f83d894430b846)

### Create a Package

On the package screen, click on the **create** button to create a new package.

Enter the package name and select the package type. We select the “**User Managed**” in our use case.

![image-20240424-185536.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931943.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=55291b3c786356135d177ded52aeb9f9)

To create new files, click on the **Create** button. The create file screen will expect the file path and object type. Here we have selected Object type as Customization. Enter the value and fields related to the object type selected will be displayed.

Click on Evaluate if any modifications are done. Click on the **Save** button to save the file.

To inactivate the file, click on the Active switch box.

![image-20240424-190438.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931946.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=781dbd59a4880e29aa392d820c8cf094)

The file is created in the below screen.

![image-20240424-190617.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931952.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=31350fba449cee75ddc0e9d8ede45367)

We can also Click on the **Add Files** icon to add the files that are populated from the SCM repository.

![image-20240424-190936.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931958.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=6130cfbfe3618320edbcb65a1ec9ae42)

Click on the file name directly to add the file to the package.

![image-20240424-191209.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931955.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=2daf857f4d0c8f00b8cd58f52b172a20)

We can see the file added to the package under the package file screen.

![image-20240424-191557.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931961.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=c3f0c84216c244c442ef32c87327e091)

### Building Package

Click on the **Execution** tab to submit the build request for that package. Click on **Build**.

![image-20240424-191833.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931967.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=420d6afcebf6ba336a24fb2a5f7cadbf)

The Build Request Form is displayed, select your package name and environment. Click on the “**Submit**” button for the build to execute.

![image-20240424-192233.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931964.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=06ebe06d8b6fe4b9df3b8c0de2a6d549)

The Deploy Request Form is displayed. Click on the “**Submit**” button for the deployment to execute.

![image-20240424-192527.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931970.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=046be739bf611415bc3e6f4997a457ac)

Here you can make note of **build execution** and **deploy execution** details for version **1.0.1** of our **Package** package.  To view more detail, click on the generated **Execution Id**

![image-20240530-230113.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590932009.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=2979b65e7d97a5d2a5aaeafeb21da055)

Notice the **Initialize: Extract Project Files (Revisions)** step.  This is an implicit step that is injected into the build workflow when using partial deployment.  This step extracts the source code for the package files from the configured SCM.  These files are then available for the **PeopleSoft Build** step to assemble them into an artifact, which is versioned (1.0.1) in the artifact repository.

After the build completes, we can see the artifact on the **Artifacts** tab, and see details of the files within it on the **Files** tab.

![image-20240424-193443.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931973.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=e3106792d9426e153d480beeeed8d724)

#### Artifacts Tab

![image-20240424-193623.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931976.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=de8a34cc82da31887f1dc5b44a8af4d4)

#### Files tab

![image-20240424-193815.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931979.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=92e0689ebbb7a5dea8a4dd421e1c851d)

Same for the Deploy once we deploy the project, we can see the Artifact details on the **Artifacts** Tab and deploy logs under the steps tab.

![image-20240424-194115.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931982.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=f76ea4529185c2d60e1d76bdce4a6b0a)

#### Artifacts tab

![image-20240424-194302.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931988.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=4fd58a908cce72bdf79b46c5c05435f3)

We can see the file that we selected is successfully deployed to the Development Environment under Files Tab.

![image-20240424-194652.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590931985.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=8c60ed8cf1a1825204322d610e20c321)

We have come to the end of this PeopleSoft Tutorial. In this tutorial, we learned how to build and deploy all of your PeopleSoft Projects.