Tech Articles


Quick start for contributing to Open Source PFC


Given that not everyone is fluent in using Git and or Github (where the Open Source PFC is hosted now), I put together a quick introduction in how to get started.  The video below walks through the steps, which in summary are:

  • Create a GitHub account if you don't already have one.  https://github.com/join
  • Navigate to the Open Source PFC and "Fork" a copy of the code into your account.  The 2019 version of the PFC can be found at: https://github.com/OpenSourcePFCLibraries/2019
  • Chose Code -> Clone and copy the HTTPS URL for your fork.
  • Open the PowerBuilder 2019 IDE and with no workspace open select File -> Connect to Workspace.
    • Source Control System:  Choose Git
    • Repository URL: Paste in the URL you copied above
    • Workspace File: Give it any name you choose
    • User ID:  Your Github user id (normally your email address)
    • Password:  Your Github password
    • Checkout Directory:  Select or create a new empty subdirectory on your local machine for the code to be copied to
  • Wait until the source code is downloaded and refreshed (12 to 15 minutes)

Now you're ready to start making changes.  The process for doing that is:

  • Make the change in your workspace
  • Commit it to your local repository (using the PowerBuilder IDE)
  • Push it to your fork in Github (using the PowerBuilder IDE)
  • Create a Pull Request in your fork of the code in Github

The Pull Request sends the suggested change back to the main Open Source PFC project.  It is then reviewed and if approved is then is merged into the main project.

 

 

 

Comments (5)
Wednesday, Jan 27 2021

Great stuff Bruce!
(just in case anyone gets into the same trouble as I did)
I'm an absolute noob on GitHub and forgot to first do the "Fork", I stupidly enough tried to connect in the new powerbuilder workspace to your repo.
After that, I also realized I cannot connect in powerbuilder using my password and created a token in my own github account, which I then used as the "password" in the powerbuilder workspace when connecting to git.
Thank you!
MiguelL

0

Thursday, Oct 07 2021

Hello Bruce!

I done everything as you did in video, but I have problem with connection to workspace from PB (PB 2019 R2 2328).
I always get notice (Cannot connect to the repository. Please make sure you have specified the correct repository URL, user ID and password)
For sure I use correct credentials.
What could be the problem?
Tomaz

0
Thursday, Oct 07 2021

Since I wrote that article Github has moved to the user of personal access tokens rather than using the password for the Github account.

https://github.blog/2020-07-30-token-authentication-requirements-for-api-and-git-operations/

Just generate a personal access token for your repository and use that instead of the password.

0

Thursday, Sep 07 2023

Hi,

Recently we migrated our application into Powerserver 2021 version. While migrating we faced some below Unsupported Powerserver features in PFC libraries

sqlreturndata
previewinsert
previewdelete
previewupdate
when i searched help docs

https://docs.appeon.com/ps2021/bk06ch02s01s05.html

https://docs.appeon.com/ps2021/bk06ch02s01s06.html

not able to find the workaround for the above PFC feature



Kindly help me to identify the workaround for the above features.



Thanks

Vignesh

0
Thursday, Sep 07 2023

I just turned on discussions in the PFC project in Github. That would be the more appropriate location to discuss this.

https://github.com/orgs/OpenSourcePFCLibraries/discussions

0

Find Articles by Tag

PowerBuilder Branch & Merge Event Handling Application BLOB Export JSON PowerBuilder (Appeon) License Git GhostScript Stored Procedure Database Connection Encryption OLE Filter Source Code Window Graph CrypterObject Mobile PBVM Service DevOps PDF Debugger Android PowerServer Web WebBrowser Import Database Profile Installation PFC CI/CD Configuration RichTextEdit Control PostgreSQL ODBC driver Platform Outlook Migration Jenkins Design Encoding IDE SnapObjects MessageBox Source Control PowerServer Mobile Event Handler Messagging Import JSON Windows OS Trial 64-bit Excel JSONGenerator Database Table Data DataWindow JSON Authentication TortoiseGit Testing Transaction TreeView Array SQL iOS JSONParser Resize API .NET Assembly C# PBDOM ActiveX Elevate Conference Automated Testing SDK InfoMaker Bug TLS/SSL Text RESTClient RibbonBar Builder Model SVN SOAP RibbonBar .NET DataStore Repository ODBC XML Error Charts Database Table Web API Visual Studio OAuth 2.0 SQL Server NativePDF JSON Expression External Functions WinAPI Database Object UI Modernization DragDrop SnapDevelop COM Menu Icon Open Source Class Database Painter HTTPClient Event OAuth Oracle Syntax CoderObject Database Interface Variable File Debug REST DLL PostgreSQL Authorization TFS Windows 10 Icons Script UI Deployment DataWindow .NET Std Framework Sort SqlModelMapper 32-bit SqlExecutor PowerScript (PS) Validation Azure Data Web Service Proxy Export Debugging PDFlib DataType PBNI PowerBuilder Compiler Linux OS Performance UI Themes OrcaScript Database Table Schema