Sağlık Net Adaptörü - Bileşenler ve Mimari Yapı

Web Servisleri sözkonusu olduğunda, tüketici olan veya kullanıcı olan tarafı en çok ilgilendiren kısım, bu web serv

islerinin interfaceleri olan, karşılıklı anlaşma metni olarak da tanımlanabilen wsdl dosyalarıdır.

Kabaca değinilecek olursa, Xml formatı ile ilgili olarak çalışmalar başladığında, xmlin en büyük avantajı olan sınırsız esnekliğin aynı zamanda en büyük dezavantajı olacağı farkedilerek, karşılıklı kullanılmak üzere bir xml dosyası formatı tanımlama dili (XSD) oluşturuldu. Bu dil, herbir kullanım için farklı şekilde, o kullanım için geçerli olacak xml formatının şeklini tanımlamakta kullanıldı. Bu şekilde kullanımı devam etmektedir.

Xml tabanlı olarak çalışan web servisleri için bu problem daha da ciddi idi, artık birbirlerinden bağımsız iki farklı sistemin mesajlaşma yapılarını birbirlerine açmak sözkonusu idi. Xml formatı tercih edilince tabii ki xsd düşünüldü ve wsdl yapısı içerisine xsd yerleştirildi.

Buradan hareketle, wsdl dosyaları, bir web servisin nasıl mesaj beklediğini gösteren kontratıdır. Bu kontrattaki şarta uyan taraflar bu wsdlın sahibi web servisleri ile haberleşebilirler.

Sağlık Net Web Servisleri ile sağlık Net Adaptörü Web Servislerinin wsdlları birbirlerinden çok farklıdır. Wsdl okuması güç olduğu için xml dosyalarından örnek vermek daha doğru olacaktır. Aşağıda, Sağlık Net Adaptörü Web Servislerinin kabul ettiği formatta Muayene Gönderim Şeması mevcuttur.

Dikkat edileceği gibi, bu mesaj içerisinde usvs ye yabancı bir başlık yoktur. Bu sayede, hem iletişime sağlanan efor azalır, hem yanlışlar daha oluşmadan ortadan kalkmış olurlar.

Yukarıdaki mesaj, aynı zamanda wsdl tanımında da bu şekilde istendiğinden, herhangi bir programlama dili ile wsdldan kod oluşturma seçeneğini seçtiğinizde, oluşan objeler, ControlActEvent gibi tuhaf objeler değil, MudahaleBilgisi gibi usvs içerisinde belirtilen objeler olacaktır.

Benzer bir mesaj için HL7 v3 karşılığı aşağıdaki gibidir.

