SAP R/3

GUIA DE IMPLEMENTAÇÃO – 4.6B

___________________________________________________________________________________________
Atualizar matchcodes para clientes

Transação: OB49 IMG > Contabilidade financeira > Contabilidade de clientes e fornecedores > Contas de clientes >
Dados mestre > Matchcode > Atualizar matchcodes para clientes

______________________________________________________________________________________________________
Versão: 1.0 - 11/02/11 Pág. 1
 SAP R/3
GUIA DE IMPLEMENTAÇÃO – 4.6B
___________________________________________________________________________________________

Nome de um parâmetro de ajuda para pesquisa

Através do Parâmetro de uma ajuda para pesquisa é possível determinar quais os dados de
contexto que entram nas entradas possíveis e quais os dados que podem ser reinicializados na
máscara de entrada. A cada campo na caixa de diálogo para a restrição de valores e a cada campo
na lista de acertos deve corresponder um parâmetro da ajuda para pesquisa.

Código p/parâmetro IMPORTAÇÃO da ajuda p/pesquisa

Código que indica se o Parâmetro é um parâmetro de importação.

Através de um parâmetro de importação podem ser transferidas informações de contexto a partir

da máscara de entrada processada (tela) para o processo de ajuda. Na Conexão da ajuda para
pesquisa é determinado no respetivo campo da máscara de entrada de onde um parâmetro de
importação recebe os seus valores.

Código p/parâmetro de EXPORTAÇÃO da ajuda p/pesquisa

Código que indica se o Parâmetro é um parâmetro de exportação.

Através de um parâmetro de exportação, os valores da lista de acertos podem ser reinicializados

na máscara de entrada (tela). Na Conexão da ajuda para pesquisa é determinado em que campos da
máscara de entrada são reinicializados os conteúdos do parâmetro de exportação.

______________________________________________________________________________________________________
Versão: 1.0 - 11/02/11 Pág. 2
 SAP R/3
GUIA DE IMPLEMENTAÇÃO – 4.6B
___________________________________________________________________________________________
Elemento de dados atribuido

É necessário que seja atribuído o tipo a um parâmetro de ajuda para pesquisa, por meio de
atribuição de um elemento de dados.

Valor de default para um parâmetro de ajuda para pesquisa

A um parâmetro de uma ajuda para pesquisa é possível atribuir um valor proposto adequado ao
tipo. O parâmetro recebe este valor proposto ao chamar as entradas possíveis nos seguintes casos:

1. Se o parâmetro não for um parâmetro IMPORT.

2. Se, na conexão de ajuda para pesquisa através da qual a ajuda para pesquisa foi ligada à área
de tela, não estiver nada atribuído ao parâmetro.

3. Se, na conexão de ajuda para pesquisa, foi atribuído ao parâmetro um campo que, no processo
das entradas possíveis, não existe nem na tela nem na lógica de processamento (pool de módulos).

4. Se uma ajuda para pesquisa estiver incluída em uma ajuda para pesquisa composta e o
parâmetro não estiver ligado a nenhum parâmetro desta ajuda para pesquisa composta.

Existem as seguintes possibilidades para valores propostos:

a) Constantes entre apóstrofes ('). Em parâmetros cuja categoria de dados possui uma máscara
de edição (ex: data e hora), a constante tem de ser indicada na representação interna. Por exemplo, a
data 01.03.1998 deve ser indicada como '19980301'.

b) Campos de sistema. São campos da estrutura DDIC SYST onde em vez do prefixo SYST-,
também é possível utilizar o prefixo SY-.

c) O Id de um parâmetro GET.

______________________________________________________________________________________________________
Versão: 1.0 - 11/02/11 Pág. 3
 SAP R/3
GUIA DE IMPLEMENTAÇÃO – 4.6B
___________________________________________________________________________________________

Dar dois Clicks na linha acima para incluir a nova pesquisa

Ajuda p/pesquisa incluída numa ajuda para pesquisa coletiva

A inclusão de ajudas para pesquisa é o mecanismo que atribui à ajuda para pesquisa composta os
caminhos de pesquisa alternativos que definem o seu comportamento.

Na inclusão de ajudas para pesquisa, é possível atribuir qualquer outra ajuda para pesquisa à
ajuda para pesquisa composta de inclusão.
Normalmente, a ajuda para pesquisa incluída é uma ajuda para pesquisa elementar. Neste caso, o
caminho de pesquisa implementado através desta ajuda para pesquisa é convertido em um dos
caminhos de pesquisa alternativos da ajuda para pesquisa de inclusão. Se a ajuda para pesquisa
incluída voltar a ser uma ajuda para pesquisa composta, todas as ajudas para pesquisa elementares
contidas nesta ajuda para pesquisa composta são convertidas em caminhos de pesquisa alternativos
da ajuda para pesquisa composta de inclusão. Contudo, em uma inclusão de vários níveis como esta,
devem ser consideradas algumas particularidades.

