(PowerShell) Populi Add Financial Aid Disbursement

Demonstrates the Populi addFinancialAidDisbursement task.

Chilkat .NET Downloads Chilkat .NET Assemblies

Add-Type -Path "C:\chilkat\ChilkatDotNet47-9.5.0-x64\ChilkatDotNet47.dll"

# This example assumes the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

# First load the previously obtained API token.
# See Get Populi Access Token for sample code showing how to get the API token.
$xml = New-Object Chilkat.Xml
$success = $xml.LoadXmlFile("qa_data/tokens/populi_token.xml")
$accessKey = $xml.GetChildContent("access_key")
if ($xml.LastMethodSuccess -ne $true) {
    $("Did not find the access_key")
    exit
}

$rest = New-Object Chilkat.Rest

# Connect using TLS.
# A single REST object, once connected, can be used for many Populi REST API calls.
# The auto-reconnect indicates that if the already-established HTTPS connection is closed,
# then it will be automatically re-established as needed.
$bAutoReconnect = $true
$success = $rest.Connect("yourcollege.populi.co",443,$true,$bAutoReconnect)
if ($success -ne $true) {
    $($rest.LastErrorText)
    exit
}

$rest.Authorization = $accessKey

$rest.AddQueryParam("task","addFinancialAidDisbursement")
$rest.AddQueryParam("person_id","12345678")
$rest.AddQueryParam("award_id","555555")
$rest.AddQueryParam("academic_term_id","123")
$rest.AddQueryParam("scheduled_date","2019-10-10")
$rest.AddQueryParam("amount","12345")

$responseBody = $rest.FullRequestFormUrlEncoded("POST","/api/index.php")
if ($rest.LastMethodSuccess -ne $true) {
    $($rest.LastErrorText)
    exit
}

# We should expect a 200 response if successful.
if ($rest.ResponseStatusCode -ne 200) {
    $("Request Header: ")
    $($rest.LastRequestHeader)
    $("----")
    $("Response StatusCode = " + $rest.ResponseStatusCode)
    $("Response StatusLine: " + $rest.ResponseStatusText)
    $("Response Header:")
    $($rest.ResponseHeader)
    $("Response Body:")
    $($responseBody)
    exit
}

$xml.LoadXml($responseBody)
$($xml.GetXml())

# Sample response:
# Use this online tool to generate parsing code from sample XML: 
# Generate Parsing Code from XML

# <?xml version="1.0" encoding="UTF-8"?>
# <result>
# 	<disbursement>123456</disbursement>
# </result>

$disbursement = $xml.GetChildIntValue("disbursement")