Piattaforma legacy

Attuazione della proposta

Sterling™ Field Sales fornisce l'attività Generate Proposal per consentire all'utente di generare una proposta per un preventivo.

A volte, un rappresentante delle vendite sul campo può voler stampare una proposta per un preventivo in modo che possa essere inviata a un cliente. Ad esempio, un cliente può richiedere a un rappresentante delle vendite sul campo di inviare un'e-mail al preventivo in modo che il cliente possa visualizzare i prezzi degli articoli nel preventivo.

Soluzione

Sterling Field Sales fornisce l'attività correlata Genera proposta per abilitare un utente a generare una proposta per un preventivo. L'utente può stampare la proposta in formato PDF selezionando il formato PDF dall'elenco a discesa Scegli un formato di stampa, che viene generato utilizzando il servizio SAA_GeneratePrint.

L'API getCompleteOrderDetails viene richiamata per recuperare i dettagli del preventivo da visualizzare nella schermata Generate Proposal. L'API getTransformationData viene richiamata per recuperare i valori da visualizzare nell'elenco a discesa Scegli un modello di formattazione. L'API getCommonCodeList viene richiamata per recuperare i valori da visualizzare nell'elenco a discesa Scegli un formato di stampa. I formati di stampa vengono memorizzati come codici comuni con tipo di codice SAA_QUOTE_PRNT_FRMT. In base al modello selezionato, i formati specifici della locale configurati per il modello selezionato vengono visualizzati nell'elenco a discesa Scegli una locale .

Un utente può selezionare gli attributi che devono essere stampati nella proposta dal pannello Includi nella stampa . Gli attributi visualizzati nel pannello Includi nella stampa sono definiti nel formato XML di Sterling Business Center, che viene memorizzato nel database e recuperato quando viene richiamata l'API getTransformationConfigList.

Nota: per visualizzare gli attributi nel pannello Includi nella stampa in Sterling Field Sales, il nome del modello di stampa creato in Sterling Business Center deve essere PrintProposal.
Di seguito viene riportato un file XML di metadati di esempio:
<Resource>
<Group Name="ProposalHeader" DisplayName="Quote_Proposal_Header" Id="header">
		<Attribute Name="ProposalDate" DisplayName="Quote_Proposal_Date" Value="Y"/>
		<Attribute Name="Status" DisplayName="Quote_Proposal_Quote_Status" Value="Y"/>
		<Attribute Name="ExpirationDate" DisplayName="Quote_Proposal_Expiration_Date" Value="Y"/>
		<Attribute Name="ProposalTitle" DisplayName="Quote_Proposal_Title" Value="Y"/>
		<Attribute Name="ProposalID" DisplayName="Quote_Proposal_ID" Value="Y"/>
	</Group>			
	
	<Group Name="Address" DisplayName="Quote_Proposal_Address">
		<Attribute Name="BillTo" DisplayName="Quote_Proposal_Bill_Address" Value="Y"/>
		<Attribute Name="ShipTo" DisplayName="Quote_Proposal_Shipping_Address" Value="Y"/>
	</Group>
	
	<Group Name="OrderLines" DisplayName="Quote_Proposal_Lines">
		<Attribute Name="QuoteLines" DisplayName="Quote_Proposal_Quote_Lines" Value="Y"/>
		<Attribute Name="RecommendedLines" DisplayName="Quote_Proposal_Recommended_Lines" Value="Y"/>
	</Group>
	
	<Group Name="PricingInformation" DisplayName="Quote_Proposal_Quote_Totals">
		<Attribute Name="Additional" DisplayName="Quote_Proposal_Additional_Upfront_Charges" Value="Y"/>
		<Attribute Name="SubTotal" DisplayName="Quote_Proposal_Line_Sub_Total" Value="Y"/>
		<Attribute Name="Discounts" DisplayName="Quote_Proposal_Adjustments" Value="Y"/>
		<Attribute Name="ShippingCharges" DisplayName="Quote_Proposal_Shipping" Value="Y"/>
		<Attribute Name="Taxes" DisplayName="Quote_Proposal_Taxes" Value="Y"/>
		<Attribute Name="GrandTotal" DisplayName="Quote_Proposal_Total" Value="Y"/>				
	</Group>	
	
	<Group Name="Terms" DisplayName="Quote_Proposal_Terms">
		<Attribute Name="PaymentTerms" DisplayName="Quote_Proposal_Payment_Terms" Value="Y"/>
		<Attribute Name="ShippngTerms" DisplayName="Quote_Proposal_Carrier" Value="Y"/>
		<Attribute Name="LevelOfService" DisplayName="Quote_Proposal_Level_Service" Value="Y"/>
		<Attribute Name="DeliveryDate" DisplayName="Quote_Proposal_Devivery_Date" Value="Y"/>
		<Attribute Name="InstructionText" DisplayName="Quote_Proposal_Shipping_Instructions" Value="Y"/>
	</Group>	                                   
