Playground

Extension Overview

This extension allows to easily upload your Salesforce projects as assets/plays directly to Playground, right from your editor, giving you the best experience. This is the easiest way to upload solutions to Playground. This works well with SFDX projects and Salesforce extensions.

About Playground

Playground is an intuitive, collaborative and easy-to-use cloud application to upload and share solutions within the Salesforce ecosystem.

Extension Requirements

You should have a Playground login to use this extension. Once you are logged in, you need to create an App Password to be used for this extension.

Setup

Once installed, connect your extension with App Passwords. Follow the below step by step process to connect:

1. Go to your profile on Playground by clicking under your name & selecting profile.
2. Go to the App Passwords tab & generate a new password & save it. Put vscode as the name of App Password.
3. Once the password is generated, come back to the vscode editor & establish a connection. Click on Playground: Connect button on the bottom status bar as shown in the picture.
4. On button click, it will ask for Nickname & Password. Use your nickname & password generated here.

Upload your project

Once everything is set up, Uploading project to Playground is a single click task. Just go to Playground: Push Changes button in the bottom status bar & it will pick your whole force-app/src structure & upload it, thus making it a Playground directory. This button is clever & it overrides/updates the existing play next time if the same directory sent again with any changes.

Open the play through vscode

There is an open link button just along with Playground: Push Changes that can simply open your play whenever you want. See the above image to locate.

Extension Usage

This extension comes with two actions i.e. Playground: Connect & Playground: Push Changes. All of these can be handled by following either of the things above. It comes with one fancy open link button as well to see you existing

Extension Commands (ONLY USE IF BUTTONS ARE NOT VISIBLE PROPERLY)

• Connect: Run this command to reset your login if required to replace it with the new App Password.
• Push & Create Play: Creates a play by pushing all files in your Salesforce Project
• Push & Update Play: Updates the current play by sending your changed files to Playground.

Relevant Links

• What is Playground?
• Terminology
• Create a New Play

Release Notes

[0.0.20 - 0.0.25] - 2020-05-17

Fix zip issues for certain files on Windows
Error handling improvements
Update README

0.0.19

Path issue fixed for Windows

0.0.18

Error handling improvements

0.0.15 - 0.0.17

Updated README
Default Configuration fix
Minor fixes with creation

0.0.12

minor bug fixes

0.0.11

Introduction of following status bar items for quick use

Open link -> Open link of existing play from directory
Push Changes -> Create/Update plays appropriately

Commands renamed to following

Create Play -> Push & Create Play
Update Play -> Push & Update Play
Reset Login -> Connect

0.0.9

Configuration properties to support changes from settings

0.0.2 - 0.0.8

Fix for dependency injection issues
Update to README

0.0.1

Initial release of Playground extension. It supports the following commands:

• Reset Login
• Create Play
• Update Play

Enjoy!