MuleSoft-services synchroniseren naar API-catalogus
Synchroniseer in aanmerking komende nieuwe en bijgewerkte versies van MuleSoft-API's en MCP-servers in uw catalogus.
Vereiste editions
| Beschikbaar in: Lightning Experience |
| Beschikbaar in: Developer, Enterprise, Performance en Unlimited Edition |
MuleSoft-API's die aan deze criteria voldoen, komen in aanmerking voor synchronisatie naar API-catalogus.
- Zijn een REST API-type
- Een
sf-api-cataloghebben in Anypoint Exchange - Een extra
sf-api-topichebben in Anypoint Exchange voor API's met agent- of subagentannotaties - Een consumenteneindpunt hebben voor minstens één exemplaar, waarbij het consumenteneindpunt een geldige HTTPS-URL is
Consumenten-URL's worden weergegeven als bestemmings-URL's in de API-catalogus.
Zie MuleSoft-documentatie voor informatie over het configureren van API's om aan deze criteria te voldoen: Activumtags en MuleSoft-documentatie toevoegen en verwijderen: API-exemplaren toevoegen.
Zie MuleSoft MCP-servers beheren in API-catalogus voor informatie over de criteria voor het synchroniseren van MCP-servers in API-catalogus.
API-catalogus maakt het eenvoudig om veilige verbindingen te maken voor uw MuleSoft-API's. Bewaak API-versies terwijl ze worden gesynchroniseerd naar de catalogus, vraag API-toegang aan en selecteer SLA-lagen rechtstreeks vanuit de catalogus.
- Vraag een Anypoint Platform-beheerder om de vereiste configuratie te voltooien in de Anypoint Platform-organisatie van waaruit u API's wilt synchroniseren. Zie MuleSoft-documentatie voor details: Een vertrouwde Salesforce-organisatie verbinden met Anypoint Platform.
- Geef vanuit Set-up API-catalogus op in het vak Snel zoeken en selecteer vervolgens API-catalogus.
-
Klik op Synchronisatie inschakelen.
De voltooiing van de synchronisatie duurt doorgaans enkele minuten, met name bij de eerste synchronisatie, en wordt uitgevoerd als een achtergrondbewerking.
-
Zorg ervoor dat de nieuwste gesynchroniseerde API's worden weergegeven in hun respectieve lijst door de pagina te vernieuwen.
Als u niet de API's ziet die u verwacht, controleert u nogmaals de randvoorwaarden voor synchroniseren naar de catalogus.
Als u tijdens de synchronisatie systeemlimieten bereikt, verwijdert u API's of API-versies die u niet langer nodig hebt. Zie API's verwijderen uit API-catalogus.
API-updates synchroniseren naar de catalogus
Wanneer u een gesynchroniseerde API-specificatie bijwerkt in Anypoint Platform, pikt API-catalogus de updates op bij de volgende synchronisatie. Of de synchronisatie de updates toepast op het schema in Salesforce, is afhankelijk van het type update en of er betrokken componenten in gebruik zijn.
De synchronisatie past automatisch ondersteunde updates toe op het schema. Dit zijn updates van bewerkingen die niet in gebruik zijn en additieve updates, zoals het toevoegen van bewerkingen, objecten, eigenschappen of parameters. De synchronisatie kan echter geen niet-ondersteunde updates toepassen, die updates verbreken voor componenten die in gebruik zijn. De synchronisatie kan geen updates toepassen die vereiste eigenschappen of parameters verwijderen, hernoemen of bijwerken waarnaar actieve stromen, Apex klassen of agentacties verwijzen. Salesforce overschrijft geen schema waarvan actieve acties afhankelijk zijn.
-
Nadat de synchronisatie is voltooid, controleert u of het schema is bijgewerkt zoals verwacht.
Als de verwachte update niet wordt weergegeven, is de update mogelijk een niet-ondersteunde update. Wanneer de synchronisatie een niet-ondersteunde update detecteert, wordt er geen fout weergegeven in de UI. De synchronisatie wordt normaal voltooid, maar laat het bestaande schema ongewijzigd.
Zie Ondersteuning voor schema-updates en Externe services beheren voor de volledige lijst van ondersteunde en niet-ondersteunde schema-updates.
-
Gebruik voor het toepassen van een brekende schema-update een van de volgende benaderingen.
-
Verwijder de verwijzingen en synchroniseer opnieuw.
Werk de stromen, Apex klassen of agentacties bij of verwijder deze die naar de betreffende component verwijzen. Stop vervolgens de synchronisatie en start deze opnieuw. Controleer na de synchronisatie uw integraties op fouten die door de update worden veroorzaakt.
-
Publiceer de update als een nieuwe API-versie.
Publiceer de bijgewerkte specificatie in Anypoint Platform als een nieuwe activumversie. Salesforce behandelt deze als een afzonderlijke registratie zonder actieve bewerkingen, waardoor deze synchroniseert zonder invloed op integraties die verwijzen naar de vorige versie. Het publiceren van een nieuwe versie is de aanbevolen aanpak wanneer actieve stromen of Apex klassen afhankelijk zijn van de betrokken velden.
-
API-synchronisatie stoppen en opnieuw starten
Stop en herstart de synchronisatie indien nodig. Stop en start opnieuw om API's of MCP-servers te synchroniseren die u zojuist hebt toegevoegd aan Anypoint Platform om te voorkomen dat u op de volgende geplande synchronisatie moet wachten. Overweeg ook om de synchronisatie te stoppen voordat u API-cataloguswijzigingssets maakt voor doorzetten naar andere organisaties en de synchronisatie opnieuw te starten nadat u klaar bent.
- Geef vanuit Set-up API-catalogus op in het vak Snel zoeken en selecteer vervolgens API-catalogus.
- Als u de synchronisatie de eerste keer wilt starten of nadat u deze hebt gestopt, klikt u op Synchronisatie inschakelen op de hoofdpagina API-catalogus.
- Als u de synchronisatie op elk gewenst moment wilt stoppen en opnieuw wilt starten, klikt u op Synchronisatie beheren en schakelt u de synchronisatie in of uit met behulp van de aan-/uitfunctie.
