Condividi tramite

Passaggio 1: Pubblicare le operazioni del componente business Siebel come servizio WCF

  • Articolo

Passaggio 1 di 4

Tempo da completare: 10 minuti

Obiettivo: È possibile usare la Creazione guidata servizio adapter WCF per generare un servizio WCF che può essere ospitato in un ambiente di hosting, ad esempio Internet Information Services (IIS) o servizio di attivazione dei processi di Windows (WAS). Questo argomento illustra come usare la procedura guidata per generare un file di servizio WCF.

Prerequisiti

Prima di eseguire la procedura guidata, installare quanto segue:

  • Microsoft Windows Communication Foundation (WCF) Line of Business Adapter SDK (LOB) con l'opzione Completa o l'opzione Personalizzata (e scegliere Strumenti all'interno di questa opzione). In questo modo viene installato il modello di Visual Studio per la Creazione guidata servizio adapter WCF.

  • Microsoft BizTalk Adapter per Siebel eBusiness Applications

  • Client Siebel richiesto.

    Per altre informazioni su questi prerequisiti, vedere la guida all'installazione di BizTalk Adapter Pack. La guida all'installazione viene in genere installata nell'unità <>di installazione:\Programmi\Microsoft BizTalk Adapter Pack\Documents.

Pubblicare i componenti aziendali Siebel come servizio WCF

  1. Avviare Visual Studio e quindi creare un progetto.

  2. Nella finestra di dialogo Nuovo progetto selezionare Visual C#nel riquadro Tipi di progetto. Nel riquadro Modelli selezionare Servizio adapter WCF.

    In alternativa, nel riquadro Tipi di progetto espandere Visual C#e quindi selezionare Web. Nel riquadro Modelli selezionare Servizio adapter WCF.

    Nota

    Se è stato installato Visual Studio con il componente Sviluppo Web, il modello di servizio adapter WCF è disponibile anche dall'opzione Nuovo sito Web .

  3. Specificare un nome e una posizione per la soluzione e quindi fare clic su OK. Viene avviata la creazione guidata del servizio adapter WCF.

  4. Nella pagina Benvenuti fare clic su Avanti.

  5. Nella pagina Scegli operazioni specificare un stringa di connessione per connettersi al sistema Siebel. A tale scopo, procedere nel seguente modo:

    1. Nell'elenco Selezionare un'associazione fare clic su siebelBinding e quindi fare clic su Configura.

    2. Nella finestra di dialogo Configura adattatore fare clic sulla scheda Sicurezza .

    3. Nell'elenco Tipo di credenziali client selezionare Nome utente e quindi specificare il nome utente e la password per connettersi al sistema Siebel.

    4. Fare clic sulla scheda Proprietà URI e quindi specificare i valori per i parametri di connessione. Per altre informazioni sull'URI di connessione per l'adapter Siebel, vedere Creat the Siebel System Connection URI ( Creat the Siebel System Connection URI).

      Nota

      Se i parametri di connessione contengono caratteri riservati ,ad esempio caratteri speciali XML, è necessario specificarli come sono nella scheda Proprietà URI , ovvero senza usare alcun carattere di escape. Tuttavia, se si specifica l'URI direttamente nel campo Configura un URI e i parametri di connessione contengono caratteri riservati, è necessario specificare i parametri di connessione usando caratteri di escape appropriati.

    5. Fare clic sulla scheda Proprietà associazione e quindi specificare i valori per le proprietà di associazione, se presenti, necessarie per le operazioni di destinazione.

      Per altre informazioni sulle proprietà di associazione, vedere Informazioni su BizTalk Adapter for Siebel Binding Properties(Informazioni sulle proprietà di associazione BizTalk per Siebel Binding Properties).

    6. Fare clic su OK e quindi su Connetti. Dopo aver stabilito la connessione, lo stato della connessione viene visualizzato come Connesso.

  6. Nella pagina Scegli operazioni fare clic su Client (operazioni in uscita) nell'elenco Seleziona tipo di contratto.

  7. Nella casella Seleziona una categoria espandere il nodo Siebel Business Objects per visualizzare l'elenco di oggetti business nel repository Siebel. Per questo esempio, eseguire le operazioni seguenti:

    1. Espandere l'oggetto Business Account e quindi fare clic sul componente Account business.

    2. Nella casella Categorie e operazioni disponibili selezionare l'operazione query e quindi fare clic su Aggiungi. L'operazione selezionata è elencata nella casella Categorie e operazioni aggiunte .

      Selezionare Operazioni del componente business Siebel

  8. Nella pagina Scegli operazioni fare clic su Avanti.

  9. Nella pagina Configura comportamenti del servizio e dell'endpoint specificare i valori per configurare il comportamento del servizio e dell'endpoint.

    1. Nella casella Configurazione comportamento servizio specificare i valori per quanto segue:

      Per la proprietà Specificare il valore
      EnableMetadataExchange Impostare questa opzione su True per creare un endpoint di scambio dei metadati. Impostando questa opzione su True, i metadati del servizio vengono resi disponibili usando protocolli standardizzati, ad esempio WS-Metadata Exchange (MEX) e le richieste HTTP/GET.

      L'impostazione predefinita è False.
      IncludeExceptionDetailsinFault Impostare questa opzione su True per includere informazioni sull'eccezione gestita in dettaglio degli errori SOAP restituiti al client a scopo di debug. L'impostazione predefinita è False.
      Nome Nome della configurazione del comportamento del servizio.
      UseServiceCertificate Specifica se si vuole usare la modalità di sicurezza a livello di messaggio di WCF. L'impostazione predefinita è True.

      Per questa esercitazione, è necessario impostare questa opzione su False.
      Findvalue Stringa che specifica il valore da cercare nell'archivio certificati X.509.

      Nota: Specificare un valore per questa proprietà solo se UseServiceCertificate è impostato su True.
      StoreLocation Valore che specifica il percorso dell'archivio certificati che il servizio può usare per convalidare il certificato del client.

      Nota: Specificare un valore per questa proprietà solo se UseServiceCertificate è impostato su True.
      StoreName Nome dell'archivio certificati X.509 da aprire.

      Nota: Specificare un valore per questa proprietà solo se UseServiceCertificate è impostato su True.
      X509FindType Il tipo di ricerca X.509 da eseguire.

      Nota: Specificare un valore per questa proprietà solo se UseServiceCertificate è impostato su True.

      Nota

      Per altre informazioni sui certificati e sulle proprietà associate, vedere Proprietà X509ClientCertificateCredentialsElement.

    2. Nella casella Configurazione comportamento endpoint specificare i valori per quanto segue:

      Per la proprietà Specificare il valore
      Tipo di autenticazione - Impostare questa opzione su ClientCredentialUserNamePassword per consentire ai client di specificare il nome utente e la password durante l'utilizzo del servizio WCF.

      - Impostare questa opzione su HTTPUserNamePassword per consentire ai client di specificare il nome utente e la password come parte dell'intestazione HTTP.

      - Impostare questa opzione su Auto per consentire ai client di specificare le credenziali tramite l'interfaccia ClientCredential . In caso contrario, i client possono passare le credenziali come parte dell'intestazione HTTP.

      Il valore predefinito è Auto. Per microsoft Office SharePoint Server per l'utilizzo del servizio WCF, è consigliabile impostare questo valore come HTTPUserNamePassword.
      Nome Specificare un nome per la configurazione del comportamento dell'endpoint.
      UsernameHeader Nome per l'intestazione nome utente. Per questo esempio, specificare MyUserHeader. Per altre informazioni sulle intestazioni HTTP, vedere "Supporto per intestazioni HTTP e SOAP personalizzate" all'indirizzo https://go.microsoft.com/fwlink/?LinkId=106692.

      Nota: È necessario specificare un valore per questa proprietà se il tipo di autenticazione è impostato su HTTPUserNamePassword. Se il tipo di autenticazione è impostato su Auto, questa proprietà è facoltativa.
      PasswordHeader Nome per l'intestazione della password. Per questo esempio, specificare MyPassHeader. Per altre informazioni sulle intestazioni HTTP, vedere "Supporto per intestazioni HTTP e SOAP personalizzate" all'indirizzo https://go.microsoft.com/fwlink/?LinkId=106692.

      Nota: È necessario specificare un valore per questa proprietà se il tipo di autenticazione è impostato su HTTPUserNamePassword. Se il tipo di autenticazione è impostato su Auto, questa proprietà è facoltativa.

      Nella figura seguente viene illustrata la pagina Configura comportamento del servizio e dell'endpoint con i valori specificati.

      Configurare i comportamenti del servizio e dell'endpoint

  10. Nella pagina Configura comportamenti del servizio e dell'endpoint fare clic su Avanti.

  11. Nella pagina Configura associazione endpoint servizio e indirizzo selezionare un contratto per configurare elenca i contratti per i componenti aziendali Siebel per i quali sono state selezionate le operazioni nella pagina Scegli operazioni. Nella casella del contratto selezionato vengono visualizzate le operazioni selezionate per ogni artefatto nella pagina Scegli operazioni.

  12. Nella casella Configura l'indirizzo e l'associazione per il contratto specificare i valori per quanto segue:

    Per la proprietà Specificare il valore
    Configurazione del binding La procedura guidata supporta solo l'associazione HTTP di base. Il campo di configurazione dell'associazione viene quindi popolato automaticamente in System.ServiceModel.Configuration.BasicHttpBindingElement.

    Fare clic sul pulsante con i puntini di sospensione (...) per modificare le proprietà per l'associazione HTTP. Per usare un canale di comunicazione sicuro, è sempre necessario impostare la proprietà Mode su Transport. La procedura guidata imposta il valore predefinito per la proprietà Mode come Transport.

    Per altre informazioni sulle altre associazioni esposte, vedere Classe BasicHttpBindingElement.
    Nome endpoint Specificare un nome endpoint per il contratto.

    Gli altri campi di questa pagina vengono popolati automaticamente in base ai valori specificati nelle pagine precedenti.

    Fare clic su Applica. Eseguire questo passaggio per tutti i contratti visualizzati nella casella Seleziona un contratto da configurare .

    Nota

    Se non si specificano valori in questa pagina, i valori predefiniti vengono accettati per tutti i contratti.

    Nella figura seguente viene illustrata la pagina Configura associazione endpoint servizio e indirizzo con i valori specificati.

    Configurare l'associazione dell'endpoint di servizio e l'indirizzo

  13. Nella pagina Configura associazione endpoint servizio e indirizzo fare clic su Avanti. La pagina Riepilogo elenca una struttura ad albero dei contratti per i componenti aziendali Siebel selezionati e, in questo caso, le operazioni selezionate per ogni componente aziendale.

  14. Esaminare il riepilogo e quindi fare clic su Fine.

  15. La procedura guidata crea un servizio WCF e aggiunge i file seguenti al progetto di Visual Studio:

    1. File con estensione svc. Si tratta del file di servizio WCF. La procedura guidata genera un file per ogni contratto.

    2. Web.config file.

    3. Codice del servizio (file con estensione cs).

  16. Pubblicare il servizio WCF.

    1. Assicurarsi che SSL sia abilitato per Internet Information Services (IIS). Vedere Come configurare SSL.

    2. Fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni e quindi scegliere Pubblica.

    3. Nella finestra di dialogo Pubblica Web specificare un URL per il servizio WCF. Ad esempio:

      https://<computer_name>/Siebel_Account/

    4. Nella casella Copia fare clic su Tutti i file di progetto.

    5. Fare clic su Pubblica.

  17. Verificare che il servizio WCF venga pubblicato correttamente.

    1. Avviare la Console di gestione Microsoft IIS. Fare clic su Start, scegliere Strumenti di amministrazione e quindi fare clic su Internet Information Services.

    2. Passare al nodo in cui è stato pubblicato il servizio. Per il servizio Siebel_Account, passare a Internet Information Services><Nome>> computerSiti>Web Sito Web> predefinitoSiebel_Account.

    3. Nel riquadro destro fare clic con il pulsante destro del mouse sul file BusinessObjects_Account_Account_Operation.svc e quindi scegliere Sfoglia.

    4. La pagina Web viene visualizzata con l'URL per il recupero del WSDL. È possibile testare il recupero dei metadati usando il comando svcutil. Ad esempio, il comando per recuperare i metadati per il servizio Siebel_Account è:

      svcutil.exe https://localhost/Siebel_Account/BusinessObjects_Account_Account_Operation.svc?wsdl

Passaggi successivi

È ora disponibile un servizio WCF per il componente business Siebel. Usare l'editor di definizione business Data Catalog per creare un file di definizione dell'applicazione per le operazioni del componente business Siebel. Per istruzioni , vedere Passaggio 2: Creare un file di definizione applicazione per le operazioni del componente Business Siebel . Il file di definizione dell'applicazione identifica la posizione in cui vengono archiviati i dati LOB e il formato in cui viene archiviato.

Vedere anche

Esercitazione 1: Presentazione di dati da un sistema Siebel in un sito di SharePoint