Plugin

The Asprova My Schedule Plugin (AsMySchedule.dll) is an Asprova plugin used to upload planning data from Asprova to My Schedule and to download result data from My Schedule to Asprova.

The basic features of the Asprova My Schedule Plugin are available on Asprova ver.17.6 or later, but some features may require a newer version of Asprova.

Installing the plugin

info

If you have installed Asprova ver.17.8 or later using the installer, the My Schedule Plugin is already installed automatically. The steps below are not necessary.

To install the Asprova My Schedule Plugin into Asprova, follow these steps.

1. Get the version of AsMySchedule.dll that corresponds to your Asprova My Schedule server.
2. Place AsMySchedule.dll in the Asprova installation folder. This may require administrator privileges.
3. Launch Asprova with administrator privileges, and open "Help" -> "Plug-in Information" from the top menu.
4. Select AsMySchedule.dll and check the box.

To use Asprova My Schedule ver.25.2 or later with Asprova prior to ver.17.10, the plugin manager may also have to be updated. For details, see the page.

Updating the plugin

When you update Asprova My Schedule, you have to update the Plugin in addition to updating Asprova My Schedule server.

To update the Plugin, follow these steps.

1. Get the version of AsMySchedule.dll that corresponds to your Asprova My Schedule server.
2. Overwrite AsMySchedule.dll in the Asprova installation folder. This may require administrator privileges.

On Asprova My Schedule ver.25.2.4 or later, a discrepancy between the installed plugin's version and the version the server expects is checked when the connection settings dialog is opened. Users are prompted to update the plugin to the version the server expects when a discrepancy is found.

Plugin features

tip

If you cannot find the specified menu, Custom Menu may be enabled. Either temporarily disable the custom menu, or add the corresponding plugin key to the custom menu.

Settings for linking Aru files with the My Schedule server

You can open the connection settings dialog by choosing "Tools" -> "Asprova My Schedule Settings" from the top menu.

To add the connection settings menu to the custom menu, use the plugin key My Schedule Settings.

The connection settings dialog lets you configure the following items.

• Server connection settings
  • Host name / IP address: Specifies the network location of the My Schedule server.
  • Trust All SSL Certificates: Enable this to allow any SSL certificate to be used in connection to the server. This is only intended to be used while testing.
  • Username: Specifies the My Schedule username used to communicate with the My Schedule server.
  • Password: Specifies the My Schedule password used to communicate with the My Schedule server.
  • Project name (*): Specifies the My Schedule project to link with.
• Display Period: Specifies the period of the planning data to upload to My Schedule.
  • Setting Method
    • "Dynamic": Sets the start and end dates of the period based on one of the properties "Assignment start time", "Scheduling basis time", or "Display start time" in the Aru file.
    • "Static": Specifies the period using absolute dates.
• View selection (*): Configures the views to upload to the My Schedule server. For views that allow styles selection, the styles can also be configured.

To set the items marked with (*) correctly, you need to connect to the My Schedule server and fetch the project's data from the server. When changing these items, use the "Get project names" button to fetch the latest information from the server.

Uploading planning data to the My Schedule server

Choosing "File" -> "Asprova My Schedule" -> "Data upload" from the top menu uploads the planning data to the server configured in the connection settings. Messages related to the upload are output to the message table.

To add the upload menu to the custom menu, use the plugin key My Schedule Upload (Menu).

To upload automatically after rescheduling, use My Schedule Upload (Command) in a scheduling parameter.

Upload with a comment

Choosing "File" -> "Asprova My Schedule" -> "Data upload with comment" from the top menu lets you upload the planning data with a comment attached.

Downloading result data from the My Schedule server

Choosing "File" -> "Asprova My Schedule" -> "Data Download" from the top menu downloads the result data from the server configured in the connection settings. Messages related to the download are output to the message table.

To add the download menu to the custom menu, use the plugin key My Schedule Download (Menu).

To download automatically after rescheduling, use My Schedule Download (Command) in a scheduling parameter.

Plan and license requirements

Uploading and downloading are gated by two independent things:

1. Your Asprova license — whether the My Schedule option is enabled, and, if so, up to which plan level (Free, Viewer, or Standard).
2. The project's plan — each project on the My Schedule server is itself assigned a plan (Free, Viewer, or Standard).

The plan levels are ordered Free → Viewer → Standard. The rules below compare the plan your license grants against the plan of the project you are uploading to or downloading from.

The messages in the tables below are those shown by plugin ver. 1.11.16 and may change in future versions.

info

The My Schedule Standard / Viewer connection options are set in Asprova's license. If you are unsure how your license is configured, contact your distributor.

Uploading

An upload succeeds only when all of the following hold. If a check fails, the upload is cancelled and the plugin shows the corresponding message:

Requirement	Message shown if it fails
The My Schedule option is enabled in your Asprova license.	"Currently My Schedule is not available. Please check My Schedule option in option function list."
Asprova has a scheduler module (e.g. APS, MS, MRP).	"Scheduling module (e.g., APS, MS) required"
Your user has Project Admin permission on the project.	"Your user doesn't have the permission to upload."
The project's plan is at or below the plan your license grants.	"This project is with plan higher than your license."
For projects on a paid plan (Viewer or Standard), your Asprova maintenance is still valid.	"Out of Maintenance."

In other words, a Standard-plan project can only be uploaded to from an Asprova whose license enables the Standard plan. A Viewer-plan project requires a Viewer- or Standard-level license.

info

On the Free plan, the display period you can upload is additionally limited to a maximum of 14 days. On the Viewer and Standard plans the upload period is unlimited.

Downloading

Downloading results is gated slightly differently from uploading:

Requirement	Message shown if it fails
The My Schedule option is enabled in your Asprova license.	"Currently My Schedule is not available. Please check My Schedule option in option function list."
For projects on a paid plan (Viewer or Standard), your Asprova maintenance is still valid.	"Out of Maintenance."
The project is not on the Viewer plan.	"Viewer plan cannot download."

Note the following differences from upload:

• Download does not require a scheduler module, so results can be pulled back into an Asprova that does not have the scheduler module.
• Because that plan has no result input to download, Viewer-plan projects cannot download. Other plans can download once the My Schedule option is enabled and, for paid plans, maintenance is valid.

Changes to the Aru file

When you use the My Schedule Plugin, the following changes are made to the Aru file.

Properties added/changed when the connection settings dialog is opened

• Connection settings
  • (My Schedule) Configurations (code: MyScheduleConfigurations)
  • (My Schedule) Checksum (code: MyScheduleChecksum)
• Properties for Resource Gantt Chart (Displaying production quantity per shift)
  • (My Schedule) Delimiter time for displaying output quantity for Resource Gantt Chart (Displaying production quantity per shift) (code: Res_MyScheduleSeparateTimeForCustomizedResGantt)