regenerate pdfco, include docuware, signinghub

Author: hallvictoria

.github/skills/connection-setup/SKILL.md

@@ -65,7 +65,7 @@ Remove-Item $tempFile -ErrorAction SilentlyContinue
 
 ### Step 2: Create Connection
 
-Supported SDK connector names: `arm`, `azureautomation`, `azuredatafactory`, `azuredigitaltwins`, `azuremonitorlogs`, `azuread`, `azureblob`, `box`, `azurequeues`, `azuretables`, `azurevm`, `commondataservice`, `documentdb`, `dropbox`, `docusign`, `eventhubs`, `excelonline`, `excelonlinebusiness`, `ftp`, `github`, `googlecalendar`, `googledrive`, `googletasks`, `jira`, `keyvault`, `kusto`, `microsoftbookings`, `microsoftforms`, `mq`, `msgraphgroupsanduser`, `office365`, `office365groups`, `office365groupsmail`, `office365users`, `onedrive`, `onedriveforbusiness`, `onenote`, `outlook`, `planner`, `powerbi`, `rss`, `salesforce`, `servicebus`, `sharepointonline`, `shifts`, `slack`, `smtp`, `teams`, `todo`, `universalprint`, `azureeventgrid`, `azureiotcentral`, `cloudmersiveconvert`, `dynamicsax`, `pdfco`, `plumsail`, `sql`, `wdatp`, `wordonlinebusiness`, `yammer`, `zendesk`, `pipedrive` (and any `Microsoft.Web/connections` connector name).
+Supported SDK connector names: `arm`, `azureautomation`, `azuredatafactory`, `azuredigitaltwins`, `azuremonitorlogs`, `azuread`, `azureblob`, `box`, `azurequeues`, `azuretables`, `azurevm`, `commondataservice`, `documentdb`, `dropbox`, `docusign`, `eventhubs`, `excelonline`, `excelonlinebusiness`, `ftp`, `github`, `googlecalendar`, `googledrive`, `googletasks`, `jira`, `keyvault`, `kusto`, `microsoftbookings`, `microsoftforms`, `mq`, `msgraphgroupsanduser`, `office365`, `office365groups`, `office365groupsmail`, `office365users`, `onedrive`, `onedriveforbusiness`, `onenote`, `outlook`, `planner`, `powerbi`, `rss`, `salesforce`, `servicebus`, `sharepointonline`, `shifts`, `slack`, `smtp`, `teams`, `todo`, `universalprint`, `azureeventgrid`, `azureiotcentral`, `cloudmersiveconvert`, `dynamicsax`, `pdfco`, `plumsail`, `sql`, `wdatp`, `wordonlinebusiness`, `yammer`, `zendesk`, `pipedrive`, `docuware`, `signinghub` (and any `Microsoft.Web/connections` connector name).
 
 ```powershell
 $connectorName = "<connector-name>"      # e.g., "azureblob", "kusto", "mq", "msgraphgroupsanduser", "office365", "office365users", "sharepointonline", "teams"

CHANGELOG.md

@@ -9,6 +9,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- **DocuWare** (`docuware.py`) connector client with unit tests and samples
+- **SigningHub** (`signinghub.py`) connector client with unit tests and samples
 - **Pipedrive** (`pipedrive.py`) connector client with unit tests and samples
 - **Zendesk** (`zendesk.py`) connector client with unit tests and samples
 - **SQL Server** (`sql.py`) connector client with unit tests and samples

README.md

@@ -216,8 +216,10 @@ The following connectors have been generated and validated with comprehensive te
 | **Yammer** | `azure.connectors.yammer` | ✅ Complete | 🔄 SDK Generated |
 | **Zendesk** | `azure.connectors.zendesk` | ✅ Complete | 🔄 SDK Generated |
 | **Pipedrive** | `azure.connectors.pipedrive` | ✅ Complete | 🔄 SDK Generated |
+| **DocuWare** | `azure.connectors.docuware` | ✅ Complete | 🔄 SDK Generated |
+| **SigningHub** | `azure.connectors.signinghub` | ✅ Complete | 🔄 SDK Generated |
 
-**Total:** 62 connectors supported
+**Total:** 64 connectors supported
 
 See [ROADMAP.md](ROADMAP.md) for planned connector additions and [tests/README.md](tests/README.md) for detailed test coverage.
 

samples/sample_connector_usage/README.md

@@ -80,6 +80,8 @@ python sample_connector_usage_<connector>.py
 | `sample_connector_usage_sql.py` | SQL Server | `SQL_CONNECTION_URL` |
 | `sample_connector_usage_zendesk.py` | Zendesk | `ZENDESK_CONNECTION_URL` |
 | `sample_connector_usage_pipedrive.py` | Pipedrive | `PIPEDRIVE_CONNECTION_URL` |
+| `sample_connector_usage_docuware.py` | DocuWare | `DOCUWARE_CONNECTION_URL` |
+| `sample_connector_usage_signinghub.py` | SigningHub | `SIGNINGHUB_CONNECTION_URL` |
 
 Set the appropriate environment variable to your connection runtime URL before running:
 

samples/sample_connector_usage/sample_connector_usage_docuware.py

@@ -0,0 +1,100 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+
+"""
+DocuWare Connector SDK Sample
+
+This sample demonstrates how to use the DocuWare connector SDK.
+
+Prerequisites:
+1. Azure subscription with a DocuWare connection
+2. DocuWare connection in Connector Namespaces
+3. Connection runtime URL from Azure Portal
+
+Installation:
+    pip install azure-connectors
+
+Usage:
+    Set environment variable:
+    $env:DOCUWARE_CONNECTION_URL =
+        "https://[region].azure-apihub.net/apim/docuware/[connection-id]"
+
+    python sample_connector_usage_docuware.py
+"""
+
+import asyncio
+import os
+
+from azure.identity.aio import DefaultAzureCredential
+
+from azure.connectors import ConnectorException
+from azure.connectors.docuware import (
+    DocuwareClient,
+    SearchForDocumentsInFileCabinetInput,
+)
+
+# Connection runtime URL format:
+# https://[region].azure-apihub.net/apim/docuware/[connection-id]
+CONNECTION_RUNTIME_URL = os.environ.get("DOCUWARE_CONNECTION_URL", "")
+
+
+async def example_1_get_file_cabinets():
+    """Example 1: List available file cabinets and document trays."""
+    print("\n=== Example 1: Get file cabinets ===")
+
+    credential = DefaultAzureCredential()
+
+    async with DocuwareClient(CONNECTION_RUNTIME_URL, credential) as client:
+        try:
+            result = await client.get_file_cabinets_async(
+                file_cabinet_type=None,
+            )
+
+            print(f"File cabinets result: {result}")
+
+        except ConnectorException as ex:
+            print(f"Connector error: {ex}")
+        except Exception as ex:
+            print(f"Error: {ex}")
+
+
+async def example_2_search_documents():
+    """Example 2: Search a file cabinet for matching documents."""
+    print("\n=== Example 2: Search documents in file cabinet ===")
+
+    credential = DefaultAzureCredential()
+
+    async with DocuwareClient(CONNECTION_RUNTIME_URL, credential) as client:
+        try:
+            request = SearchForDocumentsInFileCabinetInput()
+
+            result = await client.search_for_documents_in_file_cabinet_async(
+                input=request,
+                file_cabinet="<file-cabinet-id>",
+                search_dialog_id=None,
+            )
+
+            print(f"Search result: {result}")
+
+        except ConnectorException as ex:
+            print(f"Connector error: {ex}")
+        except Exception as ex:
+            print(f"Error: {ex}")
+
+
+async def main():
+    """Run all examples."""
+    if not CONNECTION_RUNTIME_URL:
+        print("Error: DOCUWARE_CONNECTION_URL environment variable not set.")
+        print("Set it to your connection runtime URL from Azure Portal.")
+        return
+
+    print(f"Using connection URL: {CONNECTION_RUNTIME_URL[:50]}...")
+
+    await example_1_get_file_cabinets()
+    await example_2_search_documents()
+
+    print("\n=== All examples completed ===")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

samples/sample_connector_usage/sample_connector_usage_signinghub.py

@@ -0,0 +1,124 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+
+"""
+SigningHub Connector SDK Sample
+
+This sample demonstrates how to use the SigningHub connector SDK.
+
+Prerequisites:
+1. Azure subscription with a SigningHub connection
+2. SigningHub connection in Connector Namespaces
+3. Connection runtime URL from Azure Portal
+
+Installation:
+    pip install azure-connectors
+
+Usage:
+    Set environment variable:
+    $env:SIGNINGHUB_CONNECTION_URL =
+        "https://[region].azure-apihub.net/apim/signinghub/[connection-id]"
+
+    python sample_connector_usage_signinghub.py
+"""
+
+import asyncio
+import os
+
+from azure.identity.aio import DefaultAzureCredential
+
+from azure.connectors import ConnectorException
+from azure.connectors.signinghub import (
+    SigninghubClient,
+    CheckBoxFieldRequest,
+)
+
+# Connection runtime URL format:
+# https://[region].azure-apihub.net/apim/signinghub/[connection-id]
+CONNECTION_RUNTIME_URL = os.environ.get("SIGNINGHUB_CONNECTION_URL", "")
+
+
+async def example_1_get_contacts():
+    """Example 1: Retrieve contacts for the current user."""
+    print("\n=== Example 1: Get Contacts ===")
+
+    credential = DefaultAzureCredential()
+
+    async with SigninghubClient(CONNECTION_RUNTIME_URL, credential) as client:
+        try:
+            result = await client.contacts_get_async(
+                record_per_page="10",
+                page_no="1",
+            )
+
+            print(f"Contacts result: {result}")
+
+        except ConnectorException as ex:
+            print(f"Connector error: {ex}")
+        except Exception as ex:
+            print(f"Error: {ex}")
+
+
+async def example_2_add_check_box_field():
+    """Example 2: Add a checkbox field to a document in a package."""
+    print("\n=== Example 2: Add CheckBox Field ===")
+
+    credential = DefaultAzureCredential()
+
+    async with SigninghubClient(CONNECTION_RUNTIME_URL, credential) as client:
+        try:
+            request = CheckBoxFieldRequest()
+
+            result = await client.checkbox_add_check_box_async(
+                input=request,
+                package_id="<package-id>",
+                document_id="<document-id>",
+            )
+
+            print(f"Add checkbox result: {result}")
+
+        except ConnectorException as ex:
+            print(f"Connector error: {ex}")
+        except Exception as ex:
+            print(f"Error: {ex}")
+
+
+async def example_3_delete_attachment():
+    """Example 3: Delete an attachment from a document."""
+    print("\n=== Example 3: Delete Attachment ===")
+
+    credential = DefaultAzureCredential()
+
+    async with SigninghubClient(CONNECTION_RUNTIME_URL, credential) as client:
+        try:
+            await client.attachment_delete_attachment_async(
+                package_id="<package-id>",
+                document_id="<document-id>",
+                attachment_id="<attachment-id>",
+            )
+
+            print("Attachment deleted successfully")
+
+        except ConnectorException as ex:
+            print(f"Connector error: {ex}")
+        except Exception as ex:
+            print(f"Error: {ex}")
+
+
+async def main():
+    """Run all examples."""
+    if not CONNECTION_RUNTIME_URL:
+        print("Error: SIGNINGHUB_CONNECTION_URL environment variable not set.")
+        print("Set it to your connection runtime URL from Azure Portal.")
+        return
+
+    print(f"Using connection URL: {CONNECTION_RUNTIME_URL[:50]}...")
+
+    await example_1_get_contacts()
+    await example_2_add_check_box_field()
+    await example_3_delete_attachment()
+
+    print("\n=== All examples completed ===")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

src/azure/connectors/__init__.py

@@ -296,6 +296,16 @@
 except (ImportError, NameError):
     PipedriveClient = None  # type: ignore[assignment,misc]
 
+try:
+    from .docuware import DocuwareClient
+except (ImportError, NameError):
+    DocuwareClient = None  # type: ignore[assignment,misc]
+
+try:
+    from .signinghub import SigninghubClient
+except (ImportError, NameError):
+    SigninghubClient = None  # type: ignore[assignment,misc]
+
 __version__ = '0.3.0b2'
 
 __all__ = [
@@ -370,4 +380,6 @@
     "SqlClient",
     "ZendeskClient",
     "PipedriveClient",
+    "DocuwareClient",
+    "SigninghubClient",
 ]