DMS Original Embedding Within CG42 Template

[Former Member]

Hi,

I am attempting to embed graphic output stored as a DMS original within a WWI template.  As per documentation instructions, I have maintained the DMS linkage to the specification and added the symbol to the template using GESTDHEADE user-defined text.  When generating the output, there is an issue in rendering the attachment where WWI is apparently trying to pull the DMS original from the graphics directory specified in my WWI.INI file.  My understanding was that this .INI setting is intended to control sourcing of static graphics files managed outside of DMS.  The error message I receive within the output document is "{ error: file not found: C:\Program Files (x86)\SAP\FrontEnd\sapgui\WWI\graphics\<<doc name>> }  Why is WWI attempting to locate the dynamic DMS file from the static graphics directory?

I have attempted to link a variety of document variations including KPro and non-KPro storage yet continue to receive this error.  When WWI pulls the original file during rendering, where is the file temporarily staged and how is this accessed?  Any assistance would be greatly appreciated.

Adam

[Former Member]

Hi!

I happen to have the same error as described in the post (the final one, the image is not inserted in the report but just the name of the DMS object). Adam, did you finally manage to solve it? Any hints in this line?

Many thanks!

Teresa

[Former Member]

Hi Adam,

We store all our graphics in the static graphics folder you mentioned above. We do this both on our local machines for development and on the WWI server itself for normal generation of SDS documents.

All these graphics are linked to a phrase (i.e. name of the file is written in the graph field of the phrase).

In order to embed a static graphic in the template, we use descriptor symbol EHS_L_GRAPH to which you assign the phrase that contains the graph you want to display.

In order to display graphics based on specification data, you have to add these phrases to a certain chararacteristic and embed the corresponding symbol to the template. Expension mode in that case should be GPC => Graphic

Hope this helps....

Kind regards,

Luk

[Former Member]

Hi Luk,

Thank you for the quick response although I'm not sure this is the solution in my case.  I would like to pull the graphic from a DMS original file.  According to SAP documentation, I should be using the Specification symbol type as opposed to a Descriptor (http://help.sap.com/saphelp_erp60_sp/helpdata/en/a7/2872ac0a6c11d28a220000e829fbbd/frameset.htm)

Within my template, the expansion mode assigned to the GESTDHEADE symbol is  GPC --> Graphic (size 01_GPC Automatic).  Is this the appropriate expansion mode to use for Specification Symbols?

Thanks,

Adam

[Former Member]

Hi Adam,

You're correct, my answer does not use DMS but uses your local folder (or the folder on the WWI server) instead.

To me, IMG documentation is not very clear neither.

I'm wondering how WWI has to make the link with DMS. Do you have to modify the GUI-HOME link?

" Enter under [Paths] as the GUI-HOME the path via which the respective front-end PCs reference the WWI installation, for example, GUI-HOME=Z:\WWI or enter the file server, for example, GUI-HOME=\\Fileserver\WWI.

If the graphics are located in a different subdirectory, you can enter its name under an additional entry, for example, GRAPHICS=MYGRAPHICS."

Is there a particular reason why you don't want to use the normal graphics folder on the server and using phrases instead for displaying graphics?

Kind regards,

Luk

[Former Member]

Hi Luk,

The type of graphic in question is a product schematic drawing.  Ideally this will be an Auto CAD diagram, though I am first trying to get just a basic JPG representation to work.   The schematic drawing clearly lends itself towards management within DMS (version control, status management, etc). 

WWI certainly seems to support this type of capability though I just need to understand what setting I have in place which is causing the system to ignore the DMS attachment and instead look to the static graphics folder.  I was thinking this might have something to do with utilization of the Knowledge Provider setup, though I experience the same issue when using a document type which does not go through KPro,

Adam

[Former Member]

Hi Adam,

Thanks for the extra information...

What do you maintain in the uder defined text? Do you only maintain the file name or also the path where this file is stored?

Curious to find out how you will solve this. I can imagine we might use such a set up as well in the future.

Kind regards,

Luk

[christoph_bergemann]

Dear Adam

taking your topic into account: i believe you did it right.

This is what I understood:

