agentleFS
korchard333korchard333/claude-power-platform-community/.claude/skills/integration-patterns/SKILL.md

integration-patterns

Skill46 starsChanged 8 months agoMITView on GitHub

Power Platform integration patterns with Azure services. Use when: Service Bus, Azure Functions, webhook, event-driven, hybrid, on-premises gateway, VNet, integration pattern, Event Grid, Azure Relay, private endpoints, custom connectors to Azure.

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    No dead-letter handling on Service Bus (lost messages go unnoticed)

    line 58
  2. Distinctive:

    No monitoring on integration points (failures go undetected)

    line 62

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Skill: Integration Patterns

When to Use

Trigger when designing integrations between Power Platform and Azure services — Service Bus messaging, Azure Functions for compute, Dataverse webhooks, Event Grid, on-premises gateway, VNet connectivity, or hybrid architectures.


Integration Pattern Overview

PatternDirectionCouplingBest For
Service BusDataverse → Azure (async)LooseReliable messaging, event distribution
Azure FunctionsBidirectionalMediumCustom compute, API intermediary
WebhooksDataverse → External (sync/async)LooseReal-time push notifications
Event GridAzure → Power PlatformLooseAzure event-driven triggers
On-premises gatewayPower Platform → On-premTightLegacy system access
VNet integrationPower Platform ↔ Azure VNetTightNetwork-level security
Custom connectorsPower Platform → Any APIMediumREST API integration

⚠️ REQUIRED: Load Sub-Files Before Implementation

SKILL.md is a summary only — it is NOT sufficient for implementation.

The detailed content (complete payloads, XML templates, working examples, edge-case handling) lives in sub-files in the same directory as this SKILL.md. Before writing any code, you MUST use read_file on the sub-files relevant to your task:

  • Service Bus — Azure Service Bus integration, topic/queue patterns, Dataverse plugin to Service Bus, reliable messaging, dead-letter handling, session-aware processing
  • Azure Functions — when to use Functions vs plugins vs flows, HTTP-triggered for Custom Connectors, Dataverse bindings, managed identity auth, cold start mitigation
  • Webhooks & Events — Dataverse webhooks (real-time push), webhook registration via API, payload schema, retry behavior, Event Grid integration
  • Hybrid Connectivity — on-premises data gateway, Azure VNet integration, private endpoints for Dataverse, Azure Relay, security considerations

Decision Table: Which Integration Pattern?

RequirementPatternWhy
Reliable async messagingService BusGuaranteed delivery, dead-letter, retry
Real-time event notificationWebhookImmediate push on data change
Custom compute (validation, transformation)Azure FunctionServerless, scalable, any language
Legacy on-prem database accessOn-prem gatewayBridge to SQL, Oracle, SAP
Network-isolated Azure resourcesVNet integrationPrivate endpoint access
Fan-out to multiple subscribersService Bus topics or Event GridOne event, many consumers
Simple REST API callCustom connectorLow-code, reusable
High-volume batch processingAzure Function + Service BusDecouple producer from consumer

Anti-Patterns

  • Synchronous HTTP calls in Dataverse plugins to external APIs (2-minute timeout, blocks user)
  • On-premises gateway for everything (single point of failure, bottleneck)
  • No dead-letter handling on Service Bus (lost messages go unnoticed)
  • Webhook without retry-aware endpoint (missed events)
  • Azure Functions with long cold starts on critical paths (user-facing latency)
  • Tight coupling between Dataverse and external systems (breaks when external system changes)
  • No monitoring on integration points (failures go undetected)
  • VNet integration without private endpoints (traffic still goes over public internet)

Related Skills

  • plugins — Dataverse plugins that trigger integrations
  • power-automate — Flow-based integrations with connectors
  • azure-openai — Azure Functions as AI intermediary
  • custom-connectors — Custom connector creation for APIs
  • security — Authentication for external integrations

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.