Nova Actions Guide

Introduction

Nova Actions are powerful administrative tools within Publica.la that enable administrators to perform bulk operations, manage content, and maintain the platform efficiently. This guide provides a comprehensive overview of all available actions organized by resource type, helping administrators understand when and how to use each action effectively.

Actions in Nova are context-sensitive, meaning they appear based on user permissions, resource state, and specific conditions. Understanding these actions is crucial for efficient platform management and troubleshooting.

Understanding Action Types

Nova actions fall into several categories based on their functionality and scope:

Bulk Actions

These actions operate on multiple selected records simultaneously, enabling efficient management of large datasets. Examples include bulk user deletion and bulk coupon creation.

Standalone Actions

These actions don't require record selection and operate at the resource level. They typically trigger system-wide processes or generate reports.

Conditional Actions

These actions only appear when specific conditions are met, such as tenant configuration status or user permissions.

Actions by Resource

Issues Management

The Issues resource provides the most extensive set of actions, reflecting the central role of content management in Publica.la. These actions are primarily restricted to super administrators due to their system-wide impact.

Content Processing Actions

• Reprocess Issues (Send to Queue) - This action triggers a complete reprocessing of a product's content. Use this when content appears corrupted, formatting issues arise, or after system updates that require content refresh. The reprocessing includes text extraction, format conversion, and metadata updates.

• ReEncode Audio - Specifically designed for audiobook content, this action re-encodes audio files to ensure compatibility and optimal quality. This is particularly useful when audio playback issues are reported or when updating audio encoding standards.

• Calculate Size - Calculates and updates the storage size of products. This action is essential for storage management, billing calculations, and identifying unusually large files that might need optimization.

Synchronization and Licensing

• Sync Issues - Synchronizes product data across the platform. This action requires confirmation due to its potential impact on system performance. Use this when discrepancies are detected between different parts of the system or after bulk imports.

• Set License - Establishes licensing terms for products owned by the tenant. This action is crucial for content distribution agreements and marketplace participation. Only available for tenant-owned products.

Marketplace Management

• Set Marketplace Prices - Sets the wholesale price for licensed content. This determines the cost for other tenants to include this product in their catalogs. Only available for tenant-owned products.

• Remove From Marketplace - Removes a product from the marketplace while maintaining it in the owner's catalog. This action requires confirmation and is useful when temporarily withdrawing content or addressing licensing issues. Only available for tenant-owned products.

Inventory Control

• Remove Licensed Issue From Inventory - Removes licensed content from a tenant's inventory. This action has two variants:

  • RETAIL (Withdraw marketplace issues from the inventory): For individually licensed content
  • SHARED (Withdraw shared issues from the inventory): For content under collective licensing agreements

  This action requires confirmation and is only available for non-owned content.

• Remove Tenant Issue - Completely removes a product owned by the tenant. This is a destructive action requiring confirmation and should be used carefully. Only available for tenant-owned products.

• Share With Tenant - Enables direct sharing of products with specific tenants outside the marketplace system. This facilitates private content distribution agreements. Only available for tenant-owned products.

Promotional Tools

• Create Coupons With Random Codes - Generates promotional coupons specific to individual products. This action is only available in the detail view and creates unique, randomized coupon codes for marketing campaigns. Only available for tenant-owned products.

Tenant Management

Tenant management actions focus on customization, feature management, and technical administration of individual storefronts.

Feature Customization

• Create Custom Feature - Enables the creation of tenant-specific features beyond standard offerings. This allows for customized functionality tailored to specific business needs. Only available in index view.

• Delete Custom Feature - Removes custom features when no longer needed or when reverting to standard configurations. Only available in index view.

• Refresh Features Cache - Updates the system's feature cache to ensure all feature changes are immediately reflected across the platform.

Technical Administration

• Create Tenant Sftp Account - Establishes SFTP access for bulk content uploads and automated integrations. This is essential for tenants with large catalogs or regular content updates. Only available when tenant has no existing SFTP credentials. Available in the detail view.

• Delete Tenant Sftp Account - Removes SFTP access when no longer needed or for security purposes. Available in the detail view.

• Reset Tenant Sftp Account Files Permissions - Corrects file permission issues that may prevent proper SFTP operations. Use this when upload failures occur due to permission errors. Only available when tenant has existing SFTP credentials. Available in the detail view.

Data Export and Analysis

• Download Excel - Generates comprehensive Excel reports with tenant-specific data including sales, inventory, and user information. Available in the detail view.

• Download Admin Emails - Exports a list of all administrator email addresses for the tenant, useful for communication and access audits. Available in the detail view.

Commerce Tools

• Create Bulk Coupons - Generates multiple coupons simultaneously for large-scale promotional campaigns. This action streamlines the creation of hundreds or thousands of discount codes. Only available in detail view.