a.) you defined a user defined text type which allowss to make a link to a document in DMS (cusotomizing); you assign it to all properties are a subset of properties

b.) you used the right symbol to retrieve it in the WWI template

c.) you prepared the necessary DMS customizing etc.

Normally the process runs like this:

During the WWI process the data is retrieved and passed on to the client (if you use report from template). On the top the template is passed on. I bellive the "graphic" will be passed on in the same way and stored in the folder (refer below !)

Now local WWI is started and combining template with data as well as graphic: I did did not check it in deep but:

"C:\Program Files (x86)\SAP\FrontEnd\sapgui\WWI\graphics\<<doc name>> } "

might be the folder in which the graphic is "stored" within the WWI process so that the WWI can process it.

As explained by LUk. Normally you store here nur "static" graphic files (like may be Logo etc. etc.)

Now a number of issues can come up

a.) the user (SAP GUI user) does not have Windows write access rights to this folder: in This case it is clear: no graphic can be stored here but WWI process is started. The WWI process tries to retrieve the file but can not find it

b.) years ago we have realized that there are "access issues" on SAP side as well. Therefore the SAP GUI User must have read access right to the DMS. Please check Su53 after you have used the process. May be you will find some issues

c.) Furthermore depending on your SAP set up further problems might come up. If the documents are not stored with in DMS but in KPro or other external systems the DMS is generating a "link" to the storage location. Now in the process once again the document must be read and once again may be some read access rights might be missing on SAP User side

Can yo please provide feedback regarding this question:

1.) navigate  in cg02 to the value assignment in which the graphic is "stored" by using a user defined text

2.) please do a double click with left mouse on the link. IN theory the following should happen

a.) the document should be retrieved

b.) SAP is calling Windows (if this is your local OS) and starting a "suitable" program to display the data

If you can display the graphic by using this process my personal assumption would be: there is no SAP side problem but a local WWI problem

PS: can you please describe which release you are using ECC 6.0 EnhPack EH&S activated? Because here you can do the upload of a graphic file in userdefined text direct

with best regards

C.B.

[Former Member]

Luk,

I maintain the key of the DMS record within the user text field via selection using the search help.  To enable this functionality, you need to ensure that the 'Document' checkbox is selected for the Text type - see config at 'Specify User-Defined Text Types'.

Christoph,

That certainly seemed like a plausible explanation though does not correct the issue.  I ensured that all users on my local machine have read/write access to the WWI folder and subfolders.

Within CG02, I am indeed able to launch and view the graphics by double clicking on the User Text field.  I have confirmed this ability for DMS records with and without KPro storage.  Taking this one step further, I can see that the file is temporarily being contained in a different temporarily location while the record display window is open  (C:\..\AppData\Local\SAP\SAP GUI\tmp)