A transferência de informação de contexto e o retorno dos atributos selecionados na tela ocorre

através de uma atribuição executada entre os parâmetros da ajuda para pesquisa de inclusão e os
parâmetros de interface da ajuda para pesquisa incluída.

A inclusão de ajudas para pesquisa é uma parte da definição da ajuda para pesquisa de inclusão.
Uma ajuda para pesquisa pode ser incluída em um número qualquer de ajudas para pesquisa.

______________________________________________________________________________________________________
Versão: 1.0 - 11/02/11 Pág. 4
 SAP R/3
GUIA DE IMPLEMENTAÇÃO – 4.6B
___________________________________________________________________________________________
Observação: uma ajuda para pesquisa append é incluída automaticamente no seu objeto de
anexação. A inclusão de uma ajuda para pesquisa append em outras ajudas para pesquisa
compostas não é permitida.

Código, se a inclusão de ajuda para pesquisa está oculta

Se este índice estiver definido, a Inclusão da ajuda para pesquisa indicada é ocultada. A ajuda
para pesquisa incluída não é considerada no processo de entradas possíveis, que são controladas
através da ajuda para pesquisa incluída. Se a ajuda para pesquisa incluída for ela própria incluída em
outra ajuda para pesquisa coletiva, a inclusão ocultada também não lhe é transmitida.

O ocultar de inclusões de ajudas para pesquisa faz sentido quando um ou vários caminhos de
pesquisa previstos no standard não devem ser utilizados em um sistema R/3 concreto. Pelo contrário,
as inclusões de ajudas para pesquisa também podem estar contidas standard de forma oculta, uma
vez que só podem ser utilizadas com pertinência em poucos sistemas R/3. Neste sistema deve ser
anulado o código correspondente.

Nota: Através de uma Ajuda para pesquisa append, as ajudas para pesquisa incluídas podem ser
ocultadas sem modificações a partir de uma ajuda para pesquisa coletiva.

______________________________________________________________________________________________________
Versão: 1.0 - 11/02/11 Pág. 5
 SAP R/3
GUIA DE IMPLEMENTAÇÃO – 4.6B
___________________________________________________________________________________________

Dar dois Clicks no campo de método de seleção

Nome de um parâmetro de ajuda para pesquisa

Através do Parâmetro de uma ajuda para pesquisa é possível determinar quais os dados de
contexto que entram nas entradas possíveis e quais os dados que podem ser reinicializados na
máscara de entrada. A cada campo na caixa de diálogo para a restrição de valores e a cada campo
na lista de acertos deve corresponder um parâmetro da ajuda para pesquisa.

Os parâmetros de uma ajuda para pesquisa elementar correspondem aos campos do método de
seleção. O usuário pode transferir os campos necessários do método de seleção através das entradas
possíveis relativas a este campo como parâmetros de ajuda para pesquisa.

Em casos excecionais, devem ser incluídos os parâmetros, aos quais não corresponde nenhum
campo dos método de seleção. Isto pode ser necessário se a ajuda para pesquisa utiliza um Exit de
ajuda para pesquisa que precisa de parâmetros adicionais.

Nota: a ajuda para pesquisa não pode conter parâmetros para os mandantes. Nas entradas
possíveis, é selecionado automaticamente no mandante de logon do usuário.

Código p/parâmetro IMPORTAÇÃO da ajuda p/pesquisa

Código que indica se o Parâmetro é um parâmetro de importação.

______________________________________________________________________________________________________
Versão: 1.0 - 11/02/11 Pág. 6
 SAP R/3
GUIA DE IMPLEMENTAÇÃO – 4.6B
___________________________________________________________________________________________
Através de um parâmetro de importação podem ser transferidas informações de contexto a partir
da máscara de entrada processada (tela) para o processo de ajuda. Na Conexão da ajuda para
pesquisa é determinado no respetivo campo da máscara de entrada de onde um parâmetro de
importação recebe os seus valores.

Código p/parâmetro de EXPORTAÇÃO da ajuda p/pesquisa

Código que indica se o Parâmetro é um parâmetro de exportação.

Através de um parâmetro de exportação, os valores da lista de acertos podem ser reinicializados

