{"id":46869375,"url":"https://github.com/flowsynx/plugin-json","last_synced_at":"2026-03-10T19:34:41.087Z","repository":{"id":302509440,"uuid":"1011462193","full_name":"flowsynx/plugin-json","owner":"flowsynx","description":"FlowSynx plugin to loads and parses local JSON files. Supports transformation, extraction, and mapping of hierarchical data structures in workflows.","archived":false,"fork":false,"pushed_at":"2025-12-11T20:47:01.000Z","size":68,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-02-16T08:46:04.483Z","etag":null,"topics":["data","data-platform","flowsynx","json"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/flowsynx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-30T21:22:29.000Z","updated_at":"2025-12-11T20:41:33.000Z","dependencies_parsed_at":"2025-07-02T19:38:32.204Z","dependency_job_id":"7883f867-52c2-49fb-a281-40d4652cfa5a","html_url":"https://github.com/flowsynx/plugin-json","commit_stats":null,"previous_names":["flowsynx/plugin-json","genoflow/plugin-json"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/flowsynx/plugin-json","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flowsynx%2Fplugin-json","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flowsynx%2Fplugin-json/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flowsynx%2Fplugin-json/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flowsynx%2Fplugin-json/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flowsynx","download_url":"https://codeload.github.com/flowsynx/plugin-json/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flowsynx%2Fplugin-json/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30350183,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T15:55:29.454Z","status":"ssl_error","status_checked_at":"2026-03-10T15:54:58.440Z","response_time":106,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data","data-platform","flowsynx","json"],"created_at":"2026-03-10T19:34:40.389Z","updated_at":"2026-03-10T19:34:41.075Z","avatar_url":"https://github.com/flowsynx.png","language":"C#","readme":"# FlowSynx JSON Plugin\n\nThe **FlowSynx JSON Plugin** is a built-in, plug-and-play integration for the FlowSynx automation engine. It enables parsing, transforming, extracting, and mapping structured or semi-structured JSON data within workflows with no custom coding required.\n\nThis plugin is automatically installed by the FlowSynx engine when selected in the workflow builder. It is not intended for standalone developer usage outside the FlowSynx platform.\n\n## Purpose\n\nThe JSON Plugin allows FlowSynx users to:\n\n- Parse and inspect complex JSON structures.\n- Extract values using JSONPath-like expressions.\n- Flatten nested objects.\n- Map JSON data to specific output fields using flexible rules.\n- Format the output with indentation for readability.\n\nIt integrates seamlessly into FlowSynx no-code/low-code workflows.\n\n## Supported Operations\n\n- **extract**: Extracts a specific value using a `Path` expression.\n- **transform**: Flattens a nested JSON structure into flat `key: value` pairs.\n- **map**: Maps fields to new keys using a dictionary of `Path` expressions.\n\nOperation names are case-insensitive and passed as part of the `InputParameter`.\n\n## Input Parameters\n\nThe plugin accepts the following parameters:\n\n- `Operation` (string): Required. The type of operation to perform. Supported values are `extract`, `transform`, and `map`.\n- `Data` (object): Required. The JSON object (or raw JSON string) to process.\n- `Path` (string): Required for `extract` operation. A JSONPath-like expression to locate a specific value.\n- `Mappings` (dictionary): Required for `map` operation. A dictionary where each key is an output field and each value is a `Path` expression.\n- `Flatten` (bool): Optional. Used with `transform` to specify whether to flatten nested objects (`true`) or not (`false`).\n- `Indented` (bool): Optional. Determines whether the output JSON should be pretty-printed with indentation (`true`) or compact (`false`).\n\n### Map operation example input\n\n```json\n{\n  \"Data\": { ... },\n  \"Path\": \"$.some.path\",\n  \"Mappings\": {\n    \"Name\": \"$.person.name\",\n    \"Email\": \"$.person.contact.email\"\n  },\n  \"Flatten\": true,\n  \"Indented\": true\n}\n```\n\n## Operation Examples\n\n### extract Operation\n\n**Input JSON Object:**\n```json\n{\n  \"meta\": {\n    \"version\": \"1.0.2\",\n    \"timestamp\": \"2024-12-01T10:00:00Z\"\n  }\n}\n```\n\n**Input Parameters:**\n```json\n{\n  \"Data\": { ... },\n  \"Path\": \"$.meta.version\"\n}\n```\n\n**Output:**\n```json\n\"1.0.2\"\n```\n\n---\n\n**Input JSON Array:**\n```json\n[\n  { \"id\": 1 },\n  { \"id\": 2 },\n  { \"id\": 3 }\n]\n```\n\n**Input Parameters:**\n```json\n{\n  \"Data\": \"[...]\",\n  \"Path\": \"$[*].id\"\n}\n```\n\n**Output:**\n```json\n[\n    1,\n    2,\n    3\n]\n```\n\n### transform Operation\n\n**Input Data:**\n```json\n{\n  \"user\": {\n    \"profile\": {\n      \"name\": \"Bob\",\n      \"email\": \"bob@example.com\"\n    }\n  }\n}\n```\n\n**Input Parameters:**\n```json\n{\n  \"Data\": { ... },\n  \"Flatten\": true,\n  \"Indented\": true\n}\n```\n\n**Output:**\n```json\n{\n  \"user.profile.name\": \"Bob\",\n  \"user.profile.email\": \"bob@example.com\"\n}\n```\n\n### map Operation\n\n**Input Data:**\n```json\n{\n  \"person\": {\n    \"name\": \"Alice\",\n    \"contact\": {\n      \"email\": \"alice@example.com\"\n    }\n  }\n}\n```\n\n**Input Parameters:**\n```json\n{\n  \"Data\": { ... },\n  \"Mappings\": {\n    \"Name\": \"$.person.name\",\n    \"Email\": \"$.person.contact.email\"\n  },\n  \"Indented\": false\n}\n```\n\n**Output:**\n```json\n{\n  \"Name\": \"Alice\",\n  \"Email\": \"alice@example.com\"\n}\n```\n\n## Example Use Case in FlowSynx\n\n1. Add the JSON plugin to your FlowSynx workflow.\n3. Provide the JSON input object in `Data`.\n4. Configure `Path`, `Mappings`, `Flatten`, and `Indented` depending on the operation.\n5. Use the plugin output downstream in your workflow.\n\n## Debugging Tips\n\n- If the result is null, ensure `Path` is valid and points to an existing element.\n- If nothing is mapped, check for typos in the `Path` expressions inside `Mappings`.\n- To get human-readable output, set `Indented` to `true`.\n\n## Security Notes\n\n- No data is persisted unless explicitly configured.\n- All operations run in a secure sandbox within FlowSynx.\n- Only authorized platform users can view or modify configurations.\n\n## License\n\nCopyright FlowSynx. All rights reserved.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflowsynx%2Fplugin-json","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflowsynx%2Fplugin-json","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflowsynx%2Fplugin-json/lists"}