Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Decision Proposal 134 - Banking Maintenance Iteration 4 #134

Closed
CDR-API-Stream opened this issue Jul 6, 2020 · 9 comments
Closed

Decision Proposal 134 - Banking Maintenance Iteration 4 #134

CDR-API-Stream opened this issue Jul 6, 2020 · 9 comments
Labels
Category: API A proposal for a decision to be made for the API Standards made Industry: Banking This proposal impacts the banking industry Status: Decision Made A determination on this decision has been made

Comments

@CDR-API-Stream
Copy link
Contributor

CDR-API-Stream commented Jul 6, 2020

This decision captures the outcome of Banking Maintenance Iteration 4. The approved decision record constituting the changes to be made are available here: Decision 134 - Banking Maintenance Iteration 4.pdf

Consultation considered change requests in the standards maintenance repository.

NOTE: On the 24th September the Chair approved an amendment to this decision. The decision to make a change in response to maintenance issue 152 - related to the inclusion of a crnType field - was reversed. This change should be considered to not be included in decision 134. This reversion is now published in version 1.5.1 of the standards. Further consultation on issue 152 will be included in maintenance iteration 5.


Initial consultation will be sought on the scope of the banking maintenance iteration and the prioritisation of change requests.

Schedule

Phase 1: Backlog Grooming - 9th July 2020 commencement. 2 weeks duration
Phase 2: Consultation - 22nd July 2020 commencement. 4 weeks duration
Phase 3: Approval - 19th August 2020 commencement. 1 week duration
Phase 4: Documentation - 26th August 2020 commencement. 1 week duration


Meeting series

Note: To receive calendar invites for this series please email your request via our mailbox. To receive notifications of this meeting series and more subscribe to the DSB mailing list for regular updates.

The teleconferences to support the iteration have been scheduled as follows:

  • Call to discuss Maintenance Iteration # 4 Kick-off and backlog review | 9th July 2020 @2pm for 1 hour
  • Call to discuss Maintenance Iteration # 4 Consultation | 22nd July 2020 @2pm for 1 hour
  • Call to discuss Maintenance Iteration # 4 Proposal Checkpoint | 5th August 2020 @2pm for 1 hour
  • Call to discuss Maintenance Iteration # 4 Approvals and Documentation | 19th August 2020 @2pm for 1 hour

Dial in details

@CDR-API-Stream CDR-API-Stream added Category: API A proposal for a decision to be made for the API Standards made Status: Open For Feedback Feedback has been requested for the decision Industry: Banking This proposal impacts the banking industry labels Jul 6, 2020
@CDR-API-Stream CDR-API-Stream changed the title Decision Proposal <Number> - Banking Maintenance Iteration 4 Decision Proposal 134 - Banking Maintenance Iteration 4 Jul 6, 2020
@CDR-API-Stream
Copy link
Contributor Author

The meeting agenda and dial in details for the kickoff and backlog grooming call scheduled for The 9th July @ 2pm AEST have been added to the Wiki.

@CDR-API-Stream
Copy link
Contributor Author

CDR-API-Stream commented Jul 9, 2020

The kickoff and backlog grooming call was held today, Thu 09/07/2020. The change request candidates discussed in the call to be considered this iteration can be found here: https://github.com/ConsumerDataStandardsAustralia/standards-maintenance/projects/3.

Consultation on change request prioritisation will remain open until 22/07/2020.

@commbankoss
Copy link

Commonwealth Bank requests issue 248 "Clarification on Get Product Detail V2 details missing" be included as a candidate for Maintenance Iteration 4.

@CDR-API-Stream
Copy link
Contributor Author

Commonwealth Bank requests issue 248 "Clarification on Get Product Detail V2 details missing" be included as a candidate for Maintenance Iteration 4.

Thanks @commbankoss this has been included in the maintenance iteration's backlog for review.

@CDR-API-Stream
Copy link
Contributor Author

CDR-API-Stream commented Jul 22, 2020

The second call for maintenance iteration 4 was held 22/07/2020. The final scope adopted for the iteration can be found here:
https://github.com/ConsumerDataStandardsAustralia/standards-maintenance/projects/3

Agenda and minutes for the maintenance call are available here: https://github.com/ConsumerDataStandardsAustralia/standards/wiki/DSB-Maintenance-Iteration-4:-Finalisation-of-Iteration-Scope:-Agenda-&-Meeting-Notes-(22nd-July-2020)

@CDR-API-Stream
Copy link
Contributor Author

Agenda for the next maintenance iteration call is available here: 2020-08-05 DSB Maintenance Iteration 4 Agenda

