Projects¶

Introduction¶

The Projects page of the Management Console provides the ability to manage all of your projects across the various stages of their lifecycle. You can import and delete projects, as well as run operations, create and apply a schedule on an operation, manage project backups, edit project variables, and view deploy history.

To access the Projects page, log in to the Jitterbit Harmony Portal, then use the Harmony Portal menu in the top left to go to Management Console > Projects:

Managing Projects¶

The top section of the Projects page includes a table that lists each project, its associated environment, and a description if available. Both Cloud Studio and Design Studio projects are included:

Import Projects¶

To import a Design Studio project, use the button. In the popup, use the button to browse to the Jitterpak file (.JPK). For more information on obtaining a project in .JPK format, refer to Export as a Jitterpak.

Make sure you select the environment you want to import your project into. To select multiple environments, hold the Control key or Command key while clicking. The rest of the fields should populate with information from your Jitterpak. Then click Save.

Delete Projects¶

To delete a project, use the Action dropdown on the far right and select either Delete or Delete from All Environments depending on if you would like to remove the project's association with a single environment or remove from all environments:

Search for Projects¶

Enter search criteria into the search bar located directly above the Projects table. Then click the magnifying glass button to execute the search. Optionally, you can check the box for Include Deleted if you want to include deleted projects in your search:

Enter search terms using the syntax suggested below the search box. Note that a semicolon (;) is treated as an AND operator, and a comma (,) is treated as an OR operator.

To search for projects, enter "project=" immediately followed by the name of the project. For wildcard searches, enter the first few letters of the name of the project followed by the percent (%) symbol.

To search for environments, enter "environment=" immediately followed by the name of the environment. For wildcard searches, enter the first few letters of the name of the environment followed by the percent (%) symbol.

Sort Projects¶

Click the column header in any column to sort the table based on the data in that column in ascending order. A white arrow pointing up will display in the column to the right of the header name.

Click the column header twice in any column to sort the table based on the data in that column in descending order. A white arrow pointing down will display in the column to the right of the header name.

Managing Detailed Information¶

When a row of the Projects table is selected, the tabs at the bottom of the screen become available: Operations, Schedules, Backups, Project Variables, and Deploy History. An additional tab, Listeners, is present if the selected project has any listening activities that have been deployed.

View, Run, or Apply Schedule to Operations¶

The Operations tab shows the operations within the selected project. From here you can limit the view of operations, identify which operations have debug mode enabled, check schedule status, enable or disable an applied schedule, run an operation, or apply or remove an existing schedule.

Search for Operations¶

To search within the table of operations, enter search terms using the syntax suggested below the search box. Note that a semicolon (;) is treated as an AND operator, and a comma (,) is treated as an OR operator.

To search by operation or schedule name, enter "operation=" or "schedule=" immediately followed by the name of the operation or schedule, respectively. For wildcard searches, enter the first few letters of the name of the operation followed by the percent (%) symbol.

To search by status, enter "schedulestatus=", "operationstatus=", or "effectivestatus=", immediately followed by "enabled" or "disabled".

Then click the magnifying glass or press the Enter key to execute the search.

Identify Operations with Debug Mode Enabled¶

If your project contains any operations that have debug mode enabled (see Cloud Studio Operation Options or Design Studio Operation Options), a wrench icon will be displayed in the Operation Name column, to the left of the name of each operation that has debug mode enabled.

Check Schedule Status or Enable/Disable Schedule¶

If your project contains any schedules, the name of the schedule will be listed in the Schedule Name column for each operation that has a schedule configured.

The next three columns provide information on the status of the schedule. It is important to understand that a schedule can be enabled or disabled overall for the whole project, or can be enabled or disabled individually on each operation. Given these options together, the Effective Status is the most meaningful column that indicates whether an operation will run on the schedule.

• Schedule Status: This indicates if the schedule is enabled or disabled overall at the schedule level. Enabling or disabling a schedule at the schedule level can be done from the next tab, Schedules. When a schedule is disabled overall, an operation that has a schedule applied at the operation level will not run on the schedule.
• Operation Status: If a schedule has been applied at the operation level, this indicates if the schedule is enabled or disabled. Click to toggle the schedule on or off on the operation. Note that if the schedule is enabled at the operation level, but the overall schedule is disabled at the schedule level (Schedule Status), then the operation will not run on the schedule (i.e. the schedule level overrides the operation level). If the operation does not have a schedule applied, "No schedule" will be displayed. A schedule can be applied or removed on the operation using the Action dropdown on the far right of the row.
• Effective Status: This indicates the effective status of a schedule for the operation, taking into account whether the schedule is enabled overall and whether it is enabled on the individual operation. If both the schedule overall and the schedule on the individual operation are enabled, then the operation will run on the schedule. If either the schedule overall or the schedule on the individual operation is disabled, then the operation will not run on the schedule. If the operation does not have a schedule applied, "No schedule" will be displayed.

