Contrato de Servio

Produo
SOA 1.0.0

Macro Revises Data

01/11/2011

Descrio
Criao do documento

Autor
Gabriel Marques

1. Informaes bsicas do servio

SOA 1.0.0
O macro servio responsvel por conter as operaes para a manuteno dos dados do processo produtivo. Classificao:
( X) simples; ( ) composto; ( ) orquestrao; ( ) utilitrio.

rea(s) de negcio afetada(s) : Produo, suprimentos, custo, expedio Transporte:

O transporte dos dados ser feito via protocolo soap sobre HTTP

2. Operaes
As operaes catalogadas para este servio so: - Envio de Ordem de Produo - Envio de Produo - Envio de Atividade - Envio de Consumo

Envio de ordem de produo

Operao responsvel por inserir informaes na base do MES que provida pelo SAP.

Mep:
( ) in-Out; (X) In-Only; ( ) Out-In; ( ) Out-only.

Frequncia de requisio:
( ) Alta; ( ) Mdia; (X) Baixa.

Mapeamentos de entrada: Tipo do documento:

O tipo de documento que representa os dados XML no padro de um envelope soap.

Mapeamento: Objeto
Campo NumOrdem TipoOrdem Status Centro NumMaterial DescricaoMater ial QtdOrdem Unidade DtInicio Tipo varchar varchar varchar varchar varchar varchar numeric varchar datetime Tam 12 4 5 4 18 40 17,3 3
Sim Sim Sim Sim Sim Sim Sim Sim No No No No No Quantidade a ser produzida na OP Unidade do material Data programada para iniciar Data Programada para finalizar a Ordem Centro de Trabalho Maquina responsvel pela produo Hora programada para inicio Hora programada para o termino Seqencial do apontamento Status dos apontamentos Depsito apontado Data e hora de inicio Data e hora de fim

Obrigatrio
Sim Sim Sim Sim Sim Sim

Descrio
Numero da Ordem de produo Tipo da Ordem Status da Ordem Centro Numero do material Descrio do Material

DtFinal datetime CentroTrabalho varchar Maquina HoraInicio HoraFim sequencial statusGPP Deposito DataInicio DataFim int varchar varchar int varchar varchar datetime datetime

8 8 8 1 4

Mapeamento de excees:
Detalha a lista de excees que esta operao pode lanar e sua descrio, podendo tambm haver detalhamento de informaes que a falha carregar.

Falha TechnicalFault Cdigo

E00001

Descrio/Causa
Falha tcnica no recupervel.

Mensagem
Falha Tcnica

Detalhe
(stack da exceo)

Lanada quando os dados obrigatrios no forem preenchidos ou forem invlidos em seu contedo.

DadosIncompletosFault

Cdigo
D00001

Mensagem

Detalhe

Parmetros invlidos Informar os parmetros que no esto corretos.

Deve ser enviada quando uma ordem de produo j existir na base.

OPJaCadastradoFault

Cdigo
C00001

Mensagem
Dados Duplicados

Detalhe
Informar os parmetros j existem

Segurana: Perfis de acesso:

Perfil
Z_ADMIN Z_PCP

Descrio
Acesso total Quem abre a Ordem de Produo

Polticas:
Poltica
Idempotncia

Descrio
O servio deve garantir que 0% vrias requisies ao mesmo tempo criem vrias Ordens de Produo

Desvio

Ao
Para casos assim, a falha OPJaCadastradoFault deve ser lanada.

Histrico:
Data
01/11/2012 Criao desta Operao

Descrio

Envio de Consumo
Operao responsvel por inserir informaes na base do MES que provida pelo SAP.

Mep:
(X) in-Out; () In-Only; ( ) Out-In; ( ) Out-only.

Freqncia de requisio:
(X) Alta; ( ) Mdia; () Baixa.

Mapeamentos de entrada: Tipo do documento:

O tipo de documento que representa os dados XML no padro de um envelope soap.

Mapeamento: Objeto
Campo Centro NumOrdem DataInicio Hora NumOperacao Fase NumMaterial QtdConsumida Unidade Lote Deposito RemessaFinal CodigoSaida ItemOrdem TipoPosicao Nrseq Apontado DataApontame nto DtRegistro Retorno Tipo varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar Int varchar datetime datetime varchar MAX Tam 4 12 8 8 4 4 18 12 3 10 4 1 1 4 1 1 Obrigatrio
SIM SIM SIM SIM SIM SIM SIM SIM SIM SIM SIM SIM SIM SIM SIM NO NO NO NO NO

Descrio
Centro Nmero da Ordem Data de inicio do consumo Hora de inicio do consumo Numero da Operao Numero da Fase Numero do Material Quantidade consumida Unidade Lote consumido Deposito consumido Identificador de remessa final Cdigo de Saida Item da Ordem Tipo de posio Numero de Sequencia do apontamento Identificador do apontamento Data do apontamento Data do Registro Mensagem de retorno

