Implementação de geração de uma proposta

O Sterling™ Field Sales fornece a tarefa relacionada Gerar proposta para permitir que um usuário gere uma proposta para uma cotação.

Às vezes, um Representante de Vendas de Campo talvez queira imprimir uma proposta para uma cotação para que ela possa ser enviada a um cliente. Por exemplo, um cliente pode solicitar que um Representante de Vendas de Campo envie a cotação por e-mail para que o cliente possa visualizar os preços dos itens na cotação.

Solução

O Sterling Field Sales fornece a tarefa relacionada Gerar Proposta para permitir que um usuário gere uma proposta para uma cotação Um usuário pode imprimir a proposta como um PDF, selecionando o formato PDF da lista suspensa Escolher um formato de impressão, que é gerada usando o serviço SAA_GeneratePrint.

A API getCompleteOrderDetails é chamada para recuperar os detalhes da cotação a ser exibida na tela Gerar proposta. A API getTransformationData é chamada para recuperar os valores a serem exibidos na lista suspensa Escolher um modelo de formatação. A API getCommonCodeList é chamada para recuperar os valores a serem exibidos na lista suspensa Escolher um formato de impressão. Os formatos de impressão são armazenados como códigos comuns com o tipo de código SAA_QUOTE_PRNT_FRMT. Com base no modelo de impressão selecionado, os formatos específicos do código do idioma configurados para o modelo selecionado são exibidos sob a lista suspensa Escolher um código do idioma.

Um usuário pode selecionar os atributos que devem ser impressos na proposta do painel Incluir na impressão. Os atributos exibidos no painel Incluir na impressão são definidos no formato XML no Sterling Business Center, que é armazenado no banco de dados e recuperado quando a API getTransformationConfigList é chamada.

Nota: Para visualizar os atributos no painel Incluir na impressão no Sterling Field Sales, o nome do Modelo de impressão criado no Sterling Business Center deve ser PrintProposal.

A seguir está um arquivo XML de metadados de amostra:

<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: O valor de atributos do DisplayName é lido a partir dos literais do pacote configurável do lado do servidor e é exibido na UI. Se um novo atributo for incluído, o valor do atributo DisplayName deve ser incluído no arquivo de pacote configurável do lado do servidor.

A API getOrganizationHierarchy chama o serviço SAA_GeneratePrint para obter os detalhes do endereço da organização. A API getUserHierarchy obtém o nome do vendedor a ser exibido na proposta.

Quando um usuário clica em Gerar na tela Gerar proposta, o serviço SAA_GeneratePrint é chamado para gerar a proposta.

Uma implementação de amostra do serviço que é usado para gerar uma proposta é ilustrada na figura a seguir:

Gerar a figura do Serviço de Proposta de Cotação

Com base no modelo e código de idioma selecionados, a API processPrint recupera o formato configurado e, juntamente com o XML, gera a proposta no formato selecionado (PDF) usando o componente Apache FOP (Formatting Objects Processor).

implementação

Esta seção explica as configurações para essa funcionalidade:

O Sterling Field Sales envia um arquivo de configuração para o componente FOP Por padrão, o arquivo de configuração enviado para o componente FOP procura todas as fontes instaladas no sistema. O componente FOP do serviço SAA_GeneratePrint usa o argumento FOPConfigFile, que aponta para o local do arquivo de configuração no caminho de classe.

É possível customizar o arquivo de configuração para incluir ou remover as fontes com base no requisito. Se o arquivo de configuração for customizado, o argumento FOPConfigFile deve ser mudado para apontar para o arquivo de configuração customizado. Esse arquivo de configuração é usado pelo processador FOP para gerar o PDF.

Nota:

Para gerar a proposta em vários idiomas, é necessário que as fontes do idioma necessárias estejam instaladas no sistema. Além disso, certifique-se de que a família da fonte na folha de estilo correspondente seja mudada de forma apropriada para refletir essas fontes.
A inclusão de todas as fontes do sistema pode afetar o desempenho da geração de proposta do FOP. Por isso, é recomendável customizar o arquivo de configuração para incluir somente as fontes que são necessárias para a geração da proposta.

Para obter mais informações sobre o arquivo de configuração FOP e a configuração de fontes, consulte o Apache.

Nota:

Para visualizar os modelos de formatação em Sterling Field Sales, o nome do Modelo de Impressão criado no Sterling Business Center deve estar em PrintProposal..

É possível configurar o modelo de impressão para gerar uma proposta.
É possível configurar o formato de impressão a ser usado para gerar uma proposta.

Instale os arquivos JAR FOP

Para instalar os arquivos JAR FOP, execute as etapas a seguir:

Copie os seguintes arquivos JAR de terceiros para o extensions.jar:
- avalon-framework-4.2.0.jar
- fop.jar
- xmlgraphics-commons-1.4.jar
Importe a versão mais recente do arquivo JAR por meio do componente OMS-CUSTOM-OMS
Execute o processo Build Customized Runtime no UCD incluindo o arquivo JAR customizado.
Atualize Sterling Order Management System.