@CDR-API-Stream CDR-API-Stream moved this from Backlog to In Review in Consumer Data Standards v1.5.0 Aug 4, 2020
@CDR-API-Stream
Copy link
Contributor Author

Meeting notes for 5/8/2020 maintenance iteration call are available here: DSB Maintenance Iteration 4: Iteration checkpoint Agenda & Meeting Notes

@CDR-API-Stream
Copy link
Contributor Author

Agenda for the final call for this maintenance iteration is available here: DSB Maintenance Iteration 4: Final iteration review: Agenda & Meeting Notes.

@CDR-API-Stream
Copy link
Contributor Author

The Data Standards Chair approved Decision 134 constituting the changes to be made. The decision records is available here: Decision 134 - Banking Maintenance Iteration 4.pdf

These changes will be included in the next release of the Consumer Data Standards (v1.5.0).

@CDR-API-Stream CDR-API-Stream added Status: Decision Made A determination on this decision has been made and removed Status: Open For Feedback Feedback has been requested for the decision labels Sep 1, 2020
@markverstege markverstege moved this from In Review to Accepted Changes in Consumer Data Standards v1.5.0 Sep 14, 2020
@ConsumerDataStandardsAustralia ConsumerDataStandardsAustralia locked and limited conversation to collaborators Sep 30, 2020
@CDR-API-Stream CDR-API-Stream moved this from Accepted Changes to Done in Consumer Data Standards v1.5.0 Nov 11, 2020
JamesMBligh added a commit that referenced this issue Mar 22, 2022
CDR-API-Stream added a commit that referenced this issue Mar 22, 2022
* Standards Staging Issue #115: Update text description of bulk balance for energy in endpoint version schedule

* Cleared out the diff comments presented on the Version Delta tab

* Added an empty release 1.16.0 release notes page

* Incremented version numbers for swagger files to 1.16.0

* Added archive link to 1.15.0

* Reverted back to standard (non-festive) logo

* Incremented version number in introduction

* Added normative reference link to RFC9126

* Added link to 1.16.0 release notes

* Corrected link for RFC2119

* Clarified requirements for Data Recipient Software Products S256 code challenge method by removing the redundant \'if supported\' text

* Standards Staging Issue #116 Change type of page and page-size in Energy APIs to PositiveInteger

* Updates for DP166

* Updates for DP166

* Removed duplicate section: Data Holders calling Data Recipients

* Corrected GetProducts response reference from ResponseBankingProductList to ResponseBankingProductListV2

* Removed the unintended additional formatting from the cds_banking.json to make diffs easier

* Corrected Register Discovery Document definition defect renaming request_object_signing_alg_values_supported to token_endpoint_auth_signing_alg_values_supported

* Corrected GetDataHolderBrands RegisterDataHolderAuth and jwksEndpoint schema definitions to clarify their usage in DH to ADR client authentication

* Standards Staging Issue #115: Updated release notes for this change

* fixed typos and ordering

* Removed tables

* Rechanged ordering

* Build and final checks

* Convert swagger to OAS
Remove 4xx error codes

* Rebuild

* Fix json typos
Update error codes for energy OAS

* Rebuild

* Added tooltip support for RFCs and normative/informative references. Also fixed invalid or missing RFC links

* Fixed markdown issue with normative references table

* Converted more normative reference links to dynamic tooltips

* Updated FAPI informative reference

* - Formatting improvements. - Added additional tooltip references

* - Moved normative references out of the Security section into the Introduction. - Added additional tooltip references

* Updated code generation for normative and informative references

* Added link to the endpoint versioning schedule to the high level standards

* Added 1.16.1 release notes

* Added release notes for Standards Staging issue 130

* Added release notes for Standards Staging issue 132

* Updated RFC4122 links in Banking and Common schemas to include tooltips

* poc secondary-dataholder-apis: Added changes to include Energy Secondary Data Holder OAS in standards

* Fix for staging 139

* fix #138

* Fix for #137

* Fix #136

* Fix #135

* Fix #134

* Initial build for review

* Update version number everywhere

* Add archive entry for 1.16.0
Clean up diff statements
Update release notes

* Fixes to SR swagger

* Update Swagger to OAS in markdown

* Updated Energy SDH swagger file to lastest version with fixes applied for error codes and attribute types

* Remove known issues that are resolved
Full rebuild

* Version bumps to address GitHub security notices

* Updated additional informative references to include tooltips

* Fix SDH security

* Fix for controlledLoad flag in energy
Rebuild

* Minor release notes and diff fixes

