Configure WorkZone Mass Dispatch

Note: This topic is targeted at WorkZone administrators who are responsible for configuring WorkZone Mass Dispatch.
Prerequisite:  
  • SmartPost must be activated and configured.
  • An NgDP dispatcher must exist.
  • See Configure dispatchers in the WorkZone Process Administrator Guide.

You configure Mass dispatch in WorkZone Configurator.

  1. In WorkZone Configurator, go to Process > Processes.
  2. Point to the Mass dispatch process.
  3. Click Edit process parameters.
  4. Enter values for the parameters.
Note: Some of the Mass dispatch parameters are similar to SmartPost process parameters.
Parameter Default Description

SPDocumentSource

 

Select the origin of the created SmartPost message. The possible settings correspond to the entries in the custom domain ACTOPR, for example SP, SmartPost, DP, Digital Post, and so on. The organization must provide this information. The setting is shown on the document in the Origin field in WorkZone Client.

MaxCombinedMessageLength

10485760 (10 MB)

When a user starts a Mass dispatch process, the Mass dispatch process calculates an estimated size of each of the messages sent to the recipients. Before the Mass dispatch process continues the process, the estimated size is compared with the MaxCombinedMessageLength setting. If the estimated size exceeds the specified value, the user is asked to reduce the size of the documents and then try to send the message again.

The reason for this is that large documents may cause the Workflow Host to run out of memory later in the flow, which causes workflows to be terminated without the user being notified.

Generally, the default value is used.

DefaultMaterialId

 

The material that will be selected by default in the Start mass dispatch dialog box.

To configure materials, click Process > Material. See Configure materials in the WorkZone Process Administrator Guide and Materials in the WorkZone Configurator Administrator Guide.

DefaultDispatcherSequenceId

 

The default dispatch sequence that will be selected by default in the Startmass dispatch dialog box.

Important: The selected dispatch sequence must have NgDP as the first dispatcher.

The list of dispatch sequences that you can choose from only contains dispatch sequences where all the dispatchers have the AllowMassDispatch parameter turned on.

To configure dispatch sequences, click Process > Dispatch sequences. See Configure Dispatch Sequences in the WorkZone Process Administrator Guide and Dispatch Sequences in the WorkZone Configurator Administrator Guide.

Important: Verify this value after successful upgrade. After upgrade, the dispatch sequences may have been renumbered.
DefaultRemotePrintTypeId  

The print type that will be used when sending letters via remote print.

To create or reconfigure print types, click Process > Print types. See Configure print types in the WorkZone Process Administrator Guide and Print types in the WorkZone ConfiguratorAdministrator Guide.

ReportId

 

Select the report you want to use for the history document.

ValidationReportId

 

Select the report you want to use for the validation report.

RecipientReportId

 

Select the report you want to use for the recipient report.

ReportRecordType

PROHIST

The document type of the history document that is generated by the Mass dispatch process.

ReportRecordState

 

The document state of the history document that is generated by the Mass dispatch process.

ReportTitleTemplate

{0}: {1} {2}

A template that is used to create the title of the history document. By default, the template has placeholders for the process type {0}, the process title {1}, and a date stamp {2}.

Note that for the history documents in CSV format, the merge field {1} for the process title will always be:

  • "Mass dispatch history" for the entire dispatch.

  • " Mass dispatch history per recipient" for the individual dispatches.

CaseTitleTemplate

 

Enter a default case title that you want to apply to recipient cases.

The title is shown in the Case title template field on the Recipient cases tab in the Start mass dispatch dialog box.

RecordTitleTemplate

 

Enter a default title that you want to apply to letters that are generated by the Mass dispatch process.

The title is shown in the Letter title template field on the Recipients tab in the Start mass dispatch dialog box.

RecipientRecordType

 

Select a default document type for the generated letters.

The document type is shown in the Document type field on the Recipients tab in the Start mass dispatch dialog box.

RecipientRecordState

 

Select a default document state for the generated letters.

The document state is shown in the Document state field on the Recipients tab in the Start mass dispatch dialog box.

SaveRecordPartyRoles

 

Turn on this parameter if you want to add recipients as parties on the generated letters.

The Add document parties check box will be selected by default on the Recipients tab in the Start mass dispatch dialog box.

DefaultRecordPartyRole

 

Select a default role for the parties that will be added to the generated letters.

The role will be selected by default in the in the Party role field on the Recipients tab in the Start mass dispatch dialog box.

SaveCasePartyRoles

 

Turn on this parameter if you want to add recipients as parties on recipient cases.

The Add case parties check box will be selected by default on the Recipient cases tab in the Start mass dispatch dialog box.

DefaultCasePartyRole

 

Select a default role for the parties that will be added to the recipient cases.

The role will be selected by default in Party role field on the Recipient cases tab in the Start mass dispatch dialog box.

ValidationProperty

 

Select the custom document field that holds the values.

ValidationValues

 

Specify which custom document values are allowed. Users will only be able to select documents (letter document and attachments) with these values in the Start mass dispatch dialog box.

DocClassificationThresHold

 

The maximum document classification that is allowed to be used with the Mass dispatch process. Documents with higher classifications than specified for this parameter will not be available for selection in the Start mass dispatch dialog box.

DefaultExcludedCprStatuses  

Select the CPR status codes that you want to exclude from the mass dispatch. You can select 80, Inactive, emigrated or 90, Inactive, dead.

The status codes that you specify will be shown as default values in the Start mass dispatch dialog box.

BatchSize

200

Specify how many letters you want the Mass dispatch process to send in a batch. The batch size affects performance and the frequency of status updates that are shown in the preview pane in WorkZone Client.

You can set the batch size from 0 and up to 5000 letters. If you set the batch size to 0, all letters will be sent at the same time.

A batch size between 200 and 1000 letters is recommended.

The default batch size is 200 letters.

UserTaskReportId

 

The ID (GUID) of the history document that is generated by the process.

RecipientRecordGroup

 

Select a document group that will be applied to the generated letter documents.

CopyTemplateFileFacets

 

Turn on this parameter if you want to add the facet from the case template to recipient cases.

If selected, the Copy facet check box will be selected by default on the Recipient cases tab in the Start mass dispatch dialog box.

ValidatePDFUA

 

Turn on this parameter to check the letter template and the generated letters for PDF/UA compliance. By default, the parameter is turned on and the PDF/UA (Universal Accessibility) check box in the Start mass dispatch dialog is selected.

GenerateIndividualReports

 

Turn on this parameter if you want the mass dispatch process to generate an individual history document for each individual dispatch in CSV format.

By default, the parameter is turned off.

See History documents.

See also Processes in the WorkZone Configurator Administrator Guide.

Configure dispatch of letters to Strålfors

You can configure the Mass dispatch process to send letters via Strålfors when it is not possible to send letters via Digital Post. If a dispatch fails or the recipient is not subscribed to Digital Post, the letter will be sent via Strålfors.

To configure the Mass dispatch process to send letters via Strålfors, complete these steps in WorkZone Configurator:

  1. Create a dispatch sequence that includes NgDP as the first dispatcher and Strålfors as the next dispatcher. See Configure dispatch sequences in the WorkZone Process Administrator Guide.

  2. Make sure that the AllowMassDispatch parameter for the Strålfors dispatcher is turned on. The parameter is turned on by default. See Configure dispatchers - Strålfors in the WorkZone Process Administrator Guide.

  3. Select a default print type for the DefaultRemotePrintTypeId parameter on the Mass Dispatch process.