C0PXEWD	  ; ERX/GPL - EWD based XPath utilities; 10/11/09 ; 5/4/12 4:29pm
	;;1.0;C0P;;Apr 25, 2012;Build 103
	;Copyright 2009 George Lilly.  Licensed under the terms of the GNU
	;General Public License See attached copy of the License.
	;
	;This program is free software; you can redistribute it and/or modify
	;it under the terms of the GNU General Public License as published by
	;the Free Software Foundation; either version 2 of the License, or
	;(at your option) any later version.
	;
	;This program is distributed in the hope that it will be useful,
	;but WITHOUT ANY WARRANTY; without even the implied warranty of
	;MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
	;GNU General Public License for more details.
	;
	;You should have received a copy of the GNU General Public License along
	;with this program; if not, write to the Free Software Foundation, Inc.,
	;51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
	;
	Q
	;
	; gpl July, 2010. This routine interfaces with EWD to generate an XPath
	; array from an XML file. It recursively visits the EWD DOM and creates
	; an XPath index, an XPath array of node values, and an XPath template
	; in three different variables. It is used to prepare incoming xml for
	; processing by applications. 
	;
TEST	;
	D XPATH($$FIRST($$ID("CCR1")),"/","GIDX","GARY")
	Q
	;
TEST2	;
	S REDUX="//soap:Envelope/soap:Body/GetPatientFullMedicationHistory5Response/GetPatientFullMedicationHistory5Result/patientDrugDetail"
	D XPATH($$FIRST($$ID("gpl")),"/","GIDX","GARY","",REDUX)
	Q
	;
XPATH(ZOID,ZPATH,ZXIDX,ZXPARY,ZNUM,ZREDUX)	; RECURSIVE ROUTINE TO POPULATE
	; THE XPATH INDEX ZXIDX, PASSED BY NAME
	; THE XPATH ARRAY XPARY, PASSED BY NAME
	; ZOID IS THE STARTING OID
	; ZPATH IS THE STARTING XPATH, USUALLY "/"
	; ZNUM IS THE MULTIPLE NUMBER [x], USUALLY NULL WHEN ON THE TOP NODE
	; ZREDUX IS THE XPATH REDUCTION STRING, TAKEN OUT OF EACH XPATH IF PRESENT
	I '$D(ZREDUX) S ZREDUX=""
	N NEWPATH
	N NEWNUM S NEWNUM=""
	I $G(ZNUM)>0 S NEWNUM="["_ZNUM_"]"
	S NEWPATH=ZPATH_"/"_$$TAG(ZOID)_NEWNUM ; CREATE THE XPATH FOR THIS NODE
	I $G(ZREDUX)'="" D  ; REDUX PROVIDED?
	. N GT S GT=$P(NEWPATH,ZREDUX,2)
	. I GT'="" S NEWPATH=GT
	S @ZXIDX@(NEWPATH)=ZOID ; ADD THE XPATH FOR THIS NODE TO THE XPATH INDEX
	N GD D DATA("GD",ZOID) ; SEE IF THERE IS DATA FOR THIS NODE
	I $D(GD(2)) M @ZXPARY@(NEWPATH)=GD ; IF MULITPLE DATA MERGE TO THE ARRAY
	E  I $D(GD(1)) S @ZXPARY@(NEWPATH)=GD(1) ; IF SINGLE VALUE, ADD TO ARRAY
	I GD'="" S @ZXPARY@(NEWPATH)=GD ; IF YES, ADD IT TO THE XPATH ARRAY
	N ZFRST S ZFRST=$$FIRST(ZOID) ; SET FIRST CHILD
	I ZFRST'="" D  ; THERE IS A CHILD
	. N ZMULT S ZMULT=$$ISMULT(ZFRST) ; IS FIRST CHILD A MULTIPLE
	. D XPATH(ZFRST,NEWPATH,ZXIDX,ZXPARY,$S(ZMULT:1,1:""),ZREDUX) ; DO THE CHILD
	N GNXT S GNXT=$$NXTSIB(ZOID)
	I GNXT'="" D  ; MOVE ON TO THE NEXT SIBLING
	. D XPATH(GNXT,ZPATH,ZXIDX,ZXPARY,$S(ZNUM>0:ZNUM+1,1:""),ZREDUX) ; DO NEXT SIB
	Q
	;
