jjlongoria / aura-helper Goto Github PK

Repository for manage the development of Aura Helper VSCode Extension

License: GNU General Public License v3.0

TypeScript 100.00%

aura-helper apex aura-components metadata vscode vscode-extension salesforce salesforce-developers salesforce-lightning salesforcedx

aura-helper's Introduction

Aura Helper

Aura Helper is the most complete extension to work with salesforce. Aura Helper provide the best IntelliSense suggestions and code completion options to Apex and Aura code of any Salesfoce extension (including Official Salesforce extensions). Can work with Salesfoce XML Metadata files and edit some files with graphic interface to minimize errors. Has the first exclusive Apex Formatter with configurable options to format your code as you like. Can work with GIT and detect changes for create packages files (and destructive too). Create a complete Apex and Aura documentation with a few clicks. and to much more.

Aura Helper not only works with any Salesforce project, it is also specially prepared to work with GIT and Salesforce, DevOps and Continuous Integration and has many tools designed to maintain the integrity of the local project and / or organizations, among other important tools to DevOps workflows.

Aura Helper contains several tools to increase productivity, facilitate code creation and make more easy work with Salesfoce. Is undoubtedly one of the necessary applications for any Salaesforce developer. Aura Helper is developed by Salesforce developer to Salesforce developers and has all you need as developer to work with Salesforce from VSCode.

Go to Aura Helper Extension Documentation to learn more about the extension and all features.

Configuration Guide
Aura Helper Features
Aura Helper Framework
Contributions

Configuration Guide

To use Aura Helper with all its features, you must to install Aura Helper SFDX Plugin. Click here and follow the instructions. Aura Helper allow yo the user to install from VSCode when install Aura Helper (or detect that does not have the plugin installed)

Aura Helper Features

Aura Helper has too many features to make work easy and faster to all Salesforce Developers.

