How not update EPMDocument attributes. Need to include as-stored baseline

Is there any reason you decided to iterate (checkout/checkin) the epmdocs?

You could have created/updated the attributes without iterating the epmdocs and then republish them all with the same utility.

Just curious.

I apologize @avillanueva  -- I left out the as-stored!  Below brings the as-stored into the workspace along with the checked-out model, so that when checking it in, the new iteration also receives an as-stored baseline (with the same iterations as the iteration checked-out).  I tested on a 12.1 system and confirmed the as-stored baseline is created on the new check-in, and that it can successfully publish using that as-stored.  I haven't added the workspace cleanup here -- the remove from workspace is removing the object just checked in, but not its as-stored members, I need to add that. Also, when I had been exploring the API to fetch baseline members, I didn't fully understand how it was handling unresolved dependencies - may want to look at the as-stored before and after in your configuration if that is a concern.

Re your question about collection -- the API works on a collection, rather than on a single item, so I create a collection of one item to use the API.  

package ext.tsd;

import java.util.Map.Entry;

import org.apache.logging.log4j.Logger;

import com.ptc.windchill.cadx.ws.WorkspaceHelper;
import wt.epm.EPMDocConfigSpec;
import wt.epm.EPMDocument;
import wt.epm.structure.EPMStructureHelper;
import wt.epm.workspaces.CheckinOption;
import wt.epm.workspaces.EPMAsStoredConfigSpec;
import wt.epm.workspaces.EPMWorkspace;
import wt.epm.workspaces.EPMWorkspaceHelper;
import wt.fc.ObjectReference;
import wt.fc.Persistable;
import wt.fc.PersistenceHelper;
import wt.fc.QueryResult;
import wt.fc.collections.WTArrayList;
import wt.fc.collections.WTCollection;
import wt.fc.collections.WTKeyedHashMap;
import wt.fc.collections.WTSet;
import wt.fc.collections.WTValuedMap;
import wt.folder.Folder;
import wt.inf.container.WTContainer;
import wt.log4j.LogR;
import wt.part.WTPartConfigSpec;
import wt.session.SessionHelper;
import wt.util.WTException;
import wt.util.WTPropertyVetoException;

