Condividi tramite

Risolvere i problemi operativi con l'adattatore Siebel

  • Articolo

Questa sezione fornisce una posizione centralizzata per informazioni sui problemi operativi che possono verificarsi quando si usa l'adapter Microsoft BizTalk per Siebel eBusiness Applications.

Abilitazione della traccia

Per informazioni sul supporto della traccia nell'adapter Siebel, vedere Traccia diagnostica e registrazione messaggi per l'adapter Siebel.

Problemi noti

Di seguito sono riportati alcuni problemi e le soluzioni consigliate che potrebbero verificarsi durante l'uso dell'adattatore Siebel.

Errore durante il caricamento delle associazioni dell'adapter

Problema

Quando si tenta di avviare il plug-in Add Adapter Service Reference di Visual Studio o il componente aggiuntivo Consume Adapter Service BizTalk Project, l'interfaccia utente grafica restituisce l'errore seguente:

There was an error loading the binding, <binding name>, from your system configuration.  
ConfigurationErrorsException: Exception has been thrown by the target of an invocation.

Causa

Quando si avvia il plug-in Add Adapter Service Reference o il componente aggiuntivo Consume Adapter Service, WCF carica le associazioni di adapter per tutte le schede installate. A sua volta, le associazioni dell'adattatore dipendono dal software client dell'applicazione aziendale specifico. Pertanto, è possibile affrontare questo problema per uno o entrambi i motivi seguenti:

  • Il software client LOB richiesto non è installato nel computer in cui è stata installata la scheda.

  • È stata eseguita un'installazione "Tipica" o "Completa" dell'adapter, che installa tutti gli adapter nel Pacchetto adapter BizTalk. Tuttavia, le librerie client potrebbero essere installate per una sola applicazione aziendale. Di conseguenza, l'interfaccia utente grafica non carica le associazioni per gli altri adattatori.

    Risoluzione

  • Assicurarsi che le versioni client necessarie siano installate nel computer in cui è stato installato BizTalk Adapter Pack.

  • Assicurarsi di eseguire un'installazione personalizzata degli adapter per installare solo la scheda necessaria.

L'adattatore Siebel non viene visualizzato nell'elenco di adattatori nella console di amministrazione di BizTalk Server

Problema

A differenza della versione precedente degli adapter forniti con BizTalk Server, l'adapter Siebel fornito con BizTalk Adapter Pack non viene visualizzato nell'elenco di adattatori nella console di amministrazione di BizTalk Server.

Causa

L'adattatore Siebel più recente è un'associazione personalizzata WCF. Pertanto, anche se la console di amministrazione di BizTalk Server visualizza l'adattatore WCF-Custom, non visualizza le associazioni personalizzate WCF e pertanto non visualizza l'adattatore Siebel basato su WCF.

Risoluzione

È possibile aggiungere in modo esplicito l'adattatore Siebel alla console di amministrazione BizTalk Server seguendo la procedura descritta in Aggiungere l'adapter Siebel alla console di amministrazione di BizTalk Server.

Errore durante la connessione al sistema Siebel

Problema

Il plug-in Add Adapter Service Reference (Aggiungi plug-in di riferimento al servizio adapter) o il componente aggiuntivo Consume Adapter Service (Utilizza servizio adapter) restituisce l'errore seguente quando si tenta di connettersi al sistema Siebel:

Connecting to the system LOB has failed. Retrieving the COM class factory for component with CLSID {ID} failed due to the following error: 80040154

Causa

Il client Web Siebel potrebbe non essere installato nel computer.

Risoluzione

Assicurarsi che nel computer sia installata la versione supportata del client Web Siebel. Vedere la guida all'installazione per le versioni client e server supportate per Siebel. La guida all'installazione è disponibile nell'unità <>di sistema:\Programmi\Microsoft BizTalk Adapter Pack\Documents.

Errore durante il recupero di XMLs con più di 65536 nodi

Problema

L'adattatore restituisce l'errore seguente durante il recupero dell'output XML con più di 65536 nodi.

Maximum number of items that can be serialized or deserialized in an object graph is '65536'.  
Change the object graph or increase the MaxItemsInObjectGraph quota.

Causa

L'adattatore non può serializzare e deserializzare un oggetto con più di 65536 elementi.

Risoluzione

È possibile risolvere questo problema impostando il maxItemsInObjectGraph parametro . È possibile impostare questa impostazione in uno dei due modi seguenti:

  • Impostare questo parametro modificando il maxItemsInObjectGraph parametro nell'attributo nella ServiceBehavior classe del servizio.

  • Aggiungere quanto segue al file di app.config dell'applicazione.

    <behaviors>  
  <endpointBehaviors>  
    <behavior name="NewBehavior">  
      <dataContractSerializer maxItemsInObjectGraph="65536000" />  
    </behavior>  
  </endpointBehaviors>  