Co-authored-by: Hemang Rathod <hemang.rathod@consumerdatastandards.gov.au>
Co-authored-by: Ivan Hosgood <ivan.hosgood@consumerdatastandards.gov.au>
Co-authored-by: Kirkycdr <brian.kirkpatrick@consumerdatastandards.gov.au>
Co-authored-by: James Bligh <40985476+JamesMBligh@users.noreply.github.com>
Co-authored-by: James Bligh <james@redcrew.com.au>
Co-authored-by: Mark Verstege <2514377+markverstege@users.noreply.github.com>
CDR-API-Stream added a commit that referenced this issue May 23, 2022
* Standards Staging Issue #115: Update text description of bulk balance for energy in endpoint version schedule

* Cleared out the diff comments presented on the Version Delta tab

* Added an empty release 1.16.0 release notes page

* Incremented version numbers for swagger files to 1.16.0

* Added archive link to 1.15.0

* Reverted back to standard (non-festive) logo

* Incremented version number in introduction

* Added normative reference link to RFC9126

* Added link to 1.16.0 release notes

* Corrected link for RFC2119

* Clarified requirements for Data Recipient Software Products S256 code challenge method by removing the redundant \'if supported\' text

* Standards Staging Issue #116 Change type of page and page-size in Energy APIs to PositiveInteger

* Updates for DP166

* Updates for DP166

* Removed duplicate section: Data Holders calling Data Recipients

* Corrected GetProducts response reference from ResponseBankingProductList to ResponseBankingProductListV2

* Removed the unintended additional formatting from the cds_banking.json to make diffs easier

* Corrected Register Discovery Document definition defect renaming request_object_signing_alg_values_supported to token_endpoint_auth_signing_alg_values_supported

* Corrected GetDataHolderBrands RegisterDataHolderAuth and jwksEndpoint schema definitions to clarify their usage in DH to ADR client authentication

* Standards Staging Issue #115: Updated release notes for this change

* fixed typos and ordering

* Removed tables

* Rechanged ordering

* Build and final checks

* Convert swagger to OAS
Remove 4xx error codes

* Rebuild

* Fix json typos
Update error codes for energy OAS

* Rebuild

* Added tooltip support for RFCs and normative/informative references. Also fixed invalid or missing RFC links

* Fixed markdown issue with normative references table

* Converted more normative reference links to dynamic tooltips

* Updated FAPI informative reference

* - Formatting improvements. - Added additional tooltip references

* - Moved normative references out of the Security section into the Introduction. - Added additional tooltip references

* Updated code generation for normative and informative references

* Added link to the endpoint versioning schedule to the high level standards

* Added 1.16.1 release notes

* Added release notes for Standards Staging issue 130

* Added release notes for Standards Staging issue 132

* Updated RFC4122 links in Banking and Common schemas to include tooltips

* poc secondary-dataholder-apis: Added changes to include Energy Secondary Data Holder OAS in standards

* Fix for staging 139

* fix #138

* Fix for #137

* Fix #136

* Fix #135

* Fix #134

* Initial build for review

* Update version number everywhere

* Add archive entry for 1.16.0
Clean up diff statements
Update release notes

* Fixes to SR swagger

* Update Swagger to OAS in markdown

* Updated Energy SDH swagger file to lastest version with fixes applied for error codes and attribute types

* Remove known issues that are resolved
Full rebuild

* Version bumps to address GitHub security notices

* Updated additional informative references to include tooltips

* Fix SDH security

* Fix for controlledLoad flag in energy
Rebuild

* Minor release notes and diff fixes

* Standards Release 1.17.0: Added release notes file

* Standards Maintenance Issue #448: Changed percentOfBill, percentOfUse, fixedAmount and percentOverThreshold attributes from optional to conditional within EnergyPlanDiscounts schema

* Standards Release 1.17.0: Removed version deltas, incremented version numbers in swagger files, added archieve entry for 1.16.1

* Updates to baseline 1.17.0 to remove legacy diffs and include a link to the release notes

* Standards Maintenance Issue 503: Fixed documentation for CDR Arrangement Form Parameter and JWT method requirements

* Added scrollabe diffs and examples to support previous and next scrolling

* Added release notes

* Updated prev/next button titles

* Minor refactoring to remove unused vars

* Standards Maintenance Issue 504: Corrected the profile scope data language to clarify request of individual claims

* Added diff

* Standards Maintenance Issue #449: Made EnergyPlanSolarFeedInTariff.timeVaryingTariffs.timeVariations.days field mandatory

* Added proof of concept to highlight obligations in the endpoint versioning schedule based on a selected mileston date

* Added release notes

* Removed diff comments

* Fix for padding of last input field in datepicker

* Added collapsible obligations that hide any future, retired, and inactive obligations

* Tweaks to collapsed highlighting

* Updated release notes to include standards maintenance issue number

