Skip to content

JNY-PFM-INT-002Move dependent work before retiring an integration

Markdown

JNY-PFM-INT-002

Move dependent work before retiring an integration

Markdown
  • DocumentDraft
  • Product intentConfirmed
  • ImplementationObserved

KindJourneyProduct areaPlatformModuleIntegration access, customer extensions and shared workflow configurationRevision1End-to-endRequired

Read atservices-platform ad3f6a65react-console baf6dae3

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Goal
Replace a retiring account in its bindings, disconnect the accounts and remove their installation.
Screens
/console/{tenantId}/configuration/platform/integrations/{integrationKey}/connections/{connectionId}/console/{tenantId}/configuration/platform/integrations/{integrationKey}/console/{tenantId}/configuration/platform/integrations/bindings
Intent sources
services-platform:docs/milestones/INTG-M1-find-install-connect.md#D7services-platform:docs/milestones/INTG-M1-find-install-connect.md#D9services-platform:docs/milestones/INTG-M1-find-install-connect.md#D11services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.md#M2-D9

Steps

#SurfaceActionCapabilityExpectedProvenance
1/console/{tenantId}/configuration/platform/integrations/{integrationKey}/connections/{connectionId}Pause an account with an explanation, then resume it.CAP-PFM-INT-004The state moves through suspended to active, and the history records both operators and explanations.test
2/console/{tenantId}/configuration/platform/integrations/{integrationKey}/connections/{connectionId}Request account disconnection.CAP-PFM-INT-004The refusal identifies the bindings that still select this account and offers replacement.test
3/console/{tenantId}/configuration/platform/integrations/{integrationKey}/connections/{connectionId}Select another account for those bindings and confirm the move.CAP-PFM-INT-007The bindings select the replacement, with the change retained in each history.test
4/console/{tenantId}/configuration/platform/integrations/{integrationKey}/connections/{connectionId}Request and confirm disconnection after the move.CAP-PFM-INT-004The account becomes disconnected, its credential is revoked and its endpoints close.test
5/console/{tenantId}/configuration/platform/integrations/{integrationKey}Disconnect the other accounts and remove the installation.CAP-PFM-INT-003Removal identifies any remaining connected account and succeeds once all accounts are disconnected.test

Alternate and Failure Paths

PathFrom stepConditionPath takenOutcomeProvenance
alternate5An account setup remains incompleteDiscard the unfinished connection rather than disconnecting itInstallation removal can proceedtest
failure2A read-only colleague requests disconnection through the serviceDeny the request before inspecting dependent bindingsPreserve every recordtest
services-platform:modules/integrations/tests/e2e/disconnect-and-uninstall.e2e.spec.js#refuses a reader the disconnection (403) before it looks at the bindings

Assertions

IdStatementProvenance
01Current bindings prevent disconnection and appear in its refusal.test
02Moving every active binding off the source account permits its disconnection.test
services-platform:modules/integrations/tests/integration/services/bindings/binding-move.integration.spec.js#leaves the source with no active binding, so its disconnection is no longer refused
03Any account that remains connected prevents installation removal.test

End-to-end policy: required: Browser acceptance must exercise binding refusal, replacement confirmation and final retirement as one administrator sequence.

The Markdown files under specs/ in rhythmsoftware/rhythm-v2-docs are the canonical source of truth. This reader is a generated, read-only projection of them.