On a similar note, I have observed storage of the temporary file created when running a preview within CG42.  In this case, the temporary file name is 'rehslay0.rtf' and is stored in my C:\TEMP folder.  Do you happen to have an example in your environment of a spec with a DMS assignment?  I would be curious to know which temp files are created when you run a CG42 preview.  The full list of files created in C:\TEMP during CG42 preview includes:

  - rehslay0.rtf

  - lehslay0.txt (log showing that symbol '01GESTDHEADE(G)[SZ:A;D:Start of UD Text]' not found

  - lehslay0.val

  - lehslay0.wwi

  - rehslay0.val

  - lehslay0.str

As for our patch levels, the EA-APPL component (PLM) is at level 18.  We are also running SPRC 2.0 with support pack 3, though I'm not sure if this touches WWI.

Regards,

Adam

[christoph_bergemann]

Dear Adam

I have more practical work done with cg02 as to use cg42 and to define a report template; therefore I am not sure if there exists is a  "difference" in handling both transactions from WWI perspective. Therefore I can only provide further hints.

cg02: perfect you can display the graphic and it s downloaded and SAP starts the corresponding application so that you can display the content

Cg02 behaves different that means the file (as you detected as well) is stored in a different folder in comparison to WWI process

Coming back to WWI:

if you use cg02 the same process is used (data is collected; data is passed on to local client and stored in a specified folder, wwi process is started). Therefore the "same" files are downloaded. Can you please temporarly prepare a generation variant and link the template to that and then use "report from template" using a specification having the file in userdefined text stored?

In doing so the file must be retrieved to your local computer. Normally any file is "Pushed" into "\temp" (depending on WWI installation). I am not sure about the user deifned text. Graphics are stored normally locall as a "static" document in the other folder as mentioned

What I do not know (because of lack of experience) is: if you use CG42 is the same approach used?; therefore you "simulate" a generation variant and you define a specification. Normally I would assume that the same process will be used and therefore the file should be downloaded, WWI started and WWI process can retrieve the graphic file

Therefore: can you please check if by using cg42: is there any file downloaded on "top" to the files you mentioned "nearly" at the same time and if so in which folder ? as long as this "download" does not work properly the WWI process "struggle".

With best regards

PS: you can try "report from template"  or "create report" using a specification (cg02). In this case nearly the some approach is used. Only difference: if you use a WWI server farm any file is pushed to the server farm and you well get a "WWI" report in status "Ready" (in most cases) in cg50. If you use CG50 and mark this report the user defined text should be retrieved yet

PPS: I found some OSS notes which might help. In any case I believe they are potentially helpful in daily work in cg42

Note 1601188

Note 1576098

May be: Note 1349193

PPPS: http://help.sap.com/saphelp_dimp50/helpdata/en/a7/2872ac0a6c11d28a220000e829fbbd/content.htm

If you read cross chapter:

"Symbol Type “Specification” " I assume you have adapted WWI.ini as requested ? (subchapter: Output of Document Management Documents)

[Former Member]

Hi Christoph,

Even with a gen variant, I experience the same problem.  I found an OSS note, 1086712, which highlighted to me that I was missing the slave group definition and apparently am using an incorrect expansion mode.  The example provided in the note is as follows:

<11BRG000(M,SAP_EHS_1013_008;*)>

   <11BRG001(S:FREI,GR;*)>

      <01GESTDHEADE(;*)>

   <11ERG001>

<11ERG000>

I was defining the user text with GPC graphic expansion (

<01GESTDHEADE(G)[SZ:A;D:Start of UD Text)  I suppose I can appreciate that graphic expansion mode would be interpreted to read the static graphic folder.  The problem is that when I define the symbol without an expansion mode (as per the example), nothing at all shows up in my output now.

Will keep playing with this and advise if I can get this to work. 

Regards,

Adam

[christoph_bergemann]

Dear Adam

I read cross the OSS note you found and the WWI logic

<11BRG000(M,SAP_EHS_1013_008;*)>

   <11BRG001(S:FREI,GR;*)>

      <01GESTDHEADE(;*)>

   <11ERG001>

<11ERG000>

I Assume thta you adapted WWI.Ini as required and you changed value assignment type acoordingly and that you do not use "GR" as user defined text type (to store the file)?? If so exchange that by your user defined text type. We are now using this feature for many years without a problem.

In the OSS note you found two othere note are mentioned.

OSS 843067 and OSS 818171: Both are "old" OSS so that they might not apply to your system.

Hopefully you will remove the issues asap.

With best regards

C.B.

[Former Member]

Hi Christoph,

I have indeed verified the WWI.ini settings to include the following:

[DocumentTypes]

jpg=GRAPHIC

Other entries are present as well, though the file I am testing with is a JPG.  The workstation application config is also maintained such that I am able to view the document without issue.

What are the changes required to the value assignment type?  I am using a standard VAT (SAP_RCS_CUSEXPSCE) and have not adjusted the config for this in any way.  IMG settings for the VAT I am using include:

  - Value Ass.Cat: A

  - VA Copy Active: check

  - Single Instance: uncheck

  - Int VA Type: uncheck

  - New VA Active: check

  - Change Active: check

  - Usage profile: PROF001

  - ID Listing: blank

  - Profile overridden: uncheck

  - Screen function: blank

My exact WWI template definition is as follows:

<11BRG013(M,SAP_RCS_CUSEXPSCE;*)>

<11BRG014(S:FREI,GR;*)>

<01GESTDHEADE(;*)[D:Start of UD Text]>

<11ERG014>

I AM using the standard 'GR' user defined text type, and it has the 'Document' checkbox selected in config.  After reading your message, I configured a new text type, Z1, though still have the same issue (yes, I also adjusted the WWI template above to the new value as well).

The only item from note 1086712 I am uncertain of is item #8: "Note that you must install the relevant graphic filter in MS Word to enable you to include the graphic in a WWI report.".  I have not adjusted Word and am not sure what a graphic filter is nor how to install one.  Perhaps this is the step holding me back?  I suspect I am very close!  Thanks much for your continued assistance.

Thanks,
Adam

[Former Member]

I found the registry setting for the Word graphic filter and the entry for JPG was indeed maintained so this is apparently not the issue.  Note that after adding the slave group to the WWI value, the tool is no longer trying to read the static graphics directory, though all that is being written to the output is the name of the file, and not the graphic attached to the file.  For example, the exact output showing up is:

Doc with JPG Attachment (w/o KPRO) ( ZZZ JPG_TEST 000 A0 )

As a reminder, I have tried working with several different document types both with and without the Knowledge Provider setting.  This doc is just a plain JPG original attached to a document type not going through KPro.

[christoph_bergemann]

Dear Adam

quite tricky really.

a.) I am not aware of any effects regarding the value assignment type regarding the output in WWI document; I believe we can exclude problems on this level (as long as active indicaor is set and usage of value assignment type (data record) does fit usage in generation variant)

b.) If you are able to use the value assignment type together with the userdefined text type then i believe you have done it right (prepared the right customizing etc.)

