Difference between revisions of "HowTo Guides"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Β 
(149 intermediate revisions by the same user not shown)
Line 2: Line 2:
__TOC__
__TOC__
==For Users==
==For Users==
These guides tell you how to get the most out of the platform. You should be familiar with the [[Navigating the User Interface|User Interface]].
These guides tell you how to get the most out of the platform. You should be familiar with the [[Agent Portal]].


===Perform Basic Operations===
===Platform Access===
:* [[HowTo:Login When You Forgot Your Password|Login When You Forgot Your Password]]
:* [[HowTo:Login When You Forgot Your Password|Login When You Forgot Your Password]]
:* [[HowTo:Change Your Password|Change Your Password]]
:* [[HowTo:Change Your Password|Change Your Password]]
===Basic Operations===
:* [[HowTo:Search a View to Find Records|Search a View to Find Records]]
:* [[HowTo:Search a View to Find Records|Search a View to Find Records]]
:* [[HowTo:Filter a View to Restrict the Records it Displays|Filter a View to Restrict the Records it Displays]]
:* [[HowTo:Filter a View to Restrict the Records it Displays|Filter a View to Restrict the Records it Displays]]
Β 
:* [[HowTo:Generate Printable PDFs for Views, Records, and Reports|Generate Printable PDFs for Views, Records, and Reports]]
===Perform Specialized Operations===
:* [[HowTo:Create, Test, and Run an Email Campaign|Create, Test, and Run an Email Campaign]]


===Customize Your Interface===
===Customize Your Interface===
:* HowTo:Create a [[Dashboard]]
<!--:* Future Guide:Create a custom [[Dashboard]] (Dashboard) for an application, to see things at a glance.-->
:* HowTo:Filter a Record [[View]]
<!--POSSIBLE: Add the [[Notes widget]] to the dashboard-->
:* HowTo:Modify a [[Report]]
<!--:* Future Guide:Filter a Record [[View]]
:* HowTo:Customize Your [[Workspace]]
:* Future Guide:Modify a [[Report]]
:* HowTo:Display a Widget in the Home Page
:* Future Guide:Customize Your [[Workspace]]
:* HowTo:Display a Widget in the Sidebar
-->
:* [[Integrating with SalesForce]]


===Manage Your Data===
===Manage Your Data===
:* HowTo:Import Data
<!--:* [[HowTo:Create a Project|Create a Project]]-->
:* HowTo:Remove Recently Imported Records
:* [[HowTo:Use the Application Wizard to Build a Simple Order Processing System|Use the Application Wizard to Build a Simple Order Processing System]]
:* HowTo:Send an email when a record is created or updated, using a [[Data Policy]]
:* [[HowTo:Import Data from an External System|Import Data from an External System]]
<!--:* Future Guide:Remove Recently Imported Records
:* Future Guide:Send an email when a record is created or updated, using a [[Data Policy]]
-->
Β 
===Specialized Operations===
Β 
:* [[HowTo:Create a Database View to Join Data from Related Objects|Create a Database View to Join Data from Related Objects]]
:* [[HowTo:Create a Report based on a Database View|Create a Report based on a Database View]]


==For Application Designers==
==For Application Designers==
These guides tell you how to create and customize applications. You should be familiar with one or more of HTML coding, CSS formatting, or [[JavaScript]], and be familiar with the [[Platform Interface]].
When you create an application, much is done ''for'' you. The platform automatically constructs record views, forms for adding and updating data, and basic reports. From there, you can begin to customize the application. These guides tell you how to do that. Ideally, you should be familiar with HTML coding and CSS formatting, and be adept at [[Using the Agent Portal]].


===Customize the Application Interface===
For information on design options and step-by-step instructions, that you can use as a template when building your own applications, see [[Article Index]].
:* [[HowTo:Create a Custom Sidebar Using Graphic Images|Create a Custom Sidebar Using Graphic Images]]
:* HowTo:Collect Data from an External Web Site using [[Web Forms]]
:* HowTo:Create a [[Site]] that anyone can access without logging into the platform


=== Build and Customize Applications===
===Beginner===
:* HowTo:Quickly Build a [[Sample Order Processing System]]
These guides do not require you to write any code.
::Notes:
:* [[HowTo:Create an Object|Create an Object]] Β 
::* DONE FOR YOU: List view of records, forms to add and update data, basic reports
:* [[HowTo:Compute a Date Value in a View or Report|Compute a Date Value in a View or Report]]
:* HowTo:Calculate values using data in [[Related Record|''Related'' Records]] ([[Subform]]s)
:* [[HowTo:Case Creation from Mobile Devices|Case Creation from Mobile Devices]]
:* HowTo:Automate a standard business process by creating a [[Workflow]]
:* [[HowTo:Send Messages to Multiple Recipients|Send Messages to Multiple Recipients]]
:* HowTo:Automatically take action when Object data changes with an Event-Based [[Data Policy]]
:* HowTo:Automatically take action on specified dates with a Calendar-Based [[Data Policy]]


==For Platform Developers==
===Intermediate===
These guides tell you how to program the platform APIs to take advantage of advanced platform features. You should be familiar with one or more of [[Java]], [[JavaScript]], [[AJAX and REST|AJAX]], [[SQL Syntax|SQL]], or [[REST]].
These guides may require a bit of [[JavaScript]] code. Familiarity is a plus.
:* [[HowTo:Display Customer Data in an Order as a Read-Only Field|Display Customer Data in an Order as a Read-Only Field]]
:* [[HowTo:Add a Custom Print Button to a Form|Add a Custom Print Button to a Form]]
:* [[HowTo:Create Application-Specific Help|Create Application-Specific Help]]
Β 
This one requires a bit of Java hacking:
:* [[HowTo:Send Notification Messages to Followers|Send Notification Messages to Followers]]
Β 
See the [[Java Code Samples]] for more great projects.
Β 
==For Application Developers==
These are advanced topics that require familiarity with Java code.


