You can use MDriven samples to start a new MDriven Turnkey application, explore a complete model, or find a focused implementation example for a specific client or integration scenario.
Choose the right kind of sample
Samples are published in the public supportMDriven GitHub organization. Use the sample type that matches how you want to work.
| Sample type | Use it when | What to expect |
|---|---|---|
| Turnkey application sample | You want a working site and model to explore or adapt. | Applying the sample to a Turnkey site replaces that site's current model and content. |
| Example app or model | You want to study a complete application model. | Download the model from the sample site after applying it, then adapt the copy in MDriven Designer. |
| Model section | You already have a model and want to add a focused capability. | Use the merge-in examples described on Documentation:Example Gist. |
| Client or technology sample | You need an implementation example for a particular client technology or integration. | Follow the sample's own documentation and prerequisites. For example, the Android barcode sample is covered in Documentation:Barcode - on Android - with Xamarin and MDriven. |
Apply a sample to a Turnkey site
Use a disposable or newly requested site when you evaluate a sample. Applying a sample replaces the current site content.
- Log in to
portal.mdriven.netand request a demo site if you do not already have a site available. - Open the Cloud dialog and select the site you want to use.
- Find the available sample, read its description, and select Apply this sample.
- Read and accept the warning only if you intend to replace the site's current model and content.
- Wait for the sample to be applied.
- Download the model from the site if you want to inspect or continue developing it in MDriven Designer.
- Open the site in a browser and use its views to explore the sample data and behavior.
For example, applying the SoftConflict sample gives the selected site a copy of the SoftConflict sample model. You can then download that model, add an attribute or change a ViewModel, upload the changed model to the site, and continue from that copy.
Gotcha: Do not apply a sample to a site whose current model or data you need to keep. The apply operation replaces the current content of that site.
Find examples
Documentation:Example Gist is the starting point for available example applications and model sections. It includes examples such as BaseApp, Store complaint handling, Sudoku, Board Map Balls Gantt, InstantPoll, SoftConflict, and ProjectPlanning.
Use that page when you need to decide whether to apply a complete sample or merge a model section into an existing model.
Client and integration examples
Some samples demonstrate a client technology or an integration rather than a Turnkey starting model.
- For barcode scanning on Android with Xamarin Forms, see Documentation:Barcode - on Android - with Xamarin and MDriven. The example uses code-generated ViewModels that bind to Xamarin Forms views and sends scanned shelf and item information to the server model.
- For SOAP service calls, including inspecting the generated SOAP envelope with a
vSoapDebugViewModel variable, see Documentation:SOAP the protocol from the stone age.
Work safely with a sample
- Start with a separate Turnkey site for evaluation.
- Apply the sample and verify that you can open its views and work with its sample data.
- Download the model before making changes, so you work on a local copy in MDriven Designer.
- Make one small, testable change. For example, add an attribute to a sample class and update the ViewModel where the related value is shown.
- Upload the changed model to the evaluation site and verify the affected view.
- Move only the model parts you understand into your own solution. If you need a focused addition rather than a full replacement, use a merge-in model section from Documentation:Example Gist.
Database sample files
Some older Turnkey samples have been distributed as SQL Server Compact database files with the .sdf extension. Treat such a file as site content that can replace the content of a site you control. Do not use it against a site whose current content must be preserved.
This page does not provide a database-injection procedure because the available source material does not define the required tool, command, or supported workflow. Use the repository documentation supplied with the specific sample, or use the Turnkey Apply this sample workflow when it is available.