{"schema":"debriefmd.connector-requirements","version":1,"platform":"risr-advance","tenant":"","evidence":[],"requirements":[{"id":"tenant","title":"Tenant and owner","detail":"Exact tenant URL, institution, program scope, platform/version, named technical owner and sandbox."},{"id":"authorization","title":"Authorized access","detail":"Supported scoped grant or service account, secret-store reference, rotation/revocation and denied cross-program tests. Never collect an institutional password."},{"id":"workflow","title":"Supported destination workflow","detail":"Vendor/admin confirmation of the exact write operation or completed-assessment importer, template/schema, size limits and sandbox example. Roster, schedule or grade imports are different workflows."},{"id":"identity","title":"Identity and authorship","detail":"Stable resident, assessor, program and academic-year mappings. Record DebriefMD as drafter and retain the real completing actor; never impersonate a preceptor."},{"id":"mapping","title":"Versioned field mapping","detail":"Frozen source form ID/definition hash and destination form/version/question IDs. Map every field and rating option explicitly; record unmapped items and preserve attribution, blanks and multi-note structure."},{"id":"approval","title":"Exact reviewed revision","detail":"Bind resident release to the submitted content hash. Changes invalidate approval. Confirm any destination-required assessor approval separately."},{"id":"privacy","title":"Data and residency approval","detail":"Approved destination/processing locations, minimum payload, retention/deletion and institutional agreement. No audio, transcript, self-reflection or model evidence in the handoff."},{"id":"delivery","title":"Delivery and reconciliation","detail":"Idempotency key, timeouts/rate limits, retry policy, destination record ID and read-back receipt. A download or HTTP 200 alone is not official filing."},{"id":"corrections","title":"Corrections and rollback","detail":"Define draft/final states, locked-record amendments, duplicate handling, revocation and reconciliation; do not assume a submitted evaluation can be edited or deleted."},{"id":"acceptance","title":"Tenant acceptance evidence","detail":"Synthetic end-to-end filing approved by program/admin: exact fields, authorship, receipt, denied foreign access, duplicate retry and correction. Record versions and dated evidence."}],"research":{"id":"risr-advance","name":"risr/advance","api":"The vendor documents a configured risr/assess-to-advance results integration with event types and mapped candidate identities. This is not evidence of open DebriefMD write access.","fileImport":"Event types define fields and completion workflows. Obtain a supported third-party event/evidence import contract and attachment limits for the target tenant.","nextStep":"Request the event creation API or import schema, completing actor rules, candidate identity, correction semantics and a tenant sandbox. Do not reuse exam-result endpoints for workplace notes without approval.","sources":[{"label":"Vendor results integration and event types","url":"https://risr-assess.zendesk.com/hc/en-gb/articles/28509718785425-risr-assess-to-advance-result-integration"}]},"researchedOn":"2026-10-22","notice":"Discovery checklist only. Contains no credentials or assessment data. Completeness does not enable a connector or certify vendor compatibility."}