Skip to content

Commit

Permalink
Student Application Process New Sample (#177)
Browse files Browse the repository at this point in the history
* Add files via upload

* Updated sample app

* Removed images from app & removed reference to allcountries list.

* Updated readme

---------

Co-authored-by: Daniel Laskewitz <daniel.laskewitz@microsoft.com>
  • Loading branch information
sam-404 and Daniel Laskewitz committed Feb 15, 2023
1 parent d645c8d commit 4273e53
Show file tree
Hide file tree
Showing 60 changed files with 109,797 additions and 0 deletions.
194 changes: 194 additions & 0 deletions samples/student-application-process/README.md
@@ -0,0 +1,194 @@

# Student Application Process

## Summary

This application is built for prospective students at a university/college. It allows them to register and apply for a program at the college/university by submitting relevant details and documents.

By integrating Power Automate it becomes an end to end application where a student can submit an application and receive automatic emails regarding the status of their application. An admin approves the application and enters in test and interview scores. The student then receives the final email where they are either accepted or rejected into the university/college. You can find the entire application with the flows [here](https://drive.google.com/file/d/1DhIm47FtgJc2DvWGObuRVVE5kOLmsWuC/view?usp=sharing).

Flow of the application:
![picture of the sample](assets/flow.png)

Login:
![picture of the sample](assets/login.png)

Register:
![picture of the sample](assets/register.png)

Dashboard:
![picture of the sample](assets/dashboard.png)

## Applies to

* [Microsoft Power Apps](https://docs.microsoft.com/powerapps/)
* [Microsoft Power Automate](https://learn.microsoft.com/power-automate/)
* [Microsoft SharePoint]( https://learn.microsoft.com/sharepoint/dev/)

## Compatibility

![Power Apps Source File Pack and Unpack Utility 0.20](https://img.shields.io/badge/Packing%20Tool-0.20-green.svg)
![Premium License](https://img.shields.io/badge/Premium%20License-Not%20Required-green.svg "Premium Power Apps license not required")
![Experimental Features](https://img.shields.io/badge/Experimental%20Features-No-green.svg "Does not rely on experimental features")
![On-Premises Connectors](https://img.shields.io/badge/On--Premises%20Connectors-No-green.svg "Does not use on-premise connectors")
![Custom Connectors](https://img.shields.io/badge/Custom%20Connectors-Not%20Required-green.svg "Does not use custom connectors")

## Authors

Solution|Author(s)
--------|---------
Student Application Process | [Samia Sohail Azim](https://github.com/sam-404), Institute of Business Administration

## Version history

Version|Date|Comments
-------|----|--------
1.0|December 4, 2022|Initial release

## Features

This sample illustrates the following concepts:

* A prospective student can register.
* A prospective student can login.
* They can fill in their personal details, academic details and essays.
* They can also upload documents.
* They can submit the form.
* Users can view the status of their profile and the Last Modified date on the dashboard
* Users can log out.

(If you're using the application with Power Automate flows):

* A user receives the following automatic emails: after successfully registering, reject/accept email after successfully completing the application and if accepted the email also contains the fee voucher for the examination test, reject/accept email regarding their test marks and if they are accepted the email contains interview date and time, reject/accept email regarding their interview marks and if they have secured admission the email contains credentials to login to the university's student portal.
* An admin can approve an application, enter test and interview marks through approval emails and cross check application with the student's documents.

## Prerequisites

You need to first register a user then only can you login.

## Data Sources

SharePoint List Used.

### UserList

This SharePoint list contains all the information of the student. Set the list up as follows:

Enable the `ID` column in your SharePoint list by going to **+ Add Column** > Show/Hide Columns and ticking the box beside “ID”.

|Type|Internal Name|Required|Default Value|
|---|---|:---:|---|
|Single line of text|Title|No|Hello
|Choice|Status|No|
|Single line of text|CNIC|No|
|Single line of text|First Name|No|
|Single line of text|Last Name|No|
|Single line of text|Email|No|
|Single line of text|Password|No|
|Single line of text|Confirm Password|No|
|Single line of text|Address line 1|No|
|Single line of text|Address line 2|No|
|Single line of text|Address line 3|No|
|Number|Phone Number|No|
|Single line of text|City|No|
|Single line of text|Province/State|No|
|Number|Zipcode|No|
|Single line of text|Parent/Guardian Name|No|
|Single line of text|Parent/Guardian Phone No.|No|
|Single line of text|Parent/Guardian Relation|No|
|Choice|Gender|No|
|Choice|Country|No|
|Choice|Nationality|No|
|Date and Time|Date of Birth|No|
|Multiple lines of text|Essay 1|No|
|Multiple lines of text|Essay 2|No|
|Image|Student Picture|No|
|Choice|Preferred Major 1st Choice|No|
|Choice|Preferred Major 2nd Choice|No|
|Choice|High School Education|No|
|Single line of text|High School Name|No|
|Choice|College Education|No|
|Single line of text|College Name|No|
|Number|High School Equivalency|No|
|Number|College Equivalency|No|
|Choice|Test Fee Status|No|
|Number|Test Result|No|
|Number|Interview Result|No|

Choice values:

* Status:
Incomplete
Test Result Pending
Interview Result Pending
Complete
Terminated
Application Submitted
Application Approved
* Gender:
Male
Female
Other
* Country and Nationality:
You can find a list of all countries [here](https://docs.google.com/spreadsheets/d/1wusfjmURFT_8TiF98ZNqc8V3mXhWkPzcNK2jI2RgIqI/edit?usp=sharing)
* Preferred Major 1st Choice and Preferred Major 2nd Choice:
Computer Science
Accounting & Finance
Business Administration
Social Sciences
Economics
Economics & Mathematics
* High School Education:
O Levels
Inter
Other
* College Education:
A Levels
Inter
Other
* Test Fees Status:
Pending
Paid
Done

## Minimal Path to Awesome

* [Download](./solution/studentApplicationProcess.msapp) the `.msapp` from the `solution` folder
* Within **Power Apps Studio**, use the `.msapp` file using **File** > **Open** > **Browse** and select the `.msapp` file you just downloaded.
* Select the **Data** tab
* Connect the app with the two SharePoint Lists created above.

## Using the Source Code

You can also use the [Power Apps CLI](https://docs.microsoft.com/powerapps/developer/data-platform/powerapps-cli) to pack the source code by following these steps::

* Clone the repository to a local drive
* Pack the source files back into `.msapp` file:

```bash
pac canvas pack --sources pathtosourcefolder --msapp pathtomsapp
```

Making sure to replace `pathtosourcefolder` to point to the path to this sample's `sourcecode` folder, and `pathtomsapp` to point to the path of this solution's `.msapp` file (located under the `solution` folder)
* Within **Power Apps Studio**, use the `.msapp` file using **File** > **Open** > **Browse** and select the `.msapp` file you just packed.

## Disclaimer

**THIS CODE IS PROVIDED *AS IS* WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.**

## Help

We do not support samples, but we this community is always willing to help, and we want to improve these samples. We use GitHub to track issues, which makes it easy for community members to volunteer their time and help resolve issues.

If you encounter any issues while using this sample, you can [create a new issue](https://github.com/pnp/powerapps-samples/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected&template=bug-report.yml&sample=student-application-process&authors=@sam-404&title=student-application-process%20-%20).

For questions regarding this sample, [create a new question](https://github.com/pnp/powerapps-samples/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected&template=question.yml&sample=student-application-process&authors=@sam-404&title=student-application-process%20-%20).

Finally, if you have an idea for improvement, [make a suggestion](https://github.com/pnp/powerapps-samples/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected&template=suggestion.yml&sample=student-application-process&authors=@sam-404&title=student-application-process%20-%20).

## For more information

* [Overview of creating apps in Power Apps](https://docs.microsoft.com/powerapps/maker/)
* [Power Apps canvas apps documentation](https://docs.microsoft.com/powerapps/maker/canvas-apps/)

<img src="https://telemetry.sharepointpnp.com/powerapps-samples/samples/student-application-process" />
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
@@ -0,0 +1,12 @@
{
"Content": "Image",
"FileName": "/ctrllib/image/images/SampleImage.svg",
"IsSampleData": true,
"IsWritable": false,
"Name": "SampleImage",
"Path": "/ctrllib/image/images/SampleImage.svg",
"ResourceKind": "Uri",
"RootPath": "ms-appx:///ctrllib/image/images/SampleImage.svg",
"Schema": "i",
"Type": "ResourceInfo"
}
@@ -0,0 +1,12 @@
{
"Content": "Pdf",
"FileName": "/ctrllib/pdfViewer/data/SamplePdf.pdf",
"IsSampleData": true,
"IsWritable": false,
"Name": "SamplePdf",
"Path": "/ctrllib/pdfViewer/data/SamplePdf.pdf",
"ResourceKind": "Uri",
"RootPath": "ms-appx:///ctrllib/pdfViewer/data/SamplePdf.pdf",
"Schema": "o",
"Type": "ResourceInfo"
}
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
126 changes: 126 additions & 0 deletions samples/student-application-process/sourcecode/CanvasManifest.json
@@ -0,0 +1,126 @@
{
"FormatVersion": "0.24",
"Header": {
"DocVersion": "1.327",
"MinVersionToLoad": "1.327",
"MSAppStructureVersion": "2.0"
},
"Properties": {
"AppCreationSource": "AppFromFigma",
"AppDescription": "",
"AppPreviewFlagsMap": {
"aibuilderserviceenrollment": false,
"allowmultiplescreensincanvaspages": false,
"appinsightserrortracing": false,
"appinstrumentationcorrelationtracing": false,
"autocreateenvironmentvariables": false,
"backfromhostaction": false,
"behaviorpropertyui": true,
"blockmovingcontrol": true,
"cdsdataformatting": false,
"classiccontrols": false,
"consistentreturnschemafortabularfunctions": false,
"copyandmerge": false,
"datatablev2control": true,
"delaycontrolrendering": false,
"delayloadscreens": true,
"disablecdsfileandlargeimage": false,
"disablecommandbar": false,
"dynamicschema": false,
"enableappembeddingux": false,
"enablebarcodereaderfeature": false,
"enablecomponentnamemaps": false,
"enablecomponentscopeoldbehavior": false,
"enableeditcacherefreshfrequency": false,
"enableexcelonlinebusinessv2connector": true,
"enableideaspanel": true,
"enableonstart": true,
"enableonstartnavigate": false,
"enablepcfmoderndatasets": true,
"enablepowerautomatepane": true,
"enablerowscopeonetonexpand": false,
"enablerpawarecomponentdependency": true,
"enablerulespanel": false,
"enablesaveloadcleardataonweb": false,
"enhanceddelegation": true,
"enhancedgalleryinitialization": true,
"errorhandling": true,
"excelcompatibility": false,
"expandedsavedatasupport": true,
"exportimportcomponents2": true,
"externalmessage": false,
"fluentv9controls": false,
"formuladataprefetch": true,
"formularepair": true,
"generatedebugpublishedapp": false,
"herocontrols": false,
"improvedmediacapture": false,
"improvedtabstopbehavior": true,
"keeprecentscreensloaded": false,
"longlivingcache": false,
"namedformulas": false,
"nativecdsexperimental": true,
"optimizedforteamsmeeting": false,
"packagemodernruntime": false,
"parallelcodegen": false,
"pdffunction": false,
"projectionmapping": true,
"reactformulabar": false,
"reliableconcurrent": true,
"reverttooldpowerautomate": false,
"rtlinstudiopreview": false,
"rtlsupport": false,
"supportcolumnnamesasidentifiers": false,
"tabledoesntwraprecords": false,
"untypedobject": false,
"usedisplaynamemetadata": true,
"useenforcesavedatalimits": true,
"useexperimentalcdsconnector": true,
"useexperimentalsqlconnector": true,
"useguiddatatypes": true,
"usenonblockingonstartrule": true,
"webbarcodescanner": false,
"zeroalltabindexes": false
},
"Author": "",
"ContainsThirdPartyPcfControls": false,
"DefaultConnectedDataSourceMaxGetRowsCount": 500,
"DocumentAppType": "DesktopOrTablet",
"DocumentLayoutHeight": 768,
"DocumentLayoutLockOrientation": false,
"DocumentLayoutMaintainAspectRatio": true,
"DocumentLayoutOrientation": "landscape",
"DocumentLayoutScaleToFit": true,
"DocumentLayoutWidth": 1366,
"DocumentType": "App",
"EnableInstrumentation": false,
"FileID": "7104147a-710b-4b62-952d-f3becedc6d74",
"Id": "de9afd87-678a-4211-9700-0b8c9ce473ee",
"InstrumentationKey": "",
"LocalDatabaseReferences": "{}",
"Name": "CC+Project.msapp",
"OriginatingVersion": "1.324"
},
"PublishInfo": {
"AppName": "CC Project",
"BackgroundColor": "RGBA(54,176,75,1)",
"IconColor": "RGBA(255,255,255,1)",
"IconName": "FavoriteStarFill",
"LogoFileName": "logo.jpg",
"PublishDataLocally": false,
"PublishResourcesLocally": false,
"PublishTarget": "player",
"UserLocale": "en-US"
},
"ScreenOrder": [
"Login",
"Register",
"Success",
"Main Screen",
"Personal Details Screen",
"Academic Details Screen",
"Essays Screen",
"Documents Upload Screen",
"Review Screen"
]
}
@@ -0,0 +1 @@
[]

0 comments on commit 4273e53

Please sign in to comment.