https://github.com/jlgingrich/fnonq
CLI tool for sending messages to a F&O message processor
https://github.com/jlgingrich/fnonq
cli finance-and-operations fsharp message-processor
Last synced: 4 months ago
JSON representation
CLI tool for sending messages to a F&O message processor
- Host: GitHub
- URL: https://github.com/jlgingrich/fnonq
- Owner: jlgingrich
- Created: 2025-10-16T19:02:45.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-10-29T16:32:33.000Z (4 months ago)
- Last Synced: 2025-10-29T18:32:21.296Z (4 months ago)
- Topics: cli, finance-and-operations, fsharp, message-processor
- Language: F#
- Homepage:
- Size: 3.91 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# fnonq
> **F**inance a**N**d **O**perations e**NQ**ueue
A `dotnet` tool that allows you to easily send messages to a [F&O Message Processor queue](https://learn.microsoft.com/en-us/dynamics365/supply-chain/message-processor/message-processor).
## Installation
1. Place `fnonw.1.X.X.nupkg` file in Downloads folder.
2. Run `dotnet tool install --global --add-source . fnonq`.
3. Try it out: `fnonq --help`.
4. ...Profit?
5. To uninstall, run `dotnet tool uninstall --global fnonq`
## Help
```txt
[Finance aNd Operations eNQueue] Easily add messages to a F&O Message Processor queue
USAGE: fnonq [--help] --company-id --client-id --client-secret --legal-entity --message-queue --message-type --url [--mock]
MESSAGE:
path to JSON file containing message payload
OPTIONS:
--company-id Microsoft company id; a GUID
--client-id OAuth2 client id; a UUID
--client-secret
OAuth2 client secret; a UUID
--legal-entity
F&O legal entity; a STRING
--message-queue
message queue name; a STRING
--message-type
message type; a STRING
--url base url of the F&O instance; a URL
--mock if set, display the message queue request instead of sending it
--help display this list of options.
```
## Example Use
This Powershell script is annotated and split onto multiple lines for clarity.
```powershell
fnonq `
<# Company id for authentication according to MSFT #> `
--company-id '12345657-1234-1234-1234-1234567890ab' `
<# OAuth2 client id #> `
--client-id '12345657-1234-1234-1234-1234567890ab' `
<# OAuth2 client secret #> `
--client-secret '12345657-1234-1234-1234-1234567890ab' `
<# URL of target F&O environment #> `
--url 'https://your-environment.operations.dynamics.com' `
<# Target Legal entity id #> `
--legal-entity 'USMF' `
<# Message queue id #> `
--message-queue 'MESSAGE_QUEUE' `
<# Message type id #> `
--message-type 'MESSAGE_TYPE' `
<# Add if you want to see the raw HTTP request it would've sent #> `
--mock `
<# Path to message payload #> `
message-to-send.json
```
## Building
1. Run `dotnet pack` in this directory.
2. Distribute the file `./bin/Release/fnonq.1.X.X.nupkg`.
3. See [installation instructions](#installation) above.