c.) as you can display the jpg file using cg02 by clicking on it no issue exists in DMS or definition of KPro

d.) is seems to be that no download of the grahic file is done to WWI folders

As long as no download is done it is clear that WWI process can not do the job.

I checked this FORUM and found a "similar" thread http://scn.sap.com/thread/1525492

Can you please check this: do you use the user defined text with or without a corresponding language (on CG02 level)?

It should be language independent as graphic file can normally be used for any lanuage of the WWI report

I will check our template and check in which WWI folder the download of the file is done.

With best regards

C.B.

PPS: According to note 1086712 you need to assign the specification category in definition of the user defined text type. This is important; but I assume you did it right

PPPS: Only an idea: you could try to apply OSS note 778684 with which cou can enable a logging of WWI actions; may be this might help

[Former Member]

Hi Christoph,

The user defined texts are indeed language independent (no value specified).

The user defined text type, GR, is assigned to both categories 'PACKAGE' and 'SUBSTANCE' though only the latter is applicable here.

Thanks for pointing me towards note 778684 though we are working with a local WWI installation for now and not going through a separate server.  Could the fact that we are not using the server somehow be responsible for the behavior?  My understanding was that the server is relevant in cases where one wishes to generate reports either in batch or by users without a local WWI install.  Clearly this would be used in a production setting, though for my prototyping purposes, I would imagine the local install would be sufficient?

Adam

[Former Member]

Something I just noticed which may not have any relevance to the issue but certainly seems odd is the search help results I see when dropping down on the user defined text type in CG42.  Notice that there are two identical entries for 'GR' though certainly this is defined only once in config.  I may debug through the search help to try and uncover the cause of this though I would doubt this could be contributing to the image not being displayed.

[christoph_bergemann]

Dear Adam

two new entries from your side. Let's start with topic 1:

"Thanks for pointing me towards note 778684 though we are working with a local WWI installation for now and not going through a separate server.  Could the fact that we are not using the server somehow be responsible for the behavior?  My understanding was that the server is relevant in cases where one wishes to generate reports either in batch or by users without a local WWI install. "

the behaviour of client installation and server installation regarding the topic MUST be identical.

You need to understand the "general" WWI process (High level explanation)

Local client:

1.) SAP is collecting data based on generation variant, template and specification

2.) SAP download the files locally to your client

3.) SAP is starting WWI process. You in using "Report from template" the WWI process "terminates"

Server:

1.) SAP is collecting data based on generation variant, template and specification

2.) SAP is "pushing" the data to the WWI server

3.) SAP is starting WWI process on the server

4.) Afterwards resulting document is passed back to SAP

