Skip to content

Commit 2e4ffe8

Browse files
mymattcarrollmymattcarroll
authored
OneBlink & CivicPlus v1.11 (#4052)
AP-6057 # Custom PDF operation
1 parent ea7f7f6 commit 2e4ffe8

File tree

2 files changed

+393
-15
lines changed

2 files changed

+393
-15
lines changed

‎certified-connectors/CivicPlus/apiDefinition.swagger.json‎

Lines changed: 196 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"swagger": "2.0",
33
"info": {
4-
"version": "1.10",
4+
"version": "1.11",
55
"title": "CivicPlus Transform",
66
"description": "Empowers business users to create and deploy digital forms for enterprise and government organizations as web and native apps, while allowing developers to customize, extend, or harness the forms through their own custom apps. Connect your forms with this connector to allow easy submission of your form data into your backend systems or databases without the need to write complex integration code.",
77
"contact": {
@@ -391,15 +391,85 @@
391391
}
392392
}
393393
},
394+
"/forms/{formId}": {
395+
"get": {
396+
"description": "Allow for a Form to be retrieved",
397+
"summary": "Retrieve Form",
398+
"operationId": "GetForm",
399+
"x-ms-visibility": "internal",
400+
"produces": ["application/json"],
401+
"parameters": [
402+
{
403+
"in": "path",
404+
"name": "formId",
405+
"type": "integer",
406+
"required": true,
407+
"x-ms-visibility": "important"
408+
}
409+
],
410+
"responses": {
411+
"200": {
412+
"description": "OK",
413+
"schema": {
414+
"type": "object",
415+
"properties": {
416+
"id": {
417+
"type": "number"
418+
},
419+
"name": {
420+
"type": "string"
421+
},
422+
"customPDFs": {
423+
"type": "array",
424+
"items": {
425+
"type": "object",
426+
"properties": {
427+
"id": {
428+
"type": "string"
429+
},
430+
"label": {
431+
"type": "string"
432+
}
433+
}
434+
}
435+
}
436+
}
437+
}
438+
},
439+
"401": {
440+
"description": "Unauthenticated",
441+
"schema": {
442+
"$ref": "#/definitions/APIErrorPayload"
443+
}
444+
},
445+
"403": {
446+
"description": "Forbidden",
447+
"schema": {
448+
"$ref": "#/definitions/APIErrorPayload"
449+
}
450+
},
451+
"404": {
452+
"description": "Not Found",
453+
"schema": {
454+
"$ref": "#/definitions/APIErrorPayload"
455+
}
456+
},
457+
"500": {
458+
"description": "Internal Server Error",
459+
"schema": {
460+
"$ref": "#/definitions/APIErrorPayload"
461+
}
462+
}
463+
}
464+
}
465+
},
394466
"/forms/{formId}/approval-steps": {
395467
"get": {
396468
"description": "Allows for Form approval steps to be retrieved",
397469
"summary": "Retrieve Form Approval Steps",
398470
"operationId": "GetFormApprovalSteps",
399471
"x-ms-visibility": "internal",
400-
"produces": [
401-
"application/json"
402-
],
472+
"produces": ["application/json"],
403473
"parameters": [
404474
{
405475
"in": "path",
@@ -470,9 +540,7 @@
470540
"summary": "Retrieve Approval Record",
471541
"operationId": "GetFormSubmissionApprovalByStepLabel",
472542
"x-ms-visibility": "important",
473-
"produces": [
474-
"application/json"
475-
],
543+
"produces": ["application/json"],
476544
"parameters": [
477545
{
478546
"in": "path",
@@ -616,6 +684,11 @@
616684
"x-ms-summary": "Include submission identifier in PDF",
617685
"description": "The submission identifier can be included at the bottom of each page in the PDF"
618686
},
687+
"includeExternalIdInPdf": {
688+
"type": "boolean",
689+
"x-ms-summary": "Include external identifier in PDF",
690+
"description": "The external identifier can be included at the bottom of each page in the PDF"
691+
},
619692
"includePaymentInPdf": {
620693
"type": "boolean",
621694
"x-ms-summary": "Include payment details in PDF",
@@ -626,6 +699,17 @@
626699
"x-ms-summary": "Page break on form pages",
627700
"description": "Form pages can be translated to page breaks in the PDF"
628701
},
702+
"excludedCSSClasses": {
703+
"type": "array",
704+
"x-ms-summary": "Excluded form elements via CSS classes",
705+
"description": "The CSS classes assigned to the form elements to exclude from the PDF",
706+
"x-ms-visibility": "advanced",
707+
"items": {
708+
"type": "string",
709+
"description": "The CSS class assigned to the form elements to exclude from the PDF",
710+
"x-ms-summary": "CSS class"
711+
}
712+
},
629713
"excludedElementIds": {
630714
"type": "array",
631715
"x-ms-summary": "Excluded form elements",
@@ -707,6 +791,111 @@
707791
}
708792
}
709793
},
794+
"/forms/{formId}/submissions/{submissionId}/custom-pdf-document": {
795+
"post": {
796+
"description": "Allows for a custom PDF to be generated",
797+
"summary": "Generate Custom PDF",
798+
"operationId": "GenerateCustomPDF",
799+
"x-ms-visibility": "important",
800+
"produces": ["application/pdf"],
801+
"parameters": [
802+
{
803+
"name": "formId",
804+
"in": "path",
805+
"description": "Form containing the custom PDF",
806+
"required": true,
807+
"type": "integer",
808+
"x-ms-summary": "Form",
809+
"x-ms-visibility": "important",
810+
"x-ms-dynamic-values": {
811+
"operationId": "GetForms",
812+
"value-path": "id",
813+
"value-collection": "forms",
814+
"value-title": "name"
815+
}
816+
},
817+
{
818+
"name": "submissionId",
819+
"in": "path",
820+
"description": "ID of the form submission",
821+
"required": true,
822+
"type": "string",
823+
"x-ms-summary": "Submission Id",
824+
"x-ms-visibility": "important"
825+
},
826+
{
827+
"name": "Request Body",
828+
"in": "body",
829+
"description": "This is the request body",
830+
"schema": {
831+
"type": "object",
832+
"properties": {
833+
"customPdfId": {
834+
"type": "string",
835+
"x-ms-summary": "Custom PDF",
836+
"x-ms-visibility": "important",
837+
"description": "The custom PDF to generate",
838+
"x-ms-dynamic-values": {
839+
"operationId": "GetForm",
840+
"value-path": "id",
841+
"value-collection": "customPDFs",
842+
"value-title": "label",
843+
"parameters": {
844+
"formId": {
845+
"parameter": "formId"
846+
}
847+
}
848+
}
849+
},
850+
"isCustomPdfEditable": {
851+
"type": "boolean",
852+
"x-ms-summary": "Allow editing PDF",
853+
"x-ms-visibility": "important",
854+
"description": "Allow resulting filled fields on PDF to be edited",
855+
"default": false
856+
}
857+
},
858+
"required": ["customPdfId", "isCustomPdfEditable"]
859+
}
860+
}
861+
],
862+
"responses": {
863+
"201": {
864+
"description": "Created",
865+
"schema": {
866+
"type": "string",
867+
"format": "binary",
868+
"description": "Output file content from the PDF Service",
869+
"x-ms-summary": "Form Submission PDF Content"
870+
}
871+
},
872+
"401": {
873+
"description": "Unauthenticated",
874+
"schema": {
875+
"$ref": "#/definitions/APIErrorPayload"
876+
}
877+
},
878+
"403": {
879+
"description": "Forbidden",
880+
"schema": {
881+
"$ref": "#/definitions/APIErrorPayload"
882+
}
883+
},
884+
"404": {
885+
"description": "Not Found",
886+
"schema": {
887+
"$ref": "#/definitions/APIErrorPayload"
888+
}
889+
},
890+
"500": {
891+
"description": "Internal Server Error",
892+
"schema": {
893+
"$ref": "#/definitions/APIErrorPayload"
894+
}
895+
}
896+
}
897+
}
898+
},
710899
"/form-submission-meta/{submissionId}/payments/cp-pay": {
711900
"get": {
712901
"description": "Allows for a CivicPlus Pay Payment to be retrieved",

0 commit comments

Comments
 (0)