Bulk Actions

Overview⚓︎

The Bulk Actions feature in Expeto xControl streamlines the management of multiple Mobile Assets by enabling the following operations:

• Bulk Import: Add Mobile Assets in large quantities using a .out file. This method ensures efficient data entry and allows configuration of parameters such as Customer, System, System Profile, Keyset, and initial status.
• Bulk Update: Modify or configure multiple Mobile Assets simultaneously. Updates can include changing status, assigning a System Profile, adding Extensions, or moving assets to a new System. This can be done directly or via a CSV file export/import process.
• Bulk Delete: Permanently remove multiple Mobile Assets from the list, freeing up resources and decluttering your network configuration.

These tools reduce manual effort, ensure data consistency, and enable administrators to efficiently manage large-scale Mobile Asset deployments.

Bulk Import⚓︎

The bulk import feature streamlines the process of adding multiple Mobile Assets to the system by uploading an .out file. This file contains the required details, such as IMSI values, along with optional configuration parameters. Once imported, the Mobile Assets are listed under the chosen System in the Mobile Asset list.

Key Features:⚓︎

• Supports importing Mobile Asset details in bulk using a .out file.
• Allows configuration of parameters such as Customer, System, System Profile, Keyset, and initial status.
• Includes validation checks to ensure file accuracy and proper mapping of columns.
• Provides flexibility to add Extensions for custom parameters.

How to Perform a Bulk Import⚓︎

1. Navigate to the Mobile Assets page.
2. Click the Import button: , then select Import Import.
3. Click Choose File and select the .out file to import.
   • If the file format is incorrect or validation errors occur, you will be notified.
   • If the file format is valid, the column mapping interface will appear.
4. Assign Expeto-specific parameters to the Mobile Assets. For example:
   • Customer: Select the associated Customer.
   • System: Choose the target System.
   • System Profile: Assign a System Profile for the Mobile Assets.
   • Keyset: Link an encryption Keyset for authentication.
5. Generate a 128-bit (32-character) hexadecimal string and paste it into the K encryption key field. This key is used to encrypt Mobile Asset authentication values.
6. Select the Initial Status for the Mobile Assets:
   • Active: Enables network access immediately.
   • Inactive: Prevents network access until manually activated.
7. Add any Extensions to set custom parameters for all imported Mobile Assets. For example, to add an import timestamp, use:
   • Key: importDate
   • Value: January20
8. Enable the Overwrite if Existing checkbox to replace any existing Mobile Asset with the same IMSI.
   • If this option is disabled and duplicates are found, the import will fail.
9. Click Submit to complete the import process. The imported Mobile Assets will appear in the list.

Notes and Tips⚓︎

File Content and Validation⚓︎

Before importing, the .out file undergoes a validation process to ensure proper formatting and headers. Common validation errors include:

• Missing or invalid headers.
• Missing mappings for required fields.
• Incorrect IMSI formats.
• Mismatched column counts.

Required Fields:⚓︎

• ICCID: The Integrated Circuit Card Identifier, engraved on the SIM card.
• KI: The Key Identifier, encrypted using the provided K encryption key.
• IMSI: The International Mobile Subscriber Identity, uniquely identifying each Mobile Asset.

Example .out File:⚓︎

Below is an example of a properly formatted .out file:

**************************************
*       HEADER DESCRIPTION           *
**************************************
Customer: Unreal Communications
Quantity: 6
Type:     PLUG-IN
Profile:  1.0
Batch:
*
Transport_key:
*
Graph_ref : 2.0

Address1: Unreal Communications
Address2: TBC Address3
Address4: TBC Address5
Artwork:  <artwork file>

***************************************
*       INPUT VARIABLES               *
***************************************
Var_In_List:

IMSI1:    123799534412226
IMSI2:    456060048546604
SER_NB:  1924120429575334375