public class EPMWorkspaceUtility {
	protected static Logger LOG = LogR.getLogger(EPMWorkspaceUtilityV0.class.getName());
	public static EPMDocument checkoutWorkspace(EPMDocument epmDocument, String temporaryWorkspaceName) throws WTException, WTPropertyVetoException {
		EPMWorkspace epmWorkspaceForCheckout = WorkspaceHelper.getWorkspace(temporaryWorkspaceName);
		if(epmWorkspaceForCheckout == null) {
			// Create temporary workspace
			WTPartConfigSpec wtPartConfigSpec = WTPartConfigSpec.newWTPartConfigSpec();
			EPMDocConfigSpec epmDocConfigSpec= EPMDocConfigSpec.newEPMDocConfigSpec();
			Folder folder = epmDocument.getFolderingInfo().getFolder();
			WTContainer wtContainer = epmDocument.getContainer();
			epmWorkspaceForCheckout = EPMWorkspace.newEPMWorkspace(temporaryWorkspaceName, SessionHelper.manager.getPrincipal(), folder, wtPartConfigSpec, epmDocConfigSpec, wtContainer);
			epmWorkspaceForCheckout = (EPMWorkspace)PersistenceHelper.manager.store(epmWorkspaceForCheckout);
		}
		// Add as-stored to workspace
		WTCollection asStoredWTCollection = new WTArrayList();
		EPMAsStoredConfigSpec epmAsStoredConfigSpec = EPMAsStoredConfigSpec.newEPMAsStoredConfigSpec(epmDocument);
		// Javadoc: Sets the value of the attribute: allowLatestSubstitutes; This option
		// configures the config spec to return the latest iteration when the
		// as-stored baseline config does not contain any iteration of the masterobject.
		// If allowLatestSubstitutes is set, the config spec selects the latestiteration. 
		// If allowLatestSubstitutes is not set, the config spec
		// does not select any iteration. By default, allowLatestSubstitutesis set. 
		epmAsStoredConfigSpec.setAllowLatestSubstitutes(false);
		// 2nd argument is optional query spec for further reducing what is returned
		// 3rd argument true means to return EPMDocuments (if in as-stored) or EPMDocumentMaster (if not in as-stored)
		//		If it were false, each return would be Persistable[], with [0] is the EPMMemberLink, and [1] EPMDocument or EPMDocumentMaster
		// 4th argument is config spec
		// That said, it appears that when the as-stored member is unresolved, this is returning all of the latest iteration - including commonspace + private workspace
		// And it does that regardless of whether 3rd argument is true or false (tested)
		QueryResult asStoredMembers = EPMStructureHelper.service.navigateUsesToIteration(epmDocument, null, true, epmAsStoredConfigSpec);
		LOG.trace("Found " + asStoredMembers.size() + " members");
		while(asStoredMembers.hasMoreElements()) {
			Persistable persistable = (Persistable)asStoredMembers.nextElement();
			LOG.trace("Persistable is " + persistable.toString());
			if(!(persistable instanceof EPMDocument)) {
				continue;
			}
			EPMDocument asStoredMemberEPMDocument = (EPMDocument) persistable;
			LOG.trace("Examining as-stored member " + asStoredMemberEPMDocument.getDisplayIdentity().toString());
			asStoredWTCollection.add(asStoredMemberEPMDocument);
		}
		EPMWorkspaceHelper.manager.addToWorkspace(epmWorkspaceForCheckout, asStoredWTCollection);
		
		
		WTCollection epmDocumentCollection = new WTArrayList();
		epmDocumentCollection.add(epmDocument);
		WTValuedMap wtValuedMap = EPMWorkspaceHelper.manager.checkout(epmWorkspaceForCheckout, epmDocumentCollection);
		EPMDocument originalEPMDocument = null;
		EPMDocument workingcopyEPMDocument = null;
		for(Object entryObject: wtValuedMap.entrySet()) {
			if(entryObject instanceof Entry) {
				Entry entry = (Entry)entryObject;
				Object originalObject = entry.getKey();
				if(originalObject instanceof ObjectReference) {
					ObjectReference originalObjectReference = (ObjectReference)originalObject;
					originalEPMDocument = (EPMDocument)originalObjectReference.getObject();
				}
				Object workingcopyObject = entry.getValue();
				if(workingcopyObject instanceof ObjectReference) {
					ObjectReference workingcopyObjectReference = (ObjectReference)workingcopyObject;
					workingcopyEPMDocument = (EPMDocument)workingcopyObjectReference .getObject();
				}
				break;
			}
		}
		return workingcopyEPMDocument; 
	}
	public static EPMDocument checkInWorkspace(EPMDocument epmDocument, String temporaryWorkspaceName) throws WTException, WTPropertyVetoException {
		EPMWorkspace epmWorkspaceForCheckout = WorkspaceHelper.getWorkspace(temporaryWorkspaceName);
		WTKeyedHashMap checkinMap = new WTKeyedHashMap();
		CheckinOption checkinOption = new CheckinOption("insert checkin comment here");
		checkinMap.put(epmDocument, checkinOption);
		WTSet wtSet = EPMWorkspaceHelper.manager.checkin(epmWorkspaceForCheckout, checkinMap, new WTArrayList(), new WTArrayList());
		EPMDocument checkedInEPMDocument = null;
		WTCollection wtCollectionCheckedIn = new WTArrayList();
		for(Object o: wtSet) {
			if(o instanceof ObjectReference) {
				ObjectReference objectReferenceCheckinResult = (ObjectReference)o;
				EPMDocument epmDocumentCheckinResult = (EPMDocument) objectReferenceCheckinResult.getObject();
				LOG.debug("Checked in: " + epmDocumentCheckinResult.getDisplayIdentity().toString());
				LOG.debug("OID: " + epmDocumentCheckinResult.getPersistInfo().getObjectIdentifier().getStringValue());
				wtCollectionCheckedIn.add(epmDocumentCheckinResult);
				checkedInEPMDocument = epmDocumentCheckinResult;
			}
		}
		EPMWorkspaceHelper.manager.removeFromWorkspace(epmWorkspaceForCheckout, wtCollectionCheckedIn);
		return checkedInEPMDocument;
	}
}