Depending on set up of WWI server etc. some "clean" up activities are done afterwards (to my knowledge) to delete any file which has been passed on to the server

Now coming back to your second topic:

a.) clearly a strange behaviour from my point of view. Only one report symbol should be there to be selected/selectable in WWI definition process

Question: how did you create the report symbols? I am not sure if in this case the report symbol is part of SAP standard; I clearly assume that you checked customizing and you found only one symbol => very strange => potential OSS traffic

Now coming back: I checked the process once again. 

WWI layout must be defined like:

<11BRG013(M,SAP_RCS_CUSEXPSCE;*)>

<11BRG014(S:FREI,GR;*)>

<01GESTDHEADE(;*)>

<11ERG014>

I checked the local WWI process. Any file is downloaded in a "temp" file (defined to my knowlegde in WWI.ini etc.)

Could you please check this:

1.) identify the folder which is used

2.) check any file downloaded. There should be a file like "lehsfilX.val" (X is a number)

3.) Check content of this file. Here you will find an indication how the symbol

<01GESTDHEADE(;*)>  is repaced by the graphic file and in which location the file will be stored. I strongly assume that the file should contain some information (something like):

<01GESTDHEADE(;*)> is replaced by graphic file as c:\....temp\.....jpg

SAP does provide a logic to generated the "file" name which is downloaded. It seems to be not so "pretty" but it works.

The other files generated on local client are usefull as well.

One file is used to store "basic" logging information regrading the WWI process

According to my analysis: after replacing the file in WWI report the graphic file seems to be deleted by WWI process (therefore it is only temporarily available)

By the way: one topic you should check on the top. If you prepare a user defined text which can handle documents you normally prepare a correspending

document type (may be ZJPG). This document type "behaves" like "SBR" (regarding customizing etc.) and other. But as you can display the document by diretly using cg02 I assume that there is no open task to be done.

May be this helps

C.B.

[Former Member]

Hi,

The report symbols in question are those provided with the standard SPRC 2.0 SP3 installation.  I originally attempted to add the graphic as an additional element to the CP_DECLREP template delivered as part of SPRC. 

Thinking that there may be some other nuance of the delivered template causing the issue, I created a new template and gen variant from scratch where the user text report symbol is the only symbol in the template.  Same behavior - only the file description is written to the report and not the graphic itself.

There are several entries written to my C:\TEMP folder which unfortunately do not offer any clues.  Contents of Lehslay0.val includes:

[GRAPHICS]

count=0

Contents of Lehslay0.txt is as follows:

I000 c:\Temp\lehslay0.WWI

I000 12.06.2012

I000 16:21:54

I000   Resolve-DLL    : 3.2 / 2.7B SP26; 2005,110,125,373; C:\Program Files (x86)\SAP\FrontEnd\sapgui\wwi\WWIRES32.DLL; 24.08.2011 18:23

I000   Configuration  : C:\Program Files (x86)\SAP\FrontEnd\sapgui\wwi\WWI.INI

I000   Configuration  : C:\Program Files (x86)\SAP\FrontEnd\sapgui\wwi\WWI.INI

I000 16:21:54

I000 1

Back at the time of the 8th node of this topic (before adding the slave group definition and removing GPC-G expansion mode), recall that I was getting an error that the system was looking for the graphic in the static graphics directory specified in the .INI file.  At that time, the error message was being written to the Lehslay0.txt file.  The point is that there was logging to this file when a graphic could not be located, although with the 'proper' WWI syntax, I do not get any reference to the graphic translation (success or failure) along the lines of '

<01GESTDHEADE(;*)> is replaced by graphic file as c:\....temp\.....jpg

'.

The full list of files created in C:\TEMP during CG42 preview includes:

  - rehslay0.rtf

  - lehslay0.txt

  - lehslay0.val

  - lehslay0.wwi

  - rehslay0.val

  - lehslay0.str

Contents of rehslay0 include:

90000  5V2005

91000  8EHS_FONT1160

92000  8EHS_FONT1160

92000  8EHS_LANGEN

99000 10EHS_REPORT

99000 10EHS_LENGTH(792000)

99000  9EHS_WIDTH(612000)

11  1  6BRG000

11  2  6BRG001