Mapeamento de excees:
Falha TechnicalFault Cdigo
E00001

Descrio/Causa
Falha tcnica no recupervel.

Mensagem
Falha Tcnica

Detalhe
(stack da exceo)

Lanada quando os dados obrigatrios no forem preenchidos ou forem invlidos em seu contedo.

DadosIncompletosFault

Cdigo
D00001

Mensagem

Detalhe

Parmetros invlidos Informar os parmetros que no esto corretos.

Deve ser enviada quando um consumo j existir na base.

ConsumoJaCadastradoFa ult

Cdigo
C00001

Mensagem
Dados Duplicados

Detalhe
Informar os parmetros j existem

Segurana: Perfis de acesso:

Perfil
Z_ADMIN Z_OPERADOR

Descrio
Acesso total Quem lana o Consumo

Polticas:
Poltica
Idempotncia

Descrio
O servio deve garantir que 0% vrias requisies ao mesmo tempo apontem vrias produes.

Desvio

Ao
Para casos assim, a falha consumoJaCadastradoFault deve ser lanada.

Histrico:
Data
01/11/2012 Criao desta Operao

Descrio

Envio de Produo
Operao responsvel por inserir informaes na base do MES que provida pelo SAP.

Mep:
(X) in-Out; () In-Only; ( ) Out-In; ( ) Out-only.

Frequncia de requisio:
(X) Alta; ( ) Mdia; () Baixa.

Mapeamentos de entrada: Tipo do documento:

O tipo de documento que representa os dados XML no padro de um envelope soap.

Mapeamento: Objeto
Campo Centro NumOrdem DataInicio Hora NumOperacao Fase NumMaterial QtdProduzica Unidade Lote Deposito RemessaFinal CodigoSaida ItemOrdem TipoPosicao Nrseq Tipo varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar Int Tam 4 12 8 8 4 4 18 12 3 10 4 1 1 4 1 Obrigatrio
SIM SIM SIM SIM SIM SIM SIM SIM SIM SIM SIM SIM SIM SIM SIM NO

Descrio
Centro Nmero da Ordem Data de inicio da produo Hora de inicio da produo Numero da Operao Numero da Fase Numero do Material Quantidade produzida Unidade Lote consumido Deposito consumido Identificador de remessa final Cdigo de Sada Item da Ordem Tipo de posio Numero de Seqncia do

Apontado DataApontame nto DtRegistro Retorno

varchar datetime datetime varchar MAX

NO NO NO NO

apontamento Identificador do apontamento Data do apontamento Data do Registro Mensagem de retorno

Mapeamento de excees:
Falha TechnicalFault Cdigo
E00001

Descrio/Causa
Falha tcnica no recupervel.

Mensagem
Falha Tcnica

Detalhe
(stack da exceo)

Lanada quando os dados obrigatrios no forem preenchidos ou forem invlidos em seu contedo.

DadosIncompletosFault

Cdigo
D00001

Mensagem

Detalhe

Parmetros invlidos Informar os parmetros que no esto corretos.

Deve ser enviada quando uma produo j existir na base.

ProducaoJaCadastradoFa ult

Cdigo
C00001

Mensagem
Dados Duplicados

Detalhe
Informar os parmetros j existem

Segurana: Perfis de acesso:

Perfil
Z_ADMIN Z_OPERADOR

Descrio
Acesso total Quem lana o Consumo

Polticas:
Poltica
Idempotncia

Descrio
O servio deve garantir que 0% vrias requisies ao mesmo tempo apontem vrias produes.

Desvio

Ao
Para casos assim, a falha consumoJaCadastradoFault deve ser lanada.

Histrico:
Data
01/11/2012 Criao desta Operao

Descrio

Envio de Atividade
Operao responsvel por inserir informaes na base do MES que provida pelo SAP.

Mep:
(X) in-Out; () In-Only; ( ) Out-In; ( ) Out-only.

Frequncia de requisio:
(X) Alta; ( ) Mdia; () Baixa.

Mapeamentos de entrada: Tipo do documento:

O tipo de documento que representa os dados XML no padro de um envelope soap.

Mapeamento: Objeto
Campo Tipo varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar int varchar Tam 4 12 8 6 4 4 3 20 6 6 5 1 Obrigatrio
SIM SIM SIM SIM SIM SIM SIM SIM SIM SIM SIM NO NO NO Centro Nmero da Ordem Data de inicio da atividade Hora de inicio da atividade Numero da Operao Numero da Fase Numero da Atividade Mensagem de confirmao Parmetro Valor da Atividade Status Numero de sequencia Identificador de apontamento Data do apontamento Retorno do Apontamento

Descrio

