1. Features and Purpose
The File Distribution Policy module is used to remotely and centrally push various files—such as configuration files, training materials, and promotional assets—to designated devices or device groups. It supports one-click bulk distribution and tracking of delivery results.
This module exists as an independent policy and is not involved in the “module-level merge, latest configuration takes precedence” policy stacking mechanism, nor does it support policy compliance detection or automatic remediation.
The platform supports a complete policy lifecycle, including Create, Configure, Submit, Approve, Publish, Edit, Deactivate, Restore, and Delete. The distribution process is visual, controllable, and traceable.
Notes
Only supports KMA and GMA devices, IMA is not supported.
All files included in the policy must be in the "Uploaded" status.
File Distribution Policy is an independent policy type; the “module-level merge, latest configuration takes precedence” stacking rule does not apply to this policy type.
Compliance detection is not supported; undelivered or deleted files will not trigger automatic remediation.
Primary Operations
Operation | Description |
Create File Distribution Policy | Select files, configure distribution method, set target devices or groups, and complete the policy creation process. |
View Policy Details | View policy content, distribution status, device associations, and execution logs. |
Secondary Operations
Operation | Description |
Submit | Submit a draft policy for approval (if the approval process is enabled). |
Approve | Approve or reject policies in "Pending Review" status. |
Edit | Create a new version of a published policy and adjust its configuration. |
Deploy Policy | Manually re-push a policy to ensure timely delivery or handle delivery failures. |
Activate/Deactivate | Control whether the policy continues to apply to devices; when deactivated, it will no longer be pushed; reactivation resumes execution. |
Revert | Restore an archived policy to draft status for modification or reuse. |
Delete | Permanently remove an archived policy from the system (logical deletion); this action is irreversible. |
Typical Use Cases
Distributing configuration files and materials to stores in different regions.
Pushing training materials or advertising resources to standardize terminal content display.
Replacing manual file transfer methods to standardize and automate content delivery.
Tracking policy delivery logs to improve transparency and content consistency.
Reducing content maintenance and update workload, increasing execution efficiency and delivery success rate.
2. Primary Operations
2.1 Create File Distribution Policy
Description
The File Distribution Policy is used to batch push one or more uploaded files (such as configuration templates, training manuals, promotional materials, etc.) to target devices or device groups. The policy configuration includes file selection, delivery schedule, download behavior, and target device scope.
Unlike Application Policies or Device Policies, the File Distribution Policy is an independent policy type, not involved in the “module-level merge, latest configuration takes precedence” stacking mechanism, and does not support device compliance detection.
Notes
Scope: Applicable only to KMA and GMA devices; IMA is not supported.
Policy Independence: File Distribution Policies do not participate in the policy stacking mechanism and will not be combined with other policies for execution.
No Compliance Detection: Once the policy is delivered, it does not continuously check device status. If a file is deleted, it will not trigger automatic re-delivery.
File Requirements: Only files in the “Uploaded” status under “My Files” can be selected.
Draft Mechanism: Policies can be saved as drafts and submitted later for approval.
Approval Mechanism: If the platform has enabled an approval process, policies must be approved before they take effect and are delivered.
Steps
Step 1: Select Files
Go to the File Distribution Policy module and click Create File Distribution Policy in the top right corner.
Enter the policy name in the “Policy Name” field (required, up to 256 characters).
Optionally fill in the “Policy Description” to explain the policy’s purpose.
In the “My Files List,” check the files to be delivered; the system will display the selected files.
Click Next to proceed to policy configuration.
Step 2: Configure the Policy
Configure the File Distribution Schedule:
Immediate: Execute the policy immediately after publishing.
Scheduled: Select a specific time to start policy delivery.
Configure the File Distribution Behavior:
Download Method:
Manual Download: The user manually downloads files from the Content module in the KiwiCloud App on the device.
Automatic Download: Files are automatically downloaded to the device after the policy is delivered.
Once configuration is complete, click Next to proceed to device selection.
Step 3: Select Target Devices
You can choose:
All Devices: Deliver the policy to all supported devices (KMA / GMA).
Specific Devices: Select specific device groups or individual devices for targeted delivery.
You can filter device groups using keywords.
After selection, click Submit or Save:
Submit: Policy status changes to “Pending Review” and will take effect automatically after approval.
Save: Policy is saved as a “Draft” and can be submitted later.
2.2 View Policy Details
Description
Administrators can use the Details page to view the complete configuration and execution status of a File Distribution Policy. The details include the policy overview, file list, distribution schedule, target devices, delivery logs, and system logs, which facilitate policy verification, operational tracking, and troubleshooting.
You can enter the policy details view by clicking the Details button on the policy list page.
Notes
Policy details are available for policies in Draft, Pending Review, or Published status.
Policies in the Archived status are read-only.
The details display data for the current policy version; if multiple versions exist, you can switch to view different versions.
Operation logs and system logs support filtering by time range and keywords.
Steps
1. View Policy Overview Information
The top section displays the core policy information, including:
Policy name and ID (e.g., GRJT00)
Last modified by and modification time
Most recent successful delivery time (if none, display “--”)
Current policy version number
Number of associated device groups
Number of associated devices
2. View Detailed Configurations
The policy details contain the following tab pages:
1) Selected Files
Displays all file information bound to the policy, including:
File name
File size
Creator
Creation time
2) Distribution Configuration
Displays the delivery method and behavior settings, including:
File distribution schedule: Immediate execution or scheduled delivery time (including time zone)
File download method: Automatic download or manual download
3) Deployment Configuration
Displays the target object scope of the policy, including:
Delivery scope type: All devices or specific devices
Device groups:
Device group name
Number of devices in the group
Creator and creation time
Devices (including devices from selected groups):
Device name
Serial number
Number of associated policies
Associated group
Creator and creation time
4) Operation Logs
Records all operation actions on the current policy, including:
Operation ID
Operation type (e.g., create, submit, approve, modify, etc.)
Operator
Execution result (e.g., success/failure)
Operation log
Operation time
Supports filtering by operation type, time range, and operation ID.
5) System Logs
Automatically records the delivery execution status, including:
Operation ID
Operation type
Execution result
Operation time, duration, etc.
If there has been no automatic delivery behavior, the list will be empty.
3. Secondary Operations
3.1 Submit
Description
The submit operation is used to advance a Draft status File Distribution Policy to the Pending Review stage, entering the approval process. Once submitted, the current configuration of the policy will be locked and cannot be edited again until it is reviewed and processed by an approver before proceeding to publication.
This operation is suitable for scenarios that require policy review and control, such as multi-role collaboration, unified content management, and important configuration verification.
Notes
Only policies in Draft status can be submitted.
If the approval process for the File Distribution Policy is not enabled, submission will directly skip the Pending Review stage and immediately change the policy status to Published.
The system does not provide a secondary confirmation pop-up for submission—please ensure the policy content is correct before performing this operation.
Once submitted, the policy content cannot be changed; if adjustments are needed, you must either revoke the submission or wait until the policy is rejected in the review process and then modify it.
Steps
Enter the Draft Policy List
In the File Distribution Policy module, filter for policies with the status Draft.
Initiate the Submission
Click Actions > Submit for the target policy.
The system will submit the policy immediately without secondary confirmation.
Submission Complete
The policy status changes to Pending Review and appears in the approval list.
Administrators can configure related rules under System Settings → Others → Approval Process Switch.
3.2 Approve
Description
When a File Distribution Policy is submitted by its creator, it enters the Pending Review status. Approvers can review the policy in the policy list and choose to either Approve or Reject it. Only after the policy is approved will it be officially published and trigger the file distribution process.
The approval operation is typically performed by accounts with approval permissions, ensuring that the policy content meets standards, file content is compliant, and the target device selection is reasonable.
If the system’s approval process is disabled, policies will be automatically considered Approved upon submission, requiring no manual action.
Notes
Only policies in Pending Review status can be approved.
Once executed, the approval action cannot be undone.
Approving a policy immediately changes its status to Published and schedules it for execution according to the plan.
Rejecting a policy returns it to Draft status for editing and resubmission.
The platform allows reviewing policy details before approval to ensure content accuracy.
Steps
Go to the File Distribution Policy module and locate the policy with the status Pending Review.
Click the Approve button on the right side of the policy to open the confirmation dialog.
In the dialog, choose Approve or Reject:
Approve: The policy status changes to Published, and it will be distributed according to the scheduled time.
Reject: The policy returns to Draft status, allowing further edits and resubmission.
3.3 Edit
Description
When a published File Distribution Policy needs to be updated (such as file list, delivery schedule, or target device scope), administrators can perform the Edit operation. The system will create a new version based on the current policy, automatically archiving the original version. The new version must be resubmitted and approved before it becomes effective.
Editing a policy does not affect previously executed historical versions; it only impacts execution for the new version. The platform supports multiple edits within a policy's lifecycle, with each edit generating an independent version for future reference and tracking.
Notes
Policies in Draft or Published status can be edited.
Editing automatically creates a new version while retaining the original version record.
The new version must go through the same Submit → Approve → Publish process as a newly created policy.
Policies in Pending Review or Archived status cannot be edited.
Editable fields include: policy name, description, associated files, delivery schedule, download method, and target devices/device groups.
Steps
Go to the File Distribution Policy list page and locate a policy in Published status.
Click the Actions button on the right, then select Edit.
The system will enter the policy editing process, with existing fields automatically populated for adjustment.
Follow the same steps as creating a new policy:
Modify the policy name/description (if needed)
Adjust or replace associated files
Reconfigure delivery schedule and download method (automatic/manual)
Reselect target devices or device groups
After configuration is complete, choose:
Submit to enter the approval process, or
Save as a draft for further editing later.
3.4 Deploy Policy
Description
When a File Distribution Policy is in Published status, administrators can manually execute the Distribute Policy action to immediately push the policy content to its associated devices or device groups, ensuring files are delivered to endpoints promptly.
This feature is useful in scenarios such as:
The policy is scheduled for timed delivery but needs to be executed earlier
The policy configuration is correct but the initial delivery failed and needs a manual retry
The backend has not detected device pull requests, and a manual push is required to trigger delivery
The Distribute Policy operation does not modify the policy content; it only triggers a new delivery task. Execution results can be viewed in the Operation Logs.
Notes
Only policies in Published status can be distributed.
Policies in Draft or Pending Review status cannot be distributed.
Manual distribution does not change the scheduled delivery settings.
The same policy can be distributed multiple times, with the system performing differential delivery to avoid duplication.
Distribution results can be checked in the Operation Logs.
Steps
Go to the File Distribution Policy list page and locate the target policy in Published status.
Click the Actions button on the right and select Distribute Policy.
The system will display a confirmation dialog asking “Are you sure you want to distribute this policy?”
Click Confirm, and the system will start the scheduling task and distribute the policy to all associated devices.
3.5 Disable Policy
Description
Administrators can execute the Disable operation on a File Distribution Policy that is in Published status. Once disabled, the policy will immediately become inactive, and no further file delivery tasks will be executed to devices. All associated devices will no longer receive files from this policy.
This operation is commonly used in the following scenarios:
The policy configuration contains risks or operational errors that require immediate termination
The files are outdated or no longer need to be distributed
Temporarily suspending a policy with the intention to re-enable it later
Notes
Only policies in Published status can be disabled.
After disabling, the policy status changes to Disabled, but its data is retained and can be re-enabled later.
Disabling a policy will not remove files already downloaded on devices.
Disabling a policy does not affect its historical logs and execution records — all versions remain viewable.
Steps
Go to the File Distribution Policy list page and locate the target policy (status: Published).
Click the Actions button on the right and select Disable Policy.
In the confirmation popup, review the prompt and confirm whether to disable the policy.
Click Confirm, and the system will update the policy status to Disabled.
Once disabled, the policy will no longer participate in scheduling. It can later be reactivated via the Enable Policy operation.
3.6 Enable Policy
Description
The Enable operation is used to reactivate a File Distribution Policy that is in Disabled status, restoring it to Published status. Once enabled, the policy becomes effective again, and the system will deliver the configured files to the associated devices at the scheduled time.
This feature is suitable for scenarios where an old policy needs to be restored or a temporarily disabled policy needs to be re-enabled. It eliminates the need to recreate the policy, improving operational efficiency.
Enabling the policy does not affect its original version number or configuration, and it does not re-enter the approval process. Once enabled, the policy is immediately ready for delivery.
Notes
Only policies in Disabled status can be enabled.
Once enabled, the policy status changes to Published.
Enabling does not trigger immediate delivery — the policy will follow the existing delivery schedule.
If the target devices are offline, the system will deliver the files when the devices come online according to the policy settings.
After enabling, you can use the Deliver Policy operation to manually trigger delivery.
Steps
Go to the File Distribution Policy list page and locate the target policy with Disabled status.
Click the Actions button on the right and select Enable Policy.
In the confirmation popup, confirm whether you want to enable the policy.
Click Confirm, and the policy will be restored to Published status.
After enabling, you can go to the Details page or Operation Logs to track the policy execution status. If you need to trigger immediate delivery, use the Deliver Policy operation.
3.7 Archive
Description
The Archive operation is used to remove historical versions or unused File Distribution Policies from the main list and move them to the Archived section for centralized management and record retention. Archived policies are not deleted — they retain complete records and support View, Restore, and Delete actions.
This feature is suitable for the following scenarios:
The policy lifecycle has ended and will no longer be delivered.
The policy version is deprecated but needs to be kept for records.
Simplifying the main list display to improve management efficiency.
The archive action does not require a confirmation popup. Once clicked, it takes effect immediately and the policy is moved to the Archived tab.
Notes
Only policies in Disabled status can be archived.
Once archived, a policy cannot be enabled, modified, or submitted, but it can still be viewed, restored, or deleted.
Archived policies are no longer included in any device policy delivery.
You can use the Restore action to move the policy back to the main list (restoring its original status).
Delete is only available for archived policies and cannot be undone — proceed with caution.
Steps
Go to the File Distribution Policy list page and locate the target policy.
Click the Actions button on the right and select Archive.
The system immediately executes the archive action without additional confirmation.
After successful archiving, the policy is removed from the main list and its status changes to Archived.
Switch to the Archived tab at the top of the page to view archived policies, where you can:
View Details
Restore to Main List
Delete Policy
3.8 Revert
Description
When a policy has been archived but needs to be modified, resubmitted, or re-executed, the Restore function can be used to move it from the Archived list back to the main policy list. After restoration, the policy will always enter the "Draft" status, allowing further operations such as submission, approval, or modification.
This feature is useful in scenarios such as:
Policy archived by mistake and needs to be restored for continued use
Historical policies that need to be adjusted and delivered again
Using an archived policy as a template to reconfigure file delivery content
The restore action does not require a confirmation popup — it takes effect immediately upon clicking.
Notes
Only policies in Archived status can be restored.
Restored policies will always revert to Draft status.
The original policy’s version number, files, device configurations, and other settings remain unchanged.
Restored policies can be found and operated on in the All tab.
Restoration does not affect the policy’s historical logs or archive records.
Steps
Go to the File Distribution Policy module and switch to the Archived tab.
Locate the target policy, click the Actions button on the right, and select Revert.
The system executes the restore action immediately without confirmation.
The policy will be moved to the All tab and displayed in Draft status.
3.9 Delete
Description
The delete action is used to permanently remove a file distribution policy from the system and is only available for policies in Archived status. Once deleted, the policy will no longer appear in any list, and all version information will be cleared.
Before deletion, the system will display a confirmation dialog to ensure the user fully understands the action, preventing accidental deletion.
This action performs a logical deletion — the main policy information (including content and all versions) will be removed, but related log records (such as operation logs and system logs) will be retained for auditing and traceability purposes.
Notes
Only policies in Archived status can be deleted.
A confirmation dialog will appear before deletion.
Deletion is a logical operation; the policy content and all versions will be removed from the system.
Operation logs and system logs will be retained for auditing and will not be affected.
Deleted policies cannot be recovered — it is recommended to use this operation only when the policy is permanently obsolete.
Steps
Go to the File Distribution Policy module and switch to the Archived tab.
Locate the target policy, click the Actions button on the right, and select Delete.
The system will display a confirmation dialog: "Are you sure you want to delete?"
Click Confirm, and the system will execute the logical deletion.
The policy will be removed from the system, but related log information will still be accessible in the logs module.
4. Configuration Items Description
This section explains the configuration items involved in the File Distribution Policy to help understand their meaning and the impact on device behavior.
Configuration Item | Description |
Policy Name | A custom name for the policy, used to identify and manage the file distribution task within the platform. It is recommended to name it based on the purpose and/or target devices. |
Policy Description | An optional note to supplement the purpose of the policy, the types of files included, or the business context, helping the team understand the policy's intent. |
Select Files | Choose one or more files to be distributed. Supports common formats (e.g., PDF, PNG, XLSX, etc.). Files must already be uploaded to My Files. |
File Distribution Plan | Set the delivery time for the files. Options include Immediately or Start Time, used to control when the task will be triggered. |
File Distribution Behavior Configuration | Configure how the device receives files: Automatic Download (device fetches files automatically when online) or Manual Download (user manually downloads files). |
Distribution Range | Define the target of the policy delivery. Can choose Device Groups or individual Devices. The system will push the corresponding files to the selected targets. |