Not: Mesaj, büyüklük gösterme amaçlı olarak küçük fontla yazılmıştır, mesajı incelemek isterseniz lütfen aşağıdaki kısmı kopyalıp bilgisayarınızda herhangi bir doküman ileyiciye kopyalayıp fontu büyütünüz.

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header>
      <wsse:Security mustUnderstand="0" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns="http://schemas.xmlsoap.org/soap/envelope/">
         <wsse:UsernameToken>
            <wsse:Username>12345</wsse:Username>
            <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">12345</wsse:Password>
            <wsu:Created xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">Tue Aug 26 10:06:43 EEST 2008</wsu:Created>
         </wsse:UsernameToken>
      </wsse:Security>
   </soap:Header>
   <soap:Body>
      <MCCI_IN000001TR01 xmlns="urn:hl7-org:v3">
         <id extension="1" root="2.16.840.1.113883.3.129.2.1.2"/>
         <creationTime value="20080826106"/>
         <responseModeCode code="Q"/>
         <interactionId extension="MCCI_IN000001TR01" root="2.16.840.1.113883.3.129.2.1.1"/>
         <processingCode code="3"/>
         <processingModeCode code="T"/>
         <acceptAckCode code="AL"/>
         <receiver typeCode="RCV">
            <device>
               <id extension="USBS" root="2.16.840.1.113883.3.129.1.1.5"/>
            </device>
         </receiver>
         <sender typeCode="SND">
            <device>
               <id extension="1111" root="2.16.840.1.113883.3.129.1.1.5"/>
            </device>
         </sender>
         <controlActEvent>
            <subject>
               <examination>
                  <id extension="ff11074f-cf40-4b15-81e3-104b1bd12727" root="2.16.840.1.113883.3.129.2.1.3"/>
                  <code code="MUAYENE" codesystem="2.16.840.1.113883.3.129.2.2.1" codesystemname="Döküman Tipi" codesystemversion="1.0" displayname="Muayene MSVS (Vatandaş/Yabancı)"/>
                  <effectiveTime value="20080826919"/>
                  <confidentialityCode code="1" codeSystem="2.16.840.1.113883.3.129.1.2.77" codeSystemName="Gizlilik" codeSystemVersion="1.0" displayName="NORMAL"/>
                  <languageCode code="tr-TR"/>
                  <versionNumber value="1"/>
                  <recordTarget>
                     <patientRole>
                        <id extension="12345" root="2.16.840.1.113883.3.129.1.1.1"/>
                        <patient>
                           <name>
                              <family mediaType="text/plain" partType="FAM">ALİ</family>
                              <given mediaType="text/plain" partType="GIV">VELİ</given>
                           </name>
                           <administrativeGenderCode code="2" codeSystem="2.16.840.1.113883.3.129.1.2.21" codeSystemName="Cinsiyet" codeSystemVersion="1.0" displayName="2"/>
                           <birthTime value="19751210"/>
                           <raceCode code="TR" codeSystem="2.16.840.1.113883.3.129.1.2.52" codeSystemName="Uyruk" codeSystemVersion="1.0" displayName="TR"/>
                        </patient>
                     </patientRole>
                  </recordTarget>
                  <author>
                     <time value="20080826106"/>
                     <assignedAuthor>
                        <id extension="123345" root="2.16.840.1.113883.3.129.1.1.1"/>
                     </assignedAuthor>
                  </author>
                  <custodian>
                     <assignedCustodian>
                        <representedHealthcareOrganization>
                           <id extension="3" root="2.16.840.1.113883.3.129.1.1.6"/>
                        </representedHealthcareOrganization>
                     </assignedCustodian>
                  </custodian>
                  <primaryInformationRecipient>
                     <recipient>
                        <representedMinisteryOfHealth>
                           <id extension="5881" root="2.16.840.1.113883.3.129.1.1.6"/>
                        </representedMinisteryOfHealth>
                     </recipient>
                  </primaryInformationRecipient>
                  <component>
                     <structuredBody>
                        <component2>
                           <dischargeDataset>
                              <id extension="CIKIS" root="2.16.840.1.113883.3.129.2.1.4"/>
                              <code code="CIKIS" codesystem="2.16.840.1.113883.3.129.2.2.2" codesystemname="Veriseti" codesystemversion="1.0" displayname="Çıkış Veriseti"/>
                              <text language="tr-TR" mediaType="text/x-hl7-text+xml">Çıkış Veriseti</text>
                              <component2>
                                 <dischargeSection>
                                    <id extension="Çıkış Verisinin Olduğu Bölüm" root="2.16.840.1.113883.3.129.2.1.5"/>
                                    <code code="CIKIS" codesystem="2.16.840.1.113883.3.129.2.2.3" codesystemname="Veri Kısmı" codesystemversion="1.0" displayname="Çıkış Verisinin Olduğu Bölüm"/>
                                    <text language="tr-TR" mediaType="text/x-hl7-text+xml">Çıkış Verisinin Olduğu Bölüm Çıkış Verisinin Olduğu Bölüm</text>
                                    <component>
                                       <discharge>
                                          <code code="99" codesystem="2.16.840.1.113883.3.129.1.2.9" codesystemname="Çıkış Şekli" codesystemversion="1.0" displayname="99"/>
                                          <effectiveTime value="20080814"/>
                                       </discharge>
                                    </component>
                                 </dischargeSection>
                              </component2>
                           </dischargeDataset>
                        </component2>
                        <component3>
                           <examinationDataset>
                              <id extension="MUAYENE" root="2.16.840.1.113883.3.129.2.1.4"/>
                              <code code="MUAYENE" codesystem="2.16.840.1.113883.3.129.2.2.2" codesystemname="Veriseti" codesystemversion="1.0" displayname="Muayene Veriseti"/>
                              <text language="tr-TR" mediaType="text/x-hl7-text+xml">Muayene Veriseti Muayene Veriseti</text>
                              <author>
                                 <doctor>
                                    <id extension="53428306742" root="2.16.840.1.113883.3.129.1.1.1"/>
                                 </doctor>
                              </author>
                              <component1>
                                 <examProtocolNoSection>
                                    <id extension="Protokol No Bilgisinin Olduğu Bölüm" root="2.16.840.1.113883.3.129.2.1.5"/>
                                    <code code="PROTOKOLNO" codesystem="2.16.840.1.113883.3.129.2.2.3" codesystemname="Veri Kısmı" codesystemversion="1.0" displayname="Protokol No Bilgisinin Olduğu Bölüm"/>
                                    <text language="tr-TR" mediaType="text/x-hl7-text+xml">Protokol No Bilgisinin Olduğu Bölüm Protokol No Bilgisinin Olduğu Bölüm</text>
                                    <component>
                                       <examProtocolNo>
                                          <id extension="7639" root="2.16.840.1.113883.3.129.1.1.4"/>
                                       </examProtocolNo>
                                    </component>
                                 </examProtocolNoSection>
                              </component1>
                              <component3>
                                 <investigationSection>
                                    <id extension="Bulgu Verisinin Olduğu Bölüm" root="2.16.840.1.113883.3.129.2.1.5"/>
                                    <code code="BULGU" codesystem="2.16.840.1.113883.3.129.2.2.3" codesystemname="Veri Kısmı" codesystemversion="1.0" displayname="Bulgu Verisinin Olduğu Bölüm"/>
                                    <text language="tr-TR" mediaType="text/x-hl7-text+xml">Bulgu Verisinin Olduğu Bölüm Bulgu Verisinin Olduğu Bölüm</text>
                                 </investigationSection>
                              </component3>
                              <component4>
                                 <historySection>
                                    <id extension="Hikaye Verisinin Olduğu Bölüm" root="2.16.840.1.113883.3.129.2.1.5"/>
                                    <code code="HIKAYE" codesystem="2.16.840.1.113883.3.129.2.2.3" codesystemname="Veri Kısmı" codesystemversion="1.0" displayname="Hikaye Verisinin Olduğu Bölüm"/>
                                    <text language="tr-TR" mediaType="text/x-hl7-text+xml">Hikaye Verisinin Olduğu Bölüm Hikaye Verisinin Olduğu Bölüm</text>
                                 </historySection>
                              </component4>
                              <component5>
                                 <complaintSection>
                                    <id extension="Şikayet Verisinin Olduğu Bölüm" root="2.16.840.1.113883.3.129.2.1.5"/>
                                    <code code="SIKAYET" codesystem="2.16.840.1.113883.3.129.2.2.3" codesystemname="Veri Kısmı" codesystemversion="1.0" displayname="Şikayet Verisinin Olduğu Bölüm"/>
                                    <text language="tr-TR" mediaType="text/x-hl7-text+xml">Şikayet Verisinin Olduğu Bölüm Şikayet Verisinin Olduğu Bölüm</text>
                                 </complaintSection>
                              </component5>
                              <component7>
                                 <procedureSection>
                                    <id extension="Müdehale Verisinin Olduğu Bölüm" root="2.16.840.1.113883.3.129.2.1.5"/>
                                    <code code="MUDAHALE" codesystem="2.16.840.1.113883.3.129.2.2.3" codesystemname="Veri Kısmı" codesystemversion="1.0" displayname="Müdehale Verisinin Olduğu Bölüm"/>
                                    <text language="tr-TR" mediaType="text/x-hl7-text+xml">Müdehale Verisinin Olduğu Bölüm Müdehale Verisinin Olduğu Bölüm</text>
                                    <component>
                                       <procedure>
                                          <code code="520030" codesystem="2.16.840.1.113883.3.129.1.2.2" codesystemname="BÜT" codesystemversion="1.0" displayname="520030"/>
                                       </procedure>
                                    </component>
                                    <component>
                                       <procedure>
                                          <code code="530140" codesystem="2.16.840.1.113883.3.129.1.2.2" codesystemname="BÜT" codesystemversion="1.0" displayname="530140"/>
                                       </procedure>
                                    </component>
                                 </procedureSection>
                              </component7>
                              <component8>
                                 <diagnosisSection>
                                    <id extension="Tanı Verisinin Olduğu Bölüm" root="2.16.840.1.113883.3.129.2.1.5"/>
                                    <code code="TANI" codesystem="2.16.840.1.113883.3.129.2.2.3" codesystemname="Veri Kısmı" codesystemversion="1.0" displayname="Tanı Verisinin Olduğu Bölüm"/>
                                    <text language="tr-TR" mediaType="text/x-hl7-text+xml">Tanı Verisinin Olduğu Bölüm Tanı Verisinin Olduğu Bölüm</text>
                                    <component>
                                       <diagnosis>
                                          <code code="ANATANI" codesystem="2.16.840.1.113883.3.129.2.2.6" codesystemname="Tanı Tipi" codesystemversion="1.0" displayname="Ana Tanı"/>
                                          <value code="B89" codeSystem="2.16.840.1.113883.6.3" codeSystemName="ICD-10" codeSystemVersion="1.0" displayName="B89"/>
                                       </diagnosis>
                                    </component>
                                    <component>
                                       <diagnosis>
                                          <code code="EKTANI" codesystem="2.16.840.1.113883.3.129.2.2.6" codesystemname="Tanı Tipi" codesystemversion="1.0" displayname="Ek Tanı"/>
                                          <value code="D64.9" codeSystem="2.16.840.1.113883.6.3" codeSystemName="ICD-10" codeSystemVersion="1.0" displayName="D64.9"/>
                                       </diagnosis>
                                    </component>
                                 </diagnosisSection>
                              </component8>
                              <component9>
                                 <examinationSection>
                                    <id extension="Muayene Verisinin Olduğu Bölüm" root="2.16.840.1.113883.3.129.2.1.5"/>
                                    <code code="MUAYENE" codesystem="2.16.840.1.113883.3.129.2.2.3" codesystemname="Veri Kısmı" codesystemversion="1.0" displayname="Muayene Verisinin Olduğu Bölüm"/>
                                    <text language="tr-TR" mediaType="text/x-hl7-text+xml">Muayene Verisinin Olduğu Bölüm Muayene Verisinin Olduğu Bölüm</text>
                                    <component>
                                       <encounter>
                                          <effectiveTime>
                                             <low value="20080804"/>
                                             <high value="20080814"/>
                                          </effectiveTime>
                                          <location>
                                             <clinic>
                                                <code code="16" codesystem="2.16.840.1.113883.3.129.1.2.1" codesystemname="Klinikler" codesystemversion="1.0" displayname="16"/>
                                             </clinic>
                                          </location>
                                       </encounter>
                                    </component>
                                 </examinationSection>
                              </component9>
                           </examinationDataset>
                        </component3>
                        <component4>
                           <receptionDataset>
                              <id extension="KABUL" root="2.16.840.1.113883.3.129.2.1.4"/>
                              <code code="KABUL" codesystem="2.16.840.1.113883.3.129.2.2.2" codesystemname="Veriseti" codesystemversion="1.0" displayname="Kabul Veriseti"/>
                              <text language="tr-TR" mediaType="text/x-hl7-text+xml">Kabul Veriseti</text>
                              <component1>
                                 <socialSecurityFollowNumberSection>
                                    <id extension="SGK Takip No Bilgisinin Olduğu Bölüm" root="2.16.840.1.113883.3.129.2.1.5"/>
                                    <code code="SGKTAKIPNO" codesystem="2.16.840.1.113883.3.129.2.2.3" codesystemname="Veri Kısmı" codesystemversion="1.0" displayname="SGK Takip No Bilgisinin Olduğu Bölüm"/>
                                    <text language="tr-TR" mediaType="text/x-hl7-text+xml">SGK Takip No Bilgisinin Olduğu Bölüm SGK Takip No Bilgisinin Olduğu Bölüm</text>
                                 </socialSecurityFollowNumberSection>
                              </component1>
                              <component3>
                                 <registrationSection>
                                    <id extension="Kabul Verisinin Olduğu Bölüm" root="2.16.840.1.113883.3.129.2.1.5"/>
                                    <code code="KABUL" codesystem="2.16.840.1.113883.3.129.2.2.3" codesystemname="Veri Kısmı" codesystemversion="1.0" displayname="Kabul Verisinin Olduğu Bölüm"/>
                                    <text language="tr-TR" mediaType="text/x-hl7-text+xml">Kabul Verisinin Olduğu Bölüm Kabul Verisinin Olduğu Bölüm</text>
                                    <component>
                                       <registration>
                                          <code code="3" codesystem="2.16.840.1.113883.3.129.1.2.7" codesystemname="Kabul Şekli" codesystemversion="1.0" displayname="3"/>
                                          <effectiveTime value="20080804"/>
                                       </registration>
                                    </component>
                                 </registrationSection>
                              </component3>
                              <component4>
                                 <caseTypeSection>
                                    <id extension="Vaka Türü Bilgisinin Olduğu Bölüm" root="2.16.840.1.113883.3.129.2.1.5"/>
                                    <code code="VAKATURU" codesystem="2.16.840.1.113883.3.129.2.2.3" codesystemname="Veri Kısmı" codesystemversion="1.0" displayname="Vaka Türü Bilgisinin Olduğu Bölüm"/>
                                    <text language="tr-TR" mediaType="text/x-hl7-text+xml">Vaka Türü Bilgisinin Olduğu Bölüm Vaka Türü Bilgisinin Olduğu Bölüm</text>
                                    <component>
                                       <caseType>
                                          <code code="1" codesystem="2.16.840.1.113883.3.129.1.2.53" codesystemname="Vaka Türü" codesystemversion="1.0" displayname="1"/>
                                       </caseType>
                                    </component>
                                 </caseTypeSection>
                              </component4>
                           </receptionDataset>
                        </component4>
                     </structuredBody>
                  </component>
               </examination>
            </subject>
         </controlActEvent>
      </MCCI_IN000001TR01>
   </soap:Body>
</soap:Envelope>

Sağlık Net Adaptör Web Servisi'nin yaptığı şeylerden birisi, üstteki mesaj şeklindeki mesajları alıp, alttaki mesaja çevirmektir. Sağlık Net'in istediği mesaj verisinin tümü Adaptör Web Servisi formatı ile toplanmaktadır. Aradaki tek fark, Sağlık Net servislerinin hl7 cda e uyabilmek için eklediği ekstra alanlar veya yapılması gereken çevrimlerdir.

Bu işlemler her seferinde aynı olduğu için, Sağlık Net Adaptörü bu işlemleri yaparak Sağlık Net tarafına iletmektedir.