* Corrected release description

* Updated CDR Arrangement Recovation JWT documentation to articulate requirements in accordance to self signed JWTs

* Added a new section to summarise all change requests in the release notes

* Added headings

* Added obligation milestones

* Improvement to wording of profile scope data language based on commmunity feedback

* Updated diff

* corrected non-normative examples using the unsupported HS256 alg. Changed examples to PS256 to align with FAPI requirements

* Added 482 descriptions to the release notes

* Updated release notes

* Update dcr OAS so it compiles

* Standards Maintenance Issue #457: Made EnergyServicePointDetail.meters.registers.registerSuffix field optional

* Updated release notes to contain links to the associated change request

* Updated Register swagger to addres empty content fields causing compilation issues

* header requirements for versioned Register APIs moved from mandatory to optional

* Standards Maintenance Issue #438: Added calculationFactors and adjustments objects to EnergyBillingOtherTransaction model

* Added version delta comments

* Rebuild
Fix minor typos in diffs

* Removed debugging output for date picker

* Standards Maintenance Issue #439: Added timezone field to EnergyPlanTariffPeriod

* Fixed compile issues for date picker scripts

* Added Register dependency schedule table to differentiate Register delivery from Participant future dated obligations

* Added requirement for data holders to ignore unsupported authorisation scopes

* Updated endpoint version schedule to 2022-11-15 for register API versions where binding date was subject to ACCC review

* Standards Maintenance Issue #476: Updated EnergyConcession model to cater for variable concessions. Changed RateString to represent generic percentages.

* Standards Maintenance Issue #476: Moved RateString change description to High Level Standards in Release Notes. Move RateString diff in High Level Standards

* Moved change description to API Endpoints sections in Release Notes

* Set retirement dates for outstanding deprecated Register APIs

* Added standards maintenance issue reference to release notes

* Added standards maintenance issue reference to release notes

* New authenticated endpoints only require cdr-register:read as the authorisation scope

* Added clarification that when statuses are not received or recognised from the CDR Register, the ACCC can inform Data Holders of statuses to trust using an alternative mechanism

* Added GetDataHolderBrandsSummary API to expose public details of Data Holder Brands from the CDR Register to public clients

* Standards Maintenance Issue #478: Made EnergyServicePointDetail.meters and EnergyServicePointDetail.meters.registers fields optional and updated their descriptions

* Documented scopes usage for the authenticated Register endpoint versions

* Changed formatting of dependency dates to remove leading zero

* XV header is a required field

* Made SHOULD requirement bold

* Added version-deltas for register scope usage

* Standards Staging Issue #133: Corrected description of 'oldest-date' by removing the word 'days'

* Standards Staging Issue #170: Documentation fix - EnergyServicePointDetail.meters and EnergyServicePointDetail.meters.registers have been converted into arrays

* Standards Maintenance Issue #439: Updated description of EnergyPlanContract.timezone and EnergyPlanTariffPeriod.timezone to specify default values

* Standards Staging Issue #131: Minor edit- clarification added that ServicePointId to be replaced with NMI in path param as well

* Corrected version delta presentation

* Added Get Data Holder Brands Summary to the endpoints table

* Corrected whitespacing in version deltas

* Standards Staging Issue #153: Modified Energy location to be a CommonPhysicalAddress model

* Added support for 404 response code

* Full rebuild

* Add release date
Reorder release notes

* Standards Staging Issue #167: Corrected x-fapi-interaction-id header to be mandatory for Energy SDH APIs

* Fix to force version delta code blocks to break at word boundaries not at overflow

* 404 now only applies when industry is not found

* Cosmetic improvements in the release notes

* Cleaned up version deltas to follow conventions

* Removed reference to the ACCC delivery schedule

* Full rebuild

* Correct change for staging issue 170

Co-authored-by: Hemang Rathod <hemang.rathod@consumerdatastandards.gov.au>
Co-authored-by: Ivan Hosgood <ivan.hosgood@consumerdatastandards.gov.au>
Co-authored-by: Kirkycdr <brian.kirkpatrick@consumerdatastandards.gov.au>
Co-authored-by: James Bligh <40985476+JamesMBligh@users.noreply.github.com>
Co-authored-by: James Bligh <james@redcrew.com.au>
Co-authored-by: Mark Verstege <2514377+markverstege@users.noreply.github.com>
Co-authored-by: Ivan Hosgood <51106269+dsbivan@users.noreply.github.com>
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Category: API A proposal for a decision to be made for the API Standards made Industry: Banking This proposal impacts the banking industry Status: Decision Made A determination on this decision has been made
Projects
No open projects
Development

No branches or pull requests

2 participants