For example, if Operation A has a schedule enabled at the operation level (Operation Status is "On") and Operation B has the same schedule disabled at the operation level (Operation Status is "Off"), but the schedule is disabled at the project level (Schedule Status is "Schedule Disabled"), then neither operation will run on the schedule (Effective Status is "Disabled"). If the schedule were then enabled at the project level (Schedule Status is "Schedule Enabled" and Effective Status is "Enabled"), then Operation A would run on the schedule and Operation B would not run on the schedule, as it is disabled at the operation level.

Run Operation or Apply/Remove Schedule¶

To place an operation in the queue to run or to apply a schedule, use the Action dropdown on the far right and select Run or Apply Schedule. If a schedule is already applied, select Remove Schedule to disassociate the schedule with the operation:

Upon clicking Run, a message will appear in the top right indicating if the operation has been submitted successfully.

Upon clicking Apply Schedule, a window will appear to select the schedule to apply. Use the dropdown to select an existing schedule, then click Associate to apply it to the operation. Only one schedule can be applied per operation.

Upon clicking Remove Schedule, a confirmation message will ask you to confirm you want to dissociate the schedule from the operation. The schedule itself will not be deleted, but will simply be unassigned from the operation.

View, Create, Update, or Enable/Disable Schedules¶

The Schedules tab provides the ability to create new schedules, search for schedules, update or delete existing schedules, or enable or disable an existing schedule across all operations on which it is currently enabled or disabled.

Create New Schedule¶

To create a new schedule, click the Create Schedule button. Note that this is used to create the schedule only; applying the schedule to an operation is covered above under Run Operation or Apply/Remove Schedule.

A dialog will open where you can configure your schedule:

• Name: Enter a name for your new schedule. You may want to give the schedule a name that is reflective of the schedule frequency or, if used for a specific operation, reflective of the purpose of the schedule (e.g. "Every 5 MInutes" or "Contact Sync").

