Du er her:
Medietypetilordning i registreringer av Eksterne tjenester
Du kan registrere spesifikasjoner med ikke-støttede consumes-, produces- eller OpenAPI 3.0-mediedirektiver ved å tilordne medietypene til støttede medietyper. Angi en tilordning fra en rullegardinmeny på registreringsskjermen, eller fyll ut tilordningen med kode ved bruk av Metadata API.
Tilordne medietyper under registrering
Hvis du forsøker å registrere et skjema som inkluderer en ikke-støttet medietype, blir du bedt om å oppgi en tilordning på siden Tilknytt operasjoner med støttede medietyper.
Slik knytter du operasjoner til en støttet medietype:
- Noter deg den første ikke-støttede medietypen til venstre.
- Tilordne den ikke-støttede medietypen til en støttet medietype ved å velge en støttet medietype fra rullegardinmenyen direkte til høyre.
- Hvis det er flere ikke-støttede medietyper i listen, fortsetter du nedover i listen og velger en tilordning for hver ikke-støttede medietype som er oppført.
- Klikk på Neste.
Fortsett registreringen ved å velge operasjoner, som beskrevet i trinn 10 i Registrere en ekstern tjeneste.
Tilordne medietyper med Metadata API
Hvis du vil tilordne en medietype manuelt, må den ikke-støttede medietypen tilordnes til en støttet medietype som en tilordning i feltets serviceBinding i ExternalServiceRegistration-metadatafilen.
Vurder dette Acme Bank-eksempelet for å få demonstrert den manuelle metoden for tilordning av medietyper.
Acme bank spesifiserer en OpenAPI 2.0-tjeneste for sin kredittvurderingstjeneste. Den definerer sin egen medietype for håndtering av JSON-kompatibel last: application/x-acme-json:
{
"swagger":"2.0",
"info":{
"description":"A service for checking credit for an account.",
"version":"1.0.0",
"title":"Credit Decision"
},
"host":"<ACME's host>",
"paths":{
"/account/credit-rating":{
"get":{
"operationId":"getCreditRating",
"summary":"Evaluates credit rating for offered payment terms.",
"consumes":[
"application/x-acme-json"
],
"produces":[
"application/x-acme-json"
],
"parameters":[{
"description":"Account",
"in":"body",
"name":"body",
"required":true,
"schema":{
"$ref":"#/definitions/Account"
}
}],
"responses":{
"200":{
"description": "Credit rating",
"schema":{
"$ref":"#/definitions/CreditRating"
}
}
}
}
}
},
"definitions":{
"Account":{
"type":"object",
"properties":{
"accountId":{
"type":"string"
},
"accountHolder":{
"type":"string"
}
}
},
"CreditRating":{
"type":"object",
"properties":{
"creditRating":{
"type":"string"
}
}
}
}
} Hvis du vil tilordne medietypen BankService til den støttede medietypen application/json, åpner du en kommandolinjeterminal. Opprett en mappe der du vil hente den eksterne tjenestens metadata.
> mkdir BankService
> cd BankServiceOpprett manifestfilen package.xml for metadata for eksterne tjenester som BankService skal hente fra organisasjonen:
> touch package.xmlRediger package.xml:
<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
<types>
<members>BankService</members>
<name>ExternalServiceRegistration</name>
</types>
<version>53.0</version>
</Package>Hent metadataene for den eksterne tjenesten med Salesforce CLI-kommandoen etter vellykket godkjenning i organisasjonen:
> sf project retrieve start --target-metadata-dir . --manifest package.xmlPakk ut den komprimerte pakkefilen med metadataene, og naviger til mappen med den eksterne tjenesten:
> unzip unpackaged.zip
> cd unpackaged/externalServiceRegistrationsRediger tjenestebindinger i metadatafilen BankService.externalServiceRegistration for registrering av eksterne tjenester. Ikke bryt <serviceBinding>-delen (med fet skrift) med linjeskift fordi den bryter deserialiseringen.
<?xml version="1.0" encoding="UTF-8"?>
<ExternalServiceRegistration xmlns="http://soap.sforce.com/2006/04/metadata">
<label>MediaTypeMap</label>
<namedCredential>BankServiceEndpoint</namedCredential>
<operations>
<active>true</active>
<name>getcreditrating</name>
</operations>
<registrationProviderType>Custom</registrationProviderType>
<schema>{
...
}
</schema>
<schemaType>OpenApi</schemaType>
<serviceBinding>{"compatibleMediaTypes"
:{"application/x-acme-json"
:"application/x-acme-json"}}</serviceBinding>
<status>Complete</status>
</ExternalServiceRegistration>Tjenestebindingen angir i JSON-format de ikke-støttede medietypene som defineres av denne registreringen av den eksterne tjenesten:
{"compatibleMediaTypes":{
"application/x-acme-json":"application/x-acme-json"
}}Tilordne den ikke-støttede medietypen til den støttede medietypen for serialiseringen av belastningen for den eksterne tjenesten:
{"compatibleMediaTypes":{
"application/x-acme-json":"application/json"
}}De oppdaterte metadataene for registreringen av eksempelet på den eksterne tjenesten for bankvurdering tar hensyn til medietypetilordningen til den støttede medietypen når den distribueres i en pakke:
<?xml version="1.0" encoding="UTF-8"?>
<ExternalServiceRegistration xmlns="http://soap.sforce.com/2006/04/metadata">
<label>MediaTypeMap</label>
<namedCredential>BankService</namedCredential>
<operations>
<active>true</active>
<name>getcreditrating</name>
</operations>
<registrationProviderType>Custom</registrationProviderType>
<schema>{
...
}
</schema>
<schemaType>OpenApi</schemaType>
<serviceBinding>{"compatibleMediaTypes"
:{"application/x-acme-json"
:"application/json"}}</serviceBinding>
<status>Complete</status>
</ExternalServiceRegistration>Ikke bryt <serviceBinding>-delen med linjeskift fordi den bryter deserialiseringen.
Lagre den redigerte metadatafilen for registrering av eksterne tjenester, og distribuer den:
> cd ../..
> sf project deploy start --metadata-dir unpackagedHvis du vil ha mer informasjon, kan du se:
