Additional features

BeginerGuide/Loop/merge_loop.py

@@ -0,0 +1,63 @@
+import sys
+sys.path.insert(0, "PATH_TO_COP_DIR")
+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("./data/tem.docx"),
+)
+response = printjob.execute()
+response.to_file("./output/output.docx")

BeginerGuide/Loop/usingLabel.py

@@ -0,0 +1,65 @@
+import sys
+sys.path.insert(0,"PATH_TO_COP_DIR")
+import cloudofficeprint as cop 
+
+# Create main collection
+collection = cop.elements.ElementCollection()
+
+# Create elements for the labels
+element1 = cop.elements.ElementCollection.from_mapping(
+    {
+        "FirstName": "John",
+        "LastName": "Smith",
+        "Company": "Tech Solutions Inc.",
+        "Address1": "123 Business Ave",
+        "City": "San Francisco",
+        "State": "CA",
+        "PostalCode": "94105"
+    }
+)
+element2 = cop.elements.ElementCollection.from_mapping(
+    {
+        "FirstName": "Sarah",
+        "LastName": "Johnson",
+        "Company": "Marketing Pro LLC",
+        "Address1": "456 Market Street",
+        "City": "New York",
+        "State": "NY",
+        "PostalCode": "10013"
+    }
+)
+element3 = cop.elements.ElementCollection.from_mapping(
+    {
+        "FirstName": "Michael",
+        "LastName": "Brown",
+        "Company": "Digital Services Co.",
+        "Address1": "789 Innovation Blvd",
+        "City": "Chicago",
+        "State": "IL",
+        "PostalCode": "60601"
+    }
+)
+
+loopLabel = cop.elements.loops.Labels(
+    name="labels",
+    content=[element1, element2, element3]
+)
+#  Add the loop to the main collection
+collection.add(loopLabel)
+
+# Server 
+server = cop.config.Server(
+    "http://localhost:8010/",
+    cop.config.ServerConfig(api_key="YOUR_API_KEY")
+)
+
+# Create print job
+printjob = cop.PrintJob(
+    data=collection,
+    server=server,
+    template=cop.Resource.from_local_file("./data/label_temp.docx")
+)
+
+# Execute and save the output
+response = printjob.execute()
+response.to_file("./output/label_output.docx")

BeginerGuide/Loop/usingLoop.py

@@ -0,0 +1,55 @@
+import sys
+sys.path.insert(0,"PATH_TO_COP_DIR")
+import cloudofficeprint as cop 
+
+# Create main collection
+collection = cop.elements.ElementCollection()
+
+# Create elements for the loop
+element1 = cop.elements.ElementCollection.from_mapping(
+    {
+        "a": 1,
+        "b": 2,
+        "c": 3
+    }
+)
+
+element2 = cop.elements.ElementCollection.from_mapping(
+    {
+        "a": 4,
+        "b": 5,
+        "c": 6
+    }
+)
+
+# Create  loop
+loop = cop.elements.loops.ForEachInline(
+    name="loop_name",
+    content=[element1, element2]
+)
+
+# Add loop to collection
+collection.add(loop)
+
+# Server configuration
+server = cop.config.Server(
+    "http://localhost:8010/",
+    cop.config.ServerConfig(api_key="YOUR_API_KEY")
+)
+
+# Create print job with output type specified
+# For running on localhost you do not need api_key else replace below "YOUR_API_KEY" with your api key.
+server = cop.config.Server(
+    "http://localhost:8010/",
+    cop.config.ServerConfig(api_key = "YOUR_API_KEY")
+)
+# Create print job
+# PrintJob combines template, data, server and an optional output configuration
+printjob = cop.PrintJob(
+    data=collection,
+    server=server,
+    template=cop.Resource.from_local_file("./data/loop_template.docx"),
+)
+# Execute and save
+response = printjob.execute()
+response.to_file("./output/output_loop.docx")

BeginerGuide/Loop/usingSheetLoop.py