na máscara de entrada (tela). Na Conexão da ajuda para pesquisa é determinado em que campos da
máscara de entrada são reinicializados os conteúdos do parâmetro de exportação.

Posição na lista de acertos de uma ajuda pesquisa elementar

Item do Parâmetro na lista de acertos.

Se o parâmetro não deve surgir na lista de acertos, este campo deve ser deixado livre. Nesta
coluna não deve surgir nenhum nº de item em duplicado. Pelo contrário, as lacunas são permitidas,
porque não têm efeitos na estrutura da lista de acertos.

Exemplo: uma ajuda para pesquisa elementar contém os parâmetros PAR1, PAR2, PAR3 e PAR4.
O campo LPos está ocupado da seguinte forma:

Parâmetro LPos
PAR1 3
PAR2 0 ou ' '
PAR3 1
PAR4 7

Na lista de parâmetros, surgem assim os parâmetros PAR3, PAR1 e PAR4 nesta sequência.

Nota: em uma ajuda para pesquisa elementar deveria surgir, pelo menos, um parâmetro na lista de
acertos. As únicas exceções a esta regra são as ajuda para pesquisa elementares, nas quais a
exibição da lista de acertos é completamente transferida pelo Exit da ajuda para pesquisa.

Item em caixa diálogo seleção de ajuda p/pesquisa elementar

Item do Parâmetro de ajuda para pesquisa na caixa de diálogo de seleção para restrição da
quantidade de acertos.

Se o parâmetro não deve surgir nesta caixa de diálogo, este campo deve ser deixado livre. Se não
deve surgir nenhuma caixa de diálogo no processo de entradas possíveis definido através da Ajuda
para pesquisa elementar, este campo deve ser deixado livre para todos os parâmetros.

Nesta coluna não pode surgir nenhum nº de item em duplicado. Pelo contrário, as lacunas são
permitidas, uma vez que não têm efeito na estrutura da caixa de diálogo de seleção.

Exemplo: uma ajuda para pesquisa elementar contém os parâmetros PAR1, PAR2, PAR3 e PAR4.
O campo SPos está ocupado da seguinte forma:

Parâmetro SPos
PAR1 3

______________________________________________________________________________________________________
Versão: 1.0 - 11/02/11 Pág. 7
 SAP R/3
GUIA DE IMPLEMENTAÇÃO – 4.6B
___________________________________________________________________________________________
PAR2 0 ou ' '
PAR3 1
PAR4 7

Na caixa de diálogo relativa à restrição de valores surgem depois os parâmetros PAR3, PAR1 e
PAR4 nesta sequência.

Campo exibição em popup seleção de ajuda pesquisa elementar

Se este código estiver definido, surge o Parâmetro de ajuda para pesquisa na caixa de diálogo de
seleção para a restrição da quantidade de acertos como simples campo de exibição.

Assim, a restrição é dada a conhecer ao usuário através do conteúdo do parâmetro, embora o

usuário não possa modificar esta restrição. Isto é pertinente, por exemplo, quando o parâmetro é um
parâmetro de importação ou contém um Default.

Elemento de dados atribuido

É necessário que seja atribuído o tipo a um parâmetro de ajuda para pesquisa, por meio de
atribuição de um elemento de dados.

Este elemento de dados determina as características de saída e as funções de ajuda do parâmetro

no popup para restringir os valores, e na lista de ocorrências.

Em regra, o parâmetro aceita o elemento de dados a partir do campo com o mesmo nome do
método de seleção. Se o elemento de dados deste campo for modificado, a ajuda para pesquisa é
ajustada automaticamente, ou seja, o elemento de dados também é aí modificado.

Atribuição de outro elemento de dados

Marcar o código Modificado. O campo Elemento de dados fica agora pronto para entrada. É
possível inscrever agora um novo elemento de dados, o qual tem de coincidir com o existente até ao
momento em termos de categoria de dados, comprimento e número das casas decimais.

Elem.dados de parâmetro independ.do campo do método seleção

Este código indica se o elemento de dados do parâmetro está ligado ao elemento de dados do
campo com o mesmo nome do Método de seleção.

Em regra, o parâmetro aceita o elemento de dados a partir do campo com o mesmo nome do
método de seleção. Se o elemento de dados deste campo for modificado, a ajuda para pesquisa é
ajustada automaticamente, ou seja, o elemento de dados também é aí modificado.

Atribuição de outro elemento de dados

Marcar o código Modificado. O campo Elemento de dados fica agora pronto para entrada. É
possível inscrever agora um novo elemento de dados, o qual tem de coincidir com o existente até ao
momento em termos de categoria de dados, comprimento e número das casas decimais.

