Exemplo de conversão de dados 1s 8.3 3.0. Problemas do mundo real

11.12.2023

1. Introdução.

2. O que você precisa: Configuração 1C: Conversão de dados 2.* e processamento do pacote. Para tarefas de exemplo, tomemos as configurações 1C: Trade Management 11 e 1C: BP 3.*.

Assim, para desenvolver regras de upload de dados para 1C, você precisará da configuração 1C: Object Conversion 2, bem como do processamento incluído no pacote.

Por exemplo, já implantamos um banco de dados de conversão e o lançamos.

Escreveremos o desenvolvimento de regras de troca entre a configuração 1C: Trade Management 11 e 1C: Enterprise Accounting 3 (regras de troca UT/ACCOUNT).

3. Precisaremos de Processing para descarregar a estrutura de metadados e trocar.

A primeira coisa que você precisa obter para o desenvolvimento são arquivos com estrutura de metadados. Isso é feito por meio de processamento para descarregar a estrutura de metadados incluída no pacote de conversão de objetos.

Na verdade, no diretório de configuração descompactado para configurações em formulários controlados estamos interessados ​​em processar MD83Exp.epf. Se você precisar fazer upload das configurações para formas usuais, então o processamento MD82Exp.epf será usado. Isso se, por exemplo, você precisar obter uma estrutura de configurações como 1C: UT 10, 1C: Manufacturing Enterprise Management 1.3, 1C: Integrated Automation 1.1, 1C: Zup 2.5 e assim por diante.

A seguir, para fazer upload e download de dados para 1C usando nossas regras, você precisará processar “ Troca universal dados em formato XML" V8Exchan83.epf para configurações em formulários gerenciados como 1C: Trade Management 11.*, 1C BP 3, 1C: ERP 2.* e similares. E, consequentemente, V8Exchan83.epf - para configurações em formulários regulares.

4. Carregando a estrutura de metadados da configuração 1C: Trade Management 11.3 e 1C: Enterprise Accounting 3.0.*

Vamos começar baixando a estrutura de metadados da configuração 1C: Enterprise Accounting 3.
Vamos abrir o processamento MD83Exp.epf

No formulário de processamento existem configurações adicionais, onde podemos habilitar ou desabilitar a opção de descarregamento de registros e movimentos em 1C. Também existe a opção de onde o upload ocorrerá: no servidor 1C ou “no cliente”. Especifique o nome do arquivo onde a estrutura de dados será carregada. De forma semelhante, descarregamos a estrutura de metadados da configuração Trade Management 11.

Agora você precisa fazer upload da configuração para o banco de dados de conversão. Este ponto pode ser alcançado tanto pela lista de configurações quanto pela lista de conversões. Vamos inicializar a partir da área de trabalho:

Na caixa de diálogo, carregue a estrutura do PN:

E da mesma forma - a estrutura da Gestão Comercial.

Assim que o download for concluído, uma caixa de diálogo aparecerá onde você poderá especificar um nome que seja conveniente para você.

6. Criação de regras de conversão em 1C usando um exemplo específico de tarefa.

A seguir, vá em “Configurando regras de objetos”, onde criamos uma nova configuração.
Na caixa de diálogo de criação de conversão, selecione a configuração de “origem” e a configuração de “destino” (que você carregou anteriormente) e clique em OK.

Como neste artigo pretendi mostrar a criação “do zero” e “sem lixo”, lembro que não criamos nada automaticamente. Sem protótipos.

Não faremos nada nesta caixa de diálogo, basta clicar em “Fechar”.

Vamos criar regras para carregar não um documento em um, mas um tipo em outro, por exemplo, o documento Vendas de Bens e Serviços do UT 11 com os livros de referência necessários no documento Recebimento de Bens e Serviços no BP 3.

Então, criamos um novo PKO (a regra para conversão de objetos em 1C)

Selecione a origem Vendas de Mercadorias e Serviços e o Recebimento de Mercadorias e Serviços de destino e clique em OK.
Uma caixa de diálogo aparecerá onde recusamos novamente criação automática PKS (Regras de Conversão de Propriedade). A seguir, selecionaremos apenas os necessários.

Mas à proposta de criação de DVP (regras de upload de dados), respondemos “Sim”.

São criados PVDs, que serão refletidos no processamento da troca XML universal para seleção:

