Views columns in KCM Studio
To get detailed information on the various
KCM
B&OM
objects, in
KCM Studio, on the
Administration tab, click the
button and
a select a view. The following tables list and describe the columns that appear in each view.
View columns that have more than 8100 characters may show empty fields. To check the contents of such fields, copy them from KCM Studio to another application.
Table 1: Request Summary
Column | Description |
---|---|
Request ID | Identifier of the request. |
Reference | Reference of the request as set in the request XML. |
Progress | Progress of KCM B&OM in creating and distributing the output of this request, such as: Registered, In progress, Completed. |
Correspondences | The number of correspondences that are part of this request and divided into:
Initially empty. Set by CCM_Application and updated by CCM_Communication for each processed correspondence. |
Communications | The number of communications that are part of this request and divided into:
Initially empty. Updated by CCM_Communication for each created communication and by both CCM_ElectronicDelivery and CCM_Distribution for each distributed communication. |
Registration time | In UTC, time when the request record was registered (the same as the Creation time in the Request view). |
Start time | In UTC, time when the processing for this request is started (the same as the Start time in the Request view). Initially empty. |
Completion time | In UTC, time when all output of the request is either distributed by KCM B&OM or abandoned. Initially empty. |
Table 2: Request
Column | Description |
---|---|
Request ID | Identifier of the request. |
Reference | Reference of the request as set in the request XML. |
Status | Current status of the request after being processed by CCM_Application: Waiting, Busy, Finished, Error, or Abandoned. |
Creation time | In UTC, time when the request record was created. |
Start time | In UTC, time when the processing for this request is started. Initially empty. Set by the CCM_Application standard process. |
Finish time | In UTC, time when the processing by CCM_Application for this request is finished. Initially empty. Set by the CCM_Application standard process. |
Error time | In UTC, time when an error occurred. Initially empty. |
Error message | Error message text. Initially empty. |
Abandon time | In UTC, time when the request is abandoned. Initially empty. |
Table 3: Correspondence
Column | Description |
---|---|
Correspondence ID | Identifier of the correspondence. |
Status | Current status of the correspondence, such as: Waiting, Busy, Finished, Error, or Abandoned. |
Correspondence reference | Correspondence reference as set in the request XML. |
Request ID | Identifier of the correspondence request. |
Request reference | Request reference as set in the request XML. |
Project | KCM Designer project that contains the Document Pack used for this correspondence. |
Document pack template | Document Pack used for this correspondence. |
Brand | Brand as set in the request XML. Empty when no brand was entered. |
Sender | Sender as set in the request XML. Can be changed with the application rules. Empty when no sender is entered. |
Recipients | List of recipients for the correspondence. |
Organisational metadata | Organisational metadata of the correspondence. |
Creation time | In UTC, time when the correspondence record was created. |
Start time | Time when the communication for this correspondence is started. Initially empty.
Set by the CCM_Communication standard process. |
Finish time |
Time when the correspondence is finished. Initially empty. Set by the CCM_Communication standard process. |
Error time | Initially empty. In UTC, time when the error occurred. |
Error message | Initially empty. Error message text. |
Abandon time | Initially empty. In UTC, time when the correspondence is abandoned. |
Data Backbone | Data Backbone used as input for this correspondence. Can be changed with the application rules. |
DID keys |
The keys used for this correspondence. The keys are concatenated into a single value, separated by a semi-colon. The XmlKey, if exists, is replaced with *XmlFile in this text. Can be changed with the application rules. |
DID extras |
The extras used as an input for this correspondence. The extras are concatenated into a single value, separated by a semi-colon. Can be changed with the application rules. |
DID XmlFile |
The XML data file for the DID user as an input for this correspondence. Can be changed with the application rules. |
Optional document | Optional document that is included in this correspondence as set in the request XML. Can be extended with the application rules. |
Table 4: Communication
Column | Description |
---|---|
Communication ID | Identifier of the communication. |
Communication type | Type of communication, such as: Print or Electronic. |
Status | Current status of the communication, such as: Waiting, Busy, Finished, Error, or Abandoned. |
Request Id | Identifier of the communication request. |
Correspondence ID | Identifier of the correspondence for this communication. |
Label | Label as set by the correspondence rules to identify the communication in the correspondence. |
Channel | Channel used to deliver this communication. |
Brand | Brand as set in the request XML. Empty when no brand is entered. |
Recipient type | Recipient type to which the communication is delivered, as set in the communication rules. |
Sender | Sender as set in the request XML. Empty when no sender is entered. Can be changed with the application rules. |
Recipient | Recipient of the communication as selected by the communication rules. |
Organisational metadata | Organisational metadata of the communication. |
Creation time | In UTC, time when the communication record is created. |
Start time | Time when delivery is started. Initially empty.
Set by the CCM_PrintDelivery or CCM_ElectronicDelivery standard process. |
Finish time | Time when delivery is finished. Initially empty.
Set by the CCM_PrintDelivery or CCM_ElectronicDelivery standard process. |
Error time | Initially empty. In UTC, time when the error occurred. |
Error message | Initially empty. Error message text. |
Abandon time | Initially empty. In UTC, time when the correspondence is abandoned. |
Table 5: Open Jobs
Column | Description |
---|---|
ID | Unique identifier of the job. |
Envelope ID | Identifier of the envelope where this job is incorporated. Initially not filled in.
Set by the CCM_Bundling standard process. |
State | Current state of the job, such as:
|
Seq. number | Before CCM_Bundling, this is the sequence number of the job in the process. After CCM_Bundling, this is the sequence number of the job in the envelope. The sequence numbers start at 1. |
Created at | Time on the server when the job record is created. |
Printername | Printer for which print distribution is created. Initially not filled in.
Set by the CCM_Bundling standard process. |
Form | Form used when print distribution is created for this job. |
Annex | Reserved for future use. |
Document | Identifier of the slot from which this job originated. |
Document type | Format of the input document of the job, such as: DOCX or PDF. |
Filename | Full path to the input document of the job. |
Rendition | Full path to the PDF file of the job, which is generated from the input document. |
Pagecount | Number of pages of the job. |
Papercount | Number of papers needed for printing the job. Takes duplex printing into account. Adjusted by the CCM_Bundling standard process. |
Simplex/Duplex | Mode of file printing, such as:
|
Document collection - document-nr. | Sequence number of the job in the process. The sequence number starts at 1. |
Process ID | Identifier of the process linked to this job. |
Request ID | Identifier of the request from which this job originated. |
Correspondence ID | Identifier of the correspondence from which this job originated. |
Channel name | Channel used to distribute the job. |
Slot type name | Slot type from which this job originated. |
Cover letter flag | Type of the cover letter in this job, such as:
|
Overlay file name | Overlay to optionally apply to the job. |
Overlay option | Method to apply the overlay, such as:
|
Table 6: Processes
Column | Description |
---|---|
ID | Global unique identifier of the process. |
Status |
Current status of the process, such as: Waiting, Busy, Finished, Error, or Abandoned. |
Process state | Current state of the process, such as:
|
Created at | In UTC, time when the process record was created. |
Title | Label of the communication for which the process is created. |
Error message | Error message. Set when the process is in error. |
Communication Id | Communication for which the process is created. |
Envelope Id | Envelope where the process is incorporated. Initially not filled in.
Set by the CCM_Bundling standard process. |
Seq. number | Sequence number of the process in the envelope where it is incorporated. Initially not filled in. Set by CCM_Bundling standard process. |
Table 7: Envelope
Column | Description |
---|---|
ID | Unique identifier of the envelope. |
Status | Current status of the envelope, such as: Waiting, Finished, Error, or Abandoned. |
Stack ID | Identifier of the stack containing this envelope. Initially empty.
Set by the CCM_Stacking standard process. |
Seq. number | Sequence number of the envelope in the stack where it is incorporated. Initially empty. Set by the CCM_Stacking standard process. |
Channel | Channel to distribute the envelope. |
Created at | In UTC, time when the envelope record was created. |
Error message | Error message. Set when the envelope is in error. |
Postage | Postage class selected for the envelope.
Set by the CCM_Bundling standard process. |
Pagecount | Number of pages in the envelope. |
Sheet number / Papercount | Number of papers needed for printing the envelope. Takes duplex printing and annexes into account. |
Weight | Weight of the envelope, which includes the number of papers, and the weight of the envelope cover. The weight
is shown in grams.
Set by the CCM_Bundling standard process. |
Name | Name of the envelope definition (repository object) that applies to this envelope record (runtime object). Selected from the postage class. |
Organisational metadata | Organizational metadata of this envelope, in JSON. |
Annex | Reserved for future use. |
Table 8: Stack
Column | Description |
---|---|
ID | Unique identifier of the stack. |
Status | Current status of the process, such as: Waiting, Busy, Finished, Error, or Abandoned. |
Stacktype | Current type of the stack, such as:
|
Channel | Channel to distribute the stack. |
Printer | Printer to distribute the stack. |
Created at | In UTC, time when the stack record was created. |
Organisational metadata | Organisational metadata of the stack. |
Distributed at | In UTC, time when the stack was distributed. |
Error message | Error message, only set when the stack is in error. |
Streamfile | Full path to the stream file created for the stack. Initially not filled in.
Set by the CCM_Streaming standard process. |
Papercount | Number of pages in the stack. |
Pagecount | Number of papers needed to print the stack. Takes duplex printing into account. |
Job count | Number of jobs contained in the stack. |
Envelope count | Number of envelopes contained in the stack. |