@@ -0,0 +1,68 @@
+import sys
+sys.path.insert(0,"PATH_TO_COP_DIR")
+import cloudofficeprint as cop 
+
+# Create main collection
+collection = cop.elements.ElementCollection()
+
+# Create elements for customer invoices
+element1 = cop.elements.ElementCollection.from_mapping(
+    {
+        "cust_first_name": "John",
+        "cust_last_name": "Smith",
+        "orders": [
+            {"order_name": "Office Supplies", "order_total": "$525.00"},
+            {"order_name": "Electronics", "order_total": "$1,299.99"},
+            {"order_name": "Furniture", "order_total": "$2,450.00"}
+        ]
+    }
+)
+
+element2 = cop.elements.ElementCollection.from_mapping(
+    {
+        "cust_first_name": "Sarah",
+        "cust_last_name": "Johnson",
+        "orders": [
+            {"order_name": "Software License", "order_total": "$899.00"},
+            {"order_name": "IT Support", "order_total": "$750.00"}
+        ]
+    }
+)
+
+element3 = cop.elements.ElementCollection.from_mapping(
+    {
+        "cust_first_name": "Michael",
+        "cust_last_name": "Brown",
+        "orders": [
+            {"order_name": "Marketing Services", "order_total": "$3,500.00"},
+            {"order_name": "Training Materials", "order_total": "$450.00"},
+            {"order_name": "Cloud Storage", "order_total": "$199.99"}
+        ]
+    }
+)
+
+# Create sheet loop
+loop = cop.elements.loops.ForEachSheet(
+    name="customers",
+    content=[element1, element2, element3]
+)
+
+# Add loop to collection
+collection.add(loop)
+
+# Server configuration
+server = cop.config.Server(
+    "http://localhost:8010/",
+    cop.config.ServerConfig(api_key="YOUR_API_KEY")
+)
+
+# Create print job
+printjob = cop.PrintJob(
+    data=collection,
+    server=server,
+    template=cop.Resource.from_local_file("./data/shhet_temp.xlsx")
+)
+
+# Execute and save
+response = printjob.execute()
+response.to_file("./output/sheet_output.xlsx")

BeginerGuide/Loop/usingSlideLoop.py

@@ -0,0 +1,61 @@
+import sys
+sys.path.insert(0,"PATH_TO_COP_DIR")
+import cloudofficeprint as cop 
+
+# Create main collection
+collection = cop.elements.ElementCollection()
+
+# Create elements for the loop
+element1 = cop.elements.ElementCollection.from_mapping(
+    {
+        "a": "Sales Report Q1",
+        "b": "Total Revenue: $125,000",
+        "c": "Growth: 15% YoY"
+    }
+)
+element2 = cop.elements.ElementCollection.from_mapping(
+    {
+        "a": "Marketing Metrics Q1",
+        "b": "New Customers: 2,500",
+        "c": "Campaign ROI: 225%"
+    }
+)
+element3 = cop.elements.ElementCollection.from_mapping(
+    {
+        "a": "Product Performance Q1",
+        "b": "Units Sold: 45,000",
+        "c": "Customer Satisfaction: 4.8/5"
+    }
+)
+element4 = cop.elements.ElementCollection.from_mapping(
+    {
+        "a": "Support Analytics Q1",
+        "b": "Tickets Resolved: 3,200",
+        "c": "Average Response Time: 2.5h"
+    }
+)
+
+#slide loop
+loop = cop.elements.loops.ForEachSlide(
+    name="slideloop",
+    content=[element1, element2, element3, element4]
+)
+#  Add the loop to the main collection
+collection.add(loop)
+
+# Server 
+server = cop.config.Server(
+    "http://localhost:8010/",
+    cop.config.ServerConfig(api_key="YOUR_API_KEY")
+)
+
+# Create print job
+printjob = cop.PrintJob(
+    data=collection,
+    server=server,
+    template=cop.Resource.from_local_file("./Loop/data/slide_temp.pptx")
+)
+
+# Execute and save the output
+response = printjob.execute()
+response.to_file("./Loop/output/output")

BeginerGuide/Loop/usingUncertainLoop.py

@@ -0,0 +1,49 @@
+import sys
+sys.path.insert(0,"PATH_TO_COP_DIR")
+import cloudofficeprint as cop
+
+# Create main collection
+collection = cop.elements.ElementCollection()
+
+# Create products data
+products = [
+    {"prod_name": "Business Shirt", "category": "Mens"},
+    {"prod_name": "Trousers", "category": "Mens"},
+    {"prod_name": "Jacket", "category": "Mens"},
+    {"prod_name": "Blouse", "category": "Womens"},
+    {"prod_name": "Skirt", "category": "Womens"},
+    {"prod_name": "Ladies Shoes", "category": "Womens"},
+    {"prod_name": "Belt", "category": "Accessories"},
+    {"prod_name": "Bag", "category": "Accessories"},
+    {"prod_name": "Mens Shoes", "category": "Mens"},
+    {"prod_name": "Wallet", "category": "Accessories"}
+]
+
+#elements for each product item
+product_elements = []
+for product in products:
+    element_collection = cop.elements.ElementCollection()
+    element_collection.add(cop.elements.Property("prod_name", product["prod_name"]))
+    element_collection.add(cop.elements.Property("category", product["category"]))
+    product_elements.append(element_collection)
+
+#ForEach loop
+collection.add(cop.elements.ForEach(name="products", content=product_elements))
+
+# Server configuration
+server = cop.config.Server(
+    "http://localhost:8010/",
+    cop.config.ServerConfig(api_key="YOUR_API_KEY")
+)
+
+# Create print job
+template = cop.Resource.from_local_file("./data/un_loop.docx")
+printjob = cop.PrintJob(
+    data=collection,
+    server=server,
+    template=template
+)
+
+# Execute and save
+response = printjob.execute()
+response.to_file("./output/uncertain_loop.docx")