Também serão criadas regras de conversão de dados com regras de conversão de propriedades vazias.

Além disso, pode-se observar que por padrão o software é oferecido para ser pesquisado pelo identificador interno do objeto. Isto é indicado pela lupa próxima ao PCO. Faremos a nossa própria pesquisa, e faremos por número de documento e data no início do dia.

Removemos a pesquisa por UIO:

Agora vamos começar a comparar as propriedades (detalhes) necessárias do objeto. Para fazer isso, clique em “Sincronizar Propriedades” (rótulo “1” na tela). Removemos a criação recursiva de regras (“2”). Remova todos os detalhes marcados ("3"). E escolheremos por conta própria o que precisamos.

Por exemplo, selecione o que você precisa:

Chamo a atenção para o fato de que faremos o PKS da contraparte na organização, e da organização na contraparte, e também compararemos alguns detalhes que não correspondem pelo nome, por exemplo, “Moeda” e “Documento Moeda".

Onde vemos que ainda não existem regras de conversão.

Vamos começar analisando os detalhes e descrevê-los. Primeiro, configuramos uma busca de documentos como escrevi anteriormente, carregamos e buscamos um documento no início da data e alteramos a numeração. Substituiremos os três primeiros caracteres pelo nosso prefixo “UTB”. E como a numeração em BP e UT tem 11 caracteres cada, fazemos um número composto: nosso prefixo e 8 caracteres da fonte. Um exemplo na imagem abaixo.

Sempre carregamos documentos descarregados e sem movimentação. Assumimos que os documentos serão processados ​​no destinatário após verificação pelo usuário.

Para isso, definindo PKS como não realizado, 0 ou 1, utilizamos como booleano.

Usando a moeda como exemplo, criamos uma regra de conversão de objetos para PKS. Ao mesmo tempo, acreditamos que existem moedas em ambas as bases de dados e que devem ser sincronizadas por código. Portanto, não criaremos todos os PKS no PQS da Moeda, mas apenas adicionaremos um Código de Pesquisa. Aqueles. Recusamos a oferta de criação de um PKS para o objeto.

A Regra de Conversão criada foi substituída no PQR do documento pelo PKS. E a própria regra padrão é oferecida por um identificador exclusivo. Corrigimos, pesquisamos o código e configuramos a propriedade para não criar um novo objeto.

Como resultado, obtemos a seguinte opção:

A seguir, por analogia, criamos PKO e PKS para os demais detalhes. Além disso, procuramos uma organização por contraparte e vice-versa por TIN. É mais ou menos assim que parece com detalhes mínimos (você pode adicionar se necessário).

Para Contratos de Contraparte PKO, pesquisamos por Contraparte PKS, nome e proprietário.

Vamos ver como especificar o valor necessário no tipo de enumeração no PKS. Por exemplo, o atributo “Tipo de Operação”. Aqui você pode usar várias condições e valores substitutos. Por exemplo, precisamos que o “tipo de operação” seja sempre descarregado “Mercadoria”, neste caso basta escrever o valor requerido na linha “testa”.

Abaixo é mostrado como instalar sem dificuldade e na maioria dos casos PCS para Multiplicidade de Liquidação Mútua, Taxa de Liquidação Mútua, Conta Contábil.

Para Nomenklatura PKO, deixaremos a busca por identificador único interno. Mas deixe-me chamar sua atenção para como você pode redefinir seu grupo. Por exemplo, concordamos que um novo item será carregado a partir da configuração 1C: Trade Management 11, mas é necessário que o item seja coletado em um grupo específico “NossoGrupo”.

Para implementar esta tarefa, criamos outro PKO. Vamos chamá-lo de “NomenclatureParent”, que indicaremos no PCS do pai na regra de conversão.

Configuramos duas buscas: por nome, onde indicamos estritamente o nome do nosso grupo, e a propriedade obrigatória do atributo “Este é um Grupo” é definida como verdadeira.

Como decidimos que todos os nossos itens se enquadram em nosso grupo, não há necessidade de descarregar grupos do UT 11 durante o descarregamento. Para fazer isso, no software Nomenclature, no manipulador de eventos “Before Unloading”, definiremos um filtro que. não precisa descarregar grupos “Failure = Source This is a Group;”.

