https://github.com/dalenewman/orchardcore.transformalize

a transformalize module for orchard core
https://github.com/dalenewman/orchardcore.transformalize

orchardcore transformalize

Last synced: 5 months ago
JSON representation

a transformalize module for orchard core

• Host: GitHub
• URL: https://github.com/dalenewman/orchardcore.transformalize
• Owner: dalenewman
• License: apache-2.0
• Created: 2020-04-19T19:28:44.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2025-07-16T03:05:18.000Z (6 months ago)
• Last Synced: 2025-07-17T05:46:03.262Z (6 months ago)
• Topics: orchardcore, transformalize
• Language: JavaScript
• Size: 87.9 MB
• Stars: 13
• Watchers: 6
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
## Transformalize in Orchard Core

This is an [Orchard Core](https://github.com/OrchardCMS/OrchardCore) module 

that uses [Transformalize](https://github.com/dalenewman/Transformalize) 

arrangements to create:

- **Reports**: Browse and Search for data.

- **Tasks**: Validate & transform parameters for use in data modification statements.

- **Forms**: Validate & transform form data for data collection. 

- **Bulk Actions**: Tasks run on records selected from reports.

### Reports

Reports read, filter, search, export, and page over data. 

You may transform records using [Razor](https://docs.microsoft.com/en-us/aspnet/core/mvc/views/razor?view=aspnetcore-3.1) 

, [Liquid](https://shopify.github.io/liquid), and built-in transforms. 

If the records have coordinates, you may display them on a map.

`TODO: Explain example arrangement and show GIF.`

### Tasks

Tasks accept, transform, and validate parameters before running 

traditional [transformalize](https://github.com/dalenewman/Transformalize/blob/master/README.md) 

or simple data modification processes.

`TODO: Explain example arrangement and show GIF.`

### Forms

Building off the ability to validate parameters, 

forms collect valid user supplied input and store it 

in a relational provider (a specified table).

`TODO: Explain example arrangement and show GIF.`

### Bulk Actions

Bulk Actions combine reports and tasks. You may 

select records on a report, and send them to a 

task for processing.

Configurable tasks must be defined to run bulk actions:

1. `batch-create`: create and return a batch identifier

1. `batch-write`: write batch values

1. `batch-summary`: query batch summary

1. `batch-run`: indicate the task is running (not yet implemented)

1. `batch-success`: indicate the task succeeded

1. `batch-fail`: indicate the task failed

There are recipes for MSSQL, PostgreSql, and SQLite for the above tasks. Initially, The "batch write" task must be run once in _init_ mode to setup the necessary tables/views.

---

Putting it all together, here is a GIF showing a report (with map) that has a bulk 

action to change color associated with the record.

![bogus report](src/Site/App_Data/samples/sacramento-crime/criminal-bulk-actions.gif)

`TODO: Link to arrangement here.`

---

### Development

- Visual Studio 2022 with ASP.NET Core related workloads:

  - ASP.NET and Web Development

  - .NET Core Cross-Platform Development

- Relies on nuget source https://www.myget.org/F/transformalize/api/v3/index.json

- **Caution**: This project is still under development.