Generazione del proxy Typescript per Store Commerce

  • 15 minuti

Il proxy Commerce astrae l'interfaccia tra il Retail Server e Commerce Runtime (CRT).

Ad esempio, è possibile creare una nuova entità e alcune logiche di business come operazioni di richiesta/risposta in CRT e aggiungere una nuova API Retail Server per esporre l'entità e le operazioni di richiesta/risposta. Ora si vuole accedere all'entità e alle operazioni di richiesta/risposta in Store Commerce per creare alcune logiche client.

È possibile creare manualmente tutte le entità e i metadati di richiesta/risposta in Store Commerce ed è possibile accedere a Retail Server con i parametri corretti. Il proxy Commerce riduce agevola queste operazioni generando automaticamente il proxy per tutte le entità personalizzate e le operazioni di richiesta/risposta che vengono aggiunte all'API Retail Server.

Lo strumento proxy genera l'interfaccia e tutti i metadati necessari, quindi astrae l'implementazione effettiva. In questo modo è possibile includere i file nei progetti di estensione e accedere alle entità e alle API Retail Server usando i metadati e l'interfaccia che vengono generati.

Per generare il proxy Typescript per Store Commerce, effettuare i seguenti passaggi:

  1. Apri il progetto del modello proxy di esempio da \RetailSDK\Code\SampleExtensions\TypeScriptProxy\TypeScriptProxy.Extensions.StoreHoursSample\Proxies.TypeScriptProxy.Extensions.StoreHoursSample.csproj in Visual Studio. Rinominarlo, se necessario.

  2. Aggiungere il progetto di estensione Retail Server come progetto di riferimento per questo progetto di modello proxy. Rimuovi il riferimento al progetto StoreHoursSample esistente.

  3. Fare clic con il pulsante destro del mouse su Proxies.TypeScriptProxy.Extensions.StoreHoursSample.csproj e selezionare Modifica Proxies.TypeScriptProxy.Extensions.StoreHoursSample.csproj.

  4. Nel nodo RetailServerExtensionAssemblies specificare il nome dell'assembly dell'estensione Retail Server. L'esempio seguente mostra come aggiungere il nome dell'assembly.

    <ItemGroup>
    <RetailServerExtensionAssemblies Include="..\..\RetailServer\Extensions.Sample\bin\$(Configuration)\net461\$(AssemblyNamePrefix).RetailServer.Extension.Sample.dll" />
</ItemGroup>

  5. Nel nodo Copia aggiornare il percorso DestinationFolder alla cartella dell'estensione Store Commerce, in modo che i file proxy generati vengano copiati automaticamente nella cartella Estensione POS. Anche i file proxy generati verranno copiati in \RetailSDK\Code\SampleExtensions\TypeScriptProxy\TypeScriptProxy.Extensions.StoreHoursSample\DataService. L'esempio seguente mostra come aggiornare il percorso.

    <Copy SourceFiles="@(GeneratedDataServiceContracts)" DestinationFolder="$(SdkRootPath)\POS\Extensions\Sample\DataService" SkipUnchangedFiles="true" />

  6. Al termine delle modifiche, compilare il progetto proxy per generare i file proxy Typescript. Al termine della compilazione, i file proxy saranno disponibili nella cartella \RetailSDK\Code\SampleExtensions\TypeScriptProxy\TypeScriptProxy.Extensions.StoreHoursSample\DataService e nella cartella specificata nel comando Copia. Il percorso e il percorso della cartella possono variare in base alla struttura delle cartelle.

Per altre informazioni, consultare Creazione di una nuova API dell'estensione Retail Server.