Configure WorkZone Mass Dispatch
- 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.
- In WorkZone Configurator, go to Process > Processes.
- Point to the Mass dispatch process.
- Click Edit process parameters.
- Enter values for the 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:
|
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. |
|
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. |
|
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:
-
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.
-
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.
-
Select a default print type for the DefaultRemotePrintTypeId parameter on the Mass Dispatch process.