No DRP (regras de upload de dados) de Vendas de Produtos e Serviços, adicionaremos um filtro para que não sejam carregados documentos marcados para exclusão. Para isso, no VDP nos manipuladores de eventos “Before Unloading”, escreveremos o filtro “Failure = Object.DeletionMark;”.


Vamos salvar as regras desenvolvidas em um arquivo.


7. Para resumir: Upload e carregamento de dados usando regras de troca de dados desenvolvidas.

Abra em 1C: Trade Management 11 o processamento “Troca universal de dados em formato XML” V8Exchan83.epf.

O descarregamento foi concluído, agora usamos o mesmo processamento para carregar em 1C: Enterprise Accounting 3.


Carregamento concluído. Vamos verificar como ele carregou. Assim, o documento é carregado como queríamos - nossa organização é carregada na contraparte e a contraparte na organização. Todas as contas de contabilidade são baixadas e instaladas. Conseguimos o número do documento com nosso prefixo e no início do dia. Todos os dados fornecidos foram preenchidos.

Verificamos o carregamento dos itens. Vemos que tudo saiu como planejamos.


Criamos e preenchemos os detalhes conforme pretendíamos. Existem muitas sutilezas na conversão e algumas coisas simples, mas necessárias, que ajudam a escrever a conversão com precisão. E isso permite minimizar erros, não estragar os dados existentes e se livrar de excesso de lixo. Este é um dos mais exemplos simples. Você também pode converter um objeto em muitos ou, inversamente, muitos em um.

Agora existe a conversão de dados 3, resolve outros problemas. Portanto, a conversão 2 também é necessária. Boa sorte a todos no aprendizado e domínio.

Claro, se você é um programador e este é seu trabalho principal, você mesmo pode tentar escrever a conversão. Mas se não, então você deve valorizar o seu tempo na sua área de atividade, e esta tarefa peça a profissionais para fazer isso.

Há um DB 1C Trade Management atualizado (doravante denominado UT) edição 10.2 na plataforma 8.1.
E há um banco de dados de contabilidade 1C padrão na plataforma 8.3.

Tarefa:

Estabeleça troca de dados entre bancos de dados.

Solução:

Instalado 1C Data Conversion, edição 2.1.
Carregado.
Eu inicio o “Start Assistant” (Fig. 1).

1. Próximo.
2. Selecione "Criar novas regras de troca de dados (do zero)". Próximo.
3. Na terceira etapa, o programa solicita que você especifique as configurações de origem e destino.
Eu crio uma configuração de origem (1C UT):
- como tenho 1C UT na plataforma 8.1, retiro-o do disco ITS processamento externo MD81Exp.epf (você pode baixá-lo).
- Abro 1C UT. Arquivo -> Abrir -> MD81Exp.epf .

Eu especifico o arquivo no qual as informações sobre a estrutura de metadados serão carregadas. Deve estar no formato XML.

Clico no botão "Upload".

Faço o mesmo com a base do receptor. Com 1C Contabilidade 8.3. Só para isso utilizo processamento externo MD83Exp.epf (você pode baixá-lo).

Volto à Conversão de Dados 1C.

Paramos no passo 3. Clico no botão “Novo” e especifico o arquivo de estrutura de metadados gerado. Esta estrutura será carregada no diretório de configuração.

4. Na quarta etapa, selecione a opção “Criar automaticamente todas as regras possíveis de troca de dados”.

Agora uma nova janela se abriu diante de nós. As regras de conversão de objetos foram criadas. Você precisa criar regras para baixar dados. Para fazer isso, vá até a segunda aba “Regras de upload de dados” e clique no botão “Criar regras de upload”.

Imprimir (Ctrl+P)

Conversão de dados, edição 3.0

Lição 1. Preparando-se para trabalhar com KD3.0

Conversão de dados, edição 3.0(avançar KD3.0) – é um dos componentes da tecnologia de troca de dados através do formato Dados empresariais. KD3.0 não é uma substituição de configuração Conversão de dados, edição 2.0(avançar KD2.0). Esse novo padrão, que é muito diferente do KD 2.0. Objetivo principal KD3.0 – trata-se da criação de um código de programa para um módulo gerenciador de câmbio, composto por procedimentos e funções que implementam a lógica de carregamento dos dados apresentados no formato Dados empresariais, bem como a lógica para fazer upload de dados no formato.

