Opening paragraph
Accessing Under-The-Hood
Before working with the PlanSwift API, a good understanding of PlanSwift's internal structure is recommended. To review PlanSwift's structure, the under-the-hood (U-T-H) tab needs to be enabled.
Warning |
---|
By modifying or changing anything in the back end, you may adversely affect the operation of PlanSwift. Modifications should be done in a read-only mode. If any modifications are done to the back end of PlanSwift, those modifications will be lost when PlanSwift is re-installed. |
Follow these steps to enable PlanSwift's under-the-hood U-T-H tab.
- Open PlanSwift.
- Click on Settings along the top ribbon bar (see #1 on Figure 1-1 below).
- Select Interface from the options on the left (see #2 on Figure 1-1 below).
- Click on Show Under the Hood Screen. (see #3 on Figure 1-1 below).
Figure 1-1 - For the password, please contact your PlanSwift representative–discuss with Mike Ramsey. Enter the password (see number #4 of Figure 1-1) and click on Ok. To obtain the password, send an email to devnetwork@planswift.com.
- An U-T-H (for "Under-the-Hood") now appears on the top ribbon bar (see the red arrow in Figure 1-2). Click on U-T-H.
Figure 1-2
Understanding the Under-The-Hood hierarchy
Clicking on U-T-H tab displays the Under-The-Hood (U-T-H) hierarchy. PlanSwift (1.0) is the root, or the parent object. Each of the folders beneath PlanSwift is a child of PlanSwift.
Figure 1-3
1.0 PlanSwift Root
Double-click on PlanSwift (see red arrow of Figure 1-4) to open the Advanced Properties window for the PlanSwift root object.
Simple Description
API Call:
planswift
planswift.root
Use "\" (without the quotes) to access the root object.
Figure 1-4
2.0 Settings
Accessing PlanSwift Settings
Settings are the root setting for PlanSwift. They are the default configuration settings for PlanSwift and can be written, read, and modified. Custom settings can also be added. To obtain the Advanced Properties of Settings, double click on Settings (red arrow in Figure 2-1).
API Calls:
Code Block | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
private void Main()
{
PlanSwift planswift = new PlanSwift();
IItem settings = planswift.GetItem(@"\Settings");
} |
Code Block | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
procedure main;
var
planswift: IPlanSwift;
settings: IItem;
begin
planswift := coPlanSwift.Create();
settings := planswift.getItem('\Settings');
end |
Code Block | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
Sub main()
Dim planswift = CreateObject("PlanSwift9.PlanCenter")
Dim settings = planswift.GetItem("\Settings")
End Sub |
1
begin
settings := PlanSwift.getItem('\Settings');
end
Figure 2-1
See Figures 2-2, 2-3, and 2-4 for the Settings Advanced Properties window. All of the available Settings items are displayed in these three figures. API calls for each of these are covered below in the order of the red arrowed numbers.
Figure 2-2
Figure 2-3
-4