Write code faster with the Aura Helper IntelliSense tools. Code completion for Apex, lightning, javascript... (User Classes, System Classes,Custom and Standard Objects, Methods, Fields, Picklist values, implement intefaces and extends classes automatically, Custom Labels, Aura attribute suggested values... and too much more.)
Apex Code formatter with configurable options from Aura Helper settings (spaces beetwen operators, max allowed blank lines, open curly brackets on new lines... and more options to format your code as you want). The first exclusive Apex code formatter for VSCode.
More than 200 snipets for create Aura Components, SLDS components and more with less effort
Create package and destructive files quickly with the powerful Package Generator. Select metadata manually from your org or local project, or create the files from two git branches, commits or tags differences.
Compare Metadata between local project and Auth org or between two different orgs for get the differences.
Repair Project Dependencies to get less errors on deploy. Check your local metadata and repair files if is needed. Also you can only check errors. Support al metadata types to repair.
Compress XML Files for make easy the git conflict handling and make work with git more faster.
Edit XML Files easy without errors from VSCode with the Aura Helper tools.
Modify Permissions of any object with Modify Permissions tool or modify directly the profiles, permission sets or muting permissions sets with the Permission Editor tool. Modify permissions directly from VSCode without errors.
Work with special metadata types like Profiles, Permission Sets, Translations... and download entire data from it without modify any other file
Create documentation for Aura components easy and faster based on a user defined template
Create a entire Apex Classes navigable documentation with only one command. Analize the entire code, extract data from comments using the user templates and create a full documentation in seconds.
Create your own Apex comment template for adding to apex code easy with autocompletion tools (type /** for create apex comments based on template). You can create your own tags and add datasources to replace tag with the data (for exameple, if create an @author tag with git username datasource, automatically add the git user to the @author tag value). The best comment system to Apex code.-
Outline View to see the files structure like Apex Classes Fields or Methods, Profiles or Permission Sets permissions.... Work with Apex, Aura Componentes (Apps, Events and Components), Aura JavaScript and All Metadata XML files. Provide more information than the standard Apex Outline.
Static Code Analysis with Aura Helper because implement SFDX Scanner and can run Static Code Analysis of your project to create better applications. Only need to run tthe command AuraHelper: Scan on file or folder to scan it and get results on problems panel.
To a complete work of all commands and have the better experience with Aura Helper you must Refresh the SObjects Index at least one time (recommended make it periodically when any object change) or has the SObejcts on your local project. For this porpouse, you can choose to refresh SObjects Index at VSCode Starts for refresh it automatically and have the index updated (Settings > AuraHeler > Metada > Refresh SObject Definitions On Start).
And too much more tools for make your work more easy and faster with less erros.

IntelliSense

Aura Helper implements the best IntelliSense system for Salesforce development. Aura Helper support and provide IntelliSense to Apex Code (Classes and Triggers), Aura Components (Componetns, Apps and Events) and Aura JavaScript files (Controller.js and Helper.js). Like all IntelliSense options, press Ctrl + Space to show all code suggestions.

Apex Code IntelliSense

Aura Helper can provide to many IntelliSense options to support Apex Coding. Like Salesforce with Apex code, Apex IntelliSense ignore letter case to show recomendations. For example, Label. or label. or LaBeL. will be the same and provide the same result.

Previews

List all available classes, Enums, Interfaces..., including Apex Namespaces and System classes with descriptions, documentation links and to much more info. Only need to press Ctrl + Space

List all available methods, class fields and all class members from the active class. Only need to press Ctrl + Space

List all methods, class fields,, inner classes and other class members from All System Classes and Namespaces (more than 1000 classes). Only need to press Ctrl + Space

List all class members, methods or fields from any variable or method of any type including System Classes and Namespaces (Without deep limit). Example: You can do MyClass.method1().otherMethod().stringMethod()... or variable.otherVariable.method().otherMethod()...And in every step, you can show all available options.

Implements Automatically all extended methods or implement interfaces with two simple commands: AuraHelper: Implement Extended Methods and AuraHelper: Implement Interfaces. When run this commands, Aura Helper will be parse the file to extract implements information and automatically put the missing methods from parents.

Provide SOQL IntelliSense options to complete projection query fields (including Lookup fields) and support to list and show to pick all fields from Lookup relationships (without deep limit). Only need detect the SELECT and FROM clauses to provide completions. Also work String queries. Only need to press Ctrl + Space into a query.

Provide more and better on hover information with the same IntelliSense descriptions style, including documentation links or links to the Salesforce Setup among others.

List all available Custom Labels into your project (need to download to the local project). Write label. to show all available labels.

Create Customized Apex comments based on a user defined template to addapt comments to any project. You can create your own tags with datasources to replace data automatically. See the Apex Comment section on documentation to learn more about it. Only need type /* Over every method, class or field to put the comments.

List all available SObjects stored in your org (need to execute Refresh All SObjects Index command) or list all available SObjects into your local project. Only need to press Ctrl + Space

List all fields from an SObject if you write the API Name (And all field related information). Example: Write Account. to show all Account fields.

List all available Record Types from a SObject (Name and DeveloperName) and can replace it to the String value Example: Account.yourRecordTypeName will be transform to 'yourRecordTypeName'. Aura Helper can detect if the suggetion is on a String to put or not the quottes symbol (')

List all picklist values from a SObject field to replace it with the picklist value Example: Account.picklistField__c.picklistValue will be transform to 'picklistValue'. Aura Helper can detect if the suggetion is on a String to put or not the quottes symbol (')

Aura Components IntelliSense

To work with Aura components (Components, Apps and Events), Aura Helper provide to many Intellisense options:

Previews

List all your Aura Components, Events and Apps. Only need to write c: and press Ctrl + Space to show and select any Component. Aura Helper can detect automatically if stast with < or end with > to complete it automatically. Example: If you write c: and select one component, Aura Helper will be write <c:myComponent >, but if you write <c:, Aura Helper will be write <c:myComponent > and the same in any case.

List All component Aura Attributes, incluiding inherited attributes from parent components. Only need to write v. to show all. If you select one attribute, Aura Helper can detect if is called between {! } symbols or any symbol is missing to wirte it. Example: If write {!v.} and select one attribute, Aura Helper will be write {!v.attributeName}, but if you write v. and select one, Aura Helper write {!v.attributeName} and the same if only write {v. and select any attribute.

List All Controller Functions, including inherited functions from parent components. Only need to write c. to show all. If you select one function, Aura Helper can detect if is called between {! } symbols or any symbol is missing to wirte it. Example: If write {!c.} and select one function, Aura Helper will be write {!c.functionName}, but if you write c. and select one, Aura Helper write {!c.functionName} and the same if only write {c. and select any function.

List all Aura Components Attributes (when use the components) to create components quickly. Only need to press Ctrl + Space between <> open tag symbols to show all available attributes. Example: If you press Ctrl + Space on the component call <c:myComponent > you can show all attributes from <c:myComponent >. Work with custom and System Defined Aura Components.

List All Availabble Values for a component attribute attribute (when use the components) to create components quickly. Aura Helper detect the Attribute type and automatically suggest the best (or available) values. Only need to press Ctrl + Space between quottes (") symbol on attribute value.. Example: If you press Ctrl + Space on the component call attribute value (between "") <c:myComponent oneAttribute=""> you can show all suggested values to the attribute according the attribute Datatype. Work with custom and System Defined Aura components.

List all available classes, Enums, Interfaces..., including Apex Namespaces and System classes with descriptions, documentation links and to much more info. Only need to press Ctrl + Space

List all methods, class fields,, inner classes and other class members from All System Classes and Namespaces (more than 1000 classes). Only need to press Ctrl + Space

List all available Custom Labels into your project (need to download to the local project). Write label. to show all available labels. When select one label, Aura Helper automatically will be put the Custom Labels format on Aura files. (Example: if select Label.thisIsOneLabel Aura Helper type {!$Label.c.thisIsOneLabel} or {!$Label.yourNamespace.thisIsOneLabel} if has a Namespace active in your org)

Provide SOQL IntelliSense options to complete projection query fields (including Lookup fields) and support to list and show to pick all fields from Lookup relationships (without deep limit). Only need detect the SELECT and FROM clauses to provide completions. Also work String queries. Only need to press Ctrl + Space into a query.

List all available SObjects stored in your org (need to execute Refresh All SObjects Index command) or list all available SObjects into your local project. Only need to press Ctrl + Space

List all fields from an SObject if you write the API Name (And all field related information). Example: Write Account. to show all Account fields.

List all available Record Types from a SObject (Name and DeveloperName) and can replace it to the String value Example: Account.yourRecordTypeName will be transform to 'yourRecordTypeName'.

List all picklist values from a SObject field to replace it with the picklist value Example: Account.picklistField__c.picklistValue will be transform to 'picklistValue'.

Hundreds of Snippets (with variants) to create System components quickly. Has several prefix to active the snippets, depending of the Component Namespace, use ltn. to show all Ligtning Namespace components, aura. to show all Aura Namespace components... Also has SLDS components snippets with slds. activation. Show Snippets page to learn more about it and show all available snippets.

Aura JavaScript IntelliSense

Aura Helper also implements IntelliSense to JavaSript Aura Files to provide a complete Aura IntelliSense system.

Previews

List All component Aura Attributes, incluiding inherited attributes from parent components. Only need to write v. to show all. If you select one attribute, Aura Helper can detect if is called from String to complete with quottes symbol('). For example. If you write v. and select one attribute Aura Helper will be write v.yourAttribute or 'v.yourAttribute'.

List All Apex Controller Methods, including inherited method from parent components. Only need to write c. to show all. If you select one function, Aura Helper can detect if is called from String to complete with quottes symbol('). For example. If you write c. and select one attribute Aura Helper will be write c.myMethod or 'c.myMethod'.

Complete Apex Classes Method Params Object automatically. When you write c. and list all Apex Controller Functions, you will see some elements like c.myMethod.params. If you select one of this, Aura Helper will bne write the Javascript object with all fields and comments with the datatype. Aura Helper can detect where is called to complete the body according the use case.

List all Helper file Functions, including inherited functions from parent components. Only need to write helper. to show all.

List all available classes, Enums, Interfaces..., including Apex Namespaces and System classes with descriptions, documentation links and to much more info. Only need to press Ctrl + Space

List all methods, class fields,, inner classes and other class members from All System Classes and Namespaces (more than 1000 classes). Only need to press Ctrl + Space

List all available Custom Labels into your project (need to download to the local project). Write label. to show all available labels. When select one label, Aura Helper automatically will be put the Custom Labels format on Aura JavaScript files. (Example: if select Label.thisIsOneLabel Aura Helper type $A.get('$Label.c.thisIsOneLabel') or $A.get('$Label.yourNamespace.thisIsOneLabel') if has a Namespace active in your org)

Provide SOQL IntelliSense options to complete projection query fields (including Lookup fields) and support to list and show to pick all fields from Lookup relationships (without deep limit). Only need detect the SELECT and FROM clauses to provide completions. Also work String queries. Only need to press Ctrl + Space into a query.

List all available SObjects stored in your org (need to execute Refresh All SObjects Index command) or list all available SObjects into your local project. Only need to press Ctrl + Space

List all fields from an SObject if you write the API Name (And all field related information). Example: Write Account. to show all Account fields.

List all available Record Types from a SObject (Name and DeveloperName) and can replace it to the String value Example: Account.yourRecordTypeName will be transform to 'yourRecordTypeName'. Aura Helper can detect if the suggetion is on a String to put or not the quottes symbol (')

List all picklist values from a SObject field to replace it with the picklist value Example: Account.picklistField__c.picklistValue will be transform to 'picklistValue'. Aura Helper can detect if the suggetion is on a String to put or not the quottes symbol (')

Some utils Snippets (with variants) to create JavaScript unit codes easy. Only need to write js. to show all snippets.

Code Format

Aura Helper can format your code from all Apex Code files (classes and triggers) or any XML Metadata file.

Apex Code Formatter

Aura Helper implements the first exclusive Apex Formatter for VSCode. Only need press Alt + Shift + F to format your files. Also can active Format on Save from VSCode options to format your Apex code when save files.

To addapt your formatting style as you like or need, Aura Helper has to many conficuration options on Extension Settings to change the format style. You can find all Apex format settings on Aura Helper extension preferences (Aura Helper > Apex Format).

Compress XML Files

To help developers to work with Git and reduce merge errors among other things, Aura Helper has two commands to change the XML file format to compress and minify the content with readable humans format and better to handle Git changes and conflicts.

Aura Helper granted always the same order of all XML elements on any file to identify changes better and has an options to select the order of the XML elements on files. Go to Aura Helper > Metadata > Xml Sort Order on extension settings to choose the XML Sort order.

You can compress all XML Files from project or from a folder with AuraHelper: Compress ALL XML Files commands or compress a single file with AuraHelper: Compress XML File. Aura Helper support to compress XML files from other operations to compress affected files.

Metadata Files

To work with all XML Metadata files (among other files), Aura Helper implements to many commands, options and features to work with files, minimize errors and maintance your project consistency and integrity.

Repair Dependencies

To maintenance your local project integrity and cosistency, specialy if you work with git as code master to deploy between environments the Repair Dependencies tool will be helpful.

You can repair all dependecies errors automatically or only check to find errors and repair it manually (if you want). Aura Helper support to check and repair Dependencies errors with Metadata types for all XML Files, from CustomApplications to Worflow files...

To use this feature only need to execut the command AuraHelper: Repair Project Dependencies

When you run the command, Aura Helper will show to you all supported types (included in your local project) to allow to you to choose the Metadata Types to repair (To a better code maintance). Also you can use an .ahignore.json file to ignore some Metadata Types from repair operations.

Ignore Metadata

Like Repair dependencies tool, the Ignore Metadata command has the same porpouse, maintenance your local project integrity and cosistency to deploy it with less errors, specially if work with git.

With this feature, you can ignore (even remove) all Metadata files or Metadata included in files (like some custom labels or workflow rules for example) to avoid to deploy it between environments.

This tool wil be helpful in some cases, like Custom Labels with different values between orgs (like ids) or to remove some User Permissions from Profiles or Permissions sets to avoid change it on the target org amont other use cases.

To ignore metadata, you need an .ahignore.json file to use it with the commands. You can has a single .ahignore.json file into your root project, like .gitignore to use it automatically, or can has several .ahignore.json files, with different names and locations and choose the preferred file when run the command to make the tool more flexible.

Package Generator

Aura Helper has a really powerful Package Generator tool to allow to the users to create Package XML Files (and Destructive Changes files) from several sources to retrieve, deploy or other porpouses.

You can show all available Metadata types in your Local Project or from your Auth Org (including all namespaces data) to choose Metadata Types and elements manually to create the package files.This will be helpful to retrieve only one or several SObject Fields or Validations rules amon others, because Salesforce Org Browser can't do it.

Other important feature from Package Generator is the GIT option as datasource. This option allow to the user to choose two branches, commits or tags to get the code differences and create the Package XML and Destructive Files according the detected changes. With this option, refactor code are really easy to deploy and can maintenance better your App versions.

Finally, Package Generator can merge several package or destructive files into one file by type or merge all files into one single file (to deploy, retrieve or delete data).

Custom Labels Editor

To work better with Custom Labels from VSCode and reduce the Salesforce dependency to develop, Aura Helper provide a Graphic Interafce to edit the Custom Labels Metadata file (must have downloaded into your project) without errors.

You can create, edit, delete and deploy to the Auth Org any Custom Label stored into the file. Aura Helper will be validate any Custom Label field to avoid to put wrong values.

To work with the Custom Labels Editor, go to the Custom Labels file and rigth click on it to choose AuraHelper: Custom Labels Editor option on contextual menu, or execute the command AuraHelper: Custom Labels Editor directly from the Command Palette.

Create Aura files

To simplify work with Aura Components, Aura Helper can create any Aura Component file easy with one command. Only need to go to the Aura Component folder a press right click to view the contextual menu, and choose the AuraHelper: Create Aura File option. Aura Helper will analize the component folder to check for missing files and show the users the available files to create.

All files will be created with a simple default template except the Aura Documentation File, this file will be created automatically with the content of the documentation based on the user defined template. See Aura Documentation section to learn more about Aura Documentation features from Aura Helper.

Compare Metadata

Like other tools, the Metadata Comparator tool are designed to maintenance the local project consistency and help to the users to maintenance the itegrity between environments.

With this feature, you can compare your Local project with the Auth Rrg to detect the Metadata Types that exists on the Auth Org but not exists on your local project. Also can compare two Orgs to get the Metadata Types that exists and not between two orgs.

Retrieve Special Types

Some Metadata Types like Profiles, Permission Sets, Record Types or Translations among others are created by Salesforce on runtime when retrieve it to your local project, according the Metadata Types included into the Package XML files.

To retrieve the entire data files without create the package file or modify any other file Aura Helper has the Retrieve Special Types command to allow to the user to select the special types to retrieve.

When execute the command, Aura Helper will show all available special types to download and allow to the user to select one, several or all types to retrieve.

Also you can choose to Retrieve data only from your Local Project to get and affect only the local metadata types. Retrive from Auth Org to include all available data from your org (including types that no exists on local) or Retrieve Mixed to retrieve only the Metadata Types that exists on yout local project, but will all Org data.

Manage Permissions

Working with Salesforce permissions from VSCode its a risky task. To reduce de errors and make easy edit permissions from VSCode (without dependency from Salesforce) Aura Helper provide two util tools.

Permission Editor

The Permission Editor tool, is a graphic interface to allow the users to edit Permissions file like on Salesforce, with the same validations and depending fields. To use it, go to the permissions files (Profile, Permission Sets or Muting Permission Sets) and press right click to open contextual menu and select AuraHelper: Permission Editor or open the files on editor a execute the command AuraHelper: Permission Editor from command palette.

The permission editor tool has the same behaviour than salesforce with fields validations and controlled fields. For example, if you choose ModifyAll permission to one object, Aura Helper will select Automatically the Read, Create, Edit and ViewAll Permissions like Salesfoce (works equals if you unselect permissions)

Modify Permissions

If the Permission Editor tool allow to the user to edit the permissions files, the Modify Permissions tool allow to the user to modify the permissions from any available Metadata Types. For example, in Permission Editor you can edit one permission to edit one or several Apex Classes permissions to the selected file. With the Modify Permissions tool yo can choose one Apex file to modify permissions on one or several permissions files.

To use this tool you can choose one file from the File Explorer and press right click to open contextual menu, an select AuraHelper: Modify Permissions and Aura Helper will show to you all available permissions Types (Profiles, Permissions Sets...) and allow the user to edit the permissions on all selected files.

Like the Permission Editor, the Modify Permissions tool has the same behaviour of Salesfoce with validations and controlled fields. For example, if you choose ModifyAll permission to one object, Aura Helper will select Automatically the Read, Create, Edit and ViewAll Permissions like Salesfoce (works equals if you unselect permissions)

Version Control

Aura Helper are specially designed to work with GIT and DevOps workflows and has powerful tools to this porpouses.

Packages from GIT

The Package Generator tool can connect with git an analize differences to find all created, edited and delete Metadata files (and types). When run the package generator, select GIT option to allow to the user to choose two branches, commits or tags to get the code differences and create the Package XML and Destructive Files according the detected changes. With this option, refactor code are really easy to deploy and can maintenance better your App versions.

Merge Packages Files

Other importan feature from Package Generator tool, is the ability to merge several package and destructive files (all that you need) into one file by type. For example, you can choose three Package XML Files, five Destructive before deploy and two Destructive after deploy, and Aura Helper will be merge all files into only one Package XML with data Package XML files data, and the same with before and after destuctive files.

Also, you can merge all files into only one file. For example, you can select the same files of the las example, but merge all files into only one Package XML File with the content of all files (incluid destructives) or can merge all files into one Destructive XML before or after deploy.

Other Tools

Other tools like Ignore Metadata or Repair Dependencies can be used to maintance a version control and Project Metadata Integrity. With Metadata Comparator you can compare metadata Between orgs or local and org to check if all is correc. The Manage Permissions tools can help to you to maintance Salesforce Permissions into your local project, without Salesforce org.

Outline View

Aura Helper implements features to the VSCode Output Panel to analize the structure of to many files. Aura Helper provide outline information to Apex Code (Classes and Triggers), Aura Components (Components, Events and Applications), JavaScript Aura Files (Controller.jd and Helper.js) and all XML Metadata files from any Metadata Type.

Apex Code Outline

The Apex Outline provide information about any Apex Code file, like Classes, Interfaces, Triggers... You can view all Apex Nodes in a tree view to analize better any Apex file. Aura Helper will be show all fields, constants, methods, method parameters, method variables and to much information for any Apex File. Yo can click on any node to go to it on the file. Provide more and better information than the Salesforce Outline View.

Aura Componets Outline

The Aura Outline provide information about any Aura Component, Application or Event. You can show all Aura Attributes, Registered events, dependencies... and much more from any Aura file. You can click on any node to go to it on the file.

Aura JavaScript Outline

The Aura JavaScript Outline provide information the Controller and Helper JavaScript files. You can see al declared method on the files and click on any method to go to it on the file.

Metadata XML Files

The Metadata XML Outline provide information of any XML Metadata file. You can select any XML File to view the file structure, tags, values and more. You can click on any XML Element to go to it on the file.

Documentation

To Help to the users with the boring documentation tasks, Aura Helper provide helpful tools to create documentation faster and with a few clicks.

Apex Comments

Aura Helper provide the best Apex Comments system because you can define your own comment template to create comments automatically based on the template. You can addapt the template to the preferred format to create the comments only with write /** and Aura Helper will be create the entire comment with the selected information based on the created template.

The Apex Comment Template system is a really powerful system because allow to the users to create their own custom tags with to many datasources to create the comments and replace the tags with the selected data. For example, you can define your oun @author tag with named @creator, and select Salesforce username as datasource to replace the @creator tag template automatically with the specified data. Work like JavaDoc, but allow to the users to customize the comments.

Apex Documentation

If you write all your Apex Comments following the defined template, Aura Helper can extract all information from the comments and tags to create a Navigable HTML documentation with the Apex Classes data and the comment information.

The documentation will be generated with all classes, and will be grouped into Apex Classes, Test Classes, Interfaces, Enums, Scheduled Classes, Rest Classes, Batch Classes and Queueable Classes to a better organization.

To create the Apex Documentation, only need to run the comment AuraHelper: Create Project Documentation.

Aura Documentation

Like with Apex Documentation, Aura Helper can create the Aura Documentation file for any component with a few clicks based on a user defined template. If you comment the Controller and Helper files with the Standard Javascript comment schema, Aura Helper can extract the data to include it into the Aura Documentation.

To create the Aura Documentation only need to run the command AuraHelper: Generate Aura Documentation with the Aura doc file active, or can select the file and rigth click to open contextual menu and select AuraHelper: Generate Aura Documentation. When you execute the command Aura Helper: Create Aura File and choose Aura Documentation file, Aura Helper will create the file with the documentation generated.

And too much more

Go to Aura Helper Extension Documentation to learn more about the extension and all features.

Aura Helper Framework

Aura Helper Extension is powered by the new Aura Helper Framework. This framework are stable, faster and the code are tested about 90-95%. The framework is created like a tool to all Salesforce Developers to create its own Salesfoce Application with nodeJS. To get more information about the framework Click Here.

Contributions

Code:

Juan Jose Longoria López - Kanko ([email protected])

Logo Design:

Isabel García Sánchez - Ib ([email protected]).
New Icons from Microsoft

aura-helper's People

Contributors

Stargazers

Watchers

Forkers

elloserafim lukaszhanusik nikhilvarghese963 benjaminloerincz leenaleen8686

aura-helper's Issues

Apex formatter issues: logical operators wrong formatted

Juan Jose, nice work!
while evaluating your VSCode extension I found one issue preventing me from using the Apex formatter all day. Logical operators like && or || are formatted to & & or | | with a blank between.

Btw. another small issue: something + (something else) is formatted to something +(something else), where blank is missing between "+(".

If this would be fixed I would be very happy.

Extension issue

Issue Type: Bug
Extension Name: aura-helper
Extension Version: 1.9.4
OS Version: Windows_NT x64 10.0.18363
VSCode version: 1.44.2

⚠️ We have written the needed data into your clipboard. Please paste! ⚠️

Is there a way to configure the formatting feature?

The feature to format my Apex code is great since this seems to be the only one available. However, a mild annoyance is that it deletes the space in between an if and the open parenthesis. For example, if (condition) becomes if(condition). This goes against my company code style so I would like to be able to configure this. Weirdly enough, it doesn't do this for for loops.

Extension causes high cpu load

Issue Type: Performance
Extension Name: aura-helper
Extension Version: 4.2.0
OS Version: Windows_NT x64 10.0.19044
VS Code version: 1.68.0

⚠️ Make sure to attach this file from your home-directory:
⚠️file:///c%3A/Users/vlettau/AppData/Local/Temp/Kanko.aura-helper-unresponsive.cpuprofile.txt

Find more details here: https://github.com/microsoft/vscode/wiki/Explain-extension-causes-high-cpu-load

Issue with Package.xml Generator

I have a query regarding the package.xml generator feature. Aura helper documentation suggests:-
"Create package and destructive files quickly with the powerful Package Generator. Select metadata manually or create the files from two git branches, commits or tags differences.".
Could anyone guide me on how can I create a Package.xml from the difference between the two branches?

Also, advanced GUI doesn't seem to work on windows. I have already enabled advanced GUI from aura helper settings but it is not working. Can someone guide me if I am missing something?

Thanks

ORDER BY clause is wrongly formatted in dynamic SOQL

Hi, it seems the white space between a bind variable and the "ORDER" key word is removed on formatting if "aurahelper.apexFormat.query.oneClausePerLine" is set to false.
The bellow exemple replicates the issue on my VSC:
public class SomeClass{ public void someMethod(){ String someString = 'some'; SomeSObject__c[] lSObject = [SELECT Id FROM SomeSObject__c WHERE SomeField__c = :someString ORDER BY SomeOtherField__c DESC]; } }

It becomes:
public class SomeClass{ public void someMethod(){ String someString = 'some'; SomeSObject__c[] lSObject = [SELECT Id FROM SomeSObject__c WHERE SomeField__c = :someStringORDER BY SomeOtherField__c DESC]; } }

I don't have the issue if "aurahelper.apexFormat.query.oneClausePerLine" is set to true
Hope this feedback can be helpful!

Custom sObjects Invalid After Formatting

I love this extension and use it frequently during my day-to-day coding. I've experienced a strange bug that interrupts my work, though. When we declare a custom sObject in the first line of a scope, and then format the document, the declaration syntax is messed up and the file cannot be saved. Here's an example:

private void BeforeFormat() {
     CustomObject__c exampleA = new CustomObject__c();
     CustomObject__c exampleB = new CustomObject__c();
}

private void AfterFormat() {
     CustomObject__cexampleA = new CustomObject__c(); // Notice the missing space
     CustomObject__c exampleB = new CustomObject__c(); // Space is still there in Line 2
}

Since this only impacts the very first line, I've had to use this workaround:

private void BeforeFormat() {
     // Some random comment will prevent formatting errors
     CustomObject__c exampleA = new CustomObject__c();
     CustomObject__c exampleB = new CustomObject__c();
}

private void AfterFormat() {
     // Some random comment will prevent formatting errors
     CustomObject__c exampleA = new CustomObject__c(); // Space is still there
     CustomObject__c exampleB = new CustomObject__c();
}

This issue also occurs in the first line of any compound statement. for (...) { CustomObject__c example = new CustomObject__c(); } will become for (...) { CustomObject__cexample = new CustomObject__c(); }

Since this impacts the entire document, it is difficult and annoying to fix manually and use comments to work-around in every instance. Is this a settings issue on my end or a bug that needs to be fixed? Any help is appreciated!

not able to format instanceof operator

Hi,
when i format code using aura-helper it is not able to format insteadof operator.
if i format bellow code
if (fieldName != null && !(fieldName instanceOf Map<String, Object>)){
than
it's format like
if (fieldName != null && !(fieldNameinstanceOfMap<String, Object>)){

please suggest if there any configration is need to do to fix this.

Lines between methods and class attributes removed

Hello, sorry to interrupt again.

Since last version I noticed that lines between methods and/or class attributes are removed, regardless of the newLinesBetweenCodeBlockMembers setting.
Is this a behavior you can replicate on your side as well?
For instance, if I format this code:

public class TestClass {

	static boolean bool1 = false;



	static boolean bool2 = true;

	
	public static void test1(String test1) {
	}
	
	public static void test2(String test2) {
	}
}

I will get this result, despite newLinesBetweenCodeBlockMembers = 1 :

public class TestClass {
	static boolean bool1 = false;
	static boolean bool2 = true;
	public static void test1(String test1) {
	}
	public static void test2(String test2) {
	}
}

I would more have expected this result, if I am not wrong?

public class TestClass {
	static boolean bool1 = false;

	static boolean bool2 = true;

	public static void test1(String test1) {
	}

	@AuraEnabled
	public static void test2(String test2) {
	}
}

One Projection Clause Per Line - request

Hi,
awesome extension but I have one request if its possible about formatting SOQL.
Can we have setting to format conditions to be one per line.

Before
WHERE Name = '' OR Name = '' AND Name = ''];
After

WHERE Name = '' 
 OR Name = ''  
 AND Name = ''];

Something like this will be great.
Thanks alot

space still be removed

Apex variable declaration When formatting, the variable and the space in the middle will be removed
EmailTemplate validEmailTemplate = new EmailTemplate();
fomatted
EmailTemplatevalidEmailTemplate = new EmailTemplate();

Formatting issue - Unclear problem

Hi,

We were able to format the document like this before:

But now, if I format the document, the result is like this. I'm not sure how to describe the issue here but

Line breaks were made even where they were not required

Before Format
public Attachment attachment1 {get;set;}

Wanna to Format
public Attachment attachment1 { get; set; }

After Formated
public Attachment attachment1 {
get;
set;
}

Trigger - space before 'on' keyword gets removed

Hi there, a little issue I ran into.

My current triggers look like this:

However when I run the formatter it turns into this:

Looks like the space before the 'on' keyword just gets removed, and I've tried a lot of combinations from the extension config.

No longer working for VSCode?

Aura-helper no longer shows up when I start a comment block with /** . Entering command AuraHelper: Edit Apex Comment Template shows error "An error occurred while processing command. Error: TypeError: str.split is not a function" and doesn't do anything. Not sure what I'm missing...

Refresh all SObject Definitions fails

SFDX: Refresh SObjects works with no problem. However, when I try to use AuraHelper: Refresh All SObject Definitions I get an undefined error.

The output of Aura Helper console is simply

With latest version - formatting an apex code doesn't allow to enter blank lines

Max Field Projections on SOQLs instead of One Projection Field Per Line

First of all, thanks for this awesome extension! It is helping our team a lot on our development process formatting Apex code!

This is a suggestion for an improvement on an existing feature (One Projection Field Per Line).

For now, if this setting is enabled, the SOQL fields are separated into different lines and if it is disabled, the fields are concatenated in the same line.

Would you consider changing this setting to allow the developer to choose the maximum number of fields on each line? For large SOQLs (with more than 10 fields selected, for example) the line ends up being too large and separating each field on a different line makes the code too large.

This feature could be very useful this way:

The user sets the maximum number of fields per line on an SOQL (for this example, 3 fields).
The query gets formatted this way:

Before formatting:

[SELECT Id, CreatedDate, LastModifiedById, LastModifiedDate, CreatedById, OwnerId, Phone__c, Email__c FROM Account]

After formatting:

[SELECT Id, CreatedDate, LastModifiedById,
  LastModifiedDate, CreatedById, OwnerId,
  Phone__c, Email__c
  FROM Account]

This would greatly reduce the line sizes while keeping the code on a managed size as well.

Let me know what do you think of this feature improvement and if it is possible to implement :)

Once again, thanks for your awesome work! 👍

Lowercase require causes problem with case sensitivity on Ubuntu LInux

Thank you for the amazing work, this is an extension I am looking forward to try.
But I am unable to activate the extension and it does not work on my computer for a reason that others may experience.
In my extension log (exthost.log) it reads:

[2020-09-01 19:04:01.750] [exthost] [info] eager extensions activated
[2020-09-01 19:04:18.998] [exthost] [info] ExtensionService#_doActivateExtension Kanko.aura-helper {"startup":false,"extensionId":{"value":"Kanko.aura-helper","_lower":"kanko.aura-helper"},"activationEvent":"workspaceContains:sfdx-project.json"}
[2020-09-01 19:04:18.998] [exthost] [info] ExtensionService#loadCommonJSModule file:///home/ello/.vscode/extensions/kanko.aura-helper-2.2.1/extension.js
[2020-09-01 19:04:19.060] [exthost] [error] Activating extension Kanko.aura-helper failed due to an error:
[2020-09-01 19:04:19.063] [exthost] [error] Error: Cannot find module './nodes/fornode'
Require stack:
- /home/ello/.vscode/extensions/kanko.aura-helper-2.2.1/resources/scripts/languages/apex/parser.js
- /home/ello/.vscode/extensions/kanko.aura-helper-2.2.1/resources/scripts/languages/apex/index.js
- /home/ello/.vscode/extensions/kanko.aura-helper-2.2.1/resources/scripts/languages/index.js
- /home/ello/.vscode/extensions/kanko.aura-helper-2.2.1/resources/scripts/providers/utils.js
- /home/ello/.vscode/extensions/kanko.aura-helper-2.2.1/resources/scripts/providers/apexCompletionProvider.js
- /home/ello/.vscode/extensions/kanko.aura-helper-2.2.1/resources/scripts/providers/index.js
- /home/ello/.vscode/extensions/kanko.aura-helper-2.2.1/extension.js
- /snap/code/42/usr/share/code/resources/app/out/vs/loader.js
- /snap/code/42/usr/share/code/resources/app/out/bootstrap-amd.js
- /snap/code/42/usr/share/code/resources/app/out/bootstrap-fork.js
	at Function.Module._resolveFilename (internal/modules/cjs/loader.js:764:15)
	at Module._load (internal/modules/cjs/loader.js:669:27)
	at Module._load (electron/js2c/asar.js:717:26)
	at Function.Module._load (electron/js2c/asar.js:717:26)
	at Function.t._load (/snap/code/42/usr/share/code/resources/app/out/vs/workbench/services/extensions/node/extensionHostProcess.js:1005:775)
	at Function.i._load (/snap/code/42/usr/share/code/resources/app/out/vs/workbench/services/extensions/node/extensionHostProcess.js:975:661)
	at Function.n._load  [...]
	at /snap/code/42/usr/share/code/resources/app/out/vs/workbench/services/extensions/node/extensionHostProcess.js:612:374
	at processTicksAndRejections (internal/process/task_queues.js:85:5)
	at async h.$activate (/snap/code/42/usr/share/code/resources/app/out/vs/workbench/services/extensions/node/extensionHostProcess.js:882:193)

(I am abbreviating the log here)

It happens that in repo file aura-helper/resources/scripts/languages/apex/parser.js/ line 27 ForNode module is imported like 'fornode' :

const WhileNode = require('./nodes/whileNode');
const ForNode = require('./nodes/fornode');    //  * Note all lowercase here *
const ForeachNode = require('./nodes/foreachNode');

whereas the file name is ./node/forNode.js, like other files in the same folder. This may note be a problem on Windows, but it may cause problems on case-sensitive systems.

Can't format Apex

When I try to fotmat an apex cls file , An error that "cant read the 'public' property " happened .

Extension issue

Issue Type: Bug
Extension Name: aura-helper
Extension Version: 4.2.2
OS Version: Windows_NT x64 10.0.19044
VS Code version: 1.71.0

⚠️ We have written the needed data into your clipboard. Please paste! ⚠️

Format issue when using the ".class" keyword in class

Hello,

I noticed an issue lately, it seems whenever I have the ".class" keyword in a class, the formatting is not reacting well in the rest of the class after.
See for instance this code example

public class TestClass {
	private static final String CLASS_NAME = Testclass.class.getName();
	public static void testMethod() {
		TAD.testMeth(CLASS_NAME);
		if (true) {
			String someVar = '1';
		}else {
			String someVar = '2';
		}
		if (false) {
			String someVar2 = 'A';
		}
		return rtrn;
	}
}

When I format it, it becomes :

public class TestClass {
	private static final String CLASS_NAME = Testclass.class.getName();
	public static void testMethod() {
		TAD.testMeth(CLASS_NAME);

		if (true) {
			String someVar = '1';
		}

		 else {
			String someVar = '2';
		}

		if (false) {
			String someVar2 = 'A';
		}

		return rtrn;
	}
}

It's inserting extra line breaks that I'm not expecting given my setup. This is the result I expect (see here, I simply remove the ".class" reference in the line 2):

public class TestClass {
	private static final String CLASS_NAME = Testclass.getName();

	public static void testMethod() {
		TAD.testMeth(CLASS_NAME);
		if (true) {
			String someVar = '1';
		} else {
			String someVar = '2';
		}
		if (false) {
			String someVar2 = 'A';
		}
		return rtrn;
	}
}

For the record, my project setup is as following:
{
"aurahelper.apexFormat.classMembers.newLinesBetweenClassFields": 0,
"aurahelper.apexFormat.classMembers.newLinesBetweenCodeBlockMembers": 1,
"aurahelper.apexFormat.classMembers.newLinesBetweenGetterAndSetterAccessor": 1,
"aurahelper.apexFormat.classMembers.singleLineProperties": true,
"aurahelper.apexFormat.comment.holdAfterWhitespacesOnLineComment": true,
"aurahelper.apexFormat.comment.holdBeforeWhitespacesOnLineComment": true,
"aurahelper.apexFormat.comment.newLinesBewteenComments": 0,
"aurahelper.apexFormat.operator.addWhitespaceAfterOpenParenthesisOperator": false,
"aurahelper.apexFormat.operator.addWhitespaceAfterOperator": true,
"aurahelper.apexFormat.operator.addWhitespaceBeforeCloseParenthesisOperator": false,
"aurahelper.apexFormat.operator.addWhitespaceBeforeOperator": true,
"aurahelper.apexFormat.punctuation.addNewLineAfterCloseCurlyBracket": false,
"aurahelper.apexFormat.punctuation.addWhitespaceAfterCloseCurlyBracket": true,
"aurahelper.apexFormat.punctuation.addWhiteSpaceAfterComma": true,
"aurahelper.apexFormat.punctuation.addWhitespaceAfterOpenGuardParenthesis": false,
"aurahelper.apexFormat.punctuation.addWhitespaceBeforeCloseGuardParenthesis": false,
"aurahelper.apexFormat.punctuation.addWhitespaceBeforeOpenCurlyBracket": true,
"aurahelper.apexFormat.punctuation.addWhitespaceBeforeOpenGuardParenthesis": true,
"aurahelper.apexFormat.punctuation.addWhitespaceBeforeOpenTriggerEvents": true,
"aurahelper.apexFormat.punctuation.maxBlankLines": 2,
"aurahelper.apexFormat.punctuation.openCurlyBracketOnNewLine": false,
"aurahelper.apexFormat.query.maxProjectionFieldPerLine": 0,
"aurahelper.apexFormat.query.oneClausePerLine": false
}

I hope this contribution can be helpful

Can't format inner class variable

When a variable of an inner class is declared, spaces are deleted.

Refreshing Apex Classes Definitions keep loading

After the update of vsCode and the aura-helper plugin, in the status bar has appeared this "refreshing apex classes definitions" that never stops. I've installed npm and the Aura-helper CLI, at the moment I use both ForceCode and SFDX.

Recommend Projects

React

A declarative, efficient, and flexible JavaScript library for building user interfaces.
Vue.js

🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript

TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
TensorFlow

An Open Source Machine Learning Framework for Everyone
Django

The Web framework for perfectionists with deadlines.
Laravel

A PHP framework for web artisans
D3

Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

javascript

JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
web

Some thing interesting about web. New door for the world.
server

A server is a program made to process requests and deliver data to clients.
Machine learning

Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Visualization

Some thing interesting about visualization, use data art
Game

Some thing interesting about game, make everyone happy.

Recommend Org

Facebook

We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft

Open source projects and samples from Microsoft.
Google

Google ❤️ Open Source for everyone.
Alibaba

Alibaba Open Source for everyone
D3

Data-Driven Documents codes.
Tencent

China tencent open source team.

jjlongoria / aura-helper Goto Github PK

aura-helper's Introduction

Table of Contents

Code:

Logo Design:

aura-helper's People

Contributors

Stargazers

Watchers

Forkers

aura-helper's Issues

Recommend Projects

Recommend Topics

Recommend Org