Incluindo os comentários do código-fonte COBOL em arquivos XSD e WSDL gerados

Editar on-line

Este tópico descreve uma opção que permite que você inclua os comentários de um arquivo de código-fonte COBOL nos arquivos XSD e WSDL, que são criados quando você gera um serviço da web usando o método de baixo para cima e usando a conversão de XML compilada em um projeto de serviço único.

Essa opção está disponível no assistente Criar nova interface de serviço (de baixo para cima) (consulte Definir preferências para os conversores XML do COBOL ) e no processador em lote da linha de comando (consulte a propriedade GEN_COMMENT_IN_XSD em CodegenProperty ).

A tabela a seguir mostra os tipos de arquivos que são usados como arquivos de entrada e alguns dos arquivos que são gerados como arquivos de saída quando você cria um serviço da Web usando o método bottom-up e usando a conversão de XML compilado no processador em lote (consulte Os tipos de projetos de serviço único ):
Tipo de arquivo: Finalidade:
Arquivo de entrada: Um arquivo de código-fonte COBOL ou arquivo comum Esse arquivo contém a estrutura de linguagem de solicitação e a estrutura de linguagem de resposta que você especifica para o serviço da web.
Arquivos WSDL XSD de saída: Um arquivo WSDL Esse arquivo descreve o serviço da web.
Dois arquivos XSD Esses dois arquivos descrevem um formato de mensagem derivado da estrutura de dados de linguagem de solicitação e da estrutura de dados de linguagem de resposta.

Quando a opção descrita nesse tópico é ativada, o gerador de código de tempo de execução extrai os comentários do arquivo de código-fonte COBOL e inclui os comentários no arquivo WSDL e nos dois arquivos XSD descritos na tabela anterior.

A tabela a seguir descreve essa opção com mais detalhes:
Item: Descrição:
Quais linhas de comentário são extraídas:
  • Toda linha de comentário é extraída a partir do início do arquivo de origem e continuando até, mas não incluindo, qualquer um dos itens seguintes que vier primeiro:
    • A primeira instrução PROCEDURE DIVISION. Se o arquivo de origem não contiver uma instrução PROCEDURE DIVISION, cada linha de comentário será extraída do arquivo de origem.
    • O próximo grupo level 01 disponível após o grupo level 01 selecionado para a interface.

  • Os comentários são extraídos do próprio arquivo de código-fonte COBOL especificado e não de quaisquer arquivos COPY que ele possa se referir.

  • Somente as linhas de comentário (criadas colocando um * na coluna 7) são extraídas. As entradas de comentário e parágrafos opcionais não são extraídos.
Onde as linhas de comentário são colocados nos arquivos XSD e WSDL: As linhas de comentário extraídas em cada item de dados de nível 01 COBOL no arquivo de código-fonte COBOL são adicionadas ao elemento documentation do elemento annotation pertencente ao tipo de dados de nível superior derivado desse item de dados de nível 01 COBOL.
Referências da entidade: O caracteres usados em XML como referências de entidades predefinidas são substituídos por suas formas expandidas. Por exemplo, um símbolo de ampersand (&) é substituída por uma string que representa a expansão da entidade ampersand.
Caracteres de multibyte: Os caracteres de multibyte no texto de um comentário de COBOL devem seguir as regras fornecidas na documentação do Enterprise COBOL para caracteres múltiplos.
Interesses de globalização: Espera-se que o conteúdo das linhas de comentários de COBOL sigam as regras do Enterprise COBOL versão 3.4 e posterior. Nenhuma tentativa de manipular, transformar ou traduzir o conteúdo (além do que está descrito nesta seção) foi feita pelo processo de geração do EST.
Pontos de código XML inválidos: Se aparecerem pontos de código inválidos do XML 1.0 nos comentários de COBOL e o copybook for fornecido às ferramentas de serviço único, o comportamento da ferramenta será imprevisível (o caractere nulo (0x00) é um exemplo de conteúdo XML inválido).