In this quickstart we demonstrate how you could build an .net 8 host that process files from Quotation Factory.
We use the Quotation Factory Agent/Connector that connects with Quotation Factory and downloads the file to the Output directory.

When you create an Quotation Factory Agent in the portal you need to provide a 'Root directory' this is the location of the directory the Quotation Factory Agent uses to operate with.
Output files from Quotation Factory are stored in the Output directory inside the root directory of the Quotation Factory Agent.

For example: if the Quotation Factory Agent has the root directory configured like 'C:\Agent\Exchange', the Output files will be stored in 'C:\Agent\Exchange\Output'.

The Root directory needs to be configured in the appsettings.json or appsettings.development.json in this project.

If we run the Quotation Factory.Host project inside this solution and we do an 'Export from Quotation Factory' the filewatcher will notice this new file the Quotation Factory Agent created and it will publish a MediatR notification 'AgentOutputFileCreated'.

The 'AgentOutputFileCreatedHandler' will process this notification and will read the file and deserialize it to the Project class.

When change the status of a project inside Quotation Factory to Quoted or Ordered and export will be triggered and if the Quotation Factory Agent is configured and running it will download the file to the Output directory of that agent.

Please create an issue if you got a suggestion or if you need help.

The Quotation Factory Agent (QF Agent) enables robust, custom integrations with the Quotation Factory cloud platform. Developers can leverage the example project provided on GitHub as a starting point for building their own integrations. Access the project here: QF.Basic.Integration.Quickstart Repository.

The AgentOutputFileCreatedHandler.cs class within the example project includes various message handlers that facilitate interactions between your local systems and the QF cloud platform. Below is a detailed table summarizing the messages, their purposes, and the corresponding response objects.

To develop your own integration using the QF Agent, follow these steps:

1. Clone the Example Project: Start by cloning the example project from the GitHub repository.
2. Review the Example Handlers: Understand how the handlers in the AgentOutputFileCreatedHandler.cs class interact with the Quotation Factory platform.
3. Customize Message Handlers: Modify existing handlers or create new ones to meet the specific needs of your integration.
4. Test Your Integration: Thoroughly test the integration in a controlled environment to ensure it functions correctly and interacts with the QF platform as expected.
5. Deploy: Once testing is complete, deploy your custom integration to production.

• Use Clear Naming Conventions: Like the examples, ending handler names with Message helps in identifying the purpose and nature of the handler.
• Handle Failures Gracefully: Implement error handling within your handlers to manage and log failures or unexpected issues.
• Test Thoroughly: Before deploying your handlers, thoroughly test them to ensure they handle all expected scenarios correctly.

Building integrations with the QF Agent provides a powerful way to enhance the functionality of the Quotation Factory platform, enabling customized workflows and improved data management. By following this guide and utilizing the provided example project, you can effectively develop robust integrations tailored to your specific needs.