===Set up Your Environment===
=== Build Custom Web Pages ===
:* HowTo:Develop Safely Using Sandboxes (and use them for backups)
:* [[HowTo:Use AJAX and REST in a Web Page to GET data|Use AJAX and REST in a Web Page to GET data]]
:* HowTo:Deploy Your Work Using Packages (and use them for backups)
:* [[HowTo:Use AJAX and REST in a Web Page to POST data|Use AJAX and REST in a Web Page to POST data]]
:* HowTo:Do Unit Testing in the Platform
:* HowTo:Develop in Eclipse
:* HowTo:Develop in Teams Using a Version Control System
:* HowTo:Debug using Eclipse


===Customize Application Pages===
===Customize Applications===
:* HowTo:Create a JSP Page using Java, or JavaScript and REST
:* [[Lab Exercises#Basic Programming Exercises|Basic Programming Exercises: A Simple JSP Page and a Java Controller]]
::* HowTo:Make a JSP Page into a Web Tab
:* [[HowTo:Classes, APIs, and Naming Conventions|Classes, APIs, and Naming Conventions]]
::* HowTo:Make a JSP Page into a Widget
:* [[HowTo:Create_a_JSP_Page_and_Java_Controller|Create a JSP page and Java Controller]] (more advanced)
:* HowTo: Create a Back-end Controller for a JSP Page
:* [[HowTo:Use a SQL Query to List Records in a Custom Page|Use a SQL Query to List Records in a Custom JSP Page]]
:* [[HowTo:Use a SQL Query to List Records in a Custom Page|Use a SQL Query to List Records in a Custom Page]]
:* [[HowTo:Protect Your Users by Ensuring that Data Never Executes as Code|Protect Your Users by Ensuring that Data Never Executes as Code]]
:* HowTo:Use SQL Queries and Java Sets to Get the Inverse of a Complex Query
:: Notes:
::* E.g. All orders last month that do ''not'' include product X. (No related OrderItems point to that product.)
::* Easier to query for orders that do, set-subtract from all orders using <tt>HashSet(HashMap)</tt> constructors and the <tt>set.removeAll(set)</tt> method.
::* Similarly: Use Set Intersection to find all orders that include product X and product Y, using the <tt>set.retainAll(set)</tt> method.


===Tackle Advanced Projects===
===Tackle Advanced Projects===
:* [[HowTo:Handle Incoming Emails Programmatically|Handle Incoming Emails Programmatically]]
:* [[HowTo:Use a Java Method to Validate Incoming Data|Use a Java Method to Validate Incoming Data]]
:* HowTo:Write Programs that Use the [[REST API]]s
:* [[HowTo:Create a Data Handler to Add Data to a Package|Create a Data Handler to Add Data to a Package]]
:* [[HowTo:Use the HttpConnection Class to access a web service|Use the HttpConnection Class to access a web service]]
<!--
==For Platform Developers==
These guides tell you how to program the platform APIs to create even more sophisticated applications. You should be familiar with one or more of [[Java]], [[JavaScript]], [[AJAX and REST|AJAX]], [[SQL Syntax|SQL]], and [[REST]].


<!--{{#if: {{ShowIsvInfo}} |
===Set up Your Environment===
==For ISVs==
:* Future Guide:Develop using the [[Eclipse Plug-In]]
:* ...
:* Future Guide:Use the [[Debug Log]] effectively
}}-->
--><!--
<!--noinclude>
ToDo:
Finish construction of the Trace object:
Β  - Implement the reflection bits needed to unpack HashMaps & Lists
Β  - Add XML pretty printing.
--><!--
:* Future Guide:Use the Platform's [[Unit Test Framework]]
:* Future Guide:Debug using Eclipse


[[Category:Help]]
:* Future Guide:Develop Safely Using [[Sandboxes]] (and use them for backups)
</noinclude-->
:* Future Guide:Deploy Your Work Using [[Packages]] (and use them for backups)
:* Future Guide:Develop in Teams Using a Version Control System
-->

Latest revision as of 06:51, 21 March 2018

Bookmark this page: https://agileappscloud.info/aawiki-src/HowTo

For Users

These guides tell you how to get the most out of the platform. You should be familiar with the Agent Portal.

Platform Access

Basic Operations

Customize Your Interface

Manage Your Data

Specialized Operations

For Application Designers

When you create an application, much is done for you. The platform automatically constructs record views, forms for adding and updating data, and basic reports. From there, you can begin to customize the application. These guides tell you how to do that. Ideally, you should be familiar with HTML coding and CSS formatting, and be adept at Using the Agent Portal.

For information on design options and step-by-step instructions, that you can use as a template when building your own applications, see Article Index.

Beginner

These guides do not require you to write any code.

Intermediate

These guides may require a bit of JavaScript code. Familiarity is a plus.

This one requires a bit of Java hacking:

See the Java Code Samples for more great projects.

For Application Developers

These are advanced topics that require familiarity with Java code.

Build Custom Web Pages

Customize Applications

Tackle Advanced Projects