AAPI Quick Start Guide

Contact Support

Customizing Your Default Dashboard for the New Cycle

In Outcomes, each institution has its own Default Dashboard, allowing teams to see the information that is most relevant to them. You also can adjust your Dashboard to customize it to your preferences.  Changes made to the Default Dashboard apply to all users on your side who have not customized their own Dashboard. To update the Default Dashboard when a new cycle begins:

1. From the Navigation Menu, click Reporting.
2. Select your Default Dashboard report.
   
   
3. Click the Edit pencil at the top right.
   
   
4. Adjust the Program dropdown by selecting the current cycle. This filters the data that is used on your Dashboard, so that it only includes the selected cycle.
   
   
5. Click Save Changes. The Default Dashboard now updates with the applicable data.

Customizing Your Own Dashboard for the New Cycle

If you prefer to update your own Dashboard, rather than applying changes to the shared Default Dashboard, follow these steps:

1. Click My Dashboard from the Navigation Menu.
2. Click the Edit pencil to customize your Dashboard.
   
   
3. Adjust the Program dropdown by selecting the current cycle. This filters the data that is used on your Dashboard, so that it only includes the selected cycle.
   
   
4. Click Save Changes. Your Dashboard now updates with the applicable data.

Updating the Desired Program of Interest Chart

By default, there is a Desired Program of Interest chart on your Dashboard indicating what applicants have selected on the application when asked to identify the program they are interested in. Each cycle's application has a new version of this question, so for this chart to contain current data, you'll need to point it to the most recent version. To update the chart:

1. Click Reporting from the Navigation Menu, and select your Default Dashboard.
   
   
2. Click the Edit pencil.
   
   
3. Locate the Desired Program of Interest chart and click the dropdown filter.
   
   
4. Search for "cq" to locate this custom question. It appears near the bottom under the label Custom Form Phase Applicants 2022. Click the cq_ code to select it.
   
   
5. The chart now updates, using the data from the most recent version of this question.
6. Click Save Changes at the top of the page.

Accessing Phase II Applications

Once Phase II begins, you can review Phase II applications. To access this group of applications:

1. Navigate to the Applications Grid and use the Program filter to select Phase II Applicants.
   
   
2. This removes Phase I applications from the grid, allowing you to work with only the applicants who applied for Phase II.

Once you have identified your Phase II applicants, you can:

• organize them with Phases or Tags,
• review them,
• or communicate with them.

Filtering the Dashboard for Phase II Applicants

The Dashboard in Outcomes displays charts to provide you with relevant information about your application pool. Each report on the Dashboard can be filtered to display Phase II applicant information. To do this:

1. Navigate to the Dashboard and click Edit Dashboard.
   
   
2. Go to the chart you'd like to adjust and click the Filter icon.
   
   
3. From the Edit Filter window, click Add Filter and select Program.
   
   
4. Select Phase II from the program list and click Update Filter.
   
   
5. The chart updates, only including Phase II applications.
6. Complete this for each chart you'd like to filter.

Using Tags to Assign Reviews

Tags are labels that you can place on applications to categorize them for any purpose. One way of working with Tags is to create Tags that indicate which reviewer should work with an application. Once the reviewer has completed their review, they can use the comments tab or add other Tags to indicate the results of their review.

To assign reviews using Tags:

1. Go to the Applications View and find an application you wish to assign.
2. From the Information Panel on the right, click the plus sign under Tags.
   
       
3. Start typing to name the Tag. You can choose a name that associates the application with the appropriate reviewer (e.g., Barry, Review Group 1, or November 15th Reviews).
4. Once you've created a Tag on one application, that Tag becomes available to use on other applications. So to use the Tag again, click on the plus sign and select the Tag from the list.
   
       

Assigning Tags in Batch

To save time, Tags can also be created and assigned in batch from the Applications View. To do this:

1. Navigate to the Applications View and click the checkboxes next to the applications you wish to Tag.
2. When the Batch Action menu appears, select Tag.
3. Type to create a new tag, or select the existing Tag(s) you wish to apply and click Update Tags.
   
       

After Tags have been created, you can group them for reviewers, interviewers, or others to see which applications they should work with.

Grouping Applications Based on Tags