</behaviors>

    Un app.config di esempio avrà un aspetto simile al seguente:

<?xml version="1.0" encoding="utf-8"?>  
<configuration>  
  <system.serviceModel>  
    <behaviors>  
      <endpointBehaviors>  
        <behavior name="NewBehavior">  
         <dataContractSerializer maxItemsInObjectGraph="65536000" />  
        </behavior>  
      </endpointBehaviors>  
    </behaviors>  
    <client>  
      <endpoint   behaviorConfiguration="NewBehavior" binding="siebelBinding"  
       contract="IOutboundContract" name="siebel_ICalculator" />  
    </client>  
  </system.serviceModel>  
</configuration>

Errore durante la specifica di un URI di connessione per una porta WCF-Custom in BizTalk

Problema

BizTalk Server restituisce l'errore seguente quando si specifica un URI di connessione per connettersi al sistema Siebel.

Error saving properties.  
(System.ArgumentException) The specified address is invalid.  
(System.ArgumentException) Invalid address;  
"<connection URI>" is not a well-formed absolute uri.

Causa

L'URI di connessione non rispetta il formato di codifica standard. Ad esempio, il valore di un parametro può contenere uno spazio.

Risoluzione

Assicurarsi che l'URI di connessione specificato sia conforme al formato di codifica standard. Ad esempio, uno spazio vuoto deve essere sostituito da "%20".

Errore durante l'esecuzione dell'operazione nel sistema Siebel

Problema

L'adattatore restituisce l'errore seguente durante l'esecuzione di qualsiasi operazione nel sistema Siebel usando BizTalk Server.

  • Per BizTalk Server

    System.ArgumentNullException: Value cannot be null.

    Causa

    L'azione WCF per il messaggio non è specificata. WCF richiede che venga specificata un'azione SOAP per ogni operazione, che informa l'adattatore sull'operazione da eseguire nell'applicazione LOB.

    Risoluzione

    Specificare l'azione SOAP nella porta di trasmissione o come proprietà di contesto del messaggio in un'orchestrazione BizTalk. Per istruzioni, vedere Configurare l'azione SOAP per Siebel. Per un elenco di azioni per ogni operazione, vedere Messaggi e schemi di messaggio .

XmlReaderParsingException a causa di un nome di operazione non corretto nell'azione specificata

Problema

La console di amministrazione di BizTalk Server restituisce l'errore seguente quando si inviano messaggi a un sistema Siebel:

Microsoft.ServiceModel.Channels.Common.XmlReaderParsingException: Invalid argument:  
<BtsActionMapping xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
  <Operation Name="<operation_name>" Action="<action>" />  
</BtsActionMapping>

Causa

Se si configura una porta WCF-Custom importando il file di associazione delle porte creato dal componente aggiuntivo Progetto BizTalk del servizio adapter di utilizzo, l'azione nella porta viene specificata nel formato seguente:

<BtsActionMapping>  
  <Operation Name="Op1" Action="http://MyService/Svc/Op1" />  
</BtsActionMapping>

Nel formato precedente, il nome dell'operazione è regolato dall'operazione scelta durante la generazione dello schema. Ad esempio, se è stato generato lo schema per un'operazione di query in un componente aziendale Siebel, il nome dell'operazione nell'azione sarà "Query". Tuttavia, il nome dell'operazione nella porta logica creata nell'orchestrazione BizTalk in Visual Studio potrebbe essere diverso.

Risoluzione