Fig 1 Módulo gerenciador de troca geral

KD3.0 pode ser baixado em https://users.v8.1c.ru/

Edição 3.0.5.3, destinada ao uso com a versão do sistema
1C:Enterprise 8.3 não é inferior a 8.3.10, e a edição 3.0.4.3 é para uso com a versão do sistema 1C:Enterprise 8.3 não é inferior a 8.3.8.

A entrega KD3.0 contém o seguinte processamento externo

  • Processamento MD83Exp.epf“Carregando uma descrição da estrutura de metadados da configuração 8.3” – destina-se ao upload de uma descrição da estrutura de metadados de qualquer configuração implementada na plataforma 1C:Enterprise 8.3.
  • Processamento Fazendo upload de regras de sincronização.epf“Carregando regras de sincronização via formato universal” usado na preparação de arquivos de regras de conversão destinados ao carregamento posterior na configuração “Conversão de Dados”, edição 3.0.
  • O arquivo “Configuration Description.htm” contém uma breve descrição
    principal funcionalidade configurações
    “Conversão de Dados”, edição 3.0.

Informações adicionais sobre a configuração “Conversão de Dados”, versão 3.0
veja http://its.1c.ru/db/metod8dev#content:5846:hdoc

1. Preparando-se para estabelecer regras

Para carregar a estrutura do formato, você deve primeiro abrir o banco de dados de configuração no modo configurador e baixar os pacotes XDTO da configuração em arquivos *.xsd.

É necessário descarregar todos os pacotes associados ao formato. Os nomes dos arquivos não são de fundamental importância. Você também deve fazer upload do pacote ExchangeMessage XDTO

Após carregar o formato XDTO no CD 3.0, os diretórios “Format Objects”, “Format Properties”, “Format Values” são preenchidos

EM livro de referência “Formatar objetos” carregando:

  • Objetos do tipo “ObjectTypeXDTO”, que refletem tipos de dados de referência (documentos, diretórios)
  • Objetos do tipo “XDTOValueType” contendo uma enumeração. Eles refletem dados predefinidos (como enumerações)

EM livro de referência “Propriedades de formato” carregando:

  • Propriedades dos objetos “ObjectTypeXDTO”. Ao mesmo tempo, os próprios objetos são aqueles que foram carregados em “Format Objects”
  • Objetos com o tipo “XDTOObjectType” e suas propriedades que refletem partes tabulares e detalhes de partes tabulares

As propriedades dos objetos “XDTOValueType”, que são elementos de dados predefinidos, são carregadas no livro de referência “Format Values”. Ao mesmo tempo, os próprios objetos são aqueles que foram carregados em “Format Objects”

1. 2. Processando “Carregando estrutura de configuração”

Este processamento carrega a estrutura de metadados de configuração na infobase Conversão de dados ed.3.

Para baixar informações sobre a estrutura da infobase, é utilizado o processamento MD83Exp.epf, incluído no kit de entrega para a configuração KD3.0

Para a infobase cuja estrutura precisa ser descarregada, execute as seguintes etapas:

  1. Abra a infobase no modo Empresarial.
  2. Abrir processamento externo MD83Exp.epf(Menu Arquivo - Abrir).
  3. Especifique o nome do arquivo no qual deseja salvar a estrutura da infobase.
  4. Verifique as configurações no formulário de processamento (todos os sinalizadores devem ser desmarcados).
  5. Pressione o botão Descarregar.

Após baixar a estrutura de configuração, os diretórios são preenchidos

  • Objetos de metadados
  • Propriedades do objeto
  • Valores de objeto.

Diretório Objetos de metadados contém informações sobre objetos de metadados de configuração. O tipo de objetos é registrado no atributo correspondente. Dependendo do valor do atributo Type, são preenchidos os detalhes que descrevem as propriedades do objeto de metadados. Os detalhes dos objetos de metadados são descritos no diretório subordinado Propriedades do objeto. Os valores dos objetos (valores de enumeração e nomes de elementos predefinidos) são descritos em um diretório subordinado Valores do objeto.