Centro NumOrdem DataInicio Hora NumOperacao Fase Unidade MsgConfirmacao ParametroID Atividade Status Nrseq Apontado DataApontament o Retorno

datetime varchar MAX

NO

Mapeamento de excees:
Falha TechnicalFault Cdigo
E00001

Descrio/Causa
Falha tcnica no recupervel.

Mensagem
Falha Tcnica

Detalhe
(stack da exceo)

Lanada quando os dados obrigatrios no forem preenchidos ou forem invlidos em seu contedo.

DadosIncompletosFault

Cdigo
D00001

Mensagem

Detalhe

Parmetros invlidos Informar os parmetros que no esto corretos.

Deve ser enviada quando uma atividade j existir na base.

AtividadeJaCadastradoFa ult

Cdigo
C00001

Mensagem
Dados Duplicados

Detalhe
Informar os parmetros j existem

Segurana:

Perfis de acesso:
Perfil
Z_ADMIN Z_OPERADOR

Descrio
Acesso total Quem lana o Consumo

Polticas:
Poltica
Idempotncia

Descrio
O servio deve garantir que 0% vrias requisies ao mesmo tempo apontem vrias produes.

Desvio

Ao
Para casos assim, a falha AtividadeJaCadastradoFault deve ser lanada.

Histrico:
Data
01/11/2012 Criao desta Operao

Descrio

3. Rastreabilidade
Aqui devem ser informadas informaes para rpida localizao dos artefatos que compem o servio, como por exemplo:

Repositrio SCM HTTP://TEAMFOUNDATIONSERVER:8080 Enterprise Repository; Atividade http://ServidorAplicacaoERP:8000/sap/bc/srt/wsdl/sdef_ZPPACTIVITY/wsdl11/ws_policy/document ?sap-client=400 Consumo http://ServidorAplicacaoERP:8000/sap/bc/srt/wsdl/sdef_ZPPMATERIALCONSUMPTION/wsdl11/w s_policy/document?sap-client=400 Produo http://ServidorAplicacaoERP:8000/sap/bc/srt/wsdl/sdef_ZPPMATERIALRECEIPT/wsdl11/ws_polic y/document?sap-client=400 Ordem de Produo http://ServidorAplicacaoERP:8000/sap/bc/srt/wsdl/sdef_ZPPORDEMPRODUCAORECEIPT/wsdl11 /ws_policy/document?sap-client=400

WSDL
<?xml version="1.0" encoding="utf-8" ?> - <wsdl:definitions targetNamespace="urn:sap-com:document:sap:soap:functions:mc-style" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:tns="urn:sapcom:document:sap:soap:functions:mc-style" xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurityutility-1.0.xsd" xmlns:n1="urn:sap-com:document:sap:rfc:functions"> - <wsdl:documentation> <sidl:sidl xmlns:sidl="http://www.sap.com/2007/03/sidl" /> </wsdl:documentation> <wsp:UsingPolicy wsdl:required="true" /> - <wsp:Policy wsu:Id="IF_ZPPACTIVITY"> - <sapsession:Session xmlns:sapsession="http://www.sap.com/webas/630/soap/features/session/"> <sapsession:enableSession>false</sapsession:enableSession> </sapsession:Session> <wsp:ExactlyOne xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:sapsp="http://www.sap.com/webas/630/soap/features/security/policy" xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702" xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:wsu="http://schemas.xmlsoap.org/ws/2002/07/utility" /> </wsp:Policy> - <wsp:Policy wsu:Id="OP_ZppGppActivity"> <sapcomhnd:enableCommit xmlns:sapcomhnd="http://www.sap.com/NW05/soap/features/commit/">false</sapcomhnd:enableCommit> <sapblock:enableBlocking xmlns:sapblock="http://www.sap.com/NW05/soap/features/blocking/">true</sapblock:enableBlocking> <saptrhnw05:required xmlns:saptrhnw05="http://www.sap.com/NW05/soap/features/transaction/">no</saptrhnw05:required> <saprmnw05:enableWSRM xmlns:saprmnw05="http://www.sap.com/NW05/soap/features/wsrm/">false</saprmnw05:enableWSRM> </wsp:Policy> - <wsdl:types> - <xsd:schema attributeFormDefault="qualified" targetNamespace="urn:sapcom:document:sap:rfc:functions"> - <xsd:simpleType name="char1"> - <xsd:restriction base="xsd:string"> <xsd:maxLength value="1" /> </xsd:restriction> </xsd:simpleType> - <xsd:simpleType name="char12"> - <xsd:restriction base="xsd:string"> <xsd:maxLength value="12" /> </xsd:restriction> </xsd:simpleType> - <xsd:simpleType name="char20"> - <xsd:restriction base="xsd:string"> <xsd:maxLength value="20" />

</xsd:restriction> </xsd:simpleType> <xsd:simpleType name="char220"> <xsd:restriction base="xsd:string"> <xsd:maxLength value="220" /> </xsd:restriction> </xsd:simpleType> <xsd:simpleType name="char3"> <xsd:restriction base="xsd:string"> <xsd:maxLength value="3" /> </xsd:restriction> </xsd:simpleType> <xsd:simpleType name="char30"> <xsd:restriction base="xsd:string"> <xsd:maxLength value="30" /> </xsd:restriction> </xsd:simpleType> <xsd:simpleType name="char4"> <xsd:restriction base="xsd:string"> <xsd:maxLength value="4" /> </xsd:restriction> </xsd:simpleType> <xsd:simpleType name="char5"> <xsd:restriction base="xsd:string"> <xsd:maxLength value="5" /> </xsd:restriction> </xsd:simpleType> <xsd:simpleType name="char6"> <xsd:restriction base="xsd:string"> <xsd:maxLength value="6" /> </xsd:restriction> </xsd:simpleType> <xsd:simpleType name="char8"> <xsd:restriction base="xsd:string"> <xsd:maxLength value="8" /> </xsd:restriction> </xsd:simpleType> <xsd:simpleType name="numeric3"> <xsd:restriction base="xsd:string"> <xsd:maxLength value="3" /> <xsd:pattern value="\d*" /> </xsd:restriction> </xsd:simpleType> </xsd:schema> <xsd:schema attributeFormDefault="qualified" targetNamespace="urn:sapcom:document:sap:soap:functions:mc-style" xmlns:n0="urn:sapcom:document:sap:rfc:functions"> <xsd:import namespace="urn:sap-com:document:sap:rfc:functions" /> <xsd:complexType name="Zppcl003"> <xsd:sequence> <xsd:element name="Centro" type="n0:char4" /> <xsd:element name="ProcessOrder" type="n0:char12" /> <xsd:element name="EventDate" type="n0:char8" /> <xsd:element name="EventTime" type="n0:char6" /> <xsd:element name="Operation" type="n0:char4" />

<xsd:element name="Phase" type="n0:char4" /> <xsd:element name="UnitOfMeasure" type="n0:char3" /> <xsd:element name="ConfirmationShortText" type="n0:char20" /> <xsd:element name="StdValueParameterId" type="n0:char6" /> <xsd:element name="Activity" type="n0:char6" /> <xsd:element name="StatusConfirmed" type="n0:char5" /> <xsd:element name="Sequencial" type="n0:char30" /> </xsd:sequence> </xsd:complexType> <xsd:complexType name="Zppcl003r"> <xsd:sequence> <xsd:element name="Centro" type="n0:char4" /> <xsd:element name="ProcessOrder" type="n0:char12" /> <xsd:element name="EventDate" type="n0:char8" /> <xsd:element name="EventTime" type="n0:char6" /> <xsd:element name="Operation" type="n0:char4" /> <xsd:element name="Phase" type="n0:char4" /> <xsd:element name="Type" type="n0:char1" /> <xsd:element name="Number" type="n0:numeric3" /> <xsd:element name="Message" type="n0:char220" /> </xsd:sequence> </xsd:complexType> <xsd:complexType name="Zppct003"> <xsd:sequence> <xsd:element name="item" type="tns:Zppcl003" minOccurs="0" maxOccurs="unbounded" /> </xsd:sequence> </xsd:complexType> <xsd:complexType name="Zppct003r"> <xsd:sequence> <xsd:element name="item" type="tns:Zppcl003r" minOccurs="0" maxOccurs="unbounded" /> </xsd:sequence> </xsd:complexType> <xsd:element name="ZppGppActivity"> <xsd:complexType> <xsd:sequence> <xsd:element name="IActivconf" type="tns:Zppct003" minOccurs="0" /> </xsd:sequence> </xsd:complexType> </xsd:element> <xsd:element name="ZppGppActivityResponse"> <xsd:complexType> <xsd:sequence> <xsd:element name="EReturn" type="tns:Zppct003r" /> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:schema> </wsdl:types> <wsdl:message name="ZppGppActivity"> <wsdl:part name="parameters" element="tns:ZppGppActivity" /> </wsdl:message> <wsdl:message name="ZppGppActivityResponse"> <wsdl:part name="parameter" element="tns:ZppGppActivityResponse" /> </wsdl:message>

+ <wsdl:portType name="ZPPACTIVITY"> </wsdl:definitions>

diagrama de implantao

Cliente MES <<TCP IP>> Servidor de Aplicao MES ERP_BD SQL Server 2k5
<< TC PI P> >

Servidor WebService

MES_BD SQL Server 2k5

I CP <T <

> P>

Integration

> P IP> <<TC << TC PI P> >

IIS

Servidor de Aplicao ERP SAP

<<TCP IP>>

Cliente ERP