Additional features

BeginerGuide/Loop/merge_loop.py

@@ -0,0 +1,63 @@
+import sys
+sys.path.insert(0, "C:/Users/em8ee/OneDrive/Documents/cloudofficeprint-python")
+import cloudofficeprint as cop 
+
+
+data = cop.elements.ElementCollection("data")
+
+eng_emp1 = cop.elements.ElementCollection.from_mapping({
+    "name": "John Smith",
+    "project": "Website Redesign", 
+    "status": "In Progress"
+})
+
+eng_emp2 = cop.elements.ElementCollection.from_mapping({
+    "name": "Emily Johnson",
+    "project": "API Development",
+    "status": "Completed"
+})
+
+eng_emp3 = cop.elements.ElementCollection.from_mapping({
+    "name": "Michael Brown", 
+    "project": "Mobile App",
+    "status": "Planning"
+})
+
+mkt_emp1 = cop.elements.ElementCollection.from_mapping({
+    "name": "Sarah Wilson",
+    "project": "Brand Campaign",
+    "status": "In Progress"
+})
+
+mkt_emp2 = cop.elements.ElementCollection.from_mapping({
+    "name": "David Thompson",
+    "project": "Market Research", 
+    "status": "Not Started"
+})
+
+engineering_dept = cop.elements.ElementCollection.from_mapping({
+    "department": "Engineering"
+})
+engineering_dept.add(cop.elements.ForEachMergeCells("employees", [eng_emp1, eng_emp2, eng_emp3]))
+
+marketing_dept = cop.elements.ElementCollection.from_mapping({
+    "department": "Marketing"
+})
+marketing_dept.add(cop.elements.ForEachMergeCells("employees", [mkt_emp1, mkt_emp2]))
+
+departments = cop.elements.ForEachMergeCells("departments", [engineering_dept, marketing_dept])
+
+data.add(departments)
+
+server = cop.config.Server(
+    "http://localhost:8010/"
+)
+# Create print job
+# PrintJob combines template, data, server and an optional output configuration
+printjob = cop.PrintJob(
+    data=data,
+    server=server,
+    template=cop.Resource.from_local_file("C:/Users/em8ee/OneDrive/Documents/cloudofficeprint-python/BeginerGuide/Loop/data/tem.docx"),
+)
+response = printjob.execute()
+response.to_file("C:/Users/em8ee/OneDrive/Documents/cloudofficeprint-python/BeginerGuide/Loop/output/output.docx")

BeginerGuide/Transformation/usingTransformation.py