Assicurarsi che i nomi delle operazioni nella porta logica (nell'orchestrazione BizTalk in Visual Studio) e nella porta fisica (nella console di amministrazione di BizTalk Server) siano uguali.

L'applicazione che usa l'adattatore Siebel non termina

Problema

Un'applicazione che usa l'adattatore Siebel con il client Siebel versione 7.5 non termina.

Causa

Ciò è dovuto a un problema del client Siebel per cui il processo non termina quando si disconnette da un server Siebel.

Risoluzione

Assicurarsi di avere installato la patch 7.5.3.17 per il server Siebel, insieme alla correzione rapida QF0H05.

L'adattatore Siebel può bloccarsi se il server Siebel viene riavviato

Problema

Se il server Siebel viene riavviato mentre l'adapter Siebel invia un messaggio al server Siebel utilizzando, l'adapter Siebel potrebbe bloccarsi.

Risoluzione

Riavviare l'istanza host dell'applicazione BizTalk. A tale scopo, dalla console di amministrazione di BizTalk Server, nell'albero della console espandere Gruppo BizTalk, espandere Impostazioni piattaforma e quindi fare clic su Istanze host. Nel riquadro destro fare clic con il pulsante destro del mouse sul nome host e quindi scegliere Riavvia.

L'adattatore non riconosce l'azione sulla porta fisica anche se si utilizza il file di associazione generato dal componente aggiuntivo Consume Adapter Service per creare le porte

Problema

Dopo aver usato il componente aggiuntivo Consume Adapter Service per generare lo schema per un'operazione specifica nel sistema Siebel, il componente aggiuntivo crea anche un file di associazione di porte. È possibile importare questo file di associazione usando la console di amministrazione di BizTalk Server per creare porte fisiche in BizTalk Server. Tuttavia, quando si inviano messaggi al sistema Siebel usando tali porte, l'adapter non riesce a comprendere l'azione specificata sulla porta e restituisce un errore simile al seguente:

Microsoft.ServiceModel.Channels.Common.UnsupportedOperationException: Incorrect Action   
<BtsActionMapping xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
  <Operation Name="<op_name>" Action="<action>" />  
</BtsActionMapping>. Correct the specified Action, or refer to the documentation on the allowed formats for the Actions.

Causa

Quando si creano porte logiche in un'orchestrazione BizTalk, si specificano determinati nomi per le operazioni su tali porte o si usano solo i nomi predefiniti come Operation_1, Operation_2 e così via. Tuttavia, nel file di associazione generato dal componente aggiuntivo Del servizio adapter di utilizzo, il nome dell'operazione corrisponde al nome dell'operazione per cui si generano metadati. Ad esempio, se si generano metadati per l'operazione Di inserimento nel componente Business Account, l'azione verrà impostata su quanto segue:

<Operation Name="Insert" Action="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert" />

Quando si importa il file di associazione, la stessa azione viene impostata sulla porta fisica. Quindi, i nomi delle operazioni sulla porta logica (Operation_1, Operation_2 e così via) non corrispondono ai nomi di operazione specificati nell'azione sulla porta fisica, causando un errore.

Risoluzione

Assicurarsi che il nome dell'operazione nella porta logica sia uguale al nome dell'operazione specificato come parte dell'azione nella porta fisica. Eseguire una delle operazioni seguenti:

  • Modificare il nome dell'operazione nella porta logica nell'orchestrazione BizTalk da Operation_1 e così via all'operazione per cui si generano metadati, ad esempio Inserisci.

  • Modificare il nome dell'operazione nell'azione sulla porta fisica nel nome dell'operazione nella porta logica. Ad esempio, è possibile modificare l'azione nella porta fisica in modo che sia simile al seguente:

    <Operation Name="Operation_1" Action="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert" />

L'adattatore Siebel non gestisce gli oggetti Siebel con stringhe con codifica XML nel nome

Problema

L'adattatore Siebel non può eseguire operazioni che coinvolgono oggetti Siebel (oggetti business, componenti aziendali, servizi aziendali, picklist, metodi, campi, argomenti e così via) con stringhe codificate XML nel nome. Ad esempio, l'adattatore Siebel non sarà in grado di richiamare un metodo di servizio aziendale con il nome Time_x0020_Stamp.

Risoluzione

Assicurarsi che gli oggetti Siebel non contengano stringhe codificate XML nel nome.

Errore con RootNode TypeName nei progetti BizTalk

Problema

In un progetto BizTalk in Visual Studio, se gli schemi generati dal componente aggiuntivo Del servizio adapter di utilizzo contengono caratteri non validi o parole riservate per la proprietà RootNode TypeName , si verificherà l'errore seguente durante la compilazione del progetto:

Node <node reference> - Specify a valid .NET type name for this root node.  
The current .NET type name of this root node is invalid (it is a reserved BizTalk Keyword or is an invalid C# identifier).

Risoluzione

  1. Fare clic con il pulsante destro del mouse sul nodo rood a cui fa riferimento nell'errore e selezionare Proprietà.

  2. Per la proprietà RootNode TypeName , rimuovere qualsiasi carattere illegale o parole riservate, ad esempio punto (.).

Avviso di associazione non valido quando si usa l'adapter in Visual Studio

Problema

Quando si usa l'adapter per creare un'applicazione in Visual Studio e si apre il file di configurazione (app.config) generato dall'adattatore, viene visualizzato un avviso simile al seguente:

The element 'bindings' has invalid child element 'siebelBinding'. List of possible elements expected: 'basicHttpBinding, customBinding, ...

Causa

Questo avviso viene visualizzato perché l'associazione dell'adattatore Siebel, siebelBinding, non è un'associazione standard fornita con Windows Communication Foundation (WCF).

Risoluzione

È possibile ignorare questo avviso.

Vedere anche

Risolvere i problemi dell'adapter Siebel