To have the Queue Module installed in a hosted database contact Support and reference this article. Please also provide the Queue module unlock code (if applicable). Once the Queue service has been installed in your application, users may begin creating queues with the steps below.
  1. In Administration > click Queue
  2. On the Queue page, click "New Queue" on the action bar at the top.
  3. Follow the appropriate step(s) for FE/EE or RE then proceed to step 4:
    • The Raiser's Edge: 
      • Select the appropriate module, category, and subcategory for items in the queue and click "Add to queue". Repeat this process until all items are added to the Queue.
    • The Financial Edge/The Education Edge: 
      1. Click "Add Item" under the "Queue" tab 
      2. Select the appropriate system, module, and category for items in the queue and click "Add selected Report(s) to Queue". Repeat this process until all items are added to the Queue.
  4. Click "Ok" to move to the Queue screen.
  5. On the Queue tab, add and select parameters for items in the queue.
  6. Select the "Processing" tab.
  7. In the "Frequency" field, select "On demand", "Weekly", "Monthly", or "Semi-monthly". If you select "On demand", enter a date and time in the "Next queue run date/time" field.
    • Note: If you select "Weekly", "Monthly", or "Semi-monthly", additional selections appear so you can designate exactly how often the queue runs. If an "Hourly" frequency is desired, we recommend the queue be set to "On Demand" so there is not an unnecessary load on the servers.
  8. In the "Run as" field, select which user you want to run the queue as.
    • Note: The selected user should be a queue specific user because it cannot be logged in while scheduled queues are running.
  9. In the "Run on" field, leave on the default option, "All Machines".
  10. In the Queue schedule "Start date" and "End date" fields, enter the dates the queue should first run and when it should stop running.
    • Based on frequency and start date selections, the date and time for the queue to run again appears in the "Next queue run date/time" field.
  11. To stop the queue if the program encounters an error, mark the "If an error occurs while running this queue, stop processing" checkbox.
    • If left unmarked and an error occurs, the program proceeds to the next task in the list.
  12. If you selected "On demand" in the "Frequency" field, you can mark the "If all items are processed successfully, delete this queue" checkbox.
  13. Select the "Miscellaneous" tab.
  14. To create a control report after the queue finishes, mark the "Create a control report" checkbox and select "Detail" or "Summary" in the "Format" field.
  15. In the "Action" field, set to "Export".
  16. Select the "Data format" type
  17. Set the "Export path" to a folder in the Hosting Files Folder
    • If you are hosted with Blackbaud, set to this file path: \\bbhfs01\[siteID]$\[folder name] Note: [siteID] will be replaced with your organization siteID and [folder name] will be the desired folder in the Hosted Files Folder.
    • If you are hosted with Blackbaud in Azure, your file path is slightly different. You combine the file service with your tenant ID and the $ symbol. 
      Example: \\[FileServiceName]\TenantID]$\.
      Your file service name is determined by your Azure geography.
      Europe: \\S22AOPS01FIL01\
      Canada: \\S23AOPS01FIL01\
      US: \\S21AOPS01FIL01\
      Then, to determine your tenant ID, look at the URL when you are logged into Raiser’s Edge NXT. Look for ?tenantid=. The alphanumeric code listed after is your ID.
      For example, ?tenantid=1cf5f5af-036f-4f2d-9bb1-01efe0b60f9a.The part in bold is the ID.
       
      When you combine, you’ll get something like: \\S22AOPS01FIL01\1cf5f5af-036f-4f2d-9bb1-01efe0b60f9a$. This is what you’ll copy into the Export path field.
      Note: The ellipses button does not work for Blackbaud hosting in Azure.
      You should also use the same file path for when you name your file:
      \\S22AOPS01FIL01\1cf5f5af-036f-4f2d-9bb1-01efe0b60f9a$\filename.CSV
  18. Click "Add to Queue" and repeat as needed.
  19. Click "Ok"
  20. Click "Save and Close"

NOTE: OnDemand and Scheduled queues are available features in the hosting environment. However, printing, emailing, and exporting to a local hard drive (you can only export to the Files Folder) within Scheduled queues are not available functions in the Blackbaud Hosting Services environment:
  • Printing: Scheduled queues run directly on Blackbaud hosted servers, and printing in hosting is designed to map to the default printer on a user's local workstation. Given that the scheduled queue is not running on a user's local machine, the printing function will not work for scheduled queues. Printing to a local printer is possible when running OnDemand queues since a user is logged in to run the queue.
  • Emailing: The Queue Service also does not allow a mail server to be selected when hosted.
  • Exports: Scheduled queues run directly on Blackbaud hosted servers. Scheduled exports will only run successfully when saved to the Hosting Services Files Folder. Exporting to the local drive in a scheduled queue will not work because there is no direct connection between the server and the workstation when the queue is run on Blackbaud's servers. Exporting to a local workstation is possible when running OnDemand queues since a user is logged in to run the queue.
For more information, or to purchase the Queue module, please contact your Account Manager.