Intellij SFCC uploads single files in two ways: Auto Upload sends every change as you work, and Upload Item sends what you select. Both go to the code version selected for the active connection and leave a line in the B2C Sync Log. To push whole cartridges at once, use Deploy Code
Sandbox 01
version2
Cart.js
RefArch (3)Auto Upload
Turn it on with the Auto Upload button in the main toolbar. The icon shows the state: Auto Upload Enabled or Auto Upload Disabled
- It is off by default
- The state is saved per connection, so switching the active connection also switches Auto Upload to that connection's state
- Use the toolbar button. The Auto Upload entry in Tools › Salesforce B2C Commerce doesn't toggle it
| You do this | Auto Upload does this |
|---|---|
| Create, edit, paste or copy a file | Uploads the file |
| Delete a file | Removes it from the code version |
| Move or rename a file | Moves it on the server |
| Change files outside the IDE, for example by switching Git branches | Picks the changes up from disk and syncs them the same way |
Branch switches are synced too
With Auto Upload on, switching to a branch that changes hundreds of files uploads and removes all of them. For big switches, turn Auto Upload off first and run Deploy Code afterwards
What gets uploaded
Only files inside linked roots are uploaded: cartridges marked as Cartridge Root, B2C Module Root folders and the Modules (Global Modules) Root. See Cartridges & Modules for how to link them
Some files are skipped on purpose, and the B2C Sync Log says why:
| Line | Why |
|---|---|
[EXCLUDED] You are trying to upload excluded item ... | The file is in a folder marked Excluded or Test Sources Root in the IDE |
[NOT ALLOWED] ... Please link cartridge '...' to your project | The file belongs to a cartridge that is not linked |
Upload selected items
Right-click files or folders in the Project view, an editor tab or the editor, and choose Upload ... to your connection . The label follows the selection, for example Upload Controller to Dev 01, Upload Templates to Dev 01 or Upload Cartridge to Dev 01
The shortcut is Cmd+Shift+I on macOS and Ctrl+Shift+I on Windows and Linux. The item is hidden when the selection includes anything outside a linked cartridge or module
B2C Sync Log
The B2C Sync Log tool window at the bottom of the IDE gets one tab per connection, named after it. The tab appears with the first upload, deploy or clean for that connection, so the window is empty until then
| Line | Meaning |
|---|---|
[version] :: path [size] updated | Open on server | The file was uploaded to that code version |
[version] :: path removed | The file was removed from the code version |
[401] Invalid credentials. Please check your connection settings | The instance rejected the account or access key |
Sandbox is down. This sandbox is currently stopped. Please start it and try again. | The sandbox is stopped |
Local paths in the log are links that open the file in the editor, and Open on server opens the uploaded file in the browser. Deploy and clean runs print their own steps and a summary, see Deploy Code
app_custom
cartridge
templates
cart.ismlTroubleshooting
| Symptom | What to do |
|---|---|
| Nothing uploads on save | Check that Auto Upload is enabled for the active connection and that the file's cartridge is linked |
| Upload ... to is missing from the menu | Part of the selection is outside a linked cartridge or module. Link it in Cartridges & Modules |
| Connection Error balloon | The upload failed for a connection reason. Use Edit Connection in the balloon and run Test Connection |
| Sandbox is down | Start the sandbox, for example from On-Demand Sandboxes, then save the file again |
| Files land in the wrong code version | Check the code version selected in the toolbar, see Deploy Code |