obsidian/01 Projects/loreal-global-kickoff/USER_MANUAL.md

auto_generated	manual_updated_at	modified
true	2026-05-19	2026-05-19

L'Oréal OMG Assistant Global - User Manual

What This Tool Does

L'Oréal OMG Assistant Global is a centralized web application designed to streamline campaign asset management. It serves two primary purposes:

1. Master Global Asset Submission: Automates the validation and submission of campaign assets stored in Box folders to external systems (via Make.com webhooks).
2. Global to Local CSV Transformation: Converts global campaign data into region-specific CSV files for 16 different international markets, handling date formatting and file distribution.

Additionally, the tool provides comprehensive activity logging for auditing and reporting purposes.

Who Uses It

• Marketing Managers: For validating asset folders and submitting global campaigns.
• Campaign Coordinators: For transforming global data into local market CSVs.
• IT/Support Teams: For monitoring system logs and troubleshooting submission errors.

How to Access

The application is protected by Microsoft Azure AD Single Sign-On (SSO).

1. Navigate to the application URL.
2. You will be redirected to the Microsoft login page.
3. Log in with your L'Oréal corporate credentials.
4. Upon successful authentication, you will be presented with the main dashboard.

Main Workflows

Workflow 1: Master Global Asset Submission

Use this tool to submit campaign assets for review and processing.

Step-by-Step Guide:

1. Navigate to Submission: Select "Master Global Asset Submission" from the dashboard.
2. Enter Box ID:
   • Locate your campaign folder in Box.
   • Copy the Box Folder ID.
   • Paste it into the "Box ID" input field.
3. Validate Folder:
   • Click Lookup or press Enter.
   • The system will verify if the folder exists and contains the required SUPPLIED_ASSETS subfolder.
   • A success message (green checkmark) or error message will appear.
4. Review Details:
   • If valid, the application automatically populates the Master Campaign Number based on the folder hierarchy.
   • Expandable nested folders (3 levels deep) allow you to preview the asset structure.
5. Submit:
   • Fill in any additional required metadata fields if prompted.
   • Click Submit.
   • A webhook sends your data to Make.com. A success or failure notification will confirm the action.

Workflow 2: Global to Local CSV Transformation

Use this tool to prepare regional campaign files from a single global dataset.

Step-by-Step Guide:

1. Navigate to Transformation: Select "Global to Local CSV Transformation" from the dashboard.
2. Upload File:
   • Drag and drop your global campaign CSV file into the designated area, or click to browse.
   • Confirm the file name and size are displayed correctly.
3. Process Data:
   • Click Process.
   • A visual progress tracker will show the 6 stages of processing (e.g., Parsing, Date Transformation, OMG Lookup).
   • If errors occur during processing, detailed error messages will guide you on how to fix the source file.
4. Preview Results:
   • Once processing completes, use the dropdown selector to view any of the 16 generated CSV files (en-GB, es-ES, pt-PT, etc.).
   • Review the content to ensure correct date formatting (DD/MM/YYYY) and regional data.
5. Download:
   • Click Download Individual to save a specific market file.
   • Click Download All to receive a ZIP archive containing all 16 regional CSVs.
6. Optional Upload to Box:
   • If your workflow requires immediate cloud storage, click Upload to Box after downloading.

Workflow 3: Activity Logs & Reporting

Use this tool to audit past actions and system usage.

1. Navigate to Logs: Select "Activity Logs" from the dashboard.
2. View Dashboard: See statistics on total actions, success rates, and unique users.
3. Filter Data: Use the filters to search by:
   • Action Type (e.g., Submission, CSV Transform)
   • User Name
   • Time Period
4. Export: Click Export to CSV to download the filtered log data for external analysis or compliance reporting.

FAQ

Q: I received an "Invalid Box ID" error. What should I do? A: Ensure the ID corresponds to a Folder (not a file) and that it has a direct subfolder named exactly SUPPLIED_ASSETS. Check that you have permission to access the folder in Box.

Q: The CSV transformation failed at Stage 3. What does that mean? A: Stage 3 typically relates to data parsing or OMG API lookups. Review the specific error message provided. It may indicate missing required columns in your source CSV or a temporary connectivity issue with the OMG API.

Q: How long are my activity logs retained? A: Logs are stored in a JSON file on the server. Retention policies are managed by the IT department. Please contact support for long-term archival needs.

Q: Can I cancel a CSV transformation once started? A: Yes. Click the Cancel button during the processing stage. Note that any partially generated files may need to be cleaned up manually or via the log export review.

Q: Why are dates formatted as DD/MM/YYYY in the local CSVs? A: This standardizes dates for international markets where the Month/Day format is non-standard. The tool adds 1 month to the original global date to align with local campaign timelines.