01000 10GESTDHEADEDoc with JPG Attachment (w/o KPRO) ( ZZZ JPG_TEST 000 A0 )

There is not a temp file corresponding to the DMS original on my system.  Do you see any additional files on your side which correspond to the graphic?  While the preview is rendered to the screen, the temp files are visible to me via explorer.  All that I see are the lehslay0.* and rehslay0.* files specified above and nothing specifically as a local copy of the graphic from DMS

I certainly appreciate the effort you have expended thus far in assisting

Adam

[christoph_bergemann]

Hello Adam

now we are a "little" closer to a "potential" solution: (PS: only using process "Report from template" But i assume your process should behave the same):

Lehslay0.val includes:

[GRAPHICS]

count=0

This is "wrong" and therefore the whole stuff is not working. It should look like (only high level):

[GRAPHICS]

WWigraphics .... C:\ path to folder in which grapich should be stored + file name

count=0

File name: the file name is generated like this (not exactly like that but only to explain it)

XXX YYY ZZZZ AAAA (please refer to the value assignment and the user defined text: the key shown there is part of this "file" name)

XXX = client of SAP system

YYY = name of your system (4 digits normally)

ZZZ = document type as used (may be ZJPG)

AAAA = "technical" key which describes the document stored in DMS or kpro

(may be the sequence of XX/YY etc. is wrong  but only to provide you an idea )

It is clear now that no download of the required file is done.  Lehslay0.val does not have the required content

01000 10GESTDHEADEDoc with JPG Attachment (w/o KPRO) ( ZZZ JPG_TEST 000 A0 )

This "ZZZ JPG_TEST 000 A0 " is "nearly" structure (AAAA) which we need. ZZZ I assume is the document type?

coming back to this list:

- rehslay0.rtf => is not "normal" //

  - lehslay0.txt => ok

  - lehslay0.val => ok

  - lehslay0.wwi => ok

  - rehslay0.val => ok

  - lehslay0.str => never have seens something like this

Normally in one of these files (I believe lehslay0.txt) this should show up:

"link to graphic inserted by using C:\.... \temp\file name of graphic and replacing 01GESTDHEADE(;*)"

(it is not this text but something like that). This text seems to be missing as well in the file.

First I would like once again provide some tipps regarding WWI and then may be regarding SAP part:

If you check this "temp" folder and what is happening during e.g. "Report from template" you will realize that

a.) one file is the "layout" (wwi file)

b.) one file is the "data" (val file)

c.) one file is "contol" file (txt file)

d.) and one file is "final" report (in your case I assume the RTF file)

etc.

During the SAP/WWI process this happens (high level):

a.) layout is downloaded

b.) data is downloaded

c.) wwi process is started. Now the WWI uses a "macro". On high level this happens

1.) layout is read into word

2.) the "macro" tries to find the report symbols

3.) then by using the "val" file it tries to identify the positions there data need to be inserted

At the end any report symbol (if you have entered material number, salesorg etc.) is "replaced" by the data (in val file) and you "see" the "final" report on your client.

Try to understand these files which are downloaded then you will get step by step a better picture of the process

Now coming back to the SAP issue. I have not so many ideas left.

a.) there could be a "wrong" definition existing in customizing regarding document type which you have used to "insert" the graphic (the document type should use "status" like in the case of SBR

b.) The report symbol is "technically" wrong defined => please use a different property / value assignment; prepare suitable data (correct usage, user defined text etc.) and adapt the WWI accordingly and try it again

As cou can display the graphic in cg02 a.) seems not to be the "best" choice but may be check it. Actually I "prefer" option b.)

I believe according to your explanation we can exclude topics in the area of general DMS customizing or the customizing of KPRO.

As explained: a survey in SAP marketplace was not successful and this functionality is "quite" old.

Last but not least: last chance would be:

prepare a test layout and test generation variant only with the "basic" problem. and then by using cg02 and report from template: simply debug what is happening on the process

The function modules to create reports are assigned to e.g. function group:

C12J or C12H

E.g. refer to: http://www.se80.co.uk/sapfms/c/c12j/c12j_wwi_raw_report_generate.htm

I hope that you can remove the topic.

With best regards

C.B.