Azure Storage Export 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 outgoing Azure Storage File Share:

  1. On the Settings page, select Set Azure Storage Export 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 Export

  2. Set the Azure Storage Settings for the outgoing 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.

    Please 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 Address Enter the email address that is used by the system to send notifications of scheduled outgoing 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. Azure Storage Directory path settings is used 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.
    Automate removal of empty folders

    Empty folders may cause processing delays. This is of particular concern when timestamp is added to the Directory Path. If automation is not enabled, best practice is to manually review and remove empty folders on a regular basis.

  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. You can add another time slot by selecting the Add new Time button. 

    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. Mailbox Settings: Select the Mailboxes that 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.