Once you've started applying Tags to applications, you can create Filters or Segments to see which applications are assigned to each reviewer. To create a Filter or Segment based on Tags:

1. Go to the Applications View and click Add Filter on the left.
2. Select Tags from the drop-down.
   
       
3. Select the Tag(s) you'd like to focus on. For example, you may only want to work with Tags assigned to one reviewer.
   
       
4. Click APPLY.
5. The Filter is applied and the grid updates to only show applications with the Tag(s) you've selected.
6. If desired, you can save this Filter for later use or for other users to work with. To save the Filter as a Segment, click Create Segment at the bottom left.
7. Give the Segment a name, and if desired, categorize it. For example, you can create a category of Segments based on Tags.
   
       
8. Click Create Segment.
9. Your new Segment will be listed in the Segments area of the Application View. Any user with access to Segments can consult these Segments to see which applications are assigned to each Tag.
   
       

Exporting All Application Data into a JSON File

The easiest way of extracting all applicant data into a single file is to use the Default JSON Export option. This option sends all the included applicants' data into a JSON file without any additional configuration. JSON is a format commonly used to transmit data from web applications but, unlike a Speadsheet Export, it isn't easily readable in Excel. Instead, JSON files are typically imported into another system. For a more readable file containing all application data without additional configuration, you may choose to export the Default PDF file.

To create a Default JSON Export file:

1. Navigate to the Applications View.
2. Use Segments, Filters, or the Search bar to find the applications you wish to include in your export. Select them individually or use the top checkbox to select all applications.
3. Click Export from the Batch Actions menu.
4. Click Generate next to Default JSON.
5. A window appears confirming that your export is being processed. Wait for the export to finish and click the link to download it here, or dismiss the window.
   
       
6. If you dismiss the window or need to access the export again, go to the Downloads in the Activity section to download the file later.

Exporting All Application Data into an Excel File

If you prefer to export all application data into an Excel file, you can do this by configuring a Spreadsheet Export Template with all fields included. To do this:

1. Go to the Import/Export section of the Settings menu and click Exports.
   
        
2. Click Create Export to begin creating a new export file.
   
       
3. Click Tabular/Spreadsheet.
   
       
4. Name the export file, and select from the Comma Delimited, Tab Delimited, or Fixed Width style types. The most common option is Comma Delimited, but your needs may vary.
   
       
5. In the Columns area, add the fields you wish to include in your export by finding them on the Available Fields panel and clicking to add them. You can also drag-and-drop them into your desired order.
   
       
6. Where applicable, click the plus sign near any section to add all of its fields. Fields you have already included appear with a checkmark beside them.
   
       
7. For fields that involve multiple data points, a Pivot window appears allowing you to select which columns to include. To do this:
   • Drag the desired columns from the left to the right.
     
     
   • Order them as desired.
   • Select the number of rows you'd like to include. For example, for Colleges Attended, if you set this number to 5, five colleges and their corresponding data will be included in your export. The remaining data is excluded.
   • Check the Resulting Column Headers section to review how your column headers will appear in the resulting export.
   • Click Update to save your changes.
   • To make changes to the selected fields once you've dismissed this window, click the Pivot Table icon on the corresponding field.
     
     
8. When you’re done configuring the export, click Create Export.

Exporting the Default PDF

The quickest way of exporting review results is to export the Default PDF. There's no configuration required to generate this file, which includes a cover page, attachments, documents, and other applicant data.

Since this PDF document includes the entire application, this method allows you to quickly create an export file without needing to select which sections you want to include. To export a Default PDF:

1. Navigate to the Applications View.
2. Click the checkbox near any application you wish to include in your export.
3. Click Export from the Batch Actions menu
4. Click Generate next to Default PDF.
   
       
5. A window appears confirming that your export is being processed. Wait for the export to finish and click the link to download it here, or dismiss the window.
   
       
6. If you dismiss the window or need to access the export again, click Downloads from the Activity section to download the file later.
7. The Evaluations section of the PDF file includes all review forms completed on the Application, along with the Reviewer's name, field responses, and Datestamp. The Evaluations are separated by headings displaying the name of the Evaluation Form used for the review.
   
       

You can also generate the Default PDF for an individual application by navigating to the desired application record, and selecting Export from the More Options (three dots) menu.

    

Configuring an Export Template with Review Results

