Azure Storage Import Schedule and Settings

As an administrator with the required permissions, you can define a preset schedule to automatically transmit specific message class files received from the Department of Education to the designated server. 

To configure automated incoming Azure Storage File Share:

  1. On the Settings page, select Set Azure Storage Import Schedule and Settings.

    Note: The image below shows the fields displayed in a single-tenant environment. In a multi-tenant environment, the following fields are managed for each tenant by Anthology staff using the Administration Portal and are not displayed in the Mailbox Manager UI.

    • Account Name
    • Account Key
    • File Share Name

    Azure Import

  2. Set the Azure Storage Settings for the incoming file transfers:

    Field Description
    Enabled  

    Select this check box to enable automated Azure Storage file share from ED to the designated server.

    You can clear this option at any point in the future to disable automated incoming shares.

    Validate the Azure Storage Settings prior to selection of the Enabled check box.

    File Naming Convention

    Select the naming convention used for the file shares:

    • Serial Number Extension (.dat file)

    • Standard Format (.txt file)

    Account Name

    Enter the account name of your Azure Storage.

    In a multi-tenant environment, this field is not displayed. Its value is managed by Anthology staff.

    Account Key

    Enter the account key for your Azure Storage.

    In a multi-tenant environment, this field is not displayed. Its value is managed by Anthology staff.

    File Share Name

    Enter the file share name. 

    In a multi-tenant environment, this field is not displayed. Its value is managed by Anthology staff.

    Notification Email Enter the email address that is used by the system to send notifications of scheduled incoming file transfer events (success and failure). 
  3. Select the Validate button to perform a validation against the specified Azure Storage parameters. 

    Important: If you make any revisions after the initial validation, you must repeat this step to connect to the configured server.

  4. Use the Azure Storage Directory Path settings to configure custom Azure Storage directory structure.

    Field Description
    Directory Path  

    This is the directory structure for your Azure Storage File Share where the file transfer happens.

    For root directory leave empty, or specify the directories separated with /, for example: Directory1/Directory2

    Accepted directory name characters are alphanumeric, empty space and the following special characters: !"#$%&'()*+,-./:;<=>?@[\]^_`{|}~

    Directory Path Placeholders

    Drag or select these placeholders inside the Directory Path to create custom directory structure:

    • TG Number: Directory will be created (if it does not exist), named with the TG number from the message that is sent

    • Message Class: Directory will be created (if it does not exist), named with the Message Class from the message that is sent

    • Timestamp: Directory will be created (if it does not exist), named with a timestamp indicating when the job was run.  It appears in the following format: yyyymmdd-hhmmss-milliseconds (6-digit milliseconds)

    Additional Directory Path

    This is the Additional Directory structure on your Azure Storage File Share where the file transfer happens.

    For root directory leave empty, or specify the directories separated with /, for example: Directory1/Directory2

    Accepted directory name characters are alphanumeric, empty space and the following special characters: !"#$%&'()*+,-./:;<=>?@[\]^_`{|}~

    You to add up to two (2) additional directory paths, for a maximum of three (3). At least one directory path is required to Save.

    • If you set multiple directory paths, the scheduled job will import message class files into the Mailbox Manager database from the multiple locations on FTP/Azure.

    • If you set multiple directory paths, the scheduled job will export the same message class file from the Mailbox Manager database to the multiple locations on FTP/Azure.

  5. Use the Schedule Settings to specify the occurrence of the automated incoming file shares.

    The system requires a minimum of one time slot a has maximum of seven for enabling inbound automatic file transfer. For each time slot, specify the following parameters:

    Field Description
    Time  

    Specify the time at which the system executes the scheduled file share each day.

    You can clear this option at any point in the future to disable automated incoming shares.

    Time Zone   Set the time zone for the clock time. This is typically the time zone of your institution. 
  6. Select the Message Classes you want to include in the automatic transfer. 

  7. Select Save.

    This button is not available if you do not have a successful validation against the configured Azure Storage setting and at least one time slot and message class selected. You can add another time slot by selecting the Add new Time button.