• Occurrence: Use the dropdown to select one of three options for the days on which the schedule should kick off the operation(s) on which it is assigned:

  • Daily: The schedule will activate the operation every day, or every few days. When this option is selected, these fields become available to configure:

    • Every [#] Day(s): Enter a number of day(s) in between operation runs.

  • Weekly: The schedule will activate the operation during a specified set of days of the week. When this option is selected, these fields become available to configure:

    • Every [#] Week(s): Enter a number of week(s) in between operation runs.
    • [Sun, Mon, Tue, Wed, Thu, Fri, Sat]: Select the checkboxes next to the day(s) of the week on which you want the operation to run.

  • Monthly: The schedule will activate the operation on a monthly basis. When this option is selected, choose one of two options that become available to configure:

    • Day [#] of Every [#] Month(s): Enter the day of the month and number of month(s) in between operation runs.
    • The [1st, 2nd, 3rd, 4th, or Last] [Day of Week] of Every [#] Month: Use the dropdowns to select which day of the month and enter the number of month(s) in between operation runs.

• Daily Frequency: Select one of two options for the times at which the schedule should kick off the operation on the days that it runs.

  • Occurs once at [hh:mm] [AM/PM]: The schedule will activate the operation only once at the specified time. Enter values directly or click the time icon to open a time selector to set the hour(s), minute(s), and time of day at which you want the operation to run.

  • Occurs every [#] [Minute(s)/Hour(s)] Starting at [hh:mm] [AM/PM] and Ending at [hh:mm] [AM/PM]: The schedule will repeatedly reactivate the operation for the specified period of time throughout the day. Enter a number to correspond with the dropdown selection of minute(s) or hour(s) at which you want the operation to run. Enter values directly or click the time icon to open a time selector to set any times throughout the day that you want to limit the operation to run within.

    Note

    Time zones are discussed below in Operation Time Zones.

• Duration: Configure the dates of duration for the schedule.

  Note

  Start and end dates in a schedule are inclusive.

  • Starting at: By default, the schedule will be active starting on the current date. If you want the schedule to start on another day, enter the desired date or click the calendar icon to open a calendar datepicker and select the desired start date.
  • Ending at: By default, the operation(s) on which the schedule is assigned will run indefinitely per the schedule. If you want specify an end date, first select the checkbox to enable the Ending at field. Then enter a date that you want the schedule to end or click the calendar icon to open a calendar datepicker and select the desired end date.

Operation Time Zones¶

When configuring a schedule, the Daily Frequency field does not display the time zone in which the operation will run. The time zone in which the operation will run depends on the agent running the operation, unless the Override Schedule Agent Time Zone setting is enabled in your organization's policies:

• Agent Time Zone
  • Cloud Agents: All Cloud Agents are in UTC.
  • Private Agents: Private Agent time zones are determined by the time zone of the operating system of the Private Agent. It is highly recommended for all agents in a Private Agent Group to be running on the same time zone, or the times at which a configured schedule initiates the operation may be unpredictable depending on the specific agent being used.
• Override Schedule Agent Time Zone
  • If the Override Schedule Agent Time Zone setting is enabled in your organization's policies, the selected time zone will determine the time zone in which all current and future schedules across an organization will run.

Search for Schedules¶

To search within the table of schedules, enter search terms using the syntax suggested below the search box. Note that a semicolon (;) is treated as an AND operator, and a comma (,) is treated as an OR operator.

To search by schedule name, enter "schedule=" immediately followed by the name of the schedule. For wildcard searches, enter the first few letters of the name of the operation followed by the percent (%) symbol.

To search by status, enter "schedulestatus=", "operationstatus=", or "effectivestatus=", immediately followed by "enabled" or "disabled".

Then click the magnifying glass or press the Enter key to execute the search.

Edit or Delete Schedule¶

To edit or delete an existing schedule, use the Action dropdown on the far right and select Edit or Delete:

Upon clicking Edit, the schedule configuration will open as described in Create New Schedule above. When an existing schedule is edited, it affects all operations that have the schedule applied.

Upon clicking Delete, if no operations are currently using the schedule, a confirmation message will ask you to confirm that you want to delete the schedule. If any operations are currently using the schedule, you will not be able to delete the schedule.

Enable or Disable Schedule¶

To toggle the schedule on or off, effectively enabling or disabling the schedule across all operations on which it is currently enabled or disabled, click the toggle button under the Schedule Status column.

Check Schedule Status or Enable/Disable Schedule¶

If your project contains any schedules, the name of the schedule will be listed in the Schedule Name column. Click the disclosure triangles to expand or collapse operations that have the schedule applied.

The next three columns provide information on the status of the schedule. It is important to understand that a schedule can be enabled or disabled overall for the whole project, or can be enabled or disabled individually on each operation. Given these options together, the Effective Status is the most meaningful column that indicates whether an operation will run on the schedule.

• Schedule Status: This indicates if the schedule is enabled or disabled overall at the schedule level. Click to toggle the schedule on or off for the whole project. When a schedule is disabled overall, an operation that has a schedule applied at the operation level will not run on the schedule.
• Operation Status: If a schedule has been applied at the operation level, this indicates if the schedule is enabled or disabled. Click to toggle the schedule on or off on the operation. Note that if the schedule is enabled at the operation level, but the overall schedule is disabled at the schedule level (Schedule Status), then the operation will not run on the schedule (i.e. the schedule level overrides the operation level). A schedule can be applied or removed from the Operations tab.
• Effective Status: This indicates the effective status of a schedule for the operation, taking into account whether the schedule is enabled overall and whether it is enabled on the individual operation. If both the schedule overall and the schedule on the individual operation are enabled, then the operation will run on the schedule. If either the schedule overall or the schedule on the individual operation is disabled, then the operation will not run on the schedule. If the operation does not have a schedule applied, "No schedule" will be displayed.

For example, if Operation A has a schedule enabled at the operation level (Operation Status is "On") and Operation B has the same schedule disabled at the operation level (Operation Status is "Off"), but the schedule is disabled at the project level (Schedule Status is "Schedule Disabled"), then neither operation will run on the schedule (Effective Status is "Disabled"). If the schedule were then enabled at the project level (Schedule Status is "Schedule Enabled" and Effective Status is "Enabled"), then Operation A would run on the schedule and Operation B would not run on the schedule, as it is disabled at the operation level.

View, Download, or Remove Backups¶

If the project has any backups that have been created, you can view information about them from the Backups tab.

Use the Action dropdown if you would like to Download or Remove the particular backup:

View or Edit Project Variables¶

You can view any project variables used within your project under the Project Variables tab.

To open the project variable for editing, use the Action dropdown to select Edit:

In the popup, you can edit the value, show or hide the value, or edit the description.

View Deploy History¶

When you deploy your project, information in the Deploy History tab will populate with records of your deployment history.

You may need to click the refresh button in order to update records.

Click on a deploy record row to view details about the deployment:

View or Enable/Disable Listeners¶

The Listeners tab is displayed only if the selected project has any listening activities that have been deployed. Currently, listening activities are limited to those created using the Cloud Studio Google Pub Sub, RabbitMQ, and Salesforce Events (Beta) connectors.

When displayed, this tab lists any listening activities and the operations they are used in, along with their state, which can be toggled:

• Activity Name: Activities and operations are displayed in groups of rows:

  • The first row of each group, shown in bold, represents the listening activity using a shortened form of the connector activity type followed by the user-provided connection name.

    Note

    The user-provided name of the listening activity is not shown.

  • Any subsequent rows indented below the first row of each group list the names of each operation that the activity is used in.

• State: The state of listening is provided for each activity and operation. Click to toggle the listening state between On (enabled) and Off (disabled). Note:

  • Disabling event listening for an activity will automatically disable listening for all operations it is used within. However, enabling event listening for an activity does not affect the state of any operations it is used in.

  • Operations can be enabled and disabled for event listening individually.

  • Changing the state is synced with the Cloud Studio UI in both directions. That is, toggling the listening state in the Management Console affects the state in Cloud Studio. Similarly, enabling or disabling events on a Cloud Studio operation affects the state in the Management Console. A refresh may be required to update the display.