Blackbaud RENXT Gifts connector updates (#3924)

Author: michael-tims

certified-connectors/Blackbaud RENXT Gifts/apiProperties.json

@@ -28,7 +28,8 @@
     },
     "iconBrandColor": "#0CD973",
     "scriptOperations": [
-      "ListGiftCustomFields"
+      "ListGiftCustomFields",
+      "CreatePledgePayment"
     ],
     "capabilities": [],
     "policyTemplateInstances": [
@@ -51,7 +52,10 @@
           "x-ms-apimTemplateParameter.propertyValuePathTemplate": "[{@body().payments}]",
           "x-ms-apimTemplate-policySection": "Request",
           "x-ms-apimTemplate-operationName": [
-            "CreateGift"
+            "CreateGift",
+            "CreatePledge",
+            "CreatePledgePayment",
+            "CreateStock"
           ]
         }
       },
@@ -64,7 +68,25 @@
           "x-ms-apimTemplateParameter.propertyValuePathTemplate": "[{@body().receipts}]",
           "x-ms-apimTemplate-policySection": "Request",
           "x-ms-apimTemplate-operationName": [
-            "CreateGift"
+            "CreateGift",
+            "CreatePledge",
+            "CreatePledgePayment",
+            "CreateStock"
+          ]
+        }
+      },
+      {
+        "templateId": "setproperty",
+        "title": "Set gift acknowledgements",
+        "parameters": {
+          "x-ms-apimTemplateParameter.newPropertyParentPathTemplate": "@body()",
+          "x-ms-apimTemplateParameter.newPropertySubPathTemplate": "acknowledgements",
+          "x-ms-apimTemplateParameter.propertyValuePathTemplate": "[{@body().acknowledgements}]",
+          "x-ms-apimTemplate-policySection": "Request",
+          "x-ms-apimTemplate-operationName": [
+            "CreatePledge",
+            "CreatePledgePayment",
+            "CreateStock"
           ]
         }
       },
@@ -117,6 +139,19 @@
             "AddGiftToBatch"
           ]
         }
+      },
+      {
+        "templateId": "routerequesttoendpoint",
+        "title": "Add pledge, payment, stock routing",
+        "parameters": {
+          "x-ms-apimTemplateParameter.newPath": "/gft-gifts/v2/gifts",
+          "x-ms-apimTemplateParameter.httpMethod": "@Request.OriginalHTTPMethod",
+          "x-ms-apimTemplate-operationName": [
+            "CreatePledge",
+            "CreatePledgePayment",
+            "CreateStock"
+          ]
+        }
       }
     ],
     "publisher": "Blackbaud, Inc.",

certified-connectors/Blackbaud RENXT Gifts/script.csx

@@ -4,6 +4,9 @@ public class Script : ScriptBase
     {
         switch (this.Context.OperationId)
         {
+            case "CreatePledgePayment": 
+                return await this.HandleCreatePledgePaymentOperation().ConfigureAwait(false);
+
             case "ListGiftCustomFields":
                 return await this.HandleListCustomFieldOperation().ConfigureAwait(false);
         }
@@ -13,6 +16,35 @@ public class Script : ScriptBase
         return response;
     }
 
+    private async Task<HttpResponseMessage> HandleCreatePledgePaymentOperation()
+    {
+        // transform the installment_payments property to the applied_payments shape
+
+        // first, get the object from the request
+        var requestContent = await this.Context.Request.Content.ReadAsStringAsync().ConfigureAwait(false);
+        var requestJson = JObject.Parse(requestContent);
+        
+        var installmentPayments = (JArray)requestJson["installment_payments"];
+
+        requestJson.Add("apply_payments", new JArray(installmentPayments.GroupBy(item => item["pledge_id"]).Select(group => new JObject() {
+            ["parent_id"] = group.Key,
+            ["installments"] = new JArray(group.Select(item => new JObject() {
+                ["installment_id"] = item["installment_id"],
+                ["amount_applied"] = item["amount_applied"]
+            }))
+        })));
+
+        // remove properties not used by the backend (should be ignored, but let's not risk it)
+        requestJson.Remove("installment_payments");
+
+        var newBody = requestJson;
+
+        // send the request to the backend and return the response
+        this.Context.Request.Content = CreateJsonContent(newBody.ToString());
+        var response = await this.Context.SendAsync(this.Context.Request, this.CancellationToken).ConfigureAwait(continueOnCapturedContext: false);
+        return response;
+    }
+
     private async Task<HttpResponseMessage> HandleListCustomFieldOperation()
     {
         // make the API request to the SKY API backend