***************************************
*       OUTPUT VARIABLE               *
***************************************
var out:ICC_ID/KI/IMSI/IMSI2/OPc/PIN1/PUK1/PIN2/PUK2/ADM
1924120429575334375 '8978B79E7C104F678FA5C336509DB188 123799534412226 456060048546604 6F2E82855DEE7C893CB1F7A72FD08B57 0000 05185749 2847 60978080 76183215
1924120429575334376 '8978B79E7C104F678FA5C336509DB188 123799534412227 456060048546605 6F2E82855DEE7C893CB1F7A72FD08B57 0000 05185749 2847 60978080 76183215
1924120429575334377 '8978B79E7C104F678FA5C336509DB188 123799534412228 456060048546606 6F2E82855DEE7C893CB1F7A72FD08B57 0000 05185749 2847 60978080 76183215
1924120429575334378 '8978B79E7C104F678FA5C336509DB188 123799534412229 456060048546607 6F2E82855DEE7C893CB1F7A72FD08B57 0000 05185749 2847 60978080 76183215
1924120429575334379 '8978B79E7C104F678FA5C336509DB188 123799534412230 456060048546608 6F2E82855DEE7C893CB1F7A72FD08B57 0000 05185749 2847 60978080 76183215
1924120429575334380 '8978B79E7C104F678FA5C336509DB188 123799534412231 456060048546609 6F2E82855DEE7C893CB1F7A72FD08B57 0000 05185749 2847 60978080 76183215

Bulk Update⚓︎

The Bulk Update feature enables administrators to modify existing values or apply new configurations to multiple Mobile Assets simultaneously. This streamlined process allows for efficient management of Mobile Assets with consistent updates.

Common Bulk Update Tasks⚓︎

The following tasks can be performed using the Bulk Update feature:

• Activate or Deactivate Mobile Assets: Change the status of selected Mobile Assets.
• Move Mobile Assets to a New System: Relocate all selected assets to a single target System.
• Assign a System Profile: Apply a System Profile to selected Mobile Assets. System Profiles are System-specific; you must select a System before assigning a System Profile.
• Add Extensions: Assign the same custom Extensions to all selected Mobile Assets.

Steps to Perform a Bulk Update⚓︎

1. Navigate to the Mobile Assets page.
2. Select the Mobile Assets to update:
   • Use the checkboxes to select individual Mobile Assets or select all using the "Select All" checkbox.
3. Click Edit. The Update page displays the number of Mobile Assets selected for modification.
4. Provide updated values for the selected Mobile Asset parameters. Existing values will be replaced by the new inputs.
5. Click Save to confirm and apply the updates. You will be prompted to verify the request before changes are applied.

Bulk Delete⚓︎

The Bulk Delete feature allows you to permanently remove multiple Mobile Assets from the Mobile Asset list. This action is irreversible unless specific System-level permissions are available to restore deleted assets.

Steps to Perform a Bulk Delete⚓︎

1. Navigate to the Mobile Assets page.
2. Select the Mobile Assets you want to delete:
   • Use the checkboxes to select individual Mobile Assets or select all using the "Select All" checkbox.
3. Click Delete to initiate the removal process.
4. A confirmation dialog will appear. Click OK to confirm and complete the deletion.

Export to CSV⚓︎

The Export to CSV feature allows you to download a file containing the current configuration of all Mobile Assets for editing or record-keeping purposes.

Steps to Export a CSV File⚓︎

1. Navigate to the Mobile Assets page.
2. Click the Export button .

Updating and Re-Importing the CSV File⚓︎

To make changes using the exported file:

1. Open the downloaded CSV file in a text editor or spreadsheet application.
2. Modify the desired values and save the file with a .csv extension.
3. Navigate to the Mobile Assets page and click Bulk Actions.
4. Select Bulk CSV Update.
5. Click Choose File and upload the modified .csv file. Click Next to proceed.
6. The file is verified for formatting errors. If no issues are found, click Submit to apply the updates.

CSV File Format⚓︎

When preparing a CSV file for bulk updates, ensure the required columns are correctly formatted and all necessary information is included.

Required Columns⚓︎

Example File Structure⚓︎

An example of a CSV file structure is shown below:

To change a parameter value, edit the corresponding cell in the row for the Mobile Asset. Leave the cell blank to set the value to null.