• Set Up Publica.la Payments - Configures the payment processing system for tenants using Publica.la's payment infrastructure. Only available in the detail view.

Customer Management

Customer management actions focus on payment reconciliation and data export capabilities.

Payment Management

• Has Missing Payments - Identifies and flags customers with incomplete payment records. This action integrates with Stripe to detect payment discrepancies and requires confirmation before processing. Only available for customers with Stripe integration.

• Missing Payment Settled - Marks identified missing payments as resolved after manual verification or payment collection.

Data Export

• Export to Excel - Initiates an asynchronous export of customer data to Excel format. The system processes the export in the background and sends an email notification when complete, making it ideal for large datasets.

• Download Admin Emails - Quickly exports administrator contact information for communication purposes.

Coupon Management

Coupon actions enable flexible promotional campaign management through dynamic coupon configuration.

• Add Plan to Coupon - Associates subscription plans with existing coupons, enabling discounts on recurring subscriptions.

• Add Issue to Coupon - Links specific products to coupons, creating targeted promotions for individual titles.

• Change Valid To Coupons - Modifies the expiration date of active coupons, useful for extending promotions or correcting configuration errors.

User Management

User management actions provide tools for both individual and bulk user administration.

• Create Coupons With Random Codes - Generates user-specific promotional codes, enabling personalized marketing campaigns.

• Bulk Delete Users - Removes multiple user accounts simultaneously. This powerful action is restricted to super administrators and is useful for cleaning test accounts or managing GDPR compliance.

• Refresh Reading Permission - Refreshes the reading permissions cache for the selected users (up to 25 at a time). Visible only when the tenant's custom scope feature is enabled, and available to administrators and super administrators. Use this after changing a user's access rules or collections to ensure their reading permissions reflect the latest configuration.

Payment Transaction Management

• Export to CSV - Exports transaction records to CSV format for accounting and reconciliation purposes. The system processes exports in batches of 10,000 records to maintain performance, with email notifications upon completion.

Marketplace

• Add to Library - Enables tenants to add products from the marketplace to their catalog. This streamlined action simplifies content acquisition and catalog expansion. Available to all users.

Sitemaps queue

• Force Dispatch Pending Sitemaps Generation - Manually triggers sitemap generation for SEO purposes. This standalone action ensures search engines have updated content information.

Sales Reporting

The Customer Sales resource provides comprehensive reporting capabilities for business intelligence and analysis.

• Export All Sales Records - Generates detailed sales reports in Excel format, including transaction details, customer information, and revenue analysis. Requires confirmation.

• Export Selected Sales Records - Creates and distributes automated sales reports to designated recipients. This standalone action requires confirmation and can be scheduled for regular execution.

• Export Users Statistics Report - Produces comprehensive user analytics reports for platform analysis. This action is restricted to super administrators due to the sensitive nature of the data and requires confirmation.

Resources Without Custom Actions

The following Nova resources are available but do not have custom actions configured:

Resource Name	Description
PlaFeature	Publica.la platform features
PlaTenantFeature	Tenant-specific custom features
Order	Purchase orders
Plan	Subscription plans
PlaPlan	Publica.la platform plans
PlaPlanFeature	Platform plan features
Price	Pricing configurations
Utm	UTM tracking parameters
LoanBudget	Loan budget management
Loan	Loan records
Activity	System activity logs
LoanTransaction	Loan transaction records
ApiLog	API access logs
PrepaidPlansAboutToExpire	Expiring prepaid plans
UserPlan	User subscription plans
PendingSubscriptions	Pending subscription activations
Sale	Sales records

Best Practices

Permission Considerations

Most actions are restricted to super administrators to prevent accidental system changes. Always verify your permission level before attempting sensitive operations.

Confirmation Requirements

Actions marked as requiring confirmation will prompt for additional verification. These typically involve:

• Data deletion
• System-wide changes
• Resource-intensive operations

Performance Impact

Some actions, particularly those involving bulk operations or system-wide synchronization, can impact platform performance. Schedule these during off-peak hours when possible.

Data Integrity

Always ensure you have recent backups before performing destructive actions like bulk deletions or content removal. The platform's audit log tracks all action executions for accountability.

Troubleshooting Common Issues

Action Not Visible

If an expected action isn't appearing:

1. Verify your user permissions
2. Check if conditional requirements are met
3. Ensure you're in the correct view (index vs. detail)
4. Confirm the resource state allows the action

Action Execution Failures

When actions fail to execute:

1. Check system notifications for error messages
2. Verify all required fields are populated
3. Ensure no conflicting processes are running
4. Contact support if persistent issues occur

Performance Degradation

If actions cause system slowdown:

1. Use queued/asynchronous actions when available
2. Break large operations into smaller batches
3. Schedule resource-intensive actions during maintenance windows
4. Monitor system resources during execution