Incluindo uma Mensagem

Mensagens representam uma definição abstrata dos dados que estão sendo transmitidos. Uma mensagem consiste em partes lógicas, cada uma das quais é associada a uma definição em algum sistema de tipos. As mensagens WSDL são objetos do nível superior que podem ser referenciadas pelos elementos de entrada, saída e falha de uma operação (dentro de um tipo de porta).

É possível criar uma mensagem usando a visualização Esboço, clicando com o botão direito do mouse na pasta Mensagens e clicando em Incluir Mensagem.

Se você quiser criar uma nova mensagem para seu elemento de entrada, saída ou falha, siga estas etapas:

  1. Na visualização Design, clique com o botão direito do mouse no elemento de entrada, saída ou falha e clique em Configurar Mensagem > Nova Mensagem.
  2. Digite o nome da mensagem no diálogo. Esse nome deve ser exclusivo entre todas as mensagens definidas no documento WSDL que o contém. Clique em OK.
  3. A nova mensagem aparecerá na visualização Design dentro do tipo de porta.

Nota: as mensagens são referenciadas dentro de um tipo de porta (especificamente pelos objetos de entrada, saída e falha de uma operação). Os objetos de entrada, saída e falha em uma ligação não referenciam mensagens. Por isso, não é possível criar uma nova mensagem clicando com o botão direito do mouse em uma entrada, saída ou falha em uma ligação (também conhecidos como entrada de ligação, saída de ligação e falhas de ligação).

Dica: Também é possível criar uma nova mensagem para seu elemento de entrada, saída ou falha usando a visualização Esboço. Na pasta Tipos de Porta, clique com o botão direito do mouse no elemento e clique em Configurar Mensagem > Incluir Mensagem. Sua mensagem aparecerá na visualização Esboço na pasta Mensagens.

Se você quiser reutilizar uma mensagem para seu elemento de entrada, saída ou falha, siga estas etapas:

  1. Na visualização Design, clique com o botão direito do mouse no elemento de entrada, saída ou falha e clique em Configurar Mensagem > Mensagem Existente.
  2. No campo Nome, digite uma cadeia de procura para filtrar a lista ou deixe o campo em branco para visualizar tudo.
  3. É possível alterar o escopo da lista selecionando uma das seguintes opções:
    • Espaço de Trabalho. Lista as mensagens disponíveis no espaço de trabalho.
    • Projeto Incluído. Lista as mensagens disponíveis no projeto que contém seu arquivo.
    • Recurso Atual. Lista as mensagens disponíveis no arquivo atual.
    • Conjuntos de Trabalho. Lista as mensagens disponíveis em um conjunto de arquivos especificado. Para especificar um conjunto de trabalho, clique em Escolher. É possível selecionar arquivos de um conjunto de trabalho existente um criar um novo conjunto de trabalho. Depois de selecionar os arquivos, clique em OK.
  4. As mensagens existentes serão listadas. Selecione um e clique em OK.

Se você quiser importar uma mensagem existente para seu elemento de entrada, saída ou falha, siga estas etapas:

  1. Na visualização Design, clique com o botão direito do mouse no elemento de entrada, saída ou falha e clique em Configurar Mensagem > Mensagem Existente.
  2. No campo Nome, digite uma cadeia de procura para filtrar a lista ou deixe o campo em branco para visualizar tudo.
  3. É possível importar uma mensagem selecionando uma das seguintes opções:
    • Espaço de Trabalho. Lista as mensagens disponíveis no espaço de trabalho.
    • Projeto Incluído. Lista as mensagens disponíveis no projeto que contém seu arquivo.
    • Conjuntos de Trabalho. Lista as mensagens disponíveis em um conjunto de arquivos especificado. Para especificar um conjunto de trabalho, clique em Escolher. É possível selecionar arquivos de um conjunto de trabalho existente um criar um novo conjunto de trabalho. Depois de selecionar os arquivos, clique em OK.
  4. As mensagens serão listadas. Selecione um e clique em OK.

Agora é possível incluir partes na mensagem. Partes são um mecanismo flexível para descrever o conteúdo abstrato lógico de uma mensagem.