Skip to content

refactor(cSDK): Mandatory configuration.json in configuration_form example - #616

Open
fivetran-satvikpatil wants to merge 5 commits into
mainfrom
satvik/RD-1241560-empty-configuration-2
Open

refactor(cSDK): Mandatory configuration.json in configuration_form example#616
fivetran-satvikpatil wants to merge 5 commits into
mainfrom
satvik/RD-1241560-empty-configuration-2

Conversation

@fivetran-satvikpatil

@fivetran-satvikpatil fivetran-satvikpatil commented Aug 5, 2026

Copy link
Copy Markdown
Collaborator

Jira ticket

Closes RD-1241560

Description of Change

Mandatory configuration.json
Related PR: #606

Testing

  • Setup form loading
Screenshot 2026-08-13 at 5 03 09 PM
  • fivetran configuration
Screenshot 2026-08-13 at 2 54 20 PM

@fivetran-satvikpatil fivetran-satvikpatil self-assigned this Aug 5, 2026
@fivetran-satvikpatil
fivetran-satvikpatil requested a review from a team as a code owner August 5, 2026 09:38
@fivetran-satvikpatil
fivetran-satvikpatil requested a lite review from Copilot and removed request for a team August 5, 2026 09:38
@github-actions github-actions Bot added size/XS PR size: extra small risk/unknown labels Aug 5, 2026
@cla-assistant

cla-assistant Bot commented Aug 5, 2026

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.


Satvik Patil seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
You have signed the CLA already but the status is still pending? Let us recheck it.

1 similar comment
@cla-assistant

cla-assistant Bot commented Aug 5, 2026

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.


Satvik Patil seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
You have signed the CLA already but the status is still pending? Let us recheck it.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request introduces a configuration.json file to the examples/quickstart/configuration_form example to satisfy the “mandatory configuration.json” requirement described in RD-1241560 (and related to PR #606).

Changes:

  • Added examples/quickstart/configuration_form/configuration.json as an (currently empty) configuration file.

@@ -0,0 +1 @@
{} No newline at end of file

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@fivetran-satvikpatil Can we update readme for this?
Currently it says this :
The API fields (api_base_url, api_key) in the configuration form illustrate how a real connector would collect connection details. The configuration.json file provided contains sample values for running the connector locally.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 90691a2f03

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@@ -0,0 +1 @@
{} No newline at end of file

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Populate the required setup fields

When users run this example from a fresh checkout with the newly provided configuration.json, the file is {} even though this connector's setup form marks api_base_url and api_key as required and update() builds the request URL from configuration.get("api_base_url", ""). The documented local debug path using configuration.json therefore sends "/posts" as the URL and fails before syncing; please include usable sample/placeholder values for the required form fields, or don't ship an empty config for this configured example.

Useful? React with 👍 / 👎.

@fivetran-satvikpatil fivetran-satvikpatil changed the title Mandatory configuration.json refactor(cSDK): Mandatory configuration.json in configuration_form example Aug 5, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Left a couple of suggestions. Thanks

This example demonstrates how to define a connector setup form using `ConfigurationForm`, `form_field`, and `Test` from the Fivetran Connector SDK. It covers plain text, password, dropdown, and toggle fields, including dropdown options with labels and descriptions. It also shows how to register a connection test that Fivetran runs when the user clicks **Test Connection** during setup.

The API fields (`api_base_url`, `api_key`) in the configuration form illustrate how a real connector would collect connection details. The `configuration.json` file provided contains sample values for running the connector locally.
The API fields (`api_base_url`, `api_key`) in the configuration form illustrate how a real connector would collect connection details. An empty `configuration.json` file is included as a placeholder — you can populate it by running `fivetran configuration` or by providing values through the Fivetran UI after deployment.

@fivetran-chinmayichandrasekar fivetran-chinmayichandrasekar Aug 13, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

{% note %}
This project includes an empty configuration.json because it is required during deployment. You can optionally populate it to test the setup form fields, then deploy with the pre-populated file so the values appear pre-filled in the setup form. {% /note %}

Comment thread examples/quickstart/configuration_form/README.md Outdated
@fivetran-chinmayichandrasekar

Copy link
Copy Markdown
Contributor

@fivetran-satvikpatil In the Getting started section, we should remove "generates" from step 1:
Run the fivetran configuration command to interactively provide values for each form field. This generates (or overrides) a configuration.json file in the project directory.

fivetran-satvikpatil and others added 2 commits August 14, 2026 17:20
Co-authored-by: fivetran-chinmayichandrasekar <chinmayi.chandrasekar@fivetran.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants