From 760555b41cf9f02d1c06c7dd700e9425314ec86a Mon Sep 17 00:00:00 2001
From: WyattBest <32881391+WyattBest@users.noreply.github.com>
Date: Mon, 11 Mar 2024 18:04:45 -0600
Subject: [PATCH 01/30] Error on apps with duplicate YTS + PDC
Resolves #51
---
config_sample.json | 5 +++--
ps_core.py | 31 ++++++++++++++++++++++++++++++-
ps_format.py | 2 ++
3 files changed, 35 insertions(+), 3 deletions(-)
diff --git a/config_sample.json b/config_sample.json
index 25d6397..4790227 100644
--- a/config_sample.json
+++ b/config_sample.json
@@ -99,8 +99,8 @@
},
"teams": {
"enabled": false,
- "webHookURL" : "[YOUR TEAMS WEBHOOK GOES HERE]",
- "title" : "PowerSlate [Production] Alert"
+ "webHookURL": "[YOUR TEAMS WEBHOOK GOES HERE]",
+ "title": "PowerSlate [Production] Alert"
},
"scheduled_actions": {
"enabled": false,
@@ -138,6 +138,7 @@
"error_academic_row_not_found": "Record not found by Year/Term/Session/Program/Degree/Curriculum.",
"error_invalid_college_attend": "College Attend is set to {} in PowerCampus, which is not valid for applicants.",
"error_api_missing_database": "The PowerCampus Web API is not functioning properly. You may need to remove and reinstall the application.",
+ "error_duplicate_apps": "Person has multiple applications with the same YTS + PCD.",
"sync_done": "Sync completed with no errors.",
"sync_done_not_found": "Sync completed, but one or more applications had integration errors."
},
diff --git a/ps_core.py b/ps_core.py
index 26fbae6..f81af23 100644
--- a/ps_core.py
+++ b/ps_core.py
@@ -319,6 +319,25 @@ def main_sync(pid=None):
CURRENT_RECORD = k
apps[k] = format_app_generic(v, CONFIG["slate_upload_active"])
+ # Set error flag if one pid has multiple applications with the same YTS + PCD
+ duplicates = []
+ for k, v in apps.items():
+ duplicates.extend(
+ [
+ kk
+ for kk, vv in apps.items()
+ if vv["pid"] == v["pid"]
+ and vv["Program"] == v["Program"]
+ and vv["Degree"] == v["Degree"]
+ and vv["YearTerm"] == v["YearTerm"]
+ and k != kk
+ ]
+ )
+
+ for k in duplicates:
+ apps[k]["error_flag"] = True
+ apps[k]["error_message"] = MSG_STRINGS["error_duplicate_apps"]
+
if SETTINGS.powercampus.autoconfigure_mappings.enabled:
verbose_print("Auto-configure ProgramOfStudy and recruiterMapping.xml")
CURRENT_RECORD = None
@@ -337,6 +356,8 @@ def main_sync(pid=None):
verbose_print("Check each app's status flags/PCID in PowerCampus")
for k, v in apps.items():
+ if v["error_flag"] == True:
+ continue
CURRENT_RECORD = k
status_ra, status_app, status_calc, pcid = ps_powercampus.scan_status(v)
apps[k].update(
@@ -350,6 +371,8 @@ def main_sync(pid=None):
verbose_print("Post new or repost unprocessed applications to PowerCampus API")
for k, v in apps.items():
+ if v["error_flag"] == True:
+ continue
CURRENT_RECORD = k
if (v["status_ra"] == None) or (
v["status_ra"] in (1, 2) and v["status_app"] is None
@@ -377,7 +400,11 @@ def main_sync(pid=None):
CURRENT_RECORD = None
# Send list of app GUID's to Slate; get back checklist items
actions_list = slate_get_actions(
- [k for (k, v) in apps.items() if v["status_calc"] == "Active"]
+ [
+ k
+ for (k, v) in apps.items()
+ if v["status_calc"] == "Active" and v["error_flag"] == False
+ ]
)
if CONFIG["scheduled_actions"]["autolearn_action_codes"] == True:
@@ -386,6 +413,8 @@ def main_sync(pid=None):
verbose_print("Update existing applications in PowerCampus and extract information")
edu_sync_results = []
for k, v in apps.items():
+ if v["error_flag"] == False:
+ continue
CURRENT_RECORD = k
if v["status_calc"] == "Active":
# Transform to PowerCampus format
diff --git a/ps_format.py b/ps_format.py
index 463822f..017e9d9 100644
--- a/ps_format.py
+++ b/ps_format.py
@@ -149,6 +149,8 @@ def format_app_generic(app, cfg_fields):
"""Supply missing fields and correct datatypes. Returns a flat dict."""
mapped = format_blank_to_null(app)
+ mapped["error_flag"] = False
+ mapped["error_message"] = None
fields_null = [k for (k, v) in ps_models.fields.items() if v["supply_null"] == True]
fields_bool = [k for (k, v) in ps_models.fields.items() if v["type"] == bool]
From 63580ee2736883ef51e557916cf13b515e2736bf Mon Sep 17 00:00:00 2001
From: WyattBest <32881391+WyattBest@users.noreply.github.com>
Date: Thu, 21 Mar 2024 19:30:22 -0600
Subject: [PATCH 02/30] 9.2.3 API initial compatibility
Very lightly tested. Swagger definition includes 3-valued Programs but does not actually work. Use the old 2-valued style for now.
New features include:
-Token-based auth
-Auto-configure Program of Study Data Filters in Application Form
-More use of settings class
-Changes to Veteran fields
-Modified error handling; API now returns 202 instead of 200
---
SQL/[custom].[PS_updProgramOfStudy].sql | 40 +++++++++++++---
config_sample.json | 6 ++-
ps_core.py | 42 ++++++++++-------
ps_format.py | 34 +++++++------
ps_models.py | 2 +-
ps_powercampus.py | 63 +++++++++++++++----------
6 files changed, 121 insertions(+), 66 deletions(-)
diff --git a/SQL/[custom].[PS_updProgramOfStudy].sql b/SQL/[custom].[PS_updProgramOfStudy].sql
index 93e99f1..272de7a 100644
--- a/SQL/[custom].[PS_updProgramOfStudy].sql
+++ b/SQL/[custom].[PS_updProgramOfStudy].sql
@@ -11,13 +11,16 @@ GO
-- =============================================
-- Author: Wyatt Best
-- Create date: 2021-05-17
--- Description: Inserts a PDC combination into ProgramOfStudy if it doesn't already exist.
+-- Description: Inserts a PDC combination into ProgramOfStudy and ApplicationProgramSetting if it doesn't already exist.
-- If @DegReqMinYear is not null, PDC combination will be valided against DEGREQ.
+--
+-- 2024-03-21 Wyatt Best: Also insert into ApplicationProgramSetting.
-- =============================================
CREATE PROCEDURE [custom].[PS_updProgramOfStudy] @Program NVARCHAR(6)
,@Degree NVARCHAR(6)
,@Curriculum NVARCHAR(6)
,@DegReqMinYear NVARCHAR(4) = NULL
+ ,@AppFormSettingId INT
AS
BEGIN
SET NOCOUNT ON;
@@ -36,7 +39,7 @@ BEGIN
SELECT CurriculumId
FROM CODE_CURRICULUM
WHERE CODE_VALUE_KEY = @Curriculum
- )
+ );
--Error checks
IF @ProgramId IS NULL
@@ -92,14 +95,17 @@ BEGIN
RETURN
END
- --Check for existing ProgramOfStudy row
- IF NOT EXISTS (
- SELECT *
+ --Get existing ProgramOfStudyId
+ DECLARE @ProgramOfStudyId INT = (
+ SELECT ProgramOfStudyId
FROM ProgramOfStudy
WHERE Program = @ProgramId
AND Degree = @DegreeId
AND Curriculum = @CurriculumId
- )
+ );
+
+ --If ProgramOfStudyId is null, insert it
+ IF @ProgramOfStudyId IS NULL
BEGIN
--Optionally check against DEGREQ
IF @DegReqMinYear IS NOT NULL
@@ -135,6 +141,28 @@ BEGIN
@ProgramId
,@DegreeId
,@CurriculumId
+ );
+
+ --Get the newly-inserted ProgramOfStudyId
+ SET @ProgramOfStudyId = SCOPE_IDENTITY();
+ END
+
+ --Check for existing ApplicationProgramSetting row
+ IF NOT EXISTS (
+ SELECT *
+ FROM ApplicationProgramSetting
+ WHERE ApplicationFormSettingId = @AppFormSettingId
+ AND ProgramOfStudyId = @ProgramOfStudyId
)
+ BEGIN
+ --Insert new ProgramOfStudyId
+ INSERT INTO ApplicationProgramSetting (
+ ApplicationFormSettingId
+ ,ProgramOfStudyId
+ )
+ VALUES (
+ @AppFormSettingId
+ ,@ProgramOfStudyId
+ );
END
END
diff --git a/config_sample.json b/config_sample.json
index 4790227..676d0cd 100644
--- a/config_sample.json
+++ b/config_sample.json
@@ -2,8 +2,11 @@
"powercampus": {
"api": {
"url": "https://webapi.school.edu/",
+ "auth_method": "[token|basic]",
"username": "username",
- "password": "astrongpassword"
+ "password": "astrongpassword",
+ "token": "Bearer [YOUR TOKEN]",
+ "app_form_setting_id": 3
},
"autoconfigure_mappings": {
"enabled": false,
@@ -32,7 +35,6 @@
"READ",
"blank"
],
- "app_form_setting_id": 3,
"campus_emailtype": "CAMPUS",
"database_string": "Driver={ODBC Driver 17 for SQL Server};Server=servername;Database=campus6;Trusted_Connection=yes;ServerSPN=MSSQLSvc/servername.local.domain.edu;",
"mapping_file_location": "\\\\servername\\PowerCampus Mapper\\recruiterMapping.xml",
diff --git a/ps_core.py b/ps_core.py
index f81af23..52a8e3c 100644
--- a/ps_core.py
+++ b/ps_core.py
@@ -20,6 +20,7 @@ def __init__(self, config):
self.powercampus = self.PowerCampus(config["powercampus"])
self.console_verbose = config["console_verbose"]
self.msg_strings = self.FlatDict(config["msg_strings"])
+ self.defaults = self.FlatDict(config["defaults"])
class PowerCampus:
def __init__(self, config):
@@ -327,10 +328,12 @@ def main_sync(pid=None):
kk
for kk, vv in apps.items()
if vv["pid"] == v["pid"]
- and vv["Program"] == v["Program"]
- and vv["Degree"] == v["Degree"]
+ and k != kk # Not self
+ and vv["program"] == v["program"]
+ and vv["degree"] == v["degree"]
+ # Needed if and when switching from two to three fields for 9.2.3
+ and vv["curriculum"] == v["curriculum"]
and vv["YearTerm"] == v["YearTerm"]
- and k != kk
]
)
@@ -344,14 +347,22 @@ def main_sync(pid=None):
mfl = SETTINGS.powercampus.mapping_file_location
vd = SETTINGS.powercampus.autoconfigure_mappings.validate_degreq
mdy = SETTINGS.powercampus.autoconfigure_mappings.minimum_degreq_year
- dp_list = [
- (apps[app]["Program"], apps[app]["Degree"])
- for app in apps
- if "Degree" in apps[app]
- ]
+ # Accept either two or three fields for 9.2.3
+ if ({k for k in apps if 'degree' in apps[k]}):
+ program_list = [
+ (apps[app]["program"], apps[app]["degree"], apps[app]["curriculum"])
+ for app in apps
+ if "curriculum" in apps[app]
+ ]
+ else:
+ program_list = [
+ (apps[app]["Program"], apps[app]["Degree"])
+ for app in apps
+ if "Degree" in apps[app]
+ ]
yt_list = [apps[app]["YearTerm"] for app in apps if "YearTerm" in apps[app]]
- if ps_powercampus.autoconfigure_mappings(dp_list, yt_list, vd, mdy, mfl):
+ if ps_powercampus.autoconfigure_mappings(program_list, yt_list, vd, mdy, mfl):
RM_MAPPING = ps_powercampus.get_recruiter_mapping(mfl)
verbose_print("Check each app's status flags/PCID in PowerCampus")
@@ -374,14 +385,13 @@ def main_sync(pid=None):
if v["error_flag"] == True:
continue
CURRENT_RECORD = k
- if (v["status_ra"] == None) or (
- v["status_ra"] in (1, 2) and v["status_app"] is None
+ if (
+ (v["status_ra"] == None)
+ or (v["status_ra"] in (1, 2) and v["status_app"] is None)
+ or (v["status_ra"] == 0 and v["status_app"] == None) # 9.2.3 new bad status
):
- pcid = ps_powercampus.post_api(
- format_app_api(v, CONFIG["defaults"]),
- MSG_STRINGS,
- SETTINGS.powercampus.app_form_setting_id,
- )
+ app = format_app_api(v, SETTINGS.defaults)
+ pcid = ps_powercampus.post_api(app, SETTINGS.powercampus.api, MSG_STRINGS)
apps[k]["PEOPLE_CODE_ID"] = pcid
# Rescan status
diff --git a/ps_format.py b/ps_format.py
index 017e9d9..0ecb86c 100644
--- a/ps_format.py
+++ b/ps_format.py
@@ -235,7 +235,7 @@ def format_app_api(app, cfg_defaults):
if "PostalCode" not in k:
k["PostalCode"] = None
if "County" not in k:
- k["County"] = cfg_defaults["address_country"]
+ k["County"] = cfg_defaults.address_country
if len([k for k in app if k[:5] == "Phone"]) > 0:
has_phones = True
@@ -263,30 +263,39 @@ def format_app_api(app, cfg_defaults):
item["Number"] = format_phone_number(item["Number"])
if "Type" not in item:
- item["Type"] = cfg_defaults["phone_type"]
+ item["Type"] = cfg_defaults.phone_type
else:
item["Type"] = int(item["Type"])
if "Country" not in item:
- item["Country"] = cfg_defaults["phone_country"]
+ item["Country"] = cfg_defaults.phone_country
else:
# PowerCampus WebAPI requires Type -1 instead of a blank or null when not submitting any phones.
mapped["PhoneNumbers"] = [{"Type": -1, "Country": None, "Number": None}]
- # Veteran has funny logic, and API 8.8.3 is broken (passing in 1 will write 2 into [Application].[VeteranStatus]).
- # Impact is low because custom SQL routines will fix Veteran field once person has passed Handle Applications.
+ # Veteran logic was updated in API 9.2.x
if app["Veteran"] is None:
- mapped["Veteran"] = 0
+ mapped["Veteran"] = None
mapped["VeteranStatus"] = False
else:
- mapped["Veteran"] = int(app["Veteran"])
+ mapped["Veteran"] = app["Veteran"]
mapped["VeteranStatus"] = True
# Academic program
- mapped["Programs"] = [
- {"Program": app["Program"], "Degree": app["Degree"], "Curriculum": None}
- ]
+ # API 9.2.3 seems to accept either three or two fields
+ if "curriculum" in app:
+ mapped["Programs"] = [
+ {
+ "program": app["program"],
+ "degree": app["degree"],
+ "curriculum": app["curriculum"],
+ }
+ ]
+ else:
+ mapped["Programs"] = [
+ {"Program": app["Program"], "Degree": app["Degree"], "Curriculum": None}
+ ]
# GUID's
mapped["ApplicationNumber"] = app["aid"]
@@ -358,11 +367,6 @@ def format_app_sql(app, mapping, config):
else:
mapped["VISA"] = None
- if app["Veteran"] is not None:
- mapped["VETERAN"] = mapping["Veteran"][str(app["Veteran"])]
- else:
- mapped["VETERAN"] = None
-
if app["SecondaryCitizenship"] is not None:
mapped["SECONDARYCITIZENSHIP"] = mapping["CitizenshipStatus"][
app["SecondaryCitizenship"]
diff --git a/ps_models.py b/ps_models.py
index 33c848a..c859a45 100644
--- a/ps_models.py
+++ b/ps_models.py
@@ -301,7 +301,7 @@
},
"Veteran": {
"api_verbatim": False,
- "sql_verbatim": False,
+ "sql_verbatim": True,
"supply_null": True,
"type": str,
},
diff --git a/ps_powercampus.py b/ps_powercampus.py
index 0817e31..4120ba6 100644
--- a/ps_powercampus.py
+++ b/ps_powercampus.py
@@ -6,8 +6,6 @@
def init(config, verbose, msg_strings):
- global PC_API_URL
- global PC_API_CRED
global CNXN
global CURSOR
global CONFIG
@@ -18,23 +16,19 @@ def init(config, verbose, msg_strings):
VERBOSE = verbose
MSG_STRINGS = msg_strings
- # PowerCampus Web API connection
- PC_API_URL = config.api.url
- PC_API_CRED = (config.api.username, config.api.password)
-
# Microsoft SQL Server connection.
CNXN = pyodbc.connect(config.database_string)
CURSOR = CNXN.cursor()
# Print a test of connections
- r = requests.get(PC_API_URL + "api/version", auth=PC_API_CRED)
+ r = requests.get(config.api.url + "api/version")
verbose_print("PowerCampus API Status: " + str(r.status_code))
verbose_print(r.text)
r.raise_for_status()
verbose_print("Database:" + CNXN.getinfo(pyodbc.SQL_DATABASE_NAME))
# Enable ApplicationFormSetting's ProcessAutomatically in case program exited abnormally last time with setting toggled off.
- update_app_form_autoprocess(config.app_form_setting_id, True)
+ update_app_form_autoprocess(config.api.app_form_setting_id, True)
def de_init():
@@ -56,7 +50,7 @@ def verbose_print(x):
def autoconfigure_mappings(
- dp_list, yt_list, validate_degreq, minimum_degreq_year, mapping_file_location
+ program_list, yt_list, validate_degreq, minimum_degreq_year, mapping_file_location
):
"""
Automatically insert new Program/Degree/Curriculum combinations into ProgramOfStudy and recruiterMapping.xml
@@ -65,24 +59,29 @@ def autoconfigure_mappings(
and that YearTerm values are like YEAR/TERM/SESSION.
Keyword aguments:
- dp_list -- a list of tuples like [('PROGRAM','DEGREE/CURRICULUM'), (...)]
+ program_list -- list of tuples like [('PROGRAM','DEGREE/CURRICULUM'), (...)] or [('PROGRAM','DEGREE','CURRICULUM'), (...)]
+ yt_list -- list of strings like ['YEAR/TERM/SESSION', ...]
validate_degreq -- bool. If True, check against DEGREQ for sanity using minimum_degreq_year.
minimum_degreq_year -- str
+ mapping_file_location -- str. Path to recruiterMapping.xml
Returns True if XML mapping changed.
"""
- dp_set = set(dp_list)
+ program_set = set(program_list)
yt_set = set(yt_list)
if validate_degreq == False:
minimum_degreq_year = None
# Create set of tuples like {('PROGRAM','DEGREE', 'CURRICULUM'), (...)}
pdc_set = set()
- for dp in dp_set:
- pdc = [dp[0]]
- for dc in dp[1].split("/"):
- pdc.append(dc)
- pdc_set.add(tuple(pdc))
+ if len(program_list[0]) == 2:
+ for dp in program_set:
+ pdc = [dp[0]]
+ for dc in dp[1].split("/"):
+ pdc.append(dc)
+ pdc_set.add(tuple(pdc))
+ elif len(program_list[0]) == 3:
+ pdc_set = program_set
# Create a set like {'PROGRAM', 'PROGRAM'}
p_set = set()
@@ -255,7 +254,7 @@ def get_recruiter_mapping(mapping_file_location):
return rm_mapping
-def post_api(x, cfg_strings, app_form_setting_id):
+def post_api(app, config, msg_strings):
"""Post an application to PowerCampus.
Return PEOPLE_CODE_ID if application was automatically accepted or None for all other conditions.
@@ -263,17 +262,26 @@ def post_api(x, cfg_strings, app_form_setting_id):
x -- an application dict
"""
+ creds = None
+ headers = None
+ if config.auth_method == "basic":
+ creds = (config.username, config.password)
+ elif config.auth_method == "token":
+ headers = {"Authorization": config.token}
+
# Check for duplicate person. If found, temporarily toggle auto-process off.
dup_found = False
- CURSOR.execute("EXEC [custom].[PS_selPersonDuplicate] ?", x["GovernmentId"])
+ CURSOR.execute("EXEC [custom].[PS_selPersonDuplicate] ?", app["GovernmentId"])
row = CURSOR.fetchone()
dup_found = row.DuplicateFound
if dup_found:
- update_app_form_autoprocess(app_form_setting_id, False)
+ update_app_form_autoprocess(config.app_form_setting_id, False)
# Expose error text response from API, replace useless error message(s).
try:
- r = requests.post(PC_API_URL + "api/applications", json=x, auth=PC_API_CRED)
+ r = requests.post(
+ config.url + "api/applications", json=app, auth=creds, headers=headers
+ )
r.raise_for_status()
# The API returns 202 for mapping errors. Technically 202 is appropriate, but it should bubble up to the user.
if r.status_code == 202:
@@ -283,26 +291,29 @@ def post_api(x, cfg_strings, app_form_setting_id):
rtext = r.text.replace("\r\n", "\n")
if dup_found:
- update_app_form_autoprocess(app_form_setting_id, True)
+ update_app_form_autoprocess(config.app_form_setting_id, True)
if (
"BadRequest Object reference not set to an instance of an object." in rtext
and "ApplicationsController.cs:line 183" in rtext
):
- raise ValueError(cfg_strings["error_no_phones"], rtext, e)
+ raise ValueError(msg_strings["error_no_phones"], rtext, e)
elif (
"BadRequest Activation error occured while trying to get instance of type Database, key"
in rtext
and "ServiceLocatorImplBase.cs:line 53" in rtext
):
- raise ValueError(cfg_strings["error_api_missing_database"], rtext, e)
- elif r.status_code == 202 or r.status_code == 400:
+ raise ValueError(msg_strings["error_api_missing_database"], rtext, e)
+ elif (
+ r.status_code == 202
+ and "was created successfully in PowerCampus" not in r.text
+ ) or r.status_code == 400:
raise ValueError(rtext)
- else:
+ elif "was created successfully in PowerCampus" not in r.text:
raise requests.HTTPError(rtext)
if dup_found:
- update_app_form_autoprocess(app_form_setting_id, True)
+ update_app_form_autoprocess(config.app_form_setting_id, True)
if r.text[-25:-12] == "New People Id":
try:
From 85f5c4e139ba9c37faaa090be7ab5c8ab743f136 Mon Sep 17 00:00:00 2001
From: WyattBest <32881391+WyattBest@users.noreply.github.com>
Date: Fri, 22 Mar 2024 10:07:04 -0600
Subject: [PATCH 03/30] Handle missing YearTerm error
Breaks msg_strings into its own config file.
Also fix missing parameter for PS_updProgramOfStudy
Program, Degree, Curriculum should always be capitalized
---
config_messages.json | 15 ++++++
config_sample.json | 10 ----
ps_core.py | 118 +++++++++++++++++++++++++------------------
ps_format.py | 19 ++++---
ps_powercampus.py | 26 ++++++----
5 files changed, 112 insertions(+), 76 deletions(-)
create mode 100644 config_messages.json
diff --git a/config_messages.json b/config_messages.json
new file mode 100644
index 0000000..e7b1d00
--- /dev/null
+++ b/config_messages.json
@@ -0,0 +1,15 @@
+{
+ "error": {
+ "no_apps": "No applications found. Perhaps the application(s) are not submitted or are missing required fields?
",
+ "no_phones": "Application must have at least one phone number.",
+ "academic_row_not_found": "Record not found by Year/Term/Session/Program/Degree/Curriculum.",
+ "invalid_college_attend": "College Attend is set to {} in PowerCampus, which is not valid for applicants.",
+ "api_missing_database": "The PowerCampus Web API is not functioning properly. You may need to remove and reinstall the application.",
+ "duplicate_apps": "Person has multiple applications with the same YTS + PCD.",
+ "missing_yt": "Year/Term/Session is missing from the application."
+ },
+ "success": {
+ "done": "Sync completed with no errors.",
+ "done_not_found": "Sync completed, but one or more applications had integration errors."
+ }
+}
diff --git a/config_sample.json b/config_sample.json
index 676d0cd..0a84833 100644
--- a/config_sample.json
+++ b/config_sample.json
@@ -134,16 +134,6 @@
"phone_country": "US",
"phone_type": 1
},
- "msg_strings": {
- "error_no_apps": "No applications found. Perhaps the application(s) are not submitted or are missing required fields?
",
- "error_no_phones": "Application must have at least one phone number.",
- "error_academic_row_not_found": "Record not found by Year/Term/Session/Program/Degree/Curriculum.",
- "error_invalid_college_attend": "College Attend is set to {} in PowerCampus, which is not valid for applicants.",
- "error_api_missing_database": "The PowerCampus Web API is not functioning properly. You may need to remove and reinstall the application.",
- "error_duplicate_apps": "Person has multiple applications with the same YTS + PCD.",
- "sync_done": "Sync completed with no errors.",
- "sync_done_not_found": "Sync completed, but one or more applications had integration errors."
- },
"http_port": null,
"http_ip": null
}
diff --git a/ps_core.py b/ps_core.py
index 52a8e3c..f06cfd5 100644
--- a/ps_core.py
+++ b/ps_core.py
@@ -15,12 +15,17 @@
# The Settings class should replace the CONFIG global in all new code.
class Settings:
+ class FlatDict:
+ def __init__(self, contents):
+ for field in contents:
+ setattr(self, field, contents[field])
+
def __init__(self, config):
self.fa_awards = self.FlatDict(config["fa_awards"])
- self.powercampus = self.PowerCampus(config["powercampus"])
self.console_verbose = config["console_verbose"]
- self.msg_strings = self.FlatDict(config["msg_strings"])
self.defaults = self.FlatDict(config["defaults"])
+ self.PowerCampus = self.PowerCampus(config["powercampus"])
+ self.Messages = self.Messages()
class PowerCampus:
def __init__(self, config):
@@ -32,35 +37,34 @@ def __init__(self, config):
for d in dicts:
setattr(self, d, Settings.FlatDict(config[d]))
- class FlatDict:
- def __init__(self, contents):
- for field in contents:
- setattr(self, field, contents[field])
+ class Messages:
+ def __init__(self):
+ with open("config_messages.json") as file:
+ messages = json.loads(file.read())
+ self.error = Settings.FlatDict(messages["error"])
+ self.success = Settings.FlatDict(messages["success"])
def init(config_path):
"""Reads config file to global CONFIG dict. Many frequently-used variables are copied to their own globals for convenince."""
global CONFIG
global CONFIG_PATH
- global FIELDS
global RM_MAPPING
global MSG_STRINGS
- global SETTINGS # New global for Settings class
+ global Settings # New global for Settings class
CONFIG_PATH = config_path
with open(CONFIG_PATH) as file:
CONFIG = json.loads(file.read())
- SETTINGS = Settings(CONFIG)
+ Settings = Settings(CONFIG)
RM_MAPPING = ps_powercampus.get_recruiter_mapping(
- SETTINGS.powercampus.mapping_file_location
+ Settings.PowerCampus.mapping_file_location
)
MSG_STRINGS = CONFIG["msg_strings"]
# Init PowerCampus API and SQL connections
- ps_powercampus.init(
- SETTINGS.powercampus, SETTINGS.console_verbose, SETTINGS.msg_strings
- )
+ ps_powercampus.init(Settings.PowerCampus, Settings.console_verbose)
return CONFIG
@@ -310,7 +314,7 @@ def main_sync(pid=None):
apps = {k["aid"]: k for k in apps}
if len(apps) == 0 and pid is not None:
# Assuming we're running in interactive (HTTP) mode if pid param exists
- raise EOFError(MSG_STRINGS["error_no_apps"])
+ raise EOFError(Settings.Messages.error.no_apps)
elif len(apps) == 0:
# Don't raise an error for scheduled mode
return None
@@ -318,7 +322,9 @@ def main_sync(pid=None):
verbose_print("Clean up app data from Slate (datatypes, supply nulls, etc.)")
for k, v in apps.items():
CURRENT_RECORD = k
- apps[k] = format_app_generic(v, CONFIG["slate_upload_active"])
+ apps[k] = format_app_generic(
+ v, CONFIG["slate_upload_active"], Settings.Messages
+ )
# Set error flag if one pid has multiple applications with the same YTS + PCD
duplicates = []
@@ -329,30 +335,31 @@ def main_sync(pid=None):
for kk, vv in apps.items()
if vv["pid"] == v["pid"]
and k != kk # Not self
- and vv["program"] == v["program"]
- and vv["degree"] == v["degree"]
+ and vv["Program"] == v["Program"]
+ and vv["Degree"] == v["Degree"]
# Needed if and when switching from two to three fields for 9.2.3
- and vv["curriculum"] == v["curriculum"]
+ and vv["Curriculum"] == v["Curriculum"]
and vv["YearTerm"] == v["YearTerm"]
]
)
for k in duplicates:
apps[k]["error_flag"] = True
- apps[k]["error_message"] = MSG_STRINGS["error_duplicate_apps"]
+ apps[k]["error_message"] = Settings.Messages.error.duplicate_apps
- if SETTINGS.powercampus.autoconfigure_mappings.enabled:
+ if Settings.PowerCampus.autoconfigure_mappings.enabled:
verbose_print("Auto-configure ProgramOfStudy and recruiterMapping.xml")
CURRENT_RECORD = None
- mfl = SETTINGS.powercampus.mapping_file_location
- vd = SETTINGS.powercampus.autoconfigure_mappings.validate_degreq
- mdy = SETTINGS.powercampus.autoconfigure_mappings.minimum_degreq_year
+ mfl = Settings.PowerCampus.mapping_file_location
+ vd = Settings.PowerCampus.autoconfigure_mappings.validate_degreq
+ mdy = Settings.PowerCampus.autoconfigure_mappings.minimum_degreq_year
+ afsi = Settings.PowerCampus.api.app_form_setting_id
# Accept either two or three fields for 9.2.3
- if ({k for k in apps if 'degree' in apps[k]}):
+ if {k for k in apps if "Degree" in apps[k]}:
program_list = [
- (apps[app]["program"], apps[app]["degree"], apps[app]["curriculum"])
+ (apps[app]["Program"], apps[app]["Degree"], apps[app]["Curriculum"])
for app in apps
- if "curriculum" in apps[app]
+ if "Curriculum" in apps[app]
]
else:
program_list = [
@@ -362,7 +369,14 @@ def main_sync(pid=None):
]
yt_list = [apps[app]["YearTerm"] for app in apps if "YearTerm" in apps[app]]
- if ps_powercampus.autoconfigure_mappings(program_list, yt_list, vd, mdy, mfl):
+ if ps_powercampus.autoconfigure_mappings(
+ program_list,
+ yt_list,
+ vd,
+ mdy,
+ mfl,
+ afsi,
+ ):
RM_MAPPING = ps_powercampus.get_recruiter_mapping(mfl)
verbose_print("Check each app's status flags/PCID in PowerCampus")
@@ -390,20 +404,28 @@ def main_sync(pid=None):
or (v["status_ra"] in (1, 2) and v["status_app"] is None)
or (v["status_ra"] == 0 and v["status_app"] == None) # 9.2.3 new bad status
):
- app = format_app_api(v, SETTINGS.defaults)
- pcid = ps_powercampus.post_api(app, SETTINGS.powercampus.api, MSG_STRINGS)
- apps[k]["PEOPLE_CODE_ID"] = pcid
-
- # Rescan status
- status_ra, status_app, status_calc, pcid = ps_powercampus.scan_status(v)
- apps[k].update(
- {
- "status_ra": status_ra,
- "status_app": status_app,
- "status_calc": status_calc,
- }
+ app, error_flag, error_message = format_app_api(
+ v, Settings.defaults, Settings.Messages
)
- apps[k]["PEOPLE_CODE_ID"] = pcid
+ if error_flag:
+ apps[k]["error_flag"] = error_flag
+ apps[k]["error_message"] = error_message
+ else:
+ pcid = ps_powercampus.post_api(
+ app, Settings.PowerCampus.api, Settings.Messages
+ )
+ apps[k]["PEOPLE_CODE_ID"] = pcid
+
+ # Rescan status
+ status_ra, status_app, status_calc, pcid = ps_powercampus.scan_status(v)
+ apps[k].update(
+ {
+ "status_ra": status_ra,
+ "status_app": status_app,
+ "status_calc": status_calc,
+ }
+ )
+ apps[k]["PEOPLE_CODE_ID"] = pcid
verbose_print("Get scheduled actions from Slate")
if CONFIG["scheduled_actions"]["enabled"] == True:
@@ -428,14 +450,14 @@ def main_sync(pid=None):
CURRENT_RECORD = k
if v["status_calc"] == "Active":
# Transform to PowerCampus format
- app_pc = format_app_sql(v, RM_MAPPING, SETTINGS.powercampus)
+ app_pc = format_app_sql(v, RM_MAPPING, Settings.PowerCampus)
pcid = app_pc["PEOPLE_CODE_ID"]
academic_year = app_pc["ACADEMIC_YEAR"]
academic_term = app_pc["ACADEMIC_TERM"]
academic_session = app_pc["ACADEMIC_SESSION"]
# Single-row updates
- if SETTINGS.powercampus.update_academic_key:
+ if Settings.PowerCampus.update_academic_key:
ps_powercampus.update_academic_key(app_pc)
ps_powercampus.update_demographics(app_pc)
ps_powercampus.update_academic(app_pc)
@@ -476,7 +498,7 @@ def main_sync(pid=None):
ps_powercampus.update_test_scores(pcid, test)
# Update any PowerCampus Notes defined in config
- for note in SETTINGS.powercampus.notes:
+ for note in Settings.PowerCampus.notes:
if (
note["slate_field"] in app_pc
and len(app_pc[note["slate_field"]]) > 0
@@ -486,7 +508,7 @@ def main_sync(pid=None):
)
# Update any PowerCampus User Defined fields defined in config
- for udf in SETTINGS.powercampus.user_defined_fields:
+ for udf in Settings.PowerCampus.user_defined_fields:
if udf["slate_field"] in app_pc and len(app_pc[udf["slate_field"]]) > 0:
ps_powercampus.update_udf(
app_pc, udf["slate_field"], udf["pc_field"]
@@ -505,7 +527,7 @@ def main_sync(pid=None):
ps_powercampus.update_scholarship(
pcid,
scholarship,
- SETTINGS.powercampus.validate_scholarship_levels,
+ Settings.PowerCampus.validate_scholarship_levels,
)
# Update PowerCampus Associations
@@ -532,7 +554,7 @@ def main_sync(pid=None):
custom_4,
custom_5,
) = ps_powercampus.get_profile(
- app_pc, SETTINGS.powercampus.campus_emailtype
+ app_pc, Settings.PowerCampus.campus_emailtype, Settings.Messages
)
apps[k].update(
{
@@ -557,7 +579,7 @@ def main_sync(pid=None):
sync_errors == True
# Get PowerFAIDS awards and tracking status
- if SETTINGS.fa_awards.enabled:
+ if Settings.fa_awards.enabled:
fa_awards, fa_status = ps_powercampus.pf_get_awards(
pcid,
v["GovernmentId"],
@@ -591,7 +613,7 @@ def main_sync(pid=None):
CURRENT_RECORD = k
if v["status_calc"] == "Active":
# Transform to PowerCampus format
- app_pc = format_app_sql(v, RM_MAPPING, SETTINGS.powercampus)
+ app_pc = format_app_sql(v, RM_MAPPING, Settings.PowerCampus)
fa_checklists = ps_powercampus.pf_get_fachecklist(
app_pc["PEOPLE_CODE_ID"],
diff --git a/ps_format.py b/ps_format.py
index 0ecb86c..f4c351f 100644
--- a/ps_format.py
+++ b/ps_format.py
@@ -145,7 +145,7 @@ def format_str_digits(s):
return s.translate(non_digits)
-def format_app_generic(app, cfg_fields):
+def format_app_generic(app, cfg_fields, Messages):
"""Supply missing fields and correct datatypes. Returns a flat dict."""
mapped = format_blank_to_null(app)
@@ -183,7 +183,7 @@ def format_app_generic(app, cfg_fields):
return mapped
-def format_app_api(app, cfg_defaults):
+def format_app_api(app, cfg_defaults, Messages):
"""Remap application to Recruiter/Web API format.
Keyword arguments:
@@ -192,6 +192,11 @@ def format_app_api(app, cfg_defaults):
mapped = {}
+ # Error checks
+ if "YearTerm" not in app:
+ error_message = Messages.error.missing_yt
+ error_flag = True
+
# Pass through fields
fields_verbatim = [
k for (k, v) in ps_models.fields.items() if v["api_verbatim"] == True
@@ -284,12 +289,12 @@ def format_app_api(app, cfg_defaults):
# Academic program
# API 9.2.3 seems to accept either three or two fields
- if "curriculum" in app:
+ if "Curriculum" in app:
mapped["Programs"] = [
{
- "program": app["program"],
- "degree": app["degree"],
- "curriculum": app["curriculum"],
+ "Program": app["Program"],
+ "Degree": app["Degree"],
+ "Curriculum": app["Curriculum"],
}
]
else:
@@ -301,7 +306,7 @@ def format_app_api(app, cfg_defaults):
mapped["ApplicationNumber"] = app["aid"]
mapped["ProspectId"] = app["pid"]
- return mapped
+ return mapped, error_flag, error_message
def format_app_sql(app, mapping, config):
diff --git a/ps_powercampus.py b/ps_powercampus.py
index 4120ba6..de4a612 100644
--- a/ps_powercampus.py
+++ b/ps_powercampus.py
@@ -5,16 +5,14 @@
import ps_models
-def init(config, verbose, msg_strings):
+def init(config, verbose):
global CNXN
global CURSOR
global CONFIG
global VERBOSE
- global MSG_STRINGS
CONFIG = config
VERBOSE = verbose
- MSG_STRINGS = msg_strings
# Microsoft SQL Server connection.
CNXN = pyodbc.connect(config.database_string)
@@ -50,7 +48,12 @@ def verbose_print(x):
def autoconfigure_mappings(
- program_list, yt_list, validate_degreq, minimum_degreq_year, mapping_file_location
+ program_list,
+ yt_list,
+ validate_degreq,
+ minimum_degreq_year,
+ mapping_file_location,
+ app_form_setting_id,
):
"""
Automatically insert new Program/Degree/Curriculum combinations into ProgramOfStudy and recruiterMapping.xml
@@ -110,11 +113,12 @@ def autoconfigure_mappings(
# Update ProgramOfStudy table; optionally validate against DEGREQ table
for pdc in pdc_set:
CURSOR.execute(
- "execute [custom].[PS_updProgramOfStudy] ?, ?, ?, ?",
+ "execute [custom].[PS_updProgramOfStudy] ?, ?, ?, ?, ?",
pdc[0],
pdc[1],
pdc[2],
minimum_degreq_year,
+ app_form_setting_id,
)
CNXN.commit()
@@ -254,7 +258,7 @@ def get_recruiter_mapping(mapping_file_location):
return rm_mapping
-def post_api(app, config, msg_strings):
+def post_api(app, config, Messages):
"""Post an application to PowerCampus.
Return PEOPLE_CODE_ID if application was automatically accepted or None for all other conditions.
@@ -297,13 +301,13 @@ def post_api(app, config, msg_strings):
"BadRequest Object reference not set to an instance of an object." in rtext
and "ApplicationsController.cs:line 183" in rtext
):
- raise ValueError(msg_strings["error_no_phones"], rtext, e)
+ raise ValueError(Messages.error.no_phones, rtext, e)
elif (
"BadRequest Activation error occured while trying to get instance of type Database, key"
in rtext
and "ServiceLocatorImplBase.cs:line 53" in rtext
):
- raise ValueError(msg_strings["error_api_missing_database"], rtext, e)
+ raise ValueError(Messages.error.api_missing_database, rtext, e)
elif (
r.status_code == 202
and "was created successfully in PowerCampus" not in r.text
@@ -396,7 +400,7 @@ def scan_status(x):
return ra_status, apl_status, computed_status, pcid
-def get_profile(app, campus_email_type):
+def get_profile(app, campus_email_type, Messages):
"""Fetch ACADEMIC row data and email address from PowerCampus.
Returns:
@@ -410,7 +414,7 @@ def get_profile(app, campus_email_type):
"""
error_flag = True
- error_message = MSG_STRINGS.error_academic_row_not_found
+ error_message = Messages.error.academic_row_not_found
registered = False
reg_date = None
readmit = False
@@ -464,7 +468,7 @@ def get_profile(app, campus_email_type):
if college_attend not in CONFIG.valid_college_attend:
error_flag = True
- error_message = MSG_STRINGS.error_invalid_college_attend.format(
+ error_message = Settings.Messages.error.invalid_college_attend.format(
college_attend
)
From 34c7adb14c4d64931f6b314a71432889c0c3c477 Mon Sep 17 00:00:00 2001
From: WyattBest <32881391+WyattBest@users.noreply.github.com>
Date: Fri, 22 Mar 2024 10:15:50 -0600
Subject: [PATCH 04/30] Improve final success message
---
config_messages.json | 2 +-
ps_core.py | 8 +++-----
2 files changed, 4 insertions(+), 6 deletions(-)
diff --git a/config_messages.json b/config_messages.json
index e7b1d00..318af80 100644
--- a/config_messages.json
+++ b/config_messages.json
@@ -10,6 +10,6 @@
},
"success": {
"done": "Sync completed with no errors.",
- "done_not_found": "Sync completed, but one or more applications had integration errors."
+ "done_with_errors": "Sync completed, but one or more applications had integration errors."
}
}
diff --git a/ps_core.py b/ps_core.py
index f06cfd5..65dbe62 100644
--- a/ps_core.py
+++ b/ps_core.py
@@ -50,7 +50,6 @@ def init(config_path):
global CONFIG
global CONFIG_PATH
global RM_MAPPING
- global MSG_STRINGS
global Settings # New global for Settings class
CONFIG_PATH = config_path
@@ -61,7 +60,6 @@ def init(config_path):
RM_MAPPING = ps_powercampus.get_recruiter_mapping(
Settings.PowerCampus.mapping_file_location
)
- MSG_STRINGS = CONFIG["msg_strings"]
# Init PowerCampus API and SQL connections
ps_powercampus.init(Settings.PowerCampus, Settings.console_verbose)
@@ -629,10 +627,10 @@ def main_sync(pid=None):
slate_post_fa_checklist(slate_upload_list)
# Warn if any apps returned an error flag from ps_powercampus.get_profile()
- if sync_errors == True:
- output_msg = MSG_STRINGS["sync_done_not_found"]
+ if sync_errors == True or [k for k in apps if apps[k]["error_flag"] == True]:
+ output_msg = Settings.Messages.success.done_with_errors
else:
- output_msg = MSG_STRINGS["sync_done"]
+ output_msg = Settings.Messages.success.done
verbose_print(output_msg)
return output_msg
From 6b9de21f32ea4d2b4fef99dc2bdee7ba7ffd7e8b Mon Sep 17 00:00:00 2001
From: WyattBest <32881391+WyattBest@users.noreply.github.com>
Date: Fri, 22 Mar 2024 10:34:23 -0600
Subject: [PATCH 05/30] API compatibility tweaks
-Transform PDC to PD for API
-Fix uninitialized variables
-Fix incorrect handling of good 202 status
---
ps_format.py | 8 +++++---
ps_powercampus.py | 8 +++-----
2 files changed, 8 insertions(+), 8 deletions(-)
diff --git a/ps_format.py b/ps_format.py
index f4c351f..15a95ea 100644
--- a/ps_format.py
+++ b/ps_format.py
@@ -191,6 +191,8 @@ def format_app_api(app, cfg_defaults, Messages):
"""
mapped = {}
+ error_flag = False
+ error_message = None
# Error checks
if "YearTerm" not in app:
@@ -288,13 +290,13 @@ def format_app_api(app, cfg_defaults, Messages):
mapped["VeteranStatus"] = True
# Academic program
- # API 9.2.3 seems to accept either three or two fields
+ # API 9.2.3 still requires two fields for Program and Degree, even though the Swagger schema contains three fields.
if "Curriculum" in app:
mapped["Programs"] = [
{
"Program": app["Program"],
- "Degree": app["Degree"],
- "Curriculum": app["Curriculum"],
+ "Degree": app["Degree"] + "/" + app["Curriculum"],
+ "Curriculum": None,
}
]
else:
diff --git a/ps_powercampus.py b/ps_powercampus.py
index de4a612..993c704 100644
--- a/ps_powercampus.py
+++ b/ps_powercampus.py
@@ -310,10 +310,10 @@ def post_api(app, config, Messages):
raise ValueError(Messages.error.api_missing_database, rtext, e)
elif (
r.status_code == 202
- and "was created successfully in PowerCampus" not in r.text
+ and "was created successfully in PowerCampus" in r.text == False
) or r.status_code == 400:
raise ValueError(rtext)
- elif "was created successfully in PowerCampus" not in r.text:
+ elif "was created successfully in PowerCampus" not in r.text == False:
raise requests.HTTPError(rtext)
if dup_found:
@@ -468,9 +468,7 @@ def get_profile(app, campus_email_type, Messages):
if college_attend not in CONFIG.valid_college_attend:
error_flag = True
- error_message = Settings.Messages.error.invalid_college_attend.format(
- college_attend
- )
+ error_message = Messages.error.invalid_college_attend.format(college_attend)
if row.Withdrawn == "Y":
withdrawn = True
From 3b6a34fbfdf2e22aa88a7a427d4c485330f6600c Mon Sep 17 00:00:00 2001
From: WyattBest <32881391+WyattBest@users.noreply.github.com>
Date: Fri, 22 Mar 2024 10:39:38 -0600
Subject: [PATCH 06/30] Remove SQL logging feature
Slow and rarely used. API 9.2.3 doesn't write most (any?) errors to RecruiterApplication table anymore, so this would need rewritten.
---
.../Create Table PowerSlate_AppStatus_Log.sql | 33 -------------------
Tools/GRANT EXEC.sql | 3 --
Tools/Prune log table.sql | 20 -----------
Tools/Select Most Recent Status.sql | 28 ----------------
config_sample.json | 4 ---
ps_powercampus.py | 25 --------------
6 files changed, 113 deletions(-)
delete mode 100644 Tools/Create Table PowerSlate_AppStatus_Log.sql
delete mode 100644 Tools/Prune log table.sql
delete mode 100644 Tools/Select Most Recent Status.sql
diff --git a/Tools/Create Table PowerSlate_AppStatus_Log.sql b/Tools/Create Table PowerSlate_AppStatus_Log.sql
deleted file mode 100644
index 10c3aec..0000000
--- a/Tools/Create Table PowerSlate_AppStatus_Log.sql
+++ /dev/null
@@ -1,33 +0,0 @@
-USE [PowerCampusMapper]
-GO
-
-/****** Object: Table [dbo].[PowerSlate_AppStatus_Log_test] Script Date: 2/18/2021 3:50:29 PM ******/
-SET ANSI_NULLS ON
-GO
-
-SET QUOTED_IDENTIFIER ON
-GO
-
-CREATE TABLE [dbo].[PowerSlate_AppStatus_Log](
- [ApplicationNumber] [uniqueidentifier] NULL,
- [ProspectId] [uniqueidentifier] NULL,
- [FirstName] [nvarchar](50) NULL,
- [LastName] [nvarchar](50) NULL,
- [ComputedStatus] [nvarchar](50) NULL,
- [Notes] [nvarchar](max) NULL,
- [RecruiterApplicationStatus] [int] NULL,
- [ApplicationStatus] [int] NULL,
- [PEOPLE_CODE_ID] [nvarchar](10) NULL,
- [UpdateTime] [datetime2](7) NULL,
- [ID] [int] IDENTITY(1,1) NOT NULL,
- [Ref] [nvarchar](16) NULL,
-PRIMARY KEY CLUSTERED
-(
- [ID] ASC
-)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]
-) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY]
-GO
-
-ALTER TABLE [dbo].[PowerSlate_AppStatus_Log] ADD CONSTRAINT [PowerSlate_AppStatus_Log_UpdateTime] DEFAULT (getdate()) FOR [UpdateTime]
-GO
-
diff --git a/Tools/GRANT EXEC.sql b/Tools/GRANT EXEC.sql
index 54472ef..4903c0e 100644
--- a/Tools/GRANT EXEC.sql
+++ b/Tools/GRANT EXEC.sql
@@ -27,6 +27,3 @@ GRANT EXEC ON [custom].[PS_selPFAwardsXML] to [$(service_user)]
GRANT EXEC ON [custom].[PS_selAcademicCalendar] to [$(service_user)]
GRANT EXEC ON [custom].[PS_updScholarships] to [$(service_user)]
GRANT EXEC ON [custom].[PS_updAssociation] to [$(service_user)]
-
-USE [PowerCampusMapper]
-GRANT INSERT ON PowerSlate_AppStatus_Log TO [$(service_user)]
diff --git a/Tools/Prune log table.sql b/Tools/Prune log table.sql
deleted file mode 100644
index 49147f6..0000000
--- a/Tools/Prune log table.sql
+++ /dev/null
@@ -1,20 +0,0 @@
-USE powercampusmapper;
-
-WITH RankedIDs_CTE
-AS (
- SELECT ID
- ,RANK() OVER (
- PARTITION BY ApplicationNumber ORDER BY ID DESC
- ) [RankDesc]
- ,NULL AS [RankAsc]
- ,ApplicationNumber
- FROM [PowerSlate_AppStatus_Log_test]
- )
-DELETE TOP (9000)
-FROM RankedIDs_CTE
-WHERE [RankDesc] >= 6
- AND ID <> (
- SELECT MIN(ID)
- FROM [PowerSlate_AppStatus_Log_test] L2
- WHERE L2.ApplicationNumber = RankedIDs_CTE.ApplicationNumber
- );
diff --git a/Tools/Select Most Recent Status.sql b/Tools/Select Most Recent Status.sql
deleted file mode 100644
index 3f1765a..0000000
--- a/Tools/Select Most Recent Status.sql
+++ /dev/null
@@ -1,28 +0,0 @@
-USE [your_supplementary_database]
-
-SELECT Ref
- ,ApplicationNumber
- ,ProspectId
- ,FirstName
- ,LastName
- ,ComputedStatus
- ,Notes
- ,RecruiterApplicationStatus
- ,ApplicationStatus
- ,PEOPLE_CODE_ID
- ,UpdateTime
-FROM
- (SELECT Ref
- ,ApplicationNumber
- ,ProspectId
- ,FirstName
- ,LastName
- ,ComputedStatus
- ,Notes
- ,RecruiterApplicationStatus
- ,ApplicationStatus
- ,PEOPLE_CODE_ID
- ,UpdateTime
- ,RANK() OVER (PARTITION BY ApplicationNumber ORDER BY ID DESC) N
- FROM SlaPowInt_AppStatus_Log) E
-WHERE N = 1
diff --git a/config_sample.json b/config_sample.json
index 0a84833..24b5331 100644
--- a/config_sample.json
+++ b/config_sample.json
@@ -20,10 +20,6 @@
"note_type": "GENRL"
}
],
- "logging": {
- "enabled": true,
- "log_table": "[SomeDatabase].[dbo].[PowerSlate_AppStatus_Log]"
- },
"user_defined_fields": [
{
"slate_field": "FirstGeneration",
diff --git a/ps_powercampus.py b/ps_powercampus.py
index 993c704..ec03732 100644
--- a/ps_powercampus.py
+++ b/ps_powercampus.py
@@ -372,31 +372,6 @@ def scan_status(x):
else:
computed_status = "Unrecognized Status: " + str(row.ra_status)
- if CONFIG.logging.enabled:
- # Write errors to external database for end-user presentation via SSRS.
- CURSOR.execute(
- "INSERT INTO"
- + CONFIG.logging.log_table
- + """
- ([Ref],[ApplicationNumber],[ProspectId],[FirstName],[LastName],
- [ComputedStatus],[Notes],[RecruiterApplicationStatus],[ApplicationStatus],[PEOPLE_CODE_ID])
- VALUES
- (?,?,?,?,?,?,?,?,?,?)""",
- [
- x["Ref"],
- x["aid"],
- x["pid"],
- x["FirstName"],
- x["LastName"],
- computed_status,
- row.ra_errormessage,
- row.ra_status,
- row.apl_status,
- pcid,
- ],
- )
- CNXN.commit()
-
return ra_status, apl_status, computed_status, pcid
From 4d3757c68a36cf30534c70796e2f5890daf04dc3 Mon Sep 17 00:00:00 2001
From: WyattBest <32881391+WyattBest@users.noreply.github.com>
Date: Fri, 29 Mar 2024 12:08:57 -0600
Subject: [PATCH 07/30] Utilize new ACADEMIC Guid
First draft; may contain bugs!
---
SQL/[custom].[PS_selProfile].sql | 236 +++++++++++++++++----------
SQL/[custom].[PS_updAcademicKey].sql | 126 +++++---------
config_sample.json | 3 +-
ps_core.py | 7 +-
ps_models.py | 6 +
ps_powercampus.py | 82 ++++++----
6 files changed, 250 insertions(+), 210 deletions(-)
diff --git a/SQL/[custom].[PS_selProfile].sql b/SQL/[custom].[PS_selProfile].sql
index 3d3d190..7497323 100644
--- a/SQL/[custom].[PS_selProfile].sql
+++ b/SQL/[custom].[PS_selProfile].sql
@@ -26,6 +26,7 @@ GO
-- 2021-12-01 Wyatt Best: Renamed MoodleOrientationComplete to custom_1 and added 4 more custom fields.
-- 2022-02-16 Wyatt Best: Added @EmailType parameter.
-- 2022-09-27 Wyatt Best: Return AD username (SSO ID) to Slate from PersonUser.
+-- 2024-03-29 Wyatt Best: Return Guid column (new in 9.2.3) or error message about changed YTSPDC.
-- =============================================
CREATE PROCEDURE [custom].[PS_selProfile] @PCID NVARCHAR(10)
,@Year NVARCHAR(4)
@@ -35,10 +36,16 @@ CREATE PROCEDURE [custom].[PS_selProfile] @PCID NVARCHAR(10)
,@Degree NVARCHAR(6)
,@Curriculum NVARCHAR(6)
,@EmailType NVARCHAR(10)
+ ,@AcademicGuid UNIQUEIDENTIFIER
AS
BEGIN
SET NOCOUNT ON;
+ --Writing a simple method for handling non-fatal errors because differentiating real
+ --errors in Python is hard and varies based on the ODBC driver used.
+ DECLARE @ErrorFlag BIT = 0
+ ,@ErrorMessage NVARCHAR(max)
+
--Error check
IF (
@EmailType IS NOT NULL
@@ -59,10 +66,10 @@ BEGIN
RETURN
END
- --Select credits from rollup to avoid duplicate hits to table
+ --Select credits from rollup
DECLARE @Credits NUMERIC(6, 2) = (
SELECT CREDITS
- FROM ACADEMIC A
+ FROM ACADEMIC
WHERE PEOPLE_CODE_ID = @PCID
AND ACADEMIC_YEAR = @Year
AND ACADEMIC_TERM = @Term
@@ -72,87 +79,146 @@ BEGIN
AND CURRICULUM = @Curriculum
)
- --If someone has multiple apps for one YTS with different PDC's but the same transcript sequence, you will not be able to
- --separate the credits because TRANSCRIPTDETAIL doesn't have PDC. Custom logic is required to sort out things like-zero credit certificate
- --dual enrollment with a for-credit program.
- SELECT CASE
- WHEN @Credits > 0
- THEN 'Y'
- WHEN PROGRAM = 'CERT'
- AND EXISTS (
- SELECT TD.PEOPLE_ID
- FROM TRANSCRIPTDETAIL TD
- INNER JOIN ACADEMIC A
- ON A.PEOPLE_CODE_ID = TD.PEOPLE_CODE_ID
- AND A.ACADEMIC_YEAR = TD.ACADEMIC_YEAR
- AND A.ACADEMIC_TERM = TD.ACADEMIC_TERM
- AND A.ACADEMIC_SESSION = TD.ACADEMIC_SESSION
- AND A.PROGRAM = @Program
- AND A.DEGREE = @Degree
- AND A.CURRICULUM = @Curriculum
- AND A.TRANSCRIPT_SEQ = TD.TRANSCRIPT_SEQ
- --AND A.ACADEMIC_FLAG = 'Y' --Can mask some issues of registrations w/out acceptance, but needed for someone who applies for CERT and UNDER and only registers for undergrad.
- AND A.APPLICATION_FLAG = 'Y'
- WHERE TD.PEOPLE_CODE_ID = @PCID
- AND TD.ACADEMIC_YEAR = @Year
- AND TD.ACADEMIC_TERM = @Term
- AND TD.ACADEMIC_SESSION = @Session
- AND TD.ADD_DROP_WAIT = 'A'
- )
- THEN 'Y'
- ELSE 'N'
- END AS 'Registered'
- ,CAST(COALESCE(PREREG_VAL_DATE, REG_VAL_DATE) AS DATE) [REG_VAL_DATE]
- ,cast(@Credits AS VARCHAR(6)) AS CREDITS
- ,A.COLLEGE_ATTEND
- ,(
- SELECT REQUIRE_SEPDATE
- FROM CODE_ENROLLMENT
- WHERE CODE_VALUE_KEY = A.ENROLL_SEPARATION
- ) AS Withdrawn
- ,oE.Email AS CampusEmail
- ,(
- SELECT NonQualifiedUserName
- FROM PersonUser
- WHERE PersonId = dbo.fnGetPersonId(A.ADVISOR)
- ) [AdvisorUsername]
- ,(
- SELECT NonQualifiedUserName
- FROM PersonUser
- WHERE PersonId = dbo.fnGetPersonId(A.PEOPLE_CODE_ID)
- ) [Username]
- ,CASE
- WHEN EXISTS (
- SELECT *
- FROM TESTSCORES T
- WHERE TEST_ID = 'MOOD'
- AND TEST_TYPE = 'STU'
- AND ALPHA_SCORE_1 = 'P'
- AND T.PEOPLE_CODE_ID = A.PEOPLE_CODE_ID
- )
- THEN 'Y'
- ELSE 'N'
- END [custom_1]
- ,NULL [custom_2]
- ,NULL [custom_3]
- ,NULL [custom_4]
- ,NULL [custom_5]
- FROM ACADEMIC A
- OUTER APPLY (
- SELECT TOP 1 Email
- FROM EmailAddress E
- WHERE E.PeopleOrgCodeId = A.PEOPLE_CODE_ID
- AND E.EmailType = @EmailType
- AND E.IsActive = 1
- ORDER BY E.REVISION_DATE DESC
- ,REVISION_TIME DESC
- ) oE
- WHERE PEOPLE_CODE_ID = @PCID
- AND ACADEMIC_YEAR = @Year
- AND ACADEMIC_TERM = @Term
- AND ACADEMIC_SESSION = @Session
- AND PROGRAM = @Program
- AND DEGREE = @Degree
- AND CURRICULUM = @Curriculum
- AND APPLICATION_FLAG = 'Y' --Ought to be an application, or there's a problem somewhere.
+ --Search for @AcademicGuid if NULL
+ IF @AcademicGuid IS NULL
+ SELECT @AcademicGuid = [Guid]
+ FROM ACADEMIC
+ WHERE PEOPLE_CODE_ID = @PCID
+ AND ACADEMIC_YEAR = @Year
+ AND ACADEMIC_TERM = @Term
+ AND ACADEMIC_SESSION = @Session
+ AND PROGRAM = @Program
+ AND DEGREE = @Degree
+ AND CURRICULUM = @Curriculum
+ ELSE
+ BEGIN
+ --Verify that YTSPDC match existing @AcademicGuid
+ DECLARE @TempYear NVARCHAR(4)
+ ,@TempTerm NVARCHAR(10)
+ ,@TempSession NVARCHAR(10)
+ ,@TempProgram NVARCHAR(6)
+ ,@TempDegree NVARCHAR(6)
+ ,@TempCurriculum NVARCHAR(6)
+
+ SELECT @TempYear = ACADEMIC_YEAR
+ ,@TempTerm = ACADEMIC_TERM
+ ,@TempSession = ACADEMIC_SESSION
+ ,@TempProgram = PROGRAM
+ ,@TempDegree = DEGREE
+ ,@TempCurriculum = CURRICULUM
+ FROM [ACADEMIC]
+ WHERE [Guid] = @AcademicGuid
+
+ IF @TempYear <> @Year
+ OR @TempTerm <> @Term
+ OR @TempSession <> @Session
+ OR @TempProgram <> @Program
+ OR @TempDegree <> @Degree
+ OR @TempCurriculum <> @Curriculum
+ SELECT @ErrorFlag = 1
+ ,@ErrorMessage = 'The Application in PowerCampus has a different YTS + PDC than the Slate application.
+ Expected: ' + @Year + '/' + @Term + '/' + @Session + '/' + @Program + '/' + @Degree + '/' + @Curriculum + '
+ Found: ' + @TempYear + '/' + @TempTerm + '/' + @TempSession + '/' + @TempProgram + '/' + @TempDegree + '/' + @TempCurriculum
+ END
+
+ --Return error if @ErrorFlag = 1
+ IF @ErrorFlag = 1
+ SELECT NULL [Registered]
+ ,NULL [REG_VAL_DATE]
+ ,NULL [CREDITS]
+ ,NULL [COLLEGE_ATTEND]
+ ,NULL [Withdrawn]
+ ,NULL [CampusEmail]
+ ,NULL [AdvisorUsername]
+ ,NULL [Username]
+ ,NULL [custom_1]
+ ,NULL [custom_2]
+ ,NULL [custom_3]
+ ,NULL [custom_4]
+ ,NULL [custom_5]
+ ,@ErrorFlag [ErrorFlag]
+ ,@ErrorMessage [ErrorMessage]
+ ELSE
+ BEGIN
+ --Else return ACADEMIC columns
+ --
+ --If someone has multiple apps for one YTS with different PDC's but the same transcript sequence, you will not be able to
+ --separate the credits because TRANSCRIPTDETAIL doesn't have PDC. Custom logic is required to sort out things like-zero credit certificate
+ --dual enrollment with a for-credit program.
+ SELECT CASE
+ WHEN @Credits > 0
+ THEN 'Y'
+ WHEN PROGRAM = 'CERT'
+ AND EXISTS (
+ SELECT TD.PEOPLE_ID
+ FROM TRANSCRIPTDETAIL TD
+ INNER JOIN ACADEMIC A
+ ON A.[Guid] = @AcademicGuid
+ --A.PEOPLE_CODE_ID = TD.PEOPLE_CODE_ID
+ --AND A.ACADEMIC_YEAR = TD.ACADEMIC_YEAR
+ --AND A.ACADEMIC_TERM = TD.ACADEMIC_TERM
+ --AND A.ACADEMIC_SESSION = TD.ACADEMIC_SESSION
+ --AND A.PROGRAM = @Program
+ --AND A.DEGREE = @Degree
+ --AND A.CURRICULUM = @Curriculum
+ --AND A.TRANSCRIPT_SEQ = TD.TRANSCRIPT_SEQ
+ --AND A.ACADEMIC_FLAG = 'Y' --Can mask some issues of registrations w/out acceptance, but needed for someone who applies for CERT and UNDER and only registers for undergrad.
+ AND A.APPLICATION_FLAG = 'Y'
+ WHERE TD.PEOPLE_CODE_ID = @PCID
+ AND TD.ACADEMIC_YEAR = @Year
+ AND TD.ACADEMIC_TERM = @Term
+ AND TD.ACADEMIC_SESSION = @Session
+ AND TD.ADD_DROP_WAIT = 'A'
+ )
+ THEN 'Y'
+ ELSE 'N'
+ END AS [Registered]
+ ,CAST(COALESCE(PREREG_VAL_DATE, REG_VAL_DATE) AS DATE) AS [REG_VAL_DATE]
+ ,cast(@Credits AS VARCHAR(6)) AS [CREDITS]
+ ,A.[COLLEGE_ATTEND]
+ ,(
+ SELECT REQUIRE_SEPDATE
+ FROM CODE_ENROLLMENT
+ WHERE CODE_VALUE_KEY = A.ENROLL_SEPARATION
+ ) AS [Withdrawn]
+ ,oE.Email AS [CampusEmail]
+ ,(
+ SELECT NonQualifiedUserName
+ FROM PersonUser
+ WHERE PersonId = dbo.fnGetPersonId(A.ADVISOR)
+ ) AS [AdvisorUsername]
+ ,(
+ SELECT NonQualifiedUserName
+ FROM PersonUser
+ WHERE PersonId = dbo.fnGetPersonId(A.PEOPLE_CODE_ID)
+ ) AS [Username]
+ ,[Guid]
+ ,NULL [custom_1]
+ ,NULL [custom_2]
+ ,NULL [custom_3]
+ ,NULL [custom_4]
+ ,NULL [custom_5]
+ ,@ErrorFlag [ErrorFlag]
+ ,@ErrorMessage [ErrorMessage]
+ FROM ACADEMIC A
+ OUTER APPLY (
+ SELECT TOP 1 Email
+ FROM EmailAddress E
+ WHERE E.PeopleOrgCodeId = A.PEOPLE_CODE_ID
+ AND E.EmailType = @EmailType
+ AND E.IsActive = 1
+ ORDER BY E.REVISION_DATE DESC
+ ,REVISION_TIME DESC
+ ) oE
+ WHERE 1 = 1
+ AND [Guid] = @AcademicGuid
+ --AND PEOPLE_CODE_ID = @PCID
+ --AND ACADEMIC_YEAR = @Year
+ --AND ACADEMIC_TERM = @Term
+ --AND ACADEMIC_SESSION = @Session
+ --AND PROGRAM = @Program
+ --AND DEGREE = @Degree
+ --AND CURRICULUM = @Curriculum
+ AND APPLICATION_FLAG = 'Y' --Ought to be an application, or there's a problem somewhere.
+ END
END
diff --git a/SQL/[custom].[PS_updAcademicKey].sql b/SQL/[custom].[PS_updAcademicKey].sql
index aa00a70..4dad871 100644
--- a/SQL/[custom].[PS_updAcademicKey].sql
+++ b/SQL/[custom].[PS_updAcademicKey].sql
@@ -11,11 +11,13 @@ GO
-- =============================================
-- Author: Wyatt Best
-- Create date: 2021-03-17
--- Description: Updates [custom].AcademicKey with RecruiterApplicationId. See https://github.com/WyattBest/PowerCampus-AcademicKey
--- Updates PROGRAM, DEGREE, and CURRICULUM rows in ACADEMIC if program change happens in Slate before registration or academic plan assignment.
+-- Description: Updates PROGRAM, DEGREE, and CURRICULUM rows in ACADEMIC if program change happens in Slate before registration or academic plan assignment.
+-- Set APPLICATION_FLAG to 'Y' if necessary (fix rows manually entered in Academic Records before application was inserted).
--
-- 2021-09-01 Wyatt Best: Clear bad RecruiterApplicationId entries.
-- 2022-04-04 Wyatt Best: Add ability to update PROGRAM/DEGREE/CURRICULUM in ACADEMIC. Stop clearing bad RecruiterApplicationId entries.
+-- 2024-03-29 Wyatt Best: Rewritten to use 9.2.3's built-in Academic.Guid instead of a custom key. Formerly used https://github.com/WyattBest/PowerCampus-AcademicKey.
+-- Set APPLICATION_FLAG to 'Y' if necessary.
-- =============================================
CREATE PROCEDURE [custom].[PS_updAcademicKey] @PCID NVARCHAR(10)
,@Year NVARCHAR(4)
@@ -24,94 +26,44 @@ CREATE PROCEDURE [custom].[PS_updAcademicKey] @PCID NVARCHAR(10)
,@Program NVARCHAR(6)
,@Degree NVARCHAR(6)
,@Curriculum NVARCHAR(6)
- ,@SlateAppGuid UNIQUEIDENTIFIER NULL
+ ,@AcademicGuid UNIQUEIDENTIFIER NULL
AS
BEGIN
SET NOCOUNT ON;
- DECLARE @RecruiterApplicationId INT = (
- SELECT RecruiterApplicationId
- FROM RecruiterApplication
- WHERE ApplicationNumber = @SlateAppGuid
- AND ApplicationId IS NOT NULL
- )
-
- IF @RecruiterApplicationId IS NOT NULL
- BEGIN
- -- Find ACADEMIC row ID
- DECLARE @AcademicGuid UNIQUEIDENTIFIER = (
- SELECT [id]
- FROM [custom].AcademicKey
- WHERE RecruiterApplicationId = @RecruiterApplicationId
- )
-
- IF @AcademicGuid IS NOT NULL
- BEGIN
- -- Potentially update ACADEMIC row PDC
- UPDATE A
- SET PROGRAM = @Program
- ,DEGREE = @Degree
- ,CURRICULUM = @Curriculum
- FROM ACADEMIC A
- INNER JOIN [custom].academickey AK
- ON AK.PEOPLE_CODE_ID = A.PEOPLE_CODE_ID
- AND AK.ACADEMIC_YEAR = A.ACADEMIC_YEAR
- AND AK.ACADEMIC_SESSION = A.ACADEMIC_SESSION
- AND AK.ACADEMIC_TERM = A.ACADEMIC_TERM
- AND AK.PROGRAM = A.PROGRAM
- AND AK.DEGREE = A.DEGREE
- AND AK.CURRICULUM = A.CURRICULUM
- WHERE 1 = 1
- AND AK.ID = @AcademicGuid
- AND A.PEOPLE_CODE_ID = @PCID
- AND A.ACADEMIC_YEAR = @Year
- AND A.ACADEMIC_SESSION = @Session
- AND A.ACADEMIC_TERM = @Term
- AND (
- A.PROGRAM <> @Program
- OR A.DEGREE <> @Degree
- OR A.CURRICULUM <> @Curriculum
- )
- AND [STATUS] <> 'N'
- AND APPLICATION_FLAG = 'Y'
- AND CREDITS = 0
- AND REG_VALIDATE = 'N'
- AND PREREG_VALIDATE = 'N'
- AND ACA_PLAN_SETUP = 'N'
- END
-
- ---- Find and clear RecruiterApplicationId from [custom].AcademicKey if not matched
- --UPDATE [custom].AcademicKey
- --SET RecruiterApplicationId = NULL
- --WHERE RecruiterApplicationId = @RecruiterApplicationId
- -- AND (
- -- PEOPLE_CODE_ID <> @PCID
- -- OR ACADEMIC_YEAR <> @Year
- -- OR ACADEMIC_TERM <> @Term
- -- OR ACADEMIC_SESSION <> @Session
- -- OR PROGRAM <> @Program
- -- OR DEGREE <> @Degree
- -- OR CURRICULUM <> @Curriculum
- -- )
- -- Update AcademicKey if needed
- IF NOT EXISTS (
- SELECT *
- FROM RecruiterApplication RA
- INNER JOIN [custom].AcademicKey AK
- ON AK.RecruiterApplicationId = RA.RecruiterApplicationId
- WHERE RA.ApplicationNumber = @SlateAppGuid
+ IF @AcademicGuid IS NOT NULL
+ --If the GUID is provided, potentially update PDC and APPLICATION_FLAG
+ UPDATE A
+ SET PROGRAM = @Program
+ ,DEGREE = @Degree
+ ,CURRICULUM = @Curriculum
+ ,APPLICATION_FLAG = 'Y'
+ FROM ACADEMIC A
+ WHERE 1 = 1
+ AND A.[Guid] = @AcademicGuid
+ AND (
+ A.PROGRAM <> @Program
+ OR A.DEGREE <> @Degree
+ OR A.CURRICULUM <> @Curriculum
+ OR A.APPLICATION_FLAG <> 'Y'
)
- UPDATE AK
- SET AK.RecruiterApplicationId = RA.RecruiterApplicationId
- FROM [custom].AcademicKey AK
- INNER JOIN RecruiterApplication RA
- ON RA.ApplicationNumber = @SlateAppGuid
- WHERE PEOPLE_CODE_ID = @PCID
- AND ACADEMIC_YEAR = @Year
- AND ACADEMIC_TERM = @Term
- AND ACADEMIC_SESSION = @Session
- AND PROGRAM = @Program
- AND DEGREE = @Degree
- AND CURRICULUM = @Curriculum
- END
+ AND [STATUS] <> 'N'
+ AND CREDITS = 0
+ AND REG_VALIDATE = 'N'
+ AND PREREG_VALIDATE = 'N'
+ AND ACA_PLAN_SETUP = 'N'
+ ELSE
+ --If the GUID is not provided, update APPLICATION_FLAG based on the provided YTSPDC
+ UPDATE ACADEMIC
+ SET APPLICATION_FLAG = 'Y'
+ WHERE 1 = 1
+ AND PEOPLE_CODE_ID = @PCID
+ AND ACADEMIC_YEAR = @Year
+ AND ACADEMIC_SESSION = @Session
+ AND ACADEMIC_TERM = @Term
+ AND PROGRAM = @Program
+ AND DEGREE = @Degree
+ AND CURRICULUM = @Curriculum
+ AND [STATUS] <> 'N'
+ AND APPLICATION_FLAG <> 'Y'
END
diff --git a/config_sample.json b/config_sample.json
index 24b5331..69e4120 100644
--- a/config_sample.json
+++ b/config_sample.json
@@ -68,7 +68,8 @@
"advisor",
"fa_awards",
"fa_status",
- "sso_id"
+ "sso_id",
+ "academic_guid"
],
"url": "https://apply.school.edu/manage/service/import?cmd=load&format=xxxx",
"username": "service_user",
diff --git a/ps_core.py b/ps_core.py
index 65dbe62..a16f779 100644
--- a/ps_core.py
+++ b/ps_core.py
@@ -455,7 +455,10 @@ def main_sync(pid=None):
academic_session = app_pc["ACADEMIC_SESSION"]
# Single-row updates
- if Settings.PowerCampus.update_academic_key:
+ if (
+ Settings.PowerCampus.update_academic_key
+ and app_pc["AcademicGUID"] is not None
+ ):
ps_powercampus.update_academic_key(app_pc)
ps_powercampus.update_demographics(app_pc)
ps_powercampus.update_academic(app_pc)
@@ -546,6 +549,7 @@ def main_sync(pid=None):
campus_email,
advisor,
sso_id,
+ academic_guid,
custom_1,
custom_2,
custom_3,
@@ -566,6 +570,7 @@ def main_sync(pid=None):
"campus_email": campus_email,
"advisor": advisor,
"sso_id": sso_id,
+ "academic_guid": academic_guid,
"custom_1": custom_1,
"custom_2": custom_2,
"custom_3": custom_3,
diff --git a/ps_models.py b/ps_models.py
index c859a45..cd815ac 100644
--- a/ps_models.py
+++ b/ps_models.py
@@ -329,6 +329,12 @@
"supply_null": False,
"type": str,
},
+ "AcademicGUID": {
+ "api_verbatim": False,
+ "sql_verbatim": True,
+ "supply_null": True,
+ "type": str,
+ },
}
arrays = {
diff --git a/ps_powercampus.py b/ps_powercampus.py
index ec03732..648b7b2 100644
--- a/ps_powercampus.py
+++ b/ps_powercampus.py
@@ -389,7 +389,7 @@ def get_profile(app, campus_email_type, Messages):
"""
error_flag = True
- error_message = Messages.error.academic_row_not_found
+ error_message = None
registered = False
reg_date = None
readmit = False
@@ -398,6 +398,7 @@ def get_profile(app, campus_email_type, Messages):
campus_email = None
advisor = None
sso_id = None
+ academic_guid = None
custom_1 = None
custom_2 = None
custom_3 = None
@@ -405,7 +406,7 @@ def get_profile(app, campus_email_type, Messages):
custom_5 = None
CURSOR.execute(
- "EXEC [custom].[PS_selProfile] ?,?,?,?,?,?,?,?",
+ "EXEC [custom].[PS_selProfile] ?, ?, ?, ?, ?, ?, ?, ?, ?",
app["PEOPLE_CODE_ID"],
app["ACADEMIC_YEAR"],
app["ACADEMIC_TERM"],
@@ -414,42 +415,49 @@ def get_profile(app, campus_email_type, Messages):
app["DEGREE"],
app["CURRICULUM"],
campus_email_type,
+ app["AcademicGUID"],
)
row = CURSOR.fetchone()
- if row is not None:
- error_flag = False
-
- if row.Registered == "Y":
- registered = True
- reg_date = str(row.REG_VAL_DATE)
- credits = str(row.CREDITS)
-
- campus_email = row.CampusEmail
- advisor = row.AdvisorUsername
- sso_id = row.Username
- custom_1 = row.custom_1
- custom_2 = row.custom_2
- custom_3 = row.custom_3
- custom_4 = row.custom_4
- custom_5 = row.custom_5
-
- # College Attend and Readmits
- college_attend = row.COLLEGE_ATTEND
- if college_attend == CONFIG.readmit_code:
- readmit = True
- elif college_attend == "" or college_attend is None:
- college_attend = "blank"
-
- if college_attend not in CONFIG.valid_college_attend:
- error_flag = True
- error_message = Messages.error.invalid_college_attend.format(college_attend)
-
- if row.Withdrawn == "Y":
- withdrawn = True
-
- if not error_flag:
- error_message = None
+ if row is None:
+ # ACADEMIC row not found by YTSPDC or GUID.
+ error_message = Messages.error.academic_row_not_found
+ else:
+ if row.ErrorFlag == 1:
+ # ACADEMIC row found by GUID but YTSPDC does not match.
+ error_message = row.ErrorMessage
+ else:
+ error_flag = False
+ if row.Registered == "Y":
+ registered = True
+ reg_date = str(row.REG_VAL_DATE)
+ credits = str(row.CREDITS)
+
+ campus_email = row.CampusEmail
+ advisor = row.AdvisorUsername
+ sso_id = row.Username
+ academic_guid = row.Guid
+ custom_1 = row.custom_1
+ custom_2 = row.custom_2
+ custom_3 = row.custom_3
+ custom_4 = row.custom_4
+ custom_5 = row.custom_5
+
+ # College Attend and Readmits
+ college_attend = row.COLLEGE_ATTEND
+ if college_attend == CONFIG.readmit_code:
+ readmit = True
+ elif college_attend == "" or college_attend is None:
+ college_attend = "blank"
+
+ if college_attend not in CONFIG.valid_college_attend:
+ error_flag = True
+ error_message = Messages.error.invalid_college_attend.format(
+ college_attend
+ )
+
+ if row.Withdrawn == "Y":
+ withdrawn = True
return (
error_flag,
@@ -462,6 +470,7 @@ def get_profile(app, campus_email_type, Messages):
campus_email,
advisor,
sso_id,
+ academic_guid,
custom_1,
custom_2,
custom_3,
@@ -534,7 +543,7 @@ def update_academic_key(app):
P/C/D will only be updated if application is not registered and does not have an academic plan assigned.
"""
CURSOR.execute(
- "exec [custom].[PS_updAcademicKey] ?, ?, ?, ?, ?, ?, ?, ?",
+ "exec [custom].[PS_updAcademicKey] ?, ?, ?, ?, ?, ?, ?, ?, ?",
app["PEOPLE_CODE_ID"],
app["ACADEMIC_YEAR"],
app["ACADEMIC_TERM"],
@@ -543,6 +552,7 @@ def update_academic_key(app):
app["DEGREE"],
app["CURRICULUM"],
app["aid"],
+ app["AcademicGUID"],
)
CNXN.commit()
From de1e232224e919454ad9b52b5aeb086bf10ddf34 Mon Sep 17 00:00:00 2001
From: WyattBest <32881391+WyattBest@users.noreply.github.com>
Date: Thu, 4 Apr 2024 11:28:40 -0600
Subject: [PATCH 08/30] Bugfix rollup
---
ps_core.py | 22 +++++----------
ps_format.py | 44 ++++++++++++++++++-----------
ps_powercampus.py | 15 ++++------
sync_ondemand.py | 4 +--
~$werSlate Integration Fields.docx | Bin 0 -> 162 bytes
5 files changed, 43 insertions(+), 42 deletions(-)
create mode 100644 ~$werSlate Integration Fields.docx
diff --git a/ps_core.py b/ps_core.py
index a16f779..50d7c86 100644
--- a/ps_core.py
+++ b/ps_core.py
@@ -352,19 +352,11 @@ def main_sync(pid=None):
vd = Settings.PowerCampus.autoconfigure_mappings.validate_degreq
mdy = Settings.PowerCampus.autoconfigure_mappings.minimum_degreq_year
afsi = Settings.PowerCampus.api.app_form_setting_id
- # Accept either two or three fields for 9.2.3
- if {k for k in apps if "Degree" in apps[k]}:
- program_list = [
- (apps[app]["Program"], apps[app]["Degree"], apps[app]["Curriculum"])
- for app in apps
- if "Curriculum" in apps[app]
- ]
- else:
- program_list = [
- (apps[app]["Program"], apps[app]["Degree"])
- for app in apps
- if "Degree" in apps[app]
- ]
+ program_list = [
+ (apps[app]["Program"], apps[app]["Degree"])
+ for app in apps
+ if "Degree" in apps[app]
+ ]
yt_list = [apps[app]["YearTerm"] for app in apps if "YearTerm" in apps[app]]
if ps_powercampus.autoconfigure_mappings(
@@ -425,8 +417,8 @@ def main_sync(pid=None):
)
apps[k]["PEOPLE_CODE_ID"] = pcid
- verbose_print("Get scheduled actions from Slate")
if CONFIG["scheduled_actions"]["enabled"] == True:
+ verbose_print("Get scheduled actions from Slate")
CURRENT_RECORD = None
# Send list of app GUID's to Slate; get back checklist items
actions_list = slate_get_actions(
@@ -443,7 +435,7 @@ def main_sync(pid=None):
verbose_print("Update existing applications in PowerCampus and extract information")
edu_sync_results = []
for k, v in apps.items():
- if v["error_flag"] == False:
+ if v["error_flag"] == True:
continue
CURRENT_RECORD = k
if v["status_calc"] == "Active":
diff --git a/ps_format.py b/ps_format.py
index 15a95ea..4fdf85b 100644
--- a/ps_format.py
+++ b/ps_format.py
@@ -162,7 +162,9 @@ def format_app_generic(app, cfg_fields, Messages):
fields_int.extend(["compare_" + field for field in cfg_fields["fields_int"]])
# Copy nullable strings from input to output, then fill in nulls
- mapped.update({k: v for (k, v) in app.items() if k in fields_null})
+ mapped.update(
+ {k: v for (k, v) in app.items() if k in fields_null and k not in mapped}
+ )
mapped.update({k: None for k in fields_null if k not in app})
# Convert integers and booleans
@@ -177,6 +179,18 @@ def format_app_generic(app, cfg_fields, Messages):
else:
mapped["GovernmentDateOfEntry"] = app["GovernmentDateOfEntry"]
+ # Academic program
+ # API 9.2.3 still requires two fields for Program and Degree, even though the Swagger schema contains three fields.
+ # Done here instead of in format_app_api() because format_app_sql() also needs these fields standardized.
+ if "Curriculum" in app:
+ mapped["Program"] = app["Program"]
+ mapped["Degree"] = app["Degree"] + "/" + app["Curriculum"]
+ mapped["Curriculum"] = None
+ else:
+ mapped["Program"] = app["Program"]
+ mapped["Degree"] = app["Degree"]
+ mapped["Curriculum"] = None
+
# Pass through all other fields
mapped.update({k: v for (k, v) in app.items() if k not in mapped})
@@ -289,20 +303,13 @@ def format_app_api(app, cfg_defaults, Messages):
mapped["Veteran"] = app["Veteran"]
mapped["VeteranStatus"] = True
- # Academic program
- # API 9.2.3 still requires two fields for Program and Degree, even though the Swagger schema contains three fields.
- if "Curriculum" in app:
- mapped["Programs"] = [
- {
- "Program": app["Program"],
- "Degree": app["Degree"] + "/" + app["Curriculum"],
- "Curriculum": None,
- }
- ]
- else:
- mapped["Programs"] = [
- {"Program": app["Program"], "Degree": app["Degree"], "Curriculum": None}
- ]
+ mapped["Programs"] = [
+ {
+ "Program": app["Program"],
+ "Degree": app["Degree"],
+ "Curriculum": None,
+ }
+ ]
# GUID's
mapped["ApplicationNumber"] = app["aid"]
@@ -350,7 +357,7 @@ def format_app_sql(app, mapping, config):
mapped["ACADEMIC_SESSION"] = mapping["AcademicTerm"]["PCSessionCodeValue"][
app["YearTerm"]
]
- # Todo: Fix inconsistency of 1-field vs 2-field mappings
+
mapped["PROGRAM"] = mapping["AcademicLevel"][app["Program"]]
mapped["DEGREE"] = mapping["AcademicProgram"]["PCDegreeCodeValue"][app["Degree"]]
mapped["CURRICULUM"] = mapping["AcademicProgram"]["PCCurriculumCodeValue"][
@@ -406,6 +413,11 @@ def format_app_sql(app, mapping, config):
else:
mapped["OrganizationId"] = None
+ if app["Veteran"] is not None:
+ mapped["VETERAN"] = mapping["Veteran"][app["Veteran"]]
+ else:
+ mapped["VETERAN"] = None
+
# Format Education and TestScoresNumeric if present. Newer arrays are implemented as classes.
# Currently only supplies nulls; no datatype manipulations performed.
array_models = ps_models.get_arrays()
diff --git a/ps_powercampus.py b/ps_powercampus.py
index 648b7b2..3f7ddc5 100644
--- a/ps_powercampus.py
+++ b/ps_powercampus.py
@@ -62,7 +62,7 @@ def autoconfigure_mappings(
and that YearTerm values are like YEAR/TERM/SESSION.
Keyword aguments:
- program_list -- list of tuples like [('PROGRAM','DEGREE/CURRICULUM'), (...)] or [('PROGRAM','DEGREE','CURRICULUM'), (...)]
+ program_list -- list of tuples like [('PROGRAM','DEGREE/CURRICULUM'), (...)]
yt_list -- list of strings like ['YEAR/TERM/SESSION', ...]
validate_degreq -- bool. If True, check against DEGREQ for sanity using minimum_degreq_year.
minimum_degreq_year -- str
@@ -77,14 +77,11 @@ def autoconfigure_mappings(
# Create set of tuples like {('PROGRAM','DEGREE', 'CURRICULUM'), (...)}
pdc_set = set()
- if len(program_list[0]) == 2:
- for dp in program_set:
- pdc = [dp[0]]
- for dc in dp[1].split("/"):
- pdc.append(dc)
- pdc_set.add(tuple(pdc))
- elif len(program_list[0]) == 3:
- pdc_set = program_set
+ for dp in program_set:
+ pdc = [dp[0]]
+ for dc in dp[1].split("/"):
+ pdc.append(dc)
+ pdc_set.add(tuple(pdc))
# Create a set like {'PROGRAM', 'PROGRAM'}
p_set = set()
diff --git a/sync_ondemand.py b/sync_ondemand.py
index 91b279d..ce1ced8 100644
--- a/sync_ondemand.py
+++ b/sync_ondemand.py
@@ -85,10 +85,10 @@
msg = MIMEText(body)
msg["To"] = email_config["to"]
- msg["From"] = email_config["from"]
+ msg["From"] = email_config["smtp"]["from"]
msg["Subject"] = email_config["subject"]
- with smtplib.SMTP(email_config["server"]) as smtp:
+ with smtplib.SMTP(email_config["smtp"]["server"]) as smtp:
smtp.starttls()
smtp.login(
email_config["smtp"]["username"], email_config["smtp"]["password"]
diff --git a/~$werSlate Integration Fields.docx b/~$werSlate Integration Fields.docx
new file mode 100644
index 0000000000000000000000000000000000000000..abc521e7cf04341d932bae95fae7a548caec3d20
GIT binary patch
literal 162
zcmd-IuS_f{@ySn4%wZrNa5024R5BzolmMX*Lq0{7ngIZFKp9s6
literal 0
HcmV?d00001
From 1cd2ce5214b22e00553bfcfd3eb2127047e0efb6 Mon Sep 17 00:00:00 2001
From: WyattBest <32881391+WyattBest@users.noreply.github.com>
Date: Tue, 9 Apr 2024 15:50:15 -0600
Subject: [PATCH 09/30] Bugfixes, documentation, new tool
-Fix Comments and County bugs
-Update fields doc
-New tool to select Religion mapping XML
---
PowerSlate Integration Fields.docx | Bin 35865 -> 36264 bytes
Tools/Mapper Generate Religion XML.sql | 9 +++++++++
ps_format.py | 8 +++++---
~$werSlate Integration Fields.docx | Bin 162 -> 0 bytes
4 files changed, 14 insertions(+), 3 deletions(-)
create mode 100644 Tools/Mapper Generate Religion XML.sql
delete mode 100644 ~$werSlate Integration Fields.docx
diff --git a/PowerSlate Integration Fields.docx b/PowerSlate Integration Fields.docx
index 97c5dcc3a0569f85301bc1ac150a1bdd3d76a7a9..07c6f4216513a03dffed204995b45526e3ee560a 100644
GIT binary patch
delta 29067
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
delta 28727
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