nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

Find Related files configuration using CSSDK

Jeya

TeamSite 7.2.1

Hi,

In Actions menu 'Find Related Files' shows datacapture.cfg as a default entry for a DCR.
We are creating DCRs using CSSDK. 'Find Related Files' does not show any entry for DCRs created through CSSDK. Where to set this relationship?
Any pointers?

Thanks,
Jeya.

Find more posts tagged with

Comments

Rick Poulin

A number of classes including CSSimpleFile implement CSAssociatable. Look up the Javadoc on that one -- it's how you should create your association to the datacapture.cfg if you really care to keep it. You can use the same API to read the current values of a DCR that was created by TeamSite, to see what 'type' value is.

Jeya

Thank You!! Can you please elaborate your comment:

"You can use the same API to read the current values of a DCR that was created by TeamSite, to see what 'type' value is."

Does this mean that we have predefined set of 'type' values?

API says,
"type - Type of association, this can be any string to qualify the association. Example: "localized_copy". 'type' can be set to null or empty string too."

(Sorry for my post format... I see people use separate blocks to quote but I dont know from where to insert them..)

Jeya

I tried creating association as below.


CSAssociatable[] assIns={(CSAssociatable)(client.getFile(new CSVPath(dcrFilePath)))};
sFile.createParentAssociations(assIns, "Contains New Instance", false);

While checking in 'Find Related Files' the Relationship column shows 'Uses' or 'Used by' depending upon whether the file is parent or child.

I thought whatever I pass as 'type' param will come as Relationship value. Is it possible to set custom values in Relationship column?
what is the use of 'type' param?

Rick Poulin

The association "type" is the value of the "Relationship" column in the "Find Related Files" dialog.

Yes, there are predefined type values, and yes you can define your own. However, if you're looking to replicate the relationship produced by TS when you use FormsPub to create your DCR, you'll want to be sure to use exactly the same type String that FormsPub uses. I was suggesting using the API to figure out what that string is, because it may be represented differently in the "Find Related Files" interface.

The usage of that column is up to you, at least for custom values. Interwoven uses specific association types for things like the "Attach Dependencies" task in the PLC workflow.

Jeya

The association I am trying to create is not any TS FormsPub replicant.

The association "type" is the value of the "Relationship" column in the "Find Related Files" dialog.

If so then the code below should show the relationship value as "Contains New Instance". But it shows 'Uses'. What did I miss?


CSAssociatable[] assIns={(CSAssociatable)(client.getFile(new CSVPath(dcrFilePath)))};
sFile.createParentAssociations(assIns, "Contains New Instance", false);

Rick Poulin

That's what I was alluding to with "I was suggesting using the API to figure out what that string is, because it may be represented differently in the 'Find Related Files' interface". I think there is a difference in the way the 'Relationship' column interprets the 'type' values. From the CSAssociation:

Associations could optionally be typed. At creation time, the association can be tagged with a given type. This provides a convenient mechanism for applications to keep track of only associations that they care about. It is assumed that applications would use appropriate namespacing to differentiate between association types.

In my mind, this implies that if you were to look up your newly created association, you'd find that its type is still "Contains New Instance". It may be that the "Find Related Files" dialog attempts to assign a user-friendly label for the type (which I'd think is usually a programmer-friendly key), and when it finds none for any but the OOTB types, uses "Uses" instead. ..but I haven't played around with associations enough to say for sure.

Jeya

Hi Rick,

you are correct. Below code gives the type value.


CSAssociation[] csa = sFile.createParentAssociations(assIns, "Contains New Instance", false);    
logger.info("CSAssociation Type:"+csa[0].getType());

By below code am able to retrieve them.


CSAssociation[] csa=csfile.getParentAssociations("Contains New Instance");

Thank you for your guidance.