If you don't want to export the entire application as described above, another way of exporting review results is to create a customized export file. Using this method, you can select the specific elements you wish to include in your PDF file. For example, you can configure a PDF export that only includes the Summary Page and Evaluation Form results. To configure an export file including review results:

1. Go to the Import/Export section of the Settings menu and click Exports.
   
       
2. Review the existing exports, or click Create Export to begin creating a new export file.
   
       
3. Select PDF Export.
   
       
4. Name the export file.
   
       
5. Enable the Customize Contents option to establish which sections of the PDF you'd like to include. To include review results, make sure Evaluations is checked.
   
       
6. Check and uncheck the sections as desired, then click Create Export at the bottom of the page.
7. Once you've configured this export file, it becomes available to select when generating an export file.
   
       
8. Once the files have generated, click the links to download them.
   
       
9. The Evaluations section of the PDF file includes all review forms completed on the Application, along with the Reviewer's name, field responses, and Datestamp. The Evaluations are separated by headings displaying the name of the Evaluation Form used for the review.
   
       

Creating AAPI Accreditation Custom Properties

To filter your applicants for their accreditation status, you'll first need to add three Custom Properties to capture this information. Once you're finished, you'll have fields on each application that indicate the accreditation status for APA, CPA, and PCSAS, respectively. To add the Custom Properties:

1. Navigate to the Settings menu and click Application Properties under the Application Setup heading.
   
   
2. Click the Edit Pencil.
3. Click and drag the Calculated Property option from the left to the list on the right.
   
   
4. After placing the field as desired, configure its name (e.g., APA Accreditation, CPA Accreditation, or PCSAS Accreditation). You'll do this for each of these accreditation types.
   
   
5. Select String as your Data Type.
6. Next, enter the JavaScript Expression that looks for the appropriate accreditation.
7. Once you've completed this, click Add.
8. Repeat steps 3-7 for each accreditation.

Applying the Required JavaScript Expressions

JavaScript is a programming language commonly used to add interactive elements to a webpage. In Outcomes, JavaScript expressions allow you to dynamically incorporate other data points from the software in a Custom Property. In this case, you'll need to add the following JavaScript Expressions for each Accreditation Custom Property. Copy the appropriate text below, and paste it into the Expression window when completing Step 6 above.

{
  // Enter key of accreditation value to return.
  let statusKey='apa';
  if ((forms.dct_designated_subfield_info)
      && (forms.dct_designated_subfield_info.accreditation_status.rows)
     ) {
     let formRef = forms.dct_designated_subfield_info.accreditation_status.rows;
     return (formRef[statusKey].accreditation) ? formRef[statusKey].accreditation : null;
  } else {
    return null;
  }  
}

{
  // Enter key of accreditation value to return.
  let statusKey='cpa';
  if ((forms.dct_designated_subfield_info)
      && (forms.dct_designated_subfield_info.accreditation_status.rows)
     ) {
     let formRef = forms.dct_designated_subfield_info.accreditation_status.rows;
     return (formRef[statusKey].accreditation) ? formRef[statusKey].accreditation : null;
  } else {
    return null;
  }  
}

{
  // Enter key of accreditation value to return.
  let statusKey='pcsas';
  if ((forms.dct_designated_subfield_info)
      && (forms.dct_designated_subfield_info.accreditation_status.rows)
     ) {
     let formRef = forms.dct_designated_subfield_info.accreditation_status.rows;
     return (formRef[statusKey].accreditation) ? formRef[statusKey].accreditation : null;
  } else {
    return null;
  }  
}

Working with the Accreditation Custom Properties

After completing the steps above, the accreditation information now appears as a Custom Property on each application. This allows you to run filters based on accreditation.

To find the accreditation status for an individual applicant:

1. Navigate to their application.
2. Click the More Options (three dots) button and select Application Properties.
   
   
3. The accreditation status fields you've built appear here.
   
   

To filter for accreditation statuses:

1. Navigate to the Applications View.
2. Click the Filter icon and select Add Filter.
   
   
3. Click Application Property and find the accreditation status you'd like to filter on.
   
   
4. Next, adjust the filter as necessary (e.g., select is exactly, and type in the status you'd like to filter for).
   
   
5. Click APPLY to add your filter. The applications that appear are those that match your query.