Antes de carregar as regras de sincronização através de um formato universal, o formato dos dados deve ser carregado dos arquivos (usando processamento(ver cláusula 1.1), e a configuração para a qual as regras de sincronização estão configuradas também deve ser carregada. A configuração é carregada usando processamento ( ver ponto 1.2) . Observe também que item de diretório a ser criado Conversões . Para converter, você deve especificar a configuração e uma ou mais versões de formato para as quais a conversão se destina.

1.3.1 Preparando arquivos para regras de carregamento

Os arquivos são preparados na infobase para a qual a troca será realizada em formato universal (por exemplo, Contabilidade empresarial ed.3.0).

Para preparar arquivos de regras, você deve entrar na infobase no modo Empresarial e iniciar o processamento Fazendo upload de regras de sincronização por meio de um formato universal, que está incluído na entrega da configuração Conversão de dados ed.3.

Para preparar um arquivo com módulo gerenciador, deve-se entrar na infobase no modo Configurador e salvar o módulo geral Exchange Manager por meio de formato universal para um arquivo de texto. Você pode especificar qualquer nome de arquivo.

Todos os arquivos preparados devem estar localizados no mesmo diretório.

1.3.2 Carregando regras de sincronização

Realizado na infobase Conversão de dados ed.3 por processamento Carregando regras de sincronização de arquivos.

No formulário de processamento, indique:

  • Diretório do Exchange no qual os arquivos previamente preparados estão localizados
  • Conversão
  • Composição dos dados baixados
    • ou especifique a opção “todos”
    • ou selecione carregamento seletivo e configure a lista de regras que devem ser carregadas
  • Arquivo com o módulo gerenciador de exchange (não necessário se o carregamento seletivo for executado e os manipuladores não forem carregados)
1.3.3 Recursos de carregamento em um banco de dados não vazio
  • Se a regra carregada existir e pertencer a apenas uma conversão (a atual), a regra será alterada. Neste caso, a análise das diferenças entre as regras existentes e as carregadas não é realizada;
  • Se a regra carregada existir e pertencer a vários elementos do diretório Conversões, incluindo a conversão atual, uma nova regra será criada e vinculada à conversão atual. A regra “antiga” permanecerá inalterada e permanecerá vinculada a outras conversões.
  • Os grupos de regras não são carregados. Mas se a regra foi atribuída a algum grupo, ao recarregar nesta regra esta informação permanecerá.

A conversão de dados 2.0 e 2.1 é uma configuração tecnológica 1C, implementada nas versões da plataforma 8.1 a 8.3.

A principal tarefa da ferramenta é escrever regras para troca entre soluções de aplicação 1C 8 e 7. Versão atual conversão de dados hoje - 3.0.

A conversão de dados é muito configuração útil, com sua ajuda você pode resolver não apenas a questão da transferência de informações de uma base de informações para outra, mas também, por exemplo, da transformação de informações dentro de um banco de dados.

A configuração é muito conveniente de usar com .

A conversão de dados será útil para qualquer programador: ter as habilidades para criar regras de troca é uma grande vantagem para as habilidades profissionais.

Para aprender a trabalhar com uma configuração, a solução de problemas práticos é mais adequada. Tente criar tarefas para você mesmo, por exemplo: transferir algumas informações de um banco de dados para outro, transformar um documento de vendas em um documento de recebimento, “conduzir” saldos contábeis atuais em um documento “inserir saldos” e outras tarefas.

Será muito útil entender as regras de troca “padrão” de 1C 8.3. Lá você poderá encontrar exemplos interessantes de implementação de tarefas;

Para entender o básico, você precisará de materiais, iremos considerá-los a seguir.

Instruções de vídeo para conversão

Para obter os fundamentos da configuração da troca de dados em 1C usando a configuração “1C Data Conversion”, veja o exemplo no vídeo:

Materiais, livros didáticos para estudar 1C Data Conversion 2.0

Não existem muitos materiais e documentação na Internet, tentei coletar os materiais mais importantes e interessantes:

0. Em primeiro lugar, recomendo o vídeo-curso gratuito de Ilya Leontyev, que está disponível em link.

1. Aconselho, em primeiro lugar, usar a ajuda integrada na configuração. Está muito bem escrito e tecnicamente bem implementado:

2. A segunda fonte de informação mais importante é o site http://www.mykod.info/ (site fechado), especializado especificamente em conversão de dados. Lá você pode baixar grande número materiais de conversão.

3. Separadamente, gostaria de destacar o livro didático - (autora - Olga Kuznetsova).