Desse modo, é eliminado o acoplamento entre o elemento de dados do parâmetro de ajuda para
pesquisa e o elemento de dados do campo atribuído do método de seleção.

Para utilizar novamente o elemento de dados do campo atribuído do método de seleção, basta
desmarcar o código Modificado.

______________________________________________________________________________________________________
Versão: 1.0 - 11/02/11 Pág. 8
 SAP R/3
GUIA DE IMPLEMENTAÇÃO – 4.6B
___________________________________________________________________________________________

Observação: uma ajuda para pesquisa elementar também pode conter parâmetros, para os quais
não existe nenhum campo com o mesmo nome no método de seleção. Estes parâmetros podem ser
necessários, por exemplo, quando é atribuído um Exit de ajuda para pesquisa à ajuda para pesquisa.
Deve ser sempre indicado um elemento de dados para estes parâmetros. O código Modificadot não
é oferecido para estes parâmetros.

Valor de default para um parâmetro de ajuda para pesquisa

A um parâmetro de uma ajuda para pesquisa é possível atribuir um valor proposto adequado ao
tipo. O parâmetro recebe este valor proposto ao chamar as entradas possíveis nos seguintes casos:

1. Se o parâmetro não for um parâmetro IMPORT.

2. Se, na conexão de ajuda para pesquisa através da qual a ajuda para pesquisa foi ligada à área
de tela, não estiver nada atribuído ao parâmetro.

3. Se, na conexão de ajuda para pesquisa, foi atribuído ao parâmetro um campo que, no processo
das entradas possíveis, não existe nem na tela nem na lógica de processamento (pool de módulos).

4. Se uma ajuda para pesquisa estiver incluída em uma ajuda para pesquisa composta e o
parâmetro não estiver ligado a nenhum parâmetro desta ajuda para pesquisa composta.

Existem as seguintes possibilidades para valores propostos:

a) Constantes entre apóstrofes ('). Em parâmetros cuja categoria de dados possui uma
máscara de edição (ex: data e hora), a constante tem de ser indicada na representação interna. Por
exemplo, a data 01.03.1998 deve ser indicada como '19980301'.

b) Campos de sistema. São campos da estrutura DDIC SYST onde em vez do prefixo SYST-,
também é possível utilizar o prefixo SY-.

c) O Id de um parâmetro GET.

______________________________________________________________________________________________________
Versão: 1.0 - 11/02/11 Pág. 9
 SAP R/3
GUIA DE IMPLEMENTAÇÃO – 4.6B
___________________________________________________________________________________________

Pegar na internet a chave de acesso www.sapnet.sap.com , Click em http://service.sap.com digitar

o Usuário do OSS1da W/3 na SAP S0000516190 e senha WAS01,
Click em Modifications SSCR , Click em Registration , Click em Register Object e Click no CGC da
empresa e vira a tela abaixo

______________________________________________________________________________________________________
Versão: 1.0 - 11/02/11 Pág. 10
 SAP R/3
GUIA DE IMPLEMENTAÇÃO – 4.6B
___________________________________________________________________________________________

Click em Register no roda pé da tela :

______________________________________________________________________________________________________
Versão: 1.0 - 11/02/11 Pág. 11
 SAP R/3
GUIA DE IMPLEMENTAÇÃO – 4.6B
___________________________________________________________________________________________

Pegar o campo Registration key para clocar na Chave de acesso do SAP entrar num Client com um
usuário que tem a chave de ABAP/4.

______________________________________________________________________________________________________
Versão: 1.0 - 11/02/11 Pág. 12
 SAP R/3
GUIA DE IMPLEMENTAÇÃO – 4.6B
___________________________________________________________________________________________

______________________________________________________________________________________________________
Versão: 1.0 - 11/02/11 Pág. 13
 SAP R/3
GUIA DE IMPLEMENTAÇÃO – 4.6B
___________________________________________________________________________________________

______________________________________________________________________________________________________
Versão: 1.0 - 11/02/11 Pág. 14
 SAP R/3
GUIA DE IMPLEMENTAÇÃO – 4.6B
___________________________________________________________________________________________

Resumo do Processo
Nesta transação são modificados os objetos matchcode de clientes.

Documentação SAP:

Atualizar matchcodes para clientes

Nesta atividade IMG, são definidos matchcodes para dados mestre de clientes. Caso se pretenda modificar ou exibir um registro
mestre de cliente e já não se souber o número do registro mestre, este pode ser procurado utilizando um matchcode. O sistema
grava no matchcode determinados campos de um registro mestre de cliente. A conta de cliente pode ser procurada com base
nesses campos ou matchcodes.