PARSE(INXML,INDOC)	;CALL THE EWD PARSER ON INXML, PASSED BY NAME
	; INDOC IS PASSED AS THE DOCUMENT NAME TO EWD
	; EXTRINSIC WHICH RETURNS THE DOCID ASSIGNED BY EWD
	N ZR
	K ^CacheTempEWD($j) ; CLEAN OUT ANYTHING THAT MIGHT HAVE BEEN THERE
	M ^CacheTempEWD($j)=@INXML ;
	S ZR=$$parseDocument^%zewdHTMLParser(INDOC)
	K ^CacheTempEWD($j) ;clean up after ourselves
	Q ZR
	;
DELETE(INDOC)	; DELETE A PARSED DOCUMENT FROM THE EWD DOM 
	; AFTER IT'S NO LONGER NEEDED
	N OK
	S OK=$$removeDocument^%zewdDOM(INDOC)
	Q OK
	;
ISMULT(ZOID)	; RETURN TRUE IF ZOID IS ONE OF A MULTIPLE
	N ZN
	S ZN=$$NXTSIB(ZOID)
	I ZN'="" Q $$TAG(ZOID)=$$TAG(ZN) ; IF TAG IS THE SAME AS NEXT SIB TAG
	Q 0
	;
DETAIL(ZRTN,ZOID)	; RETURNS DETAIL FOR NODE ZOID IN ZRTN, PASSED BY NAME
	N DET
	D getElementDetails^%zewdXPath(ZOID,.DET)
	M @ZRTN=DET
	Q
	;
ID(ZNAME)	;RETURNS THE docOID OF THE DOCUMENT NAMED ZNAME
	Q $$getDocumentNode^%zewdDOM(ZNAME)
	;
NAME(ZOID)	;RETURNS THE NAME OF THE DOCUMENAT WITH docOID ZOID
	Q $$getDocumentName^%zewdDOM(ZOID)
	;
FIRST(ZOID)	;RETURNS THE OID OF THE FIRST CHILD OF ZOID
	N GOID
	S GOID=ZOID
	S GOID=$$getFirstChild^%zewdDOM(GOID)
	I GOID="" Q ""
	I $$getNodeType^%zewdDOM(GOID)'=1 S GOID=$$NXTCHLD(GOID)
	Q GOID
	;
HASCHILD(ZOID)	; RETURNS TRUE IF ZOID HAS CHILD NODES
	Q $$hasChildNodes^%zewdDOM(ZOID)
	;
CHILDREN(ZRTN,ZOID)	;RETURNS CHILDREN OF ZOID IN ARRAY ZRTN, PASSED BY NAME
	N childArray
	d getChildrenInOrder^%zewdDOM(ZOID,.childArray)
	m @ZRTN=childArray
	q
	;
TAG(ZOID)	; RETURNS THE XML TAG FOR THE NODE
	Q $$getName^%zewdDOM(ZOID)
	;
NXTSIB(ZOID)	; RETURNS THE NEXT SIBLING
	Q $$getNextSibling^%zewdDOM(ZOID)
	;
NXTCHLD(ZOID)	; RETURNS THE NEXT CHILD IN PARENT ZPAR
	N GOID
	S GOID=$$getNextChild^%zewdDOM($$PARENT(ZOID),ZOID)
	I GOID="" Q ""
	I $$getNodeType^%zewdDOM(GOID)'=1 S GOID=$$NXTCHLD(GOID)
	Q GOID
	;
PARENT(ZOID)	; RETURNS PARENT OF ZOID
	Q $$getParentNode^%zewdDOM(ZOID)
	;
DATA(ZT,ZOID)	; RETURNS DATA FOR THE NODE
	N ZT2
	S ZT2=$$getElementText^%zewdDOM(ZOID,.ZT2)
	M @ZT=ZT2
	Q
	;Q $$getTextValue^%zewdXPath(ZOID)
	;Q $$getData^%zewdDOM(ZOID,.ZT)
	;