|
1 | | -# ⚡️ Lightning Flow Scanner Demo Flows |
| 1 | +# Lightning Flow Scanner Demo Repository |
2 | 2 |
|
3 | | -Welcome to the **Lightning Flow Scanner Demo Flows**! This project includes a curated set of Salesforce Flow metadata files (`.flow-meta.xml`) intended for: |
| 3 | +Welcome to the Lightning Flow Scanner Demo Repository! Get up and running and try the Lightning Flow Scanner now using our Demo Flows. We've prepared a set of example flows that showcase various types of violations, as well as flows that demonstrate how to resolve them. This repository is designed to provide you with practical examples of best practices, ensuring you have valuable resources at your fingertips to improve your code scanning and development process. Explore, learn, and enhance your Salesforce Flow scanning capabilities with our curated test data and sample flows. Happy flow building! 🚀🌟 |
4 | 4 |
|
5 | | -- ✅ Demonstrating best practices and violations detectable by [Lightning Flow Scanner](https://github.com/Lightning-Flow-Scanner) |
6 | | -- 🧪 Serving as a reliable input set for automated testing in the main scanner repository |
7 | | -- 🚀 Easy deployment to any org using the Salesforce CLI |
| 5 | +## Getting Started |
8 | 6 |
|
9 | | -These flows are designed to support testing, demoing, and local development without maintaining a separate demo repository. |
| 7 | +Follow these steps to get up and running with the Lightning Flow Scanner Demo Repository and try out our demo flows: |
10 | 8 |
|
11 | | ---- |
| 9 | +### Step 1: Clone the Repository |
| 10 | +To clone the repository, press Ctrl+Shift+P on Windows or Shift+⌘+P on macOS to open the command palette and use the Git Clone command. Alternatively, you can click the link below to clone the repository: |
12 | 11 |
|
13 | | -## 🔧 Usage |
| 12 | + |
14 | 13 |
|
15 | | -You can deploy the demo flows using: |
| 14 | +### Step 2: Open in Editor |
| 15 | +When prompted, select to open the repository. This will open the cloned repository in your preferred code editor. You can also click the link below for direct access: |
16 | 16 |
|
17 | | -```bash |
18 | | -npm run deploy:testflows -- --target-org my-sandbox |
19 | | -``` |
| 17 | + |
20 | 18 |
|
21 | | -Or with an environment variable: |
| 19 | +### Step 3: Install Recommended Extensions |
| 20 | +Upon opening the repository, you may be prompted to install recommended extensions. It's essential to do this to ensure a smooth experience when working with the Lightning Flow Scanner. Click the link below for reference: |
22 | 21 |
|
23 | | -```bash |
24 | | -SF_TARGET_ORG=my-sandbox npm run deploy:testflows |
25 | | -``` |
| 22 | + |
26 | 23 |
|
27 | | ---- |
| 24 | +### Step 4: Run Flow Commands |
| 25 | +Press Ctrl+Shift+P on Windows or Shift+⌘+P on macOS to open the command palette and type `Flow` to see the available commands from Lightning Flow Scanner. Examples of how the commands run can be found in the [Readme of the Extension repository](https://github.com/Force-Config-Control/lightning-flow-scanner-vsce). |
28 | 26 |
|
29 | | -## 📁 Project Structure |
30 | | - |
31 | | -This is a standard Salesforce DX project structure: |
32 | | - |
33 | | -``` |
34 | | -example-flows/ |
35 | | -└── force-app/ |
36 | | - └── main/ |
37 | | - └── default/ |
38 | | - └── flows/ |
39 | | - ├── Copy_API_Name.flow-meta.xml |
40 | | - ├── Hardcoded_Id.flow-meta.xml |
41 | | - ├── ... |
42 | | -``` |
43 | | - |
44 | | ---- |
45 | | - |
46 | | -## 🧪 Connected to Unit Tests |
47 | | - |
48 | | -These flows are directly referenced by unit tests in the main [`lightning-flow-scanner-core`](https://github.com/Lightning-Flow-Scanner/lightning-flow-scanner-core) repository. Tests point to: |
49 | | - |
50 | | -``` |
51 | | -../example-flows/force-app/main/default/flows/ |
52 | | -``` |
53 | | - |
54 | | -No more maintaining a separate flows repo! 🎉 |
55 | | - |
56 | | ---- |
57 | | - |
58 | | -## 💡 Want to Explore in VS Code? |
59 | | - |
60 | | -1. **Clone this repo** |
61 | | - - `git clone https://github.com/Lightning-Flow-Scanner/lightning-flow-scanner-core.git` |
62 | | -2. **Open `example-flows/` in VS Code** |
63 | | -3. **Install recommended extensions when prompted** |
64 | | -4. Use Salesforce CLI or the Lightning Flow Scanner VS Code extension to scan and analyze the flows. |
65 | | - |
66 | | ---- |
67 | | - |
68 | | -## 🧩 Recommended VS Code Extensions |
69 | | - |
70 | | -- [Lightning Flow Scanner Extension](https://marketplace.visualstudio.com/items?itemName=ForceConfigControl.lightningflowscanner) |
71 | | - |
72 | | -## 📖 Resources |
73 | | - |
74 | | -- [Lightning Flow Scanner Core](https://github.com/Lightning-Flow-Scanner/lightning-flow-scanner-core) |
75 | | -- [Lightning Flow Scanner VS Code Extension](https://marketplace.visualstudio.com/items?itemName=ForceConfigControl.lightningflowscanner) |
76 | | -- [Salesforce DX Documentation](https://developer.salesforce.com/tools/sfdxcli) |
77 | | - |
78 | | ---- |
79 | | - |
80 | | -Happy Flow Scanning! 🚦✨ |
| 27 | + |
0 commit comments