A estrutura dos matchcodes é obtida a partir das tabelas de dados mestre, utilizando visões e índices de banco de dados (=tipo
de atualização I)

Exemplo

O usuário precisa de um determinado número de conta de cliente, mas conhece apenas o seu texto descritivo e a empresa
relevante. Com uma pesquisa de matchcode, o número de conta pode ser determinado com base na empresa ou no texto
descritivo.

Opções standard

O sistema standard SAP contém os seguintes matchcodes para contas de cliente:

• O matchcode com a identificação A permite uma pesquisa com base nos dados do endereço.

• O matchcode com a identificação C permite uma pesquisa com base em classes. Neste caso, é necessário classificar
primeiro os clientes.

• O matchcode com a identificação D permite uma pesquisa com base no conceito de pesquisa. Este faz parte do registro
mestre e, em regra, contém a parte essencial do nome. Além disso, é possível efetuar também uma pesquisa com base
na empresa.

• O matchcode com a identificação E permite uma pesquisa com base no país. Este matchcode utiliza-se para a pesquisa
de clientes estrangeiros.

• O matchcode com a identificação K permite uma pesquisa com base no grupo de contas.

• O matchcode com a identificação S permite uma pesquisa com base na organização de vendas. Este matchcode utiliza-
se na aplicação Vendas e Distribuição (SD).

o O matchcode com a identificação Z permite uma pesquisa com base no nº de conta da sede. Este matchcode é utilizado para
a pesquisa de filiais de uma determinada sede.

O ojeto de matchcode para as contas de cliente denomina-se DEBI.

O ojeto de matchcode determina as tabelas de banco de dados e, por conseguinte, os campos que são necessários para os ID
matchcodes. Para um ojeto de matchcode, pode ser criado um ou vários ID matchcodes. No ID matchcode são determinados os
campos ou combinações de campos com base nos quais deve ser efetuada a pesquisa.

Nota

Uma vez que nos campos de pesquisa do nome (NAME1) e do local (ORT01) do cliente é necessário distinguir corretamente
maiúsculas e minúsculas, foram criados para esses campos campos substitutos. Nestes campos substitutos (MCOD1 para NAME1
e MCOD3 para ORT01), todas as entradas são automaticamente convertidas para maiúsculas. Assim, quando é efetuada a
entrada do nome ou local do cliente para a seleção de matchcode, não é necessário ter em atenção as maiúsculas e minúsculas.

Atenção

Se, além dos ID matchcodes contidos no sistema standard, forem necessários ID matchcodes suplementares, nos quais deverão
ser incluídos os campos destinados ao nome e local do cliente, é necessário entrar, na lista de campos dos ID matchcodes, os

______________________________________________________________________________________________________
Versão: 1.0 - 11/02/11 Pág. 15
 SAP R/3
GUIA DE IMPLEMENTAÇÃO – 4.6B
___________________________________________________________________________________________
campos de matchcode MCODF1 e MCOD3 para os campos de pesquisa NAME1 e ORT01.

No sistema standard SAP, estão definidos os campos substitutos MCOD1 e MCOD3 para os campos de pesquisa NAME1 e
ORT01. O campo de pesquisa NAME2 não está contido nos matchcodes standard. Em vez desse campo de pesquisa, pode,
assim, ser definido um outro. Pode, por exemplo, utilizar-se o campo STRAS em vez de NAME2, quando é necessária a rua como
campo de pesquisa. Para isso, deve entrar-se o campo STRAS, em vez de NAME2, na atividade IMG "Verificar campos de
pesquisa para matchcodes".

Atividades

1. Determinar os matchcodes que são necessários na empresa.

2. Verificar os ID matchcodes do sistema standard. É importante que os campos desejados sejam indicados na sequência
correta. Se necessário, criar ID matchcodes personalizados.

3. Caso se pretenda utilizar os matchcodes baseados na classificação, é necessário assegurar que as classes tenham sido
criadas por intermédio das funções válidas para todas as aplicações do guia de implementação e que sejam gravadas nos
registros mestre de clientes.

Informação adicional

Para mais informações sobre matchcodes, consultar o documento BC - ABAP/4 Dictionary. Para mais informações sobre a
classificação, consultar a seção correspondente do guia de implementação do sistema de base.

Dicas
É aconselhável modificar este objeto somente por usuários que dominem este assunto, pois se trata de um objeto extremamente
técnico.

______________________________________________________________________________________________________
Versão: 1.0 - 11/02/11 Pág. 16