@@ -0,0 +1,127 @@
+import sys
+sys.path.insert(0, "C:/Users/em8ee/OneDrive/Documents/cloudofficeprint-python")
+import cloudofficeprint as cop
+
+# Create main data structure representing the files array
+files = cop.elements.ElementCollection(name="files")
+
+# Create a file entry
+file_entry = cop.elements.ElementCollection()
+file_entry.add(cop.elements.Property("filename", "file1"))
+
+# Add customer data
+data_array = cop.elements.ElementCollection()
+customer = cop.elements.Property(
+    name='cust_first_name',
+    value='John'
+)
+customer_last_name = cop.elements.Property(
+    name='cust_last_name',
+    value='Dullas'
+)
+
+data_array.add(customer)
+data_array.add(customer_last_name)
+
+# Product data
+product1 = cop.elements.ElementCollection.from_mapping({
+    "product_name": "Buisness Shirt",
+    "unit_price": 50, 
+    "quantity": 3,
+    "category": "Mens"
+})
+
+product2 = cop.elements.ElementCollection.from_mapping({
+    "product_name": "Trousers",
+    "unit_price": 80,
+    "quantity": 3,
+    "category": "Mens" 
+})
+
+product3 = cop.elements.ElementCollection.from_mapping({
+    "product_name": "Jacket", 
+    "unit_price": 150,
+    "quantity": 3,
+    "category": "Mens"
+})
+product4 = cop.elements.ElementCollection.from_mapping({
+    "product_name": "Blouse", 
+    "unit_price": 60,
+    "quantity": 3,
+    "category": "Womens"
+})
+product5 = cop.elements.ElementCollection.from_mapping({
+    "product_name": "Skirt", 
+    "unit_price": 80,
+    "quantity": 3,
+    "category": "Womens"
+})
+product6 = cop.elements.ElementCollection.from_mapping({
+    "product_name": "Ladies Shoes", 
+    "unit_price": 120,
+    "quantity": 2,
+    "category": "Womens"
+})
+product7 = cop.elements.ElementCollection.from_mapping({
+    "product_name": "Belt", 
+    "unit_price": 50,
+    "quantity": 2,
+    "category": "Accessories"
+})
+product8 = cop.elements.ElementCollection.from_mapping({
+    "product_name": "Bag", 
+    "unit_price": 50,
+    "quantity": 2,
+    "category": "Accessories"
+})
+product9 = cop.elements.ElementCollection.from_mapping({
+    "product_name": "Mens Shoes", 
+    "unit_price": 110,
+    "quantity": 2,
+    "category": "Mens"
+})
+product10 = cop.elements.ElementCollection.from_mapping({
+    "product_name": "Wallet", 
+    "unit_price": 50,
+    "quantity": 2,
+    "category": "Accessories"
+})
+
+product = cop.elements.ForEach("product", [product1, product2, product3, product4, product5, product6, product7, product8, product9, product10])
+data_array.add(product)
+
+# Create main data object
+main_data = cop.elements.ElementCollection()
+main_data.add(cop.elements.Property("data", data_array))
+data = main_data.as_dict
+
+# Transformation function
+js_code ="function generateProductRows(products, category) {\r\n    return products\r\n        .filter(product => product.category === category)\r\n        .map(product => {\r\n            if (category === \"Mens\") {\r\n                product.category_bold = \"true\";\r\n                product.product_name_font_color = \"blue\";\r\n            } else {\r\n                product.category_italic = \"true\";\r\n                product.product_name_font_color = \"red\";\r\n            }\r\n            const totalCost = product.unit_price * product.quantity;\r\n            return `\r\n                <tr>\r\n                    <td style=\"border-width: 1px; border-style: solid; border-color: black; padding: 8px;\">${product.product_name}</td>\r\n                    <td style=\"border-width: 1px; border-style: solid; border-color: black; padding: 8px;\">${product.unit_price}</td>\r\n                    <td style=\"border-width: 1px; border-style: solid; border-color: black; padding: 8px;\">${product.quantity}</td>\r\n                    <td style=\"border-width: 1px; border-style: solid; border-color: black; padding: 8px;\">${totalCost}</td>\r\n                </tr>\r\n            `;\r\n        })\r\n        .join('');\r\n}\r\n\r\nfunction transform() {\r\n    files.forEach(file => {\r\n        let data = file.data;\r\n            // Initialize HTML strings for mens_products and womens_products\r\n            let mensProductsHtml = '<table style=\"width: 100%; border: 2px solid blue; border-collapse: collapse;\">';\r\n            let womensProductsHtml = '<table style=\"width: 100%; border: 2px solid red; border-collapse: collapse;\">';\r\n\r\n            // Add table headers\r\n            const tableHeaders = `\r\n                <tr>\r\n                    <th style=\"border-width: 1px; border-style: solid; border-color: black; padding: 8px;\">Product Name</th>\r\n                    <th style=\"border-width: 1px; border-style: solid; border-color: black; padding: 8px;\">Unit Price</th>\r\n                    <th style=\"border-width: 1px; border-style: solid; border-color: black; padding: 8px;\">Quantity</th>\r\n                    <th style=\"border-width: 1px; border-style: solid; border-color: black; padding: 8px;\">Total Cost</th>\r\n                </tr>\r\n            `;\r\n            mensProductsHtml += tableHeaders;\r\n            womensProductsHtml += tableHeaders;\r\n\r\n            // Generate HTML rows for mens and womens products\r\n            const mensProductsRows = generateProductRows(data.product, \"Mens\");\r\n            const womensProductsRows = generateProductRows(data.product, \"Womens\");\r\n\r\n            // Calculate totals using reduce\r\n            const mensTotals = data.product\r\n                .filter(product => product.category === \"Mens\")\r\n                .reduce((totals, product) => {\r\n                    totals.quantity += product.quantity;\r\n                    totals.cost += product.unit_price * product.quantity;\r\n                    return totals;\r\n                }, { quantity: 0, cost: 0 });\r\n\r\n            const womensTotals = data.product\r\n                .filter(product => product.category === \"Womens\")\r\n                .reduce((totals, product) => {\r\n                    totals.quantity += product.quantity;\r\n                    totals.cost += product.unit_price * product.quantity;\r\n                    return totals;\r\n                }, { quantity: 0, cost: 0 });\r\n\r\n            // Close the HTML tables\r\n            mensProductsHtml += mensProductsRows + '</table>';\r\n            womensProductsHtml += womensProductsRows + '</table>';\r\n\r\n            // Add the new entries to the data object\r\n            data.mens_products = mensProductsHtml;\r\n            data.womens_products = womensProductsHtml;\r\n            data.mens_total_quantity = mensTotals.quantity;\r\n            data.mens_total_cost = mensTotals.cost;\r\n            data.womens_total_quantity = womensTotals.quantity;\r\n            data.womens_total_cost = womensTotals.cost;\r\n    });\r\n    return files;\r\n}\r\n"
+# Transformation objeect
+transformation_function = cop.TransformationFunction(js_code)
+
+# transformation_function = cop.TransformationFunction("sample_transform.js")
+
+# Configure the Server 
+server = cop.config.Server(
+    url="http://localhost:8010/",
+    config=cop.config.ServerConfig(api_key="YOUR_API_KEY")  
+)
+
+template = cop.Resource.from_local_file(
+    "C:/Users/em8ee/OneDrive/Documents/cloudofficeprint-python/BeginerGuide/Transformation/data/template.docx"
+)
+output_conf = cop.config.OutputConfig(filetype="pdf")
+
+# Create print job 
+printjob = cop.PrintJob(
+    data=data,
+    server=server,
+    template=template,
+    output_config=output_conf,
+    transformation_function=transformation_function 
+)
+
+response = printjob.execute()
+response.to_file(
+        "C:/Users/em8ee/OneDrive/Documents/cloudofficeprint-python/BeginerGuide/Transformation/output/output.pdf")

