sfmc-devtools icon indicating copy to clipboard operation
sfmc-devtools copied to clipboard

[Task] explain the different ways of using templating in the docs

Open JoernBerkefeld opened this issue 1 year ago • 0 comments

In principle, both should lead to the same result, however, that's clearly not the case here.

  • [ ] bug: #390 The file should not be renamed by bt

Choosing one or the other command depends on your use case. U understood correctly how they are intended to work. With that said, rt needed to be implemented per type and we never got around to that - means there are types for which it wasn't implemented.

Bt on the other hand relies on you executing retrieve first and then works for all types you downloaded. It's more generic because it didn't need to handle downloading a single file.

If you want to use templating then you have essentially 3 ways:

  1. Use the commands rt, bd(b), d
  2. Use the commands r, bt, bd(b), d
  3. Use r, then manually copy & adapt files from retrieve/ to template/, then run bd(b), d

Option 4 is also available and relies on you using a git repo and the command createDeltaPkg & deploy together. That's mostly for CI/CD enabled projects but I have seen teams use it manually as well.

Originally posted by @JoernBerkefeld in https://github.com/Accenture/sfmc-devtools/discussions/385#discussioncomment-3214911

JoernBerkefeld avatar Jul 25 '22 10:07 JoernBerkefeld