</Resource>
Nota: il valore dell'attributo DisplayName viene letto dai valori letterali del pacchetto lato server e viene visualizzato nella UI. Se viene aggiunto un nuovo attributo, il valore dell'attributo DisplayName deve essere aggiunto al file bundle lato server.

L'API getOrganizationHierarchy richiama il servizio SAA_GeneratePrint per ottenere i dettagli dell'indirizzo dell'organizzazione. L'API getUserHierarchy ottiene il nome del venditore da visualizzare nella proposta.

Quando un utente fa clic su Genera nella schermata Genera proposta, viene richiamato il servizio SAA_GeneratePrint per generare la proposta.

Un'implementazione di esempio del servizio utilizzato per generare una proposta è illustrata nella seguente figura:

Genera figura del servizio di proposta di preventivoIn base al modello e alla locale selezionati, l'API processPrint richiama il formato configurato e, insieme all'XML, genera la proposta nel formato selezionato (PDF) utilizzando il componente Apache FOP (Formatting Objects Processor).

Implementazione

In questa sezione vengono illustrate le configurazioni per questa funzionalità:

Sterling Field Sales fornisce un file di configurazione al componente FOP. Per impostazione predefinita, il file di configurazione fornito al componente FOP ricerca tutti i font installati sul sistema. Il componente FOP del servizio SAA_GeneratePrint accetta l'argomento FOPConfigFile, che punta al percorso del file di configurazione nel classpath.

È possibile personalizzare il file di configurazione per aggiungere o rimuovere i font in base al requisito. Se il file di configurazione è personalizzato, l'argomento FOPConfigFile deve essere modificato in modo da puntare al file di configurazione personalizzato. Questo file di configurazione viene utilizzato dal processore FOP per generare il file PDF.

Nota:
  • Per generare la proposta in varie lingue, è necessario che i font della lingua richiesti siano installati sul sistema. Inoltre, verificare che la famiglia di caratteri nel foglio di stile corrispondente sia modificata in modo appropriato per riflettere tali caratteri.
  • L'inclusione di tutti i font di sistema può influire sulle prestazioni della generazione di proposte del FOP. Si consiglia quindi di personalizzare il file di configurazione in modo da includere solo i font richiesti per la creazione della proposta.

Per ulteriori informazioni sul file di configurazione FOP e sulla configurazione dei font, fare riferimento al sito Web Apache.

Nota:
  • Per visualizzare i modelli di formattazione in Sterling Field Sales, il nome del modello di stampa creato in Sterling Business Center deve essere PrintProposal.
  • È possibile configurare il modello di stampa per generare una proposta.
  • È possibile configurare il formato di stampa da utilizzare per generare una proposta.

Installa i file JAR di FOP

Per installare i file JAR FOP, effettuare le seguenti operazioni:
  1. Copiare i seguenti file JAR di terze parti in extensions.jar:
    • avalon-framework-4.2.0.jar
    • fop.jar
    • xmlgraphics-commons-1.4.jar
  2. Importare l'ultima versione del file JAR tramite il componente OMS-CUSTOM-OMS .
  3. Eseguire il processo Crea runtime personalizzato in UCD includendo il file JAR personalizzato.
  4. Aggiornare Sterling Order Management System.