BeginerGuide/UsingCharts/usingChart.py

@@ -26,6 +26,8 @@
     '2px',
     'sysDash'
 )
+
+# To make line stacked chart you can simply use cop.elements.LineStackedChart
 line_chart = cop.elements.LineChart(
     'line_chart_name',
     (line1, line2)

BeginerGuide/UsingDistribute/UsingDistribute.py

@@ -0,0 +1,75 @@
+import sys
+sys.path.insert(0, "C:/Users/em8ee/OneDrive/Documents/cloudofficeprint-python")
+import cloudofficeprint as cop
+
+#ROOT element collection 
+root = cop.elements.ElementCollection("root")
+
+# Create file entry with filename
+file_entry = cop.elements.ElementCollection.from_mapping({
+    "filename": "department_report.docx"
+})
+
+# Main data container
+data_content = cop.elements.ElementCollection("data")
+
+# Create department elements 
+def create_department(name, employees):
+    dept = cop.elements.ElementCollection.from_mapping({
+        "department": name 
+    })
+    dept.add(cop.elements.ForEach("employees", employees))
+    return dept
+
+# Create departments with distribution
+departments = cop.elements.ForEachInline(
+    name="departments",
+    content=[
+        create_department("Engineering", [
+            cop.elements.ElementCollection.from_mapping({
+                "name": "John Smith",
+                "project": "Website Redesign",
+                "status": "In Progress"
+            }),
+            cop.elements.ElementCollection.from_mapping({
+                "name": "Emily Johnson",
+                "project": "API Development",
+                "status": "Completed"
+            })
+        ]),
+        create_department("Marketing", [
+            cop.elements.ElementCollection.from_mapping({
+                "name": "Sarah Wilson",
+                "project": "Brand Campaign",
+                "status": "In Progress"
+            }),
+            cop.elements.ElementCollection.from_mapping({
+                "name": "David Thompson",
+                "project": "Market Research",
+                "status": "Not Started"
+            })
+        ])
+    ],
+    distribute=True
+)
+
+# Build the hierarchy correctly
+data_content.add(departments)
+file_entry.add(data_content)
+root.add(file_entry)
+
+# Configure server
+server = cop.config.Server("http://localhost:8010/")
+
+# Create print job with CORRECT OUTPUT PATH
+printjob = cop.PrintJob(
+    data=root,
+    server=server,
+    template=cop.Resource.from_local_file(
+        "C:/Users/em8ee/OneDrive/Documents/cloudofficeprint-python/BeginerGuide/UsingDistribute/data/horizontal_tabular_looping_output-ed506eb2e341afbf52e1a05319e2b086.docx"
+    ),
+)
+
+# Save to DIFFERENT FILE than template
+response = printjob.execute()
+response.to_file("C:/Users/em8ee/OneDrive/Documents/cloudofficeprint-python/BeginerGuide/UsingDistribute/output/output.docx")

BeginerGuide/UsingElements/using_elements.py

@@ -1,6 +1,9 @@
 # Install cloudofficeprint using  pip install cloudofficeprint
 #Import the cloudofficeprint libary.
-from ... import cloudofficeprint as cop
+import sys
+sys.path.insert(0, "PATH_TO_COP_DIR")
+import cloudofficeprint as cop
+
 # Main object that holds the data
 collection = cop.elements.ElementCollection()
 # Create the title element and add it to the element collection
@@ -42,6 +45,31 @@
     )
 collection.add(styled_prop)
 
+docx_column1_cell_style = cop.elements.CellStyleDocx(
+        cell_background_color='red',
+        border_color='0d72c7',
+        border_top='double'
+    )
+docx_column1_table_style_property = cop.elements.CellStyleProperty(
+        name='column1',
+        value='DemoCustomerName',
+        cell_style=docx_column1_cell_style
+    )
+collection.add(docx_column1_table_style_property)
+
+docx_column2_cell_style = cop.elements.CellStyleDocx(
+        border_diagonal_down='single',
+        border_diagonal_down_size=10,
+        border_diagonal_up='single',
+        border_diagonal_up_color='#0d72c7'
+    )
+docx_column2_table_style_property = cop.elements.CellStyleProperty(
+        name='column2',
+        value='DemoCustomerName',
+        cell_style=docx_column2_cell_style
+    )
+collection.add(docx_column2_table_style_property)
+
 # ------------------watermark----------
 watermark = cop.elements.Watermark(
         name='watermark_name',
@@ -66,8 +94,8 @@
 printjob = cop.PrintJob(
     data=collection,
     server=server,
-    template=cop.Resource.from_local_file("./data/template.docx"),
+    template=cop.Resource.from_local_file("D:/UC/cloudofficeprint-python/BeginerGuide/UsingElements/data/template.docx"),
 )
 # Execute print job and save response to file
 response = printjob.execute()
-response.to_file("output/output")
+response.to_file("D:/UC/cloudofficeprint-